close

keyboard_arrow_left

Table of Contents Expand all

list Table of Contents

English

traceroute mpls segment-routing spring-te

date_range 19-Nov-23

arrow_backward

arrow_forward

Syntax

content_copy zoom_out_map
traceroute mpls segment-routing spring-te
<egress-ip ( active | color |  detail | exp | logical-system | no-resolve | retries |  routing-instance | secondary | segment-list | skip-fec-validation  | source | ttl | tunnel-source) >
<label-stack ( detail | egress | labels | logical-system | nexthop-address | nexthop-interface | no-resolve) >
<source-routing-path ( lsp-name | active | color | detail | egress-ip | exp | logical-system | no-resolve | retries | routing-instance | secondary | segment-list | skip-fec-validation | source | tunnel-source) >

Description

Trace route to a remote host for a segment routing label-switched path added by segment routing traffic-engineered (SPRING-TE) tunnel. Use traceroute mpls segment-routing spring-te as a debugging tool to locate MPLS label-switched path forwarding issues in a network.

Options

egress-ip

Specify to trace to or install IP address to use when sending probes.

active	Specify to use the forwarding path or nexthops from the RIB table.
color	Specify the color identifier for the tunnel end-point. Range: 1 through 4294967295
detail	(Optional) Display detailed output.
exp `exp`	(Optional) Specify the class of service to use when sending probes. Range: 0 through 7
logical-system `logical-system-name`	(Optional) Specify the name of the logical system for the traceroute attempt.
no-resolve	Specify not to attempt to print addresses symbolically.
retries `retries-number`	(Optional) Specify the number of times to resend probe values. Range: 1 through 9
routing-instance `routing-instance-name`	(Optional) Specify the name of the routing instance for the trace route attempt.
secondary	Specify to use configured secondary segment list for the given segment routing path.
segment-list	Specify the segment list to use when sending probes.
skip-fec-validation	Specify to skip forwarding equivalence class (FEC) validation or use NIL FEC.
source `source-address`	(Optional) Specify the source address of the outgoing traceroute packets.
ttl `value`	(Optional) Specify the maximum time-to-live value to include in the traceroute request, in seconds. Range: 1 through 255
tunnel-source	Specify the source protocol used to create tunnel.

label-stack

Specify the label stack for traceroute packets. This option works only if you do a minimum configuration of source-packet-routing at the [edit protocols] hierarchy level.

detail	(Optional) Display detailed output.
egress	Specify the egress IP address.
labels	Specify the labels in label stack. Range: 16 through 1048575
logical-system `logical-system-name`	(Optional) Specify the name of the logical system for the traceroute attempt.
nexthop-address `address`	Specify the nexthop IP address for the traceroute packet.
`nexthop-interface interface`	Specify the outgoing interface for the traceroute packet.
no-resolve	Specify not to attempt to print addresses symbolically.

source-routing-path

Specify the trace source path routing to use when sending probes.

lsp-name	Specify the source path routing name.
active	Specify to use the forwarding path or nexthops from the RIB table.
color	Specify the color identifier for the tunnel end-point. Range: 1 through 4294967295
detail	(Optional) Display detailed output.
egress-ip	Specify to trace to or install IP address to use when sending probes.
exp `exp`	(Optional) Specify the class of service to use when sending probes. Range: 0 through 7
logical-system `logical-system-name`	(Optional) Specify the name of the logical system for the traceroute attempt.
no-resolve	Specify not to attempt to print addresses symbolically.
retries `retries-number`	(Optional) Specify the number of times to resend probe values. Range: 1 through 9
secondary	Specify to use configured secondary segment list for the given segment routing path.
segment-list	Specify the segment list to use when sending probes.
skip-fec-validation	Specify to skip forwarding equivalence class (FEC) validation or use NIL FEC.
source `source-address`	(Optional) Specify the source address of the outgoing traceroute packets.
ttl `value`	(Optional) Specify the maximum time-to-live value to include in the traceroute request, in seconds. Range: 1 through 255

Additional Information

Note:

With segment-list option, valid tunnel-source (source protocol used to create tunnel) is only static.

Note:

segment-list option is not present when tunnel-source is BGP-SR-TE since BGP-SR-TE does not have named segment list.

Note:

With source-routing-path name, valid tunnel-source are PCEP and static.

Note:

With tunnel-source as PCEP, secondary option is not valid as PCEP always sends one primary LSP.

Note:

FEC validation is performed for traceroute mpls segment-routing spring-te by default.

Note:

FEC validation is supported when segment-routing traffic-engineering (SR-TE) tunnel has IGP labels (OSPF and IS-IS) only. For all the other labels (for example, static, ldp, rsvp, etc.), you can use skip-fec-validation option.

Note:

For a combination of egress-ip and color options, valid tunnel-source are static and BGP-SR-TE.

Note:

traceroute mpls segment-routing spring-te command with label-stack option is supported in operational mode only. It is not supported in configuration mode.

Note:

Parallel SID, binding SID, LDP over SR-TE is not supported.

Note:

In case of traceroute mpls segment-routing spring-te, the PFE supports only 16 ECMP paths. If there more than 16 ECMP paths to the SR-TE LSP, traceroute is done up to a maximum of 16 hops.

Required Privilege Level

network

Output Fields

Table 1 describes the output fields for thetraceroute mpls segment-routing spring-te command. Output fields are listed in the approximate order in which they appear.

Table 1: traceroute mpls spring-te Output Fields
Field Name	Field Description	Level of Output
Probe options	Probe options specified in the `traceroute mpls segment-routing spring-te` command.	all levels
ttl	Time to live value of the labeled packet.	none specified
Label	Outgoing label used for forwarding the packet along the label-switched paths.	none specified
Protocol	Signaling protocol used. For this command, it is LDP.	none specified
Address	Address of the next hop.	none specified
Previous Hop	Address of the previous hop. Previous hop address of the first hop is null.	none specified
Probe status	Forwarding status from the first hop to the last-hop label-switching router (egress point in the label-switched paths).	none specified
Hop	Address of the hops in the label-switched path from the first hop to the last hop. Depth indicates the level of the hop.	detail
Parent	Address of the previous hop. Parent value for the first hop is null.	detail
Return Code	Return code for reporting the result of processing the echo request by the receiver.	detail
Response time	Time for the echo request to reach the receiver.	detail
Multipath type	Labels or addresses used by the specified multipath type. If multipaths are not used, the value is none.	detail
Label Stack	Label stack used to forward the packet.	detail

Sample Output

traceroute mpls segment-routing spring-te
traceroute mpls segment-routing spring-te (source-routing-path) (No FEC validation)
traceroute mpls segment-routing spring-te (source-routing-path) (FEC validation)
traceroute mpls segment-routing spring-te (egress-ip) (No FEC Validation)
traceroute mpls segment-routing spring-te (egress-ip) (FEC Validation)
traceroute mpls segment-routing spring-te (label-stack)