traceroute mpls bgp

Syntax

Description

Trace route to a remote host for an MPLS label-switched path (LSP) signaled by the Border Gateway Protocol (BGP). Use traceroute mpls bgp as a debugging tool to locate MPLS BGP forwarding issues in a network. (Currently supported for IPv4 packets only.)

To use the traceroute mpls bgp command, make sure you have BGP routes with MPLS labels.

Note:

The traceroute mpls bgp fec command only supports single paths.

Options

`fec`	Specify the IP address and optional prefix of the forwarding equivalence class (FEC). Suppose you are at PE1, use would want to use the IP address of PE2 to trace the BGP path to that router.
`destination destination-address`	(Optional) Specify the destination address to use when sending probes.
`detail`	(Optional) Display detailed output.
`exp exp`	(Optional) Specify the class of service to use when sending probes. Range: 0 through 7 Default: 7
`fanout fanout-number`	(Optional) Specify the maximum number of next hops to search per node. Range: 1 through 16 Default: 16
`logical-system logical-system-name`	(Optional) Specify the name of the logical system for the traceroute attempt.
`no-resolve`	(Optional) Specify not to resolve the hostname that corresponds to the IP address.
`paths paths-number`	(Optional) Specify the number of paths to search. Range: 1 through 255 Default: 16
`pipe-mode`	(Optional) Specify to trace only the outermost FEC.
`retries retries-number`	(Optional) Specify the number of times to resend probe values. Range: 1 through 9 Default: 3
`routing-instance routing-instance-name`	(Optional) Specify the name of the routing instance for the trace route attempt.
`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 125 Default: 64
`wait` `seconds`	(Optional) Specify the number of seconds to wait before resending a probe. Range: 5 though 15 Default: 10

Required Privilege Level

network

Output Fields

Table 1 describes the output fields for the traceroute mpls bgp fec command and the traceroute mpls bgp fec detail command. Output fields are listed in the approximate order in which they appear.

Table 1: traceroute mpls bgp Output Fields
Field Name	Field Description	Level of Output
Probe options	Probe options specified in the `traceroute mpls bgp fec` command.	All levels
ttl	Time to live value of the labeled packet.	None
Label	Outgoing label used for forwarding the packet along the label-switched paths.	None
Protocol	Signaling protocol used. For this command, it is BGP.	None
Address	Address of the next hop.	None
Previous Hop	Address of the previous hop. Previous hop address of the first hop is `null`.	None
Probe status	Forwarding status from the first hop to the last-hop label-switching router (egress point in the label-switched paths).	None
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`