Contents

SRv6 OAM commands· 1

ping ipv6-sid· 1

tracert ipv6-sid· 3

 

SRv6 OAM commands

ping ipv6-sid

Use ping ipv6-sid to detect connectivity of an SRv6 path.

Syntax

ping ipv6-sid [ -a source-ipv6 | -c count | -m interval | -q | -s packet-size | -t timeout | -tc traffic-class | -v ] * [ segment-by-segment ] { sid }&<1-n>

Views

Any view

Predefined user roles

network-admin

mdc-admin

Parameters

-a source-ipv6: Specifies an IPv6 address of the device as the source IP address of ICMP echo requests. If you do not specify this option, the source IPv6 address of ICMP echo requests is the IPv6 address of the outbound interface.

-c count: Specifies the number of ICMPv6 echo requests that are sent to the destination. The value range is 1 to 4294967295, and the default is 5.

-m interval: Specifies the interval (in milliseconds) to send an ICMPv6 echo request. The value range is 1 to 65535, and the default is 1000.

-q: Displays only the summary statistics. If you do not specify this keyword, the system displays all the ping statistics.

-s packet-size: Specifies the length (in bytes) of ICMPv6 echo requests (excluding the IPv6 packet header and the ICMPv6 packet header). The value range is 20 to 9600, and the default is 56.

-t timeout: Specifies the timeout time (in milliseconds) of an ICMPv6 echo reply. The value range is 0 to 65535, and the default is 2000.

-tc traffic-class: Specifies the traffic class value in an ICMPv6 packet. The value range is 0 to 255 and the default is 0.

-v: Displays detailed information about ICMPv6 echo replies. If you do not specify this keyword, the system only displays brief information about ICMPv6 echo replies.

segment-by-segment: Performs segment-by-segment ping. If you do not specify this keyword, end-to-end ping is performed.

{ sid }&<1-n>: Specifies a space-separated list of up to n SRv6 SIDs. The value for n is 10. This argument applies only to end-to-end ping. You must configure the End.OP SID by using this argument.

Usage guidelines

To perform end-to-end ping, make sure the following conditions are met:

·     An End.OP SID has been configured on the destination node.

·     When specifying the SRv6 SID list, specify the End.OP SID before the SRv6 SID of the destination node.

Take an end-to-end ping to detect the SRv6 path A—>B—>C for example (where A, B, and C are the source node, intermediate node, and destination node, respectively). The SRv6 SID of node B is 1010::1:0:1b, the End.OP SID of node C is 1020::32, and the SRv6 SID of node C is 1020::1:0:3. To perform end-to-end ping on source node A, execute the ping ipv6-sid 1010::1:0:1b 1020::32 1020::1:0:3 command.

To identify one of the multiple SRv6 paths between the source and destination nodes, you can specify the SRv6 SIDs of multiple nodes on the specific path.

To abort the SRv6 SID-based ping operation during the execution of the command, press Ctrl+C.

Examples

# Perform end-to-end ping to detect the SRv6 path connectivity (the SRv6 SID of the intermediate node is 1010::1:0:1b, the End.OP SID of the destination node is 1020::32, and the SRv6 SID of the destination node is 1020::1:0:3).

<sysname> ping ipv6-sid 1010::1:0:1b 1020::32 1020::1:0:3

Ping SRv6(56 data bytes) 1010::1:0:1b 1020::32 1020::1:0:3, press CTRL_C to break

56 bytes from 1020::1:0:3, icmp_seq=0 ttl=64 time=62.000 ms

56 bytes from 1020::1:0:3, icmp_seq=1 ttl=64 time=23.000 ms

56 bytes from 1020::1:0:3, icmp_seq=2 ttl=64 time=20.000 ms

56 bytes from 1020::1:0:3, icmp_seq=3 ttl=64 time=4.000 ms

56 bytes from 1020::1:0:3, icmp_seq=4 ttl=64 time=16.000 ms

 

--- Ping SRv6 statistics ---

5 packets transmitted, 5 packets received, 0.0% packet loss

round-trip min/avg/max/std-dev = 4.000/25.000/62.000/20.000 ms

# Perform segment-by-segment ping to detect the SRv6 path connectivity (the SRv6 SID of the intermediate node is 1010::1:0:1b and the SRv6 SID of the destination node is 1020::1:0:3).

<sysname> ping ipv6-sid segment-by-segment 1010::1:0:1b 1020::1:0:3

Ping SRv6(56 data bytes) 1010::1:0:1b 1020::1:0:3, press CTRL_C to break

56 bytes from 1010::1:0:1b, icmp_seq=0 ttl=64 time=36.000 ms

56 bytes from 1020::1:0:3, icmp_seq=0 ttl=63 time=62.000 ms

56 bytes from 1010::1:0:1b, icmp_seq=1 ttl=64 time=23.000 ms

56 bytes from 1020::1:0:3, icmp_seq=1 ttl=63 time=43.000 ms

56 bytes from 1010::1:0:1b, icmp_seq=2 ttl=64 time=10.000 ms

56 bytes from 1020::1:0:3, icmp_seq=2 ttl=63 time=20.000 ms

56 bytes from 1010::1:0:1b, icmp_seq=3 ttl=64 time=4.000 ms

56 bytes from 1020::1:0:3, icmp_seq=3 ttl=63 time=12.000 ms

56 bytes from 1010::1:0:1b, icmp_seq=4 ttl=64 time=7.000 ms

56 bytes from 1020::1:0:3, icmp_seq=4 ttl=63 time=16.000 ms

 

--- Ping SRv6 statistics ---

5 packets transmitted, 10 packets received

round-trip min/avg/max/std-dev = 4.000/23.000/62.000/20.000 ms

# Detect reachability of the node whose SRv6 SID is 1020::1:0:3. Only summary statistics are displayed.

<Sysname> ping ipv6-sid –q 1010::1:0:1b 1020::32 1020::1:0:3

Ping SRv6 (56 data bytes) 1010::1:0:1b 1020::32 1020::1:0:3, press CTRL_C to break

 

--- Ping SRv6 statistics ---

5 packets transmitted, 5 packets received, 0.0% packet loss

round-trip min/avg/max/std-dev = 4.000/25.000/62.000/20.000 ms

# Detect reachability of the node whose SRv6 SID is 1020::1:0:3. Detailed ping statistics are displayed.

<Sysname> ping ipv6-sid –v 1010::1:0:1b 1020::32 1020::1:0:3

Ping SRv6(56 data bytes) 1010::1:0:1b 1020::32 1020::1:0:3, press CTRL_C to break

56 bytes from 1020::1:0:3, icmp_seq=0 ttl=64 dst=1010::1:0:1a idx=129 time=62.000 ms

56 bytes from 1020::1:0:3, icmp_seq=1 ttl=64 dst=1010::1:0:1a idx=129 time=23.000 ms

56 bytes from 1020::1:0:3, icmp_seq=2 ttl=64 dst=1010::1:0:1a idx=129 time=20.000 ms

56 bytes from 1020::1:0:3, icmp_seq=3 ttl=64 dst=1010::1:0:1a idx=129 time=4.000 ms

56 bytes from 1020::1:0:3, icmp_seq=4 ttl=64 dst=1010::1:0:1a idx=129 time=16.000 ms

 

--- Ping SRv6 statistics ---

5 packets transmitted, 5 packets received, 0.0% packet loss

round-trip min/avg/max/std-dev = 4.000/25.000/62.000/20.000 ms

Table 1 Command output

Field	Description
Ping SRv6 1010::1:0:1b 1020::32 1020::1:0:3, 56 data bytes, press CTRL_C to break	An ICMPv6 echo request with a data length of 56 bytes is sent through an intermediate SRv6 node with SID 1010::1:0:1b to the destination node with End.OP SID 1020::32 and SRv6 SID 1020::1:0:3. Press Ctrl+C to abort the ping operation.
56 bytes from 1020::1:0:3, icmp_seq=1 ttl=64 dst=12::1 idx=129 time=62.000 ms	Received ICMPv6 echo replies from the SRv6 node whose SID is 1020::1:0:3. ·     The number of data bytes is 56. ·     The SRv6 SID of the destination node is 1020::1:0:3. ·     The packet sequence is 1. ·     The hop limit value is 64. ·     The destination address is 12::1. Specify the -v keyword to display this field. ·     The index for the packet inbound interface is 129. Specify the -v keyword to display this field. ·     The response time is 62 milliseconds.
--- Ping SRv6 statistics ---	Statistics on data received and sent in a ping operation.
5 packets transmitted	Number of ICMPv6 echo requests sent.
5 packets received	Number of ICMPv6 echo replies received.
0.0% packet loss	Percentage of unacknowledged requests to the total requests sent.
round-trip min/avg/max/ std-dev =4.000/25.000/62.000/20.000 ms	Minimum/average/maximum/standard deviation response time, in milliseconds.

 

Related commands

opcode

tracert ipv6-sid

Use tracert ipv6-sid to display the path that the IPv6 packets containing the specified SRv6 SID list traverse from the source node to the destination node.

Syntax

tracert ipv6-sid [ -a source-ipv6 | -f first-hop | -m max-hops | -p port | -q packet-number | -t traffic-class | -w timeout ] * [ overlay ] { sid }&<1-n>

Views

Any view

Predefined user roles

network-admin

mdc-admin

Parameters

-a source-ipv6: Specifies a valid IPv6 address on the device as the source IPv6 address of the probe packets. If you do not specify this option, the source IPv6 address of the probe packets is the IPv6 address of the outbound interface.

-f first-hop: Specifies the TTL value of the first packet. The value range is 1 to 255, and the default is 1. The value must be no greater than the value of the max-hops argument.

-m max-hops: Specifies the maximum number of hops allowed for a packet. The value range is 1 to 255, and the default is 30. The value must be no smaller than the value of the first-hop argument.

-p port: Specifies an invalid UDP port of the destination. The value range is 1 to 65535, and the default is 33434.

-q packet-number: Specifies the number of probe packets sent each time. The value range is 1 to 65535, and the default is 3.

-t traffic-class: Specifies the traffic class value in an IPv6 probe packet. The value range is 0 to 255, and the default is 0.

-w timeout: Specifies the timeout time (in milliseconds) of the reply packet of a probe packet. The value range is 1 to 65535, and the default is 5000.

overlay: Performs overlay tracert. If you do not specify this keyword, hop-by-hop tracert is performed. If you specify this keyword, you cannot specify the -f or -m keyword.

{ sid }&<1-n>: Specifies a space-separated list of up to n SRv6 SIDs. The value for n is 10. This argument applies only to hop-by-hop tracert. You must configure the End.OP SID by using this argument.

Usage guidelines

After identifying network failure with the ping ipv6-sid command, you can use the tracert ipv6-sid command to locate failed nodes.

The output from the tracert ipv6-sid command includes SRv6 SIDs of all the devices that the packets traverse from source to destination. Asterisks (* * *) are displayed if the device cannot reply with an ICMP error message. The reason might be the destination is unreachable or sending ICMP timeout/destination unreachable packets is disabled.

Before starting a tracert operation, you must enable sending of ICMPv6 destination unreachable messages on the intermediate devices between the source and destination. The tracert operation stops if any of the following ICMPv6 destination unreachable messages is received:

·     !N—No route to destination.

·     !P—Communication with destination administratively prohibited by filtering policies.

·     !A—Address unreachable. The unreachable reason is unknown.

·     !S—Beyond scope of source address. This message is displayed if the probe packet has a link-local source address and a non-link-local destination address. Such a packet cannot be delivered to the destination without leaving the scope of the source address.

To perform hop-by-hop tracert, make sure the following conditions are met:

·     An End.OP SID has been configured on the destination node.

·     When specifying the SRv6 SID list, specify the End.OP SID before the SRv6 SID of the destination node.

Take a hop-by-hop tracert to detect the SRv6 path A—>B—>C for example (where A, B, and C are the source node, intermediate node, and destination node, respectively). The SRv6 SID of node B is 1010::1:0:1b, the End.OP SID of node C is 1020::32, and the SRv6 SID of node C is 1020::1:0:3. To perform hop-by-hop tracert on source node A, execute the tracert ipv6-sid 1010::1:0:1b 1020::32 1020::1:0:3 command.

To identify one of the multiple SRv6 paths between the source and destination nodes, you can specify the SRv6 SIDs of multiple nodes on the specific path.

To abort the tracert operation during the execution of the command, press Ctrl+C.

Examples

# Perform hop-by-hop tracert to display information about the SRv6 path (the SRv6 SID of the intermediate node is 1010::1:0:1b, the End.OP SID of the destination node is 1020::32, and the SRv6 SID of the destination node is 1020::1:0:3).

<Sysname> tracert ipv6-sid 1010::1:0:1b 1020::32 1020::1:0:3

Traceroute SRv6 1010::1:0:1b 1020::32 1020::1:0:3, 30 hops at most, 60 bytes packets, press CTRL_C to break

1  15::1 [SRH: 1020::1:0:3, 1020::32, 1010::1:0:1b, SL=2]  0.661 ms  0.618ms  0.579ms

2  12::2 [SRH: 1020::1:0:3, 1020::32, 1010::1:0:1b, SL=1]  0.861 ms  0.718ms  0.679ms

Table 2 Command output

Field	Description
Traceroute SRv6 1010::1:0:1b 1020::32 1020::1:0:3	Display the SRv6 path that the IPv6 packets traverse through the intermediate node (whose SRv6 SID is 1010::1:0:1b) to the destination node (whose End.OP SID is 1020::32 and SRv6 SID is 1020::1:0:3).
hops at most	Maximum number of hops of the probe packets.
byte packets	Number of bytes of a probe packet.
2  12::2 [SRH: 1020::1:0:3, 1020::32, 1010::1:0:1b, SL=1]  0.861 ms  0.718ms  0.679ms	Probe result of the probe packets that contain a hop limit value of 2, including the following information about the second hop: ·     IPv6 address of the hop. ·     SRH information in the ICMPv6 reply message, including the SRv6 SID list and number of remaining SRv6 SIDs (SL). ·     The round-trip time of the probe packets, in milliseconds.

 

Related commands

ipv6 unreachables enable (Layer 3—IP Services Command Reference)

opcode

ping ipv6-sid