11-Segment Routing Command Reference

HomeSupportRoutersCR16000-F SeriesReference GuidesCommand ReferencesH3C CR16000-F Routers Command Reference-R838x-6W10111-Segment Routing Command Reference
06-SRv6 OAM commands
Title Size Download
06-SRv6 OAM commands 136.61 KB

SRv6 OAM commands

icmpv6-error relay enable

Use icmpv6-error relay enable to enable the ICMPv6 error packet relay feature.

Use undo icmpv6-error relay enable to disable the ICMPv6 error packet relay feature.

Syntax

icmpv6-error relay enable

undo icmpv6-error relay enable

Default

The ICMPv6 error packet relay feature is disabled.

Views

SRv6 view

Predefined user roles

network-admin

Usage guidelines

In an SRv6 TE policy-based tracert operation, if one SRv6 TE policy (policy A, for example) recurses to another SRv6 TE policy (policy B, for example), the following conditions can occur:

·     Nodes in the SID list of policy B return ICMPv6 time-exceeded packets only to the source node of policy B.

·     The nodes in the SID list of policy B do not return ICMPv6 time-exceeded packets to the source node of policy A.

As a result, the source node of policy A determines that unreachable nodes exist. The detection result is incorrect.

To address this issue, you can enable the ICMPv6 error packet relay feature for the source node of policy B. Upon receiving ICMPv6 time-exceeded packets from other nodes of policy B, the source node of policy B acts as a proxy to forward the packets to the source node of policy A. This can avoid incorrect detection.

Examples

# Enable the ICMPv6 error packet relay feature.

<Sysname> system-view

[Sysname] segment-routing ipv6

[Sysname-segment-routing-ipv6] icmpv6-error relay enable

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 | coc32 sid common-prefix-length }&<1-10> [ network-slice slice-id [ force-match-slice ] ]

Views

Any view

Predefined user roles

network-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 address specified in the encapsulation source-address command applies. If the encapsulation source-address command is not configured, the IPv6 address of the outbound interface for the ICMP echo requests applies.

-c count: Specifies the number of ICMPv6 echo requests to be 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 ICMPv6 echo requests. 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 ICMPv6 packets. 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 | coc32 sid common-prefix-length }&<1-10>: Specifies a space-separated list of up to 10 SRv6 SIDs, including normal SRv6 SIDs and G-SIDs. The sid argument specifies a normal SRv6 SID. The coc32 sid common-prefix-length option specifies a G-SID and the common prefix length of the next G-SID. This parameter applies only to end-to-end ping.

network-slice slice-id: Specifies an NSI ID in the range of 0 to 4294967295. If you specify this option, the device encapsulates an IPv6 hop-by-hop extension header for ICMPv6 echo request packets. In addition, the device adds the NSI ID to the IPv6 hop-by-hop extension header. If you do not specify this option, the device does not encapsulate an IPv6 hop-by-hop extension header carrying the NSI ID for ICMPv6 echo request packets.

force-match-slice: Forcibly matches the specified NSI ID. If you specify this keyword, the device sends an ICMPv6 echo request packet only when the NSI ID specified in this command matches that of the network slice channel of the packet's output interface. If the settings do not match, the device discards the ICMPv6 echo request packet, resulting in ping failure. If you do not specify this keyword, the device sends the ICMPv6 echo request packet without checking the NSI ID in the packet.

Usage guidelines

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, and the SRv6 SID of the destination node is 1020::1:0:3).

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

Ping SRv6(56 data bytes) 1::1 --> 1010::1:0:1b 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

 

--- Ping6 SRv6 statistics ---

5 packet(s) transmitted, 5 packet(s) 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) 1::1 --> 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

 

--- Ping6 SRv6 statistics ---

5 packet(s) transmitted, 10 packet(s) 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::1:0:3

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

 

--- Ping6 SRv6 statistics ---

5 packet(s) transmitted, 5 packet(s) 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::1:0:3

Ping SRv6(56 data bytes) 1::1 --> 1010::1:0:1b 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

 

--- Ping6 SRv6 statistics ---

5 packet(s) transmitted, 5 packet(s) 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 1::1 --> 1010::1:0:1b 1020::1:0:3, 56 data bytes, press CTRL_C to break

ICMPv6 echo requests with a data length of 56 bytes are sent through an intermediate SRv6 node with SID 1010::1:0:1b to the destination node with 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.

--- Ping6 SRv6 statistics ---

Statistics on data received and sent in a ping operation.

5 packet(s) transmitted

Number of ICMPv6 echo requests sent.

5 packet(s) 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

encapsulation source-address

Opcode

ping srv6-te policy

Use ping srv6-te policy to detect path connectivity and forwarding capability of an SRv6 TE policy.

Syntax

ping srv6-te policy { policy-name policy-name | color color-value end-point ipv6 ipv6-address | binding-sid bsid } [ force-match-slice ] [ end-op end-op | endpoint | destination srv6-sid ] [ -a source-ipv6 | -c count | -h hop-limit | -m interval | -s packet-size | -t timeout | -tc traffic-class ] *

Views

Any view

Predefined user roles

network-admin

Parameters

policy-name policy-name: Specifies an SRv6 TE policy by its name, a case-sensitive string of 1 to 59 characters.

color color-value end-point ipv6 ipv6-address: Specifies an SRv6 TE policy by its color attribute value and endpoint IPv6 address. The color-value argument is in the range of 0 to 4294967295. The ipv6-address argument specifies the endpoint IPv6 address.

binding-sid bsid: Specifies an SRv6 TE policy by its BSID value. The BSID value is the SID value of the ingress node.

force-match-slice: Forcibly matches the specified NSI ID. If you specify this keyword, the device sends an ICMPv6 echo request packet only when the NSI ID specified for the candidate path of the SRv6 TE policy matches that of the network slice channel of the packet's output interface. If the settings do not match, the device discards the ICMPv6 echo request packet, resulting in ping failure. If you do not specify this keyword, the device sends the ICMPv6 echo request packet without checking the NSI ID in the packet.

end-op end-op: Adds an End.OP SID to the SID list of ICMPv6 echo requests for identifying the destination node. If you do not specify this option, no End.OP SID is added to ICMPv6 echo requests. If the last node in the SID list carries the COC flag, the End.OP SID will be compressed.

endpoint: Adds the endpoint IP address of the SRv6 TE policy to the SID list of ICMPv6 echo requests (and adds the SL value in the SRH by 1). If you do not specify this keyword, the endpoint IP address of the SRv6 TE policy is not added to the ICMPv6 echo requests.

destination srv6-sid: Specifies the destination node of the SRv6 TE policy by its SRv6 SID.

-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 address specified in the encapsulation source-address command applies. If the encapsulation source-address command is not configured, the IPv6 address of the outbound interface for the ICMP echo requests applies.

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

-h hop-limit: Specifies the value for the Hop Limit field in ICMPv6 echo requests. The value range is 0 to 255, and the default is 255.

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

-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 ICMPv6 packets. The value range is 0 to 255 and the default is 0.

Examples

# Detect path connectivity and forwarding capability of SRv6 TE policy p1.

<Sysname> ping srv6-te policy policy-name p1

Ping SRv6-TE policy (56 data bytes), press CTRL_C to break

  Segment list ID: 0

    Preference=10, Path Type=primary, Protocol-Origin=local, Originator=0,0.0.0.0, Discriminator=10

56 bytes from 8000::1, icmp_seq=0 ttl=64 time=2.000 ms

56 bytes from 8000::1, icmp_seq=1 ttl=64 time=1.000 ms

56 bytes from 8000::1, icmp_seq=2 ttl=64 time=1.000 ms

56 bytes from 8000::1, icmp_seq=3 ttl=64 time=1.000 ms

56 bytes from 8000::1, icmp_seq=4 ttl=64 time=1.000 ms

 

--- Ping6 SRv6-TE Policy statistics ---

5 packet(s) transmitted, 5 packet(s) received, 0.0% packet loss

round-trip min/avg/max/std-dev = 1.000/1.200/2.000/0.400 ms

# Detect path connectivity and forwarding capability of SRv6 TE policy p1, and specify the End.OP SID 8000::A.

<Sysname> ping srv6-te policy policy-name p1 end-op 8000::A

Ping SRv6-TE policy (56 data bytes) 8000::A, press CTRL_C to break

  Segment list ID: 1

    Preference=10, Path Type=Main, Protocol origin=Local, Originator=0,0.0.0.0, Discriminator=10, End.OP=8000::A

56 bytes from 8000::A, icmp_seq=0 ttl=62 time=2.000 ms

56 bytes from 8000::A, icmp_seq=1 ttl=62 time=1.000 ms

56 bytes from 8000::A, icmp_seq=2 ttl=62 time=2.000 ms

56 bytes from 8000::A, icmp_seq=3 ttl=62 time=2.000 ms

56 bytes from 8000::A, icmp_seq=4 ttl=62 time=1.000 ms

 

--- Ping6 SRv6-TE Policy statistics ---

5 packet(s) transmitted, 5 packet(s) received, 0.0% packet loss

round-trip min/avg/max/std-dev = 1.000/1.600/2.000/0.490 ms

Table 2 Command output

Field

Description

Ping SRv6-TE policy (56 data bytes), press CTRL_C to break

ICMPv6 echo requests with a data length of 56 bytes are sent to the SRv6 TE policy.

Press Ctrl+C to abort the ping operation.

Segment list ID

Segment list ID.

Preference

Preference of the candidate path.

Path Type

Path type:

·     Main—Main path.

·     Backup—Candidate path.

·     None—The path is not selected.

Protocol-Origin

Protocol origin:

·     PCEP—The SRv6 TE policy is obtained through PCEP (not supported in the current software version).

·     BGP—The SRv6 TE policy is obtained through BGP.

·     Local—Local configuration.

·     Unknown—Unknown origin.

Originator=ASN Node-address

Information about the SRv6 TE policy obtained through BGP:

·     ASN—AS number. A value of 0 means the SRv6 TE policy is not obtained through BGP.

·     Node-address—BGP node address. The value is 0.0.0.0 for a manually configured SRv6 TE policy, and is the router ID of the BGP peer if the SRv6 TE policy information is obtained from the BGP peer.

End.OP

End.OP SID

Endpoint

Endpoint IP address of the SRv6 TE policy.

56 bytes from 8000::1, icmp_seq=0 ttl=64 time=2.000 ms

Received ICMPv6 echo replies from the SRv6 node whose SID is 8000::1.

·     The number of data bytes is 56.

·     The SRv6 SID of the destination node is 8000::1.

·     The packet sequence is 0.

·     The hop limit value is 64.

·     The response time is 2.000 milliseconds.

Ping6 SRv6-TE Policy 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 = 1.000/1.200/2.000/0.400 ms

Minimum/average/maximum/standard deviation response time, in milliseconds.

remote end-op

Use remote end-op to specify a remote End.OP SID locator.

Use undo remote end-op to delete a remote End.OP SID locator.

Syntax

remote end-op ipv6-address prefix-length

undo remote end-op ipv6-address prefix-length

Default

No remote End.OP SID locators are specified.

Views

SRv6 view

Predefined user roles

network-admin

Parameters

ipv6-address: Specifies an IPv6 address.

prefix-length: Specifies the prefix length in the range of 1 to 128.

Usage guidelines

An End.OP SID is an SRv6 SID of OAM type used in SRv6 SID/SRv6 TE policy-based ping/tracert operations. When a device receives a request packet destined for the local End.OP SID, it further checks the SRv6 SID in the packet. If the SRv6 SID is the local SRv6 SID, the device sends a reply; if not, the device discards the packet.

To execute the ping srv6-te policy or tracert srv6-te policy command, you cannot ensure the SID connectivity in all SID lists when the following conditions exist:

·     The last SIDs in the SID lists belong to different locators.

·     An End.OP SID is specified with the end-op end-op option in the command.

To resolve this issue, you can configure the remote end-op command on the source node. The command enables you to specify a remote End.OP SID locator associated with the last SID of each SID list. In a ping or tracert operation, the source node will automatically select an End.OP SID by the longest match principle from the locator associated with the specified SID.

Examples

# Specify remote End.OP SID locator 100::1/128.

<Sysname> system-view

[Sysname] segment-routing ipv6

[Sysname-segment-routing-ipv6] remote end-op 100::1 128

Related commands

ping srv6-te policy

tracert srv6-te policy

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 | -i interface-type interface-number | -m max-hops | -p port | -q packet-number | -s packet-size | -t traffic-class | -w timeout ] * [ overlay ] { sid | coc32 sid common-prefix-length }&<1-10> [ network-slice slice-id [ force-match-slice ] ]

Views

Any view

Predefined user roles

network-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 address specified in the encapsulation source-address command applies. If the encapsulation source-address command is not configured, the IPv6 address of the outbound interface for the probe packets applies.

-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.

-i interface-type interface-number: Specifies the outbound interface by its type and number. You must specify this option if the next hop address is a multicast address or link-local address. If you do not specify this option, the device determines the outbound interface for probe packets by looking up the forwarding table according to their destination IPv6 addresses.

-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.

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

-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 | coc32 sid common-prefix-length }&<1-10>: Specifies a space-separated list of up to 10 SRv6 SIDs, including normal SRv6 SIDs and G-SIDs. The sid argument specifies a normal SRv6 SID. The coc32 sid common-prefix-length option specifies a G-SID and the common prefix length of the next G-SID. This parameter applies only to hop-by-hop tracert.

network-slice slice-id: Specifies an NSI ID in the range of 0 to 4294967295. If you specify this option, the device encapsulates an IPv6 hop-by-hop extension header for IPv6 tracert packets. In addition, the device adds the NSI ID to the IPv6 hop-by-hop extension header. If you do not specify this option, the device does not encapsulate an IPv6 hop-by-hop extension header carrying the NSI ID for IPv6 tracert packets.

force-match-slice: Forcibly matches the specified NSI ID. If you specify this keyword, the device sends an IPv6 tracert packet only when the NSI ID specified in this command matches that of the network slice channel of the packet's output interface. If the settings do not match, the device discards the IPv6 tracert packet, resulting in tracert failure. If you do not specify this keyword, the device sends the IPv6 tracert packet without checking the NSI ID in the packet.

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 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, and the SRv6 SID of the destination node is 1020::1:0:3).

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

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

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

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

Table 3 Command output

Field

Description

Traceroute SRv6 1010::1:0:1b 1020::1:0:3 from 1::1

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 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 (including the IPv6 basic packet header, transport layer packet header, and total payload and excluding the IPv6 extended header, for example, SRH and HBH).

2  12::2 [SRH: 1020::1:0:3, 1010::1:0:1b, SL=0]  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

tracert srv6-te policy

Use tracert srv6-te policy to display the path to the destination node of an SRv6 TE policy.

Syntax

tracert srv6-te policy { policy-name policy-name | color color-value end-point ipv6 ipv6-address | binding-sid bsid } [ for-match-slice ] [ end-op end-op | endpoint | destination srv6-sid ] [ -a source-ipv6 | -f first-hop | -m max-hops | -p port | -q packet-number | -s packet-size | -tc traffic-class | -w timeout ] *

Views

Any view

Predefined user roles

network-admin

Parameters

policy-name policy-name: Specifies an SRv6 TE policy by its name, a case-sensitive string of 1 to 59 characters.

color color-value end-point ipv6 ipv6-address: Specifies an SRv6 TE policy by its color attribute value and endpoint IPv6 address. The color-value argument is in the range of 0 to 4294967295. The ipv6-address argument specifies the endpoint IPv6 address.

binding-sid bsid: Specifies an SRv6 TE policy by its BSID value. The BSID value is the SID value of the ingress node.

force-match-slice: Forcibly matches the specified NSI ID. If you specify this keyword, the device sends an IPv6 tracert packet only when the NSI ID specified for the candidate path of the SRv6 TE policy matches that of the network slice channel of the packet's output interface. If the settings do not match, the device discards the IPv6 tracert packet, resulting in tracert failure. If you do not specify this keyword, the device sends the IPv6 tracert packet without checking the NSI ID in the packet.

end-op end-op: Adds an End.OP SID to the SID list of ICMPv6 probe packets for identifying the destination node. If you do not specify this option, no End.OP SID is added to probe packets. If the last node in the SID list carries the COC flag, the End.OP SID will be compressed.

endpoint: Adds the endpoint IP address of the SRv6 TE policy to the SID list of probe packets (and adds the SL value in the SRH by 1). If you do not specify this keyword, the endpoint IP address of the SRv6 TE policy is not added to the probe packets.

destination srv6-sid: Specifies the destination node of the SRv6 TE policy by its SRv6 SID.

-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 address specified in the encapsulation source-address command applies. If the encapsulation source-address command is not configured, the IPv6 address of the outbound interface for the probe packets applies.

-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.

-s packet-size: Specifies the length (in bytes) of probe packets (excluding the IPv6 packet header and the transport layer packet header), in the range of 20 to 9600, and the default is 56.

-tc 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.

Usage guidelines

After identifying network failure with the ping srv6-te policy command, you can use the tracert srv6-te policy command to locate failed nodes.

The output from the tracert srv6-te policy 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 abort the tracert operation during the execution of the command, press Ctrl+C.

Examples

# Perform tracert to display information about the tunnel for SRv6 TE policy p1.

<Sysname> tracert srv6-te policy policy-name p1

Traceroute SRv6-TE policy from 1::1, 30 hops at most, 60 byte packets, press CTRL_C to break

  Segment list ID: 1

    Preference=10, Path Type=primary, Protocol origin=local, Originator=0, 0.0.0.0, Discriminator=10, End.OP=none

 1  1000::2 [SRH: 8000::1, 7000::1, 6000::1, SL=2]  1.000 ms  1.000 ms  1.000 ms

 2  2000::3 [SRH: 8000::1, 7000::1, 6000::1, SL=1]  1.000 ms  1.000 ms  1.000 ms

 3  4000::4 [SRH: 8000::1, 7000::1, 6000::1, SL=0]  0.000 ms  0.000 ms  1.000 ms

Table 4 Command output

Field

Description

Traceroute SRv6-TE policy from 1::1

Display information about the tunnel for the SRv6 TE policy.

hops at most

Maximum number of hops of the probe packets.

byte packets

Number of bytes of a probe packet (including the IPv6 basic packet header, transport layer packet header, and total payload and excluding the IPv6 extended header, for example, SRH and HBH).

press CTRL_C to break

Press Ctrl+C to abort the tracert operation.

Segment list ID

Segment list ID.

Preference

Preference of the candidate path.

Path Type

Path type:

·     Main—Main path.

·     Backup—Candidate path.

·     None—The path is not selected.

Protocol-Origin

Protocol origin:

·     PCEP—The SRv6 TE policy is obtained through PCEP (not supported in the current software version).

·     BGP—The SRv6 TE policy is obtained through BGP.

·     Local—Local configuration.

·     Unknown—Unknown origin.

Originator=ASN Node-address

Information about the SRv6 TE policy obtained through BGP:

·     ASN—AS number. A value of 0 means the SRv6 TE policy is not obtained through BGP.

·     Node-address—BGP node address. The value is 0.0.0.0 for a manually configured SRv6 TE policy, and is the router ID of the BGP peer if the SRv6 TE policy information is obtained from the BGP peer.

Discriminator

Remote discriminator.

End.OP

End.OP SID

Endpoint

Endpoint IP address of the SRv6 TE policy.

1000::2 [SRH: 8000::1, 7000::1, 6000::1, SL=2]  1.000 ms  1.000 ms  1.000 ms

Probe result of the probe packets that contain a hop limit value of 1, 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)

ping srv6-te policy

 

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
All Support
  • Become A Partner
  • Partner Policy & Program
  • Global Learning
  • Partner Sales Resources
  • Partner Business Management
  • Service Business
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网