tracert srv6-te policy

Function

The tracert srv6-te policy command tests the nodes through which an SRv6 TE Policy passes.

Format

tracert srv6-te policy { policy-name policyName | endpoint-ip endpointIpv6 color colorId | binding-sid bsid } [ force-match-slice ] [ end-op endOp | destination dest ] [ -a sourceAddr6 | -f initHl | -m maxHl | -s packetSize | -w timeout | -p destPort | -tc tc ] *

Parameters

Parameter Description Value
policy-name policyName

Specifies the name of an SRv6 TE Policy.

The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces.

endpoint-ip endpointIpv6

Specifies the destination address of an SRv6 TE Policy.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

color colorId

Specifies a color value for an SRv6 TE Policy. This parameter applies to the scenario where traffic is diverted to an SRv6 TE Policy based on the color value.

The value is an integer that ranges from 0 to 4294967295.

binding-sid bsid

Specifies a binding SID for an SRv6 TE Policy. End.B6 type defined in a binding SID, which is used in scenarios such as SRv6 TE Policy import, tunnel interworking, and SD-WAN route selection.

The value is a 32-digit hexadecimal number, in the format X:X:X:X:X:X:X:X.

force-match-slice

Forcibly matches slices and takes effect only for segment lists with slice attributes.

-

end-op endOp

Specifies the type of an End.OP segment ID. If no remote end-op is configured, you can manually specify an End.OP SID. If the last SID in an SRv6 TE Policy Segment List is an End.X SID or Binding SID, the configured remote end-op does not take effect, when initiating a ping srv6-te policy, you also need to manually specify the End.OP SID or destination.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

destination dest

Local IPv6 address or SRv6 local SID of the destination.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

-a sourceAddr6

Specifies a source IPv6 address.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

-f initHl

Specifies an initial hop limit.

The value is an integer ranging from 1 to 255. The default value is 1.

-m maxHl

Specifies a maximum hop limit.

The value is an integer ranging from 1 to 255. The default value is 30.

-s packetSize

Specifies the payload length of an ICMP echo request message.

The value is an integer ranging from 65 to 9600. The default value is 100.

-w timeout

Specifies a timeout time for waiting for the response to an ICMP echo request message.

The value is an integer that ranges from 1 to 65535. The default value is 2000 ms.

-p destPort

Specifies a destination UDP port number.

The value is an integer ranging from 1 to 65535.

-tc tc

Specifies a traffic class for ICMP echo request messages to be sent.

The value is an integer ranging from 0 to 255. The default value is 0.

Views

All views

Default Level

0: Visit level

Task Name and Operations

Task Name Operations
sla execute

Usage Guidelines

Usage Scenario

On an SRv6 TE Policy network, if data forwarding fails over the SRv6 TE Policy, the control plane for SRv6 establishment cannot detect this failure, making network maintenance difficult. The SRv6 TE Policy tracert mechanism can be used to detect such faults and locate faulty nodes. This mechanism is implemented using the tracert srv6-te policy command. To test the nodes through which an SRv6 TE Policy passes, run the tracert srv6-te policy command. The command output can be used for fault diagnosis.

Prerequisites

SRv6 has been enabled on the device and is working properly.

Precautions

If the segment list changes during the SRv6 TE Policy tracert test, the tracert results may be inaccurate. It is recommended that you press Ctrl+C to stop and then re-initiate a tracert operation.

If neither IPv6 router ID nor the encapsulation source-address command is configured, you are advised to use the -a parameter to specify the source address. Otherwise, the test may fail.

In a non-TE FRR scenario, the ingress of an SRv6 TE Policy cannot have more than one local END SID. Otherwise, the tracert operation may fail.

During BSID encapsulation, the newly encapsulated IPv6 header does not inherit the inner TTL value. As a result, the transit paths may not be displayed in the tracert command output.

Example

# Initiate a tracert test on an SRv6 TE Policy named abc.
<HUAWEI> tracert srv6-te policy policy-name abc end-op 2001:db8:2::1 -a 2001:db8:1::1 -p 5 -m 20 -tc 0
  Trace Route srv6-te policy : 100  data bytes, press CTRL_C to break
  srv6-te policy's segment list:
  Preference: 200; Path Type: primary; Protocol-Origin: local; Originator: 0, 0.0.0.0; Discriminator: 200; Segment-List ID: 1; Xcindex: 1; end-op: 2001:DB8:2::1
  TTL    Replier                                 Time    Type      SRH

  0                                                      Ingress   <SRH: 2001:DB8:1::F:1, 2001:DB8:2::F:1, 2001:DB8:2::1, SL=2> 
  1      2001:DB8:A::192:168:103:2               22 ms   Transit   <SRH: 2001:DB8:1::F:1, 2001:DB8:2::F:1, 2001:DB8:2::1, SL=2> 
  2      2001:DB8:A::192:168:106:2               10 ms   Transit   <SRH: 2001:DB8:1::F:1, 2001:DB8:2::F:1, 2001:DB8:2::1, SL=1> 
  3      2001:DB8:2::1                           4 ms    Egress
# Initiate a tracert test for the SRv6 TE Policy named policy1 to forcibly match the network slice.
<HUAWEI> tracert srv6-te policy policy-name policy1 force-match-slice
  Trace Route srv6-te policy : 100  data bytes, press CTRL_C to break
  srv6-te policy's segment list:
  Preference: 100; Path Type: primary; Protocol-Origin: local; Originator: 0, 0.0.0.0; Discriminator: 100; Segment-List ID: 1; Xcindex: 1
  TTL    Replier                                 Time    Type      SRH
  0                                                      Ingress   <SRH: 2001:DB8:120::1:0:0, 2001:DB8:130::1:0:0, 2001:DB8:130::100, SL=2, Slice-ID:100>
  1      2001:DB8:10::2                          61 ms   Transit   <SRH: 2001:DB8:120::1:0:0, 2001:DB8:130::1:0:0, 2001:DB8:130::100, SL=2, Slice-ID:100>
  2      2001:DB8:130::100                       4 ms    Egress    <SRH: 2001:DB8:120::1:0:0, 2001:DB8:130::1:0:0, 2001:DB8:130::100, SL=1, Slice-ID:100>
Table 1 Description of the tracert srv6-te policy command output
Item Description
end-op

End op.

Path Type

Path type.

Segment-List ID

Segment-List ID.

TTL

Time to live.

Replier

IP address of the transit node that returns the response packet.

Time

Round-trip time (RTT), in milliseconds.

Type
Node type:
  • Ingress.
  • Transit.
  • Egress.
SRH

Segment routing header information.

Discriminator

Discriminator.

Xcindex

Xc Index.

Preference

Preference.

Protocol-Origin

Protocol origin.

Slice-ID

Network slice ID.

SL

Segment left.

Originator

Originator.

Copyright © Huawei Technologies Co., Ltd.
Copyright © Huawei Technologies Co., Ltd.
< Previous topic Next topic >