mpls oam commands...'r' - transit router, 'x' - unknown return code,...

MPLS OAM Commands

This module describes Multiprotocol Label Switching (MPLS) label switched path (LSP) verificationcommands. These commands provide a means to detect and diagnose data plane failures and are the first setof commands in the MPLS Operations, Administration, and Maintenance (OAM) solution.

For detailed information about MPLS concepts, configuration tasks, and examples, see Cisco IOS XRMPLSConfiguration Guide for the Cisco XR 12000 Series Router.

• clear mpls oam counters, page 2

• echo disable-vendor-extension, page 4

• echo revision, page 5

• mpls oam, page 7

• ping mpls ipv4, page 8

• ping mpls traffic-eng, page 12

• ping pseudowire (AToM), page 15

• ping mpls mldp (P2MP), page 19

• ping mpls mldp (MP2MP), page 24

• show mpls oam, page 29

• show mpls oam database, page 31

• traceroute mpls ipv4, page 33

• traceroute mpls multipath, page 36

• traceroute mpls traffic-eng, page 40

• traceroute mpls mldp (P2MP), page 43

• traceroute mpls mldp (MP2MP), page 48

Cisco IOS XR MPLS Command Reference for the Cisco XR 12000 Series Router, Release 4.1 OL-24701-01 1

clear mpls oam countersTo clear MPLS OAM counters, use the clear mpls oam counters command in EXEC mode.

clear mpls oam counters {global| interface [type interface-path-id]| packet}

Syntax Description Clears global counters.global

Clears counters on a specified interface.interface

Interface type. For more information, use the question mark (?) online helpfunction.

type

Physical interface or virtual interface.interface-path-id

Use the show interfaces command to see a list of all interfaces currentlyconfigured on the router.

Note

For more information about the syntax for the router, use the question mark (?)online help function.

Clears global packet counters.packet

Command Default No default behavior or values

Command Modes EXEC

Command History ModificationRelease

This command was introduced.Release 3.3.0

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper taskIDs. If you suspect user group assignment is preventing you from using a command, contact your AAAadministrator for assistance.

Task ID OperationsTask ID

executempls-te

executempls-ldp

executempls-static

Cisco IOS XR MPLS Command Reference for the Cisco XR 12000 Series Router, Release 4.12 OL-24701-01

MPLS OAM Commandsclear mpls oam counters

Examples The following example shows how to clear all global MPLS OAM counters:

RP/0/0/CPU0:router# clear mpls oam counters global


MPLS OAM Commandsclear mpls oam counters

echo disable-vendor-extensionTo disable sending the vendor extension type length and value (TLV) in the echo request, use the echodisable-vendor extension command in MPLS OAM configuration mode. To return to the default behavior,use the no form of this command.

echo disable-vendor-extension

no echo disable-vendor-extension

Syntax Description This command has no arguments or keywords.

Command Default The default value is 4.

Command Modes MPLS OAM configuration mode





read, writempls-te

read, writempls-ldp

read, writempls-static

Examples The following example shows how to disable inclusion of the vendor extensions TLV in the echo requests:

RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# mpls oamRP/0/0/CPU0:router(config-oam)# echo disable-vendor-extension


MPLS OAM Commandsecho disable-vendor-extension

echo revisionTo set the echo packet revision, use the echo revision command in MPLS OAM configuration mode. Toreturn to the default behavior, use the no form of this command.

echo revision {1 | 2 | 3 | 4 }

no echo revision

Syntax Description Draft revision number:1 | 2 | 3 | 4

• 1: draft-ietf-mpls-lsp-ping-03 (initial)

• 2: draft-ietf-mpls-lsp-ping-03 (rev 1)

• 3: draft-ietf-mpls-lsp-ping-03 (rev 2)

• 4: draft-ietf-mpls-lsp-ping-09 (initial)

Command Default The default echo revision is 4 (in draft 9).

Command Modes MPLS OAM configuration mode





read, writempls-te

read, writempls-ldp


Examples The following example shows how to set the echo packet default revision:

RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# mpls oam


MPLS OAM Commandsecho revision

RP/0/0/CPU0:router(config-oam)# echo revision 1


MPLS OAM Commandsecho revision

mpls oamTo enableMPLSOAMLSP verification, use thempls oam command in global configuration mode. To returnto the default behavior, use the no form of this command.

mpls oam

no mpls oam

Syntax Description This command has no arguments or keywords.

Command Default By default, MPLS OAM functionality is disabled.

Command Modes Global configuration




Thempls oam command and OAM functionality is described in the IETF LSP ping draft.


read, writempls-te

read, writempls-ldp


Examples The following example shows how to enable MPLS OAM:

RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# mpls oamRP/0/0/CPU0:router(config-oam)#


MPLS OAM Commandsmpls oam

ping mpls ipv4To check MPLS host reachability and network connectivity by specifying the destination type as a LabelDistribution Protocol (LDP) IPv4 address, use the ping mpls ipv4 command in EXEC mode.

ping mpls ipv4 address/mask [destination start-address end-address increment] [dsmap] [exp exp-bits][force-explicit-null] [interval min-send-delay] [output interface output interface] [nexthopnexthop-ipv-address][pad pattern][repeat count] [reply {dscp dscp-value | reply mode{ipv4 | no-reply |router-alert}| reply pad-tlv}] [revision version] [size packet-size] [source source-address] [sweep minvalue max value increment] [timeout timeout] [ttl value] [verbose]

Syntax Description Address prefix of the target and number of bitsin the target address network mask.

address/mask

(Optional) Specifies a network 127/8 address tobe used as the destination address in the echorequest packet.

destination start address end address address increment

Start of the network address.start address

Start of the ending networkaddress.

end address

Incremental value of thenetwork address, which is

addressincrement

expressed as a decimal numbervalue or IP address.

(Optional) Indicates that a downstream mapping(DSMAP) type length and value should beincluded in the LSP echo request.

dsmap

(Optional) Specifies theMPLS experimental fieldvalue in theMPLS header for echo replies. Rangeis 0 to 7. Default is 0.

exp exp-bits

(Optional) Forces an unsolicited explicit null labelto be added to the MPLS label stack and allows

force-explicit-null

LSP ping to be used to detect LSP breakages atthe penultimate hop.

(Optional) Specifies a send interval, inmilliseconds, between requests. Range is 0 to3600000. Default is 0.

interval min-send-delay

(Optional) Specifies the the output interfacewhere echo request packets are sent.

output interface output interface


MPLS OAM Commandsping mpls ipv4

(Optional) Specifies the nextop as an IP address.nexthop nexthop-ip-address

(Optional) Specifies the pad pattern for an echorequest.

pad pattern

(Optional) Specifies the number of times toresend a packet. Range is 1 to 2147483647.Default is 5.

repeat count

Specifies the differentiated service codepointvalue for an MPLS echo reply.

reply dscp dscp-value

Specifies the reply mode for the echo requestpacket.

reply mode [ ipv4 | router-alert | no-reply]

Do not replyno-reply

Reply with an IPv4 UDP packet(this is the default)

ipv4

Reply with an IPv4 UDP packetwith the IP router alert set

router-alert

Indicates that a pad TLV should be included.reply pad-tlv

(Optional) Specifies the Cisco extension TLVversioning field:

revision version

• 1 draft-ietf-mpls-lsp-ping-03 (initial)

• 2 draft-ietf-mpls-lsp-ping-03 (rev 1)



(Optional) Specifies the packet size or numberof bytes in each MPLS echo request packet.Range is 100 to 17986. Default is 100.

size packet size

(Optional) Specifies the source address used inthe echo request packet.

source source-address

(Optional) Specifies a range of sizes for the echopackets sent.

sweep min value max value interval

Minimum or start size for an echopacket (range is 100 to 17986)

min value

Maximum or end size for an echopacket(range is 100 to 17986)

max value



Number used to increment an echopacket size(range is 1 to 8993)

interval

(Optional) Specifies the timeout interval, inseconds. Range is 0 to 3600. Default is 2.

timeout timeout

(Optional) Specifies the TTL value to be used inthe MPLS labels (range is 1 to 255).

ttl value

(Optional) Enables verbose output information,including MPLS echo reply, sender address ofthe packet, and return codes.

verbose

Command Default exp exp bits: 0

interval min-send-delay: 0

repeat count : 5

reply-mode: IPv4

timeout timeout : 2

Command Modes EXEC



Sample output was modified.Release 3.4.1


The output interface keyword specifies the output interface on which the MPLS echo request packets aresent. If the specified output interface is not part of the LSP, the packets are not transmitted.

In cases where the sweep keyword is used, values larger than the outgoing interface’sMTU are not transmitted.

The ping command sends an echo request packet to an address, and then awaits a reply. Ping output can helpyou evaluate path-to-host reliability, delays over the path, and whether the host can be reached or is functioning.

The ping mpls command is not supported on optical LSPs. If an optical LSP is encountered along theLSP's path, it is treated as a physical interface.

Note

For detailed configuration information about theMPLS ping command, see Cisco IOS XR SystemMonitoringConfiguration Guide for the Cisco XR 12000 Series Router.




read, writempls-te

read, writempls-ldp

Examples The following example shows the destination type as a label distribution protocol (LDP) prefix and specifiesa range of sizes for the echo packets sent:

RP/0/0/CPU0:router# ping mpls ipv4 140.140.140/32 verbose sweep 100 200 15 repeat 1

Sending 1, [100..200]-byte MPLS Echos to 140.140.140.140/32,timeout is 2 seconds, send interval is 0 msec:

Codes: '!' - success, 'Q' - request not sent, '.' - timeout,'L' - labeled output interface, 'B' - unlabeled output interface,'D' - DS Map mismatch, 'F' - no FEC mapping, 'f' - FEC mismatch,'M' - malformed request, 'm' - unsupported tlvs, 'N' - no rx label,'P' - no rx intf label prot, 'p' - premature termination of LSP,'R' - transit router, 'I' - unknown upstream index,'X' - unknown return code, 'x' - return code 0

Type escape sequence to abort.! size 100, reply addr 196.100.1.26, return code 3! size 115, reply addr 196.100.1.26, return code 3! size 130, reply addr 196.100.1.26, return code 3! size 145, reply addr 196.100.1.26, return code 3! size 160, reply addr 196.100.1.26, return code 3! size 175, reply addr 196.100.1.26, return code 3! size 190, reply addr 196.100.1.26, return code 3

Success rate is 100 percent (7/7), round-trip min/avg/max = 5/6/8 ms



ping mpls traffic-engTo specify the destination type as an MPLS-TE tunnel and tunnel interface, use the ping mpls traffic-engcommand in EXEC mode.

pingmpls traffic-eng tunnel tunnel-ID [dsmap] [exp exp-bits ] [force-explicit-null] [intervalmin-send-delay][pad pattern] [repeat count] [reply {dscp dscp-value | reply mode {ipv4 | no-reply | router-alert}| replypad-tlv}] [revision version] [size packet-size] [source source-address] [sweepmin-value max-value increment][timeout timeout] [ttl value] [verbose]

Syntax Description Specifies the destination type as an MPLS traffic engineering (TE) tunneland the tunnel interface number. The range for the tunnel interface numberis from 0 to 65535.

tunnel tunnel-ID

(Optional) Indicates that a downstream mapping (DSMAP) type length andvalue should be included in the LSP echo request.

dsmap

(Optional) Specifies the MPLS experimental field value in the MPLS headerfor echo replies. Range is 0 to 7. Default is 0.

exp exp-bits

(Optional) Forces an unsolicited explicit null label to be added to the MPLSlabel stack and allows LSP ping to be used to detect LSP breakages at thepenultimate hop.

force-explicit-null

(Optional) Specifies a send interval, in milliseconds, between requests. Rangeis 0 to 3600000. Default is 0.


(Optional) Specifies the pad pattern for an echo request.pad pattern

(Optional) Specifies the number of times to resend a packet. Range is 1 to2147483647. Default is 5.

repeat count

(Optional) Specifies the differentiated service codepoint value for an MPLSecho reply.


(Optional) Specifies the reply mode for the echo request packet.reply mode [ipv4 |router-alert | no-reply ]


Reply with an IPv4 UDP packet (this is the default)ipv4

Reply with an IPv4 UDP packet with the IP routeralert set

router-alert

(Optional) Indicates that a pad TLV should be included.reply pad-tlv

(Optional) Specifies the Cisco extension TLV versioning field:revision version



MPLS OAM Commandsping mpls traffic-eng




(Optional) Specifies the packet size or number of bytes in each MPLS echorequest packet. Range is 100 to 17986. Default is 100.

size packet-size

(Optional) Specifies the source address used in the echo request packet.source source-address

(Optional) Specifies a range of sizes for the echo packets sent.sweep min-value max-valueinterval

Minimum or start size for an echo packet (range is100 to 17986)

min-value

Maximum or end size for an echo packet(range is 100to 17986)

max-value

Number used to increment an echo packet size(rangeis 1 to 8993)

interval

(Optional) Specifies the timeout interval, in seconds. Range is 0 to 3600.Default is 2.

timeout timeout

(Optional) Specifies the TTL value to be used in the MPLS labels (range is1 to 255).

ttl value

(Optional) Enables verbose output information, including MPLS echo reply,sender address of the packet, and return codes.

verbose

Command Default exp exp-bits: 0


repeat count: 5

reply-mode: IPv4

timeout timeout : 2

Command Modes EXEC



Sample output was modified.Release 3.4.1




The output interface keyword specifies the output interface on which the MPLS echo request packets aresent. If the specified output interface is not part of the LSP, the packets are not transmitted.

In cases where the sweep keyword is used, values larger than the outgoing interface’sMTU are not transmitted.


The ping mpls traffic-eng command is not supported on optical LSPs. If an optical LSP is encounteredalong the LSP's path, it is treated as a physical interface.

Note


read, writempls-te

read, writempls-ldp

Examples The following example shows how to check connectivity by using the ping mpls traffic-eng command whena TE tunnel 10 is present. Return code, reply address, and packet size are displayed due to the verbose keyword.

RP/0/0/CPU0:router# ping mpls traffic-eng tunnel 10 repeat 1 verbose

Sending 1, 100-byte MPLS Echos to tunnel-te10,timeout is 2 seconds, send interval is 0 msec:

Codes: '!' - success, 'Q' - request not sent, '.' - timeout,'L' - labeled output interface, 'B' - unlabeled output interface,'D' - DS Map mismatch, 'F' - no FEC mapping, 'f' - FEC mismatch,'M' - malformed request, 'm' - unsupported tlvs, 'N' - no rx label,'P' - no rx intf label prot, 'p' - premature termination of LSP,'R' - transit router, 'X' - unknown return code, 'x' - return code 0

Type escape sequence to abort.! size 100, reply addr 196.100.1.18, return code 3

Success rate is 100 percent (1/1), round-trip min/avg/max = 15/15/15 ms

Related Commands DescriptionCommand

Displays information aboutMPLS-TE tunnels.

show mpls traffic-eng tunnels

Verifies the connectivity of theLSP path for theMPLS-TE tunnel.

ping mpls traffic-eng tunnel-te (P2P)



ping pseudowire (AToM)To verify connectivity between provider edge (PE) LSRs in an Any Transport over MPLS (AToM) setup,use the ping pseudowire command in EXEC mode.

ping [mpls] pseudowire remote-PE -address pw-id [exp exp-bits] [interval min-send-delay] [pad pattern][repeat count] [reply {dscp dscp-value | reply mode {ipv4 | no-reply | router-alert | control-channel}|reply pad-tlv}] [size packet-size] [source source-address] [sweepmin-value max-value increment] [timeouttimeout] [ttl value] [verbose]

Syntax Description (Optional) Verifies the Labeled Switch Path (LSP).mpls

IP address of the remote PE LSR.remote-PE address

Pseudowire ID that identifies the pseudowire in whichMPLSconnectivity is being verified. The pseudowire is used to sendthe echo request packets. The range is from 1 to 4294967295.

pw-id

(Optional) Specifies the MPLS experimental field value inthe MPLS header for echo replies. Range is 0 to 7. Defaultis 0.

exp exp-bits

(Optional) Specifies a send interval, in milliseconds, betweenrequests. Range is 0 to 3600000. Default is 0.


(Optional) Specifies the pad pattern for an echo request.pad pattern

(Optional) Specifies the number of times to resend a packet.Range is 1 to 2147483647. Default is 5.

repeat count

(Optional) Specifies the differentiated service codepoint valuefor an MPLS echo reply.


(Optional) Specifies the reply mode for the echo requestpacket.

reply mode {ipv4 | router-alert | no-reply| control-channel}


Reply with an IPv4 UDP packet (thedefault)

ipv4

Reply with an IPv4 UDP packet withthe IP router alert set

router-alert

Force the use of a VCCV controlchannel.

control-channel


MPLS OAM Commandsping pseudowire (AToM)

Reply using an application for a defined control channel. Thisapplies only to pseudowires in which VCCV is used in thereply path. This is the default choice for pseudowire ping.

(Optional) Indicates that a reply pad TLV should be included.reply pad-tlv

(Optional) Specifies the packet size or number of bytes ineach MPLS echo request packet. Range is 100 to 17986.Default is 100.

size packet-size

(Optional) Specifies the source address used in the echorequest packet.

source source-address

Specifies a range of sizes for the echo packets sent.sweep min-value max-value interval

Minimum or start size for an echo packet(range is 100 to 17986)

min-value

Maximum or end size for an echopacket(range is 100 to 17986)

max-value

Number used to increment an echo packetsize(range is 1 to 8993)

interval

(Optional) Specifies the timeout interval in seconds. Rangeis 0 to 3600. Default is 2 seconds.

timeout timeout

(Optional) Specifies the TTL value to be used in the MPLSlabels (range is 1 to 255).

ttl value

(Optional) Enables verbose output information, includingMPLS echo reply, sender address of the packet, and returncodes.

verbose

Command Default exp exp bits: 0


repeat count: 5

reply-mode: IPv4

timeout timeout : 2

Command Modes EXEC





ModificationRelease

The following keywords and arguments were added:Release 3.9.0

• force-control-channel, control-word, ra-label and ttl-expirykeywords were added.


In cases in which the sweep keyword is used, values larger than the outgoing interface’s MTU are nottransmitted.


The ping mpls command is not supported on optical LSPs. If an optical LSP is encountered along theLSP's path, it is treated as a physical interface.

Note

AToMVCCV allows the sending of control packets inband of an AToM pseudowire (PW) from the originatingprovider edge (PE) router. The transmission is intercepted at the destination PE router, instead of beingforwarded to the customer edge (CE) router. This lets you use MPLS LSP ping to test the pseudowire sectionof AToM virtual circuits (VCs).

The no interactive version of the ping pseudowire (AToM) command is supported.

The control word setting is either enabled along the entire path between the Terminating-Provider Edge (T-PE)or it is completely disabled. If the control word configuration is enabled on one segment and disabled onanother segment, the multisegment pseudowire does not come up.


read, writempls-te

read, writempls-ldp

Examples The following example shows how the pingmpls pseudowire command is used to verify PE to PE connectivityin which the remote PE address is 150.150.150.150. Only one echo request packet is sent and the remote PEis to answer using IPv4 instead of the control channel.

RP/0/0/CPU0:router# ping mpls pseudowire 150.150.150.150 21 repeat 1 reply mode ipv4

Sending 1, 100-byte MPLS Echos to 150.150.150.150 VC: 21,timeout is 2 seconds, send interval is 0 msec:

Codes: '!' - success, 'Q' - request not sent, '.' - timeout,'L' - labeled output interface, 'B' - unlabeled output interface,'D' - DS Map mismatch, 'F' - no FEC mapping, 'f' - FEC mismatch,'M' - malformed request, 'm' - unsupported tlvs, 'N' - no rx label,'P' - no rx intf label prot, 'p' - premature termination of LSP,



'R' - transit router, 'I' - unknown upstream index,'X' - unknown return code, 'x' - return code 0

Type escape sequence to abort.!Success rate is 100 percent (1/1), round-trip min/avg/max = 23/23/23 ms



ping mpls mldp (P2MP)To check data plane and control plane of MPLS for the Point-to-Multipoint (P2MP) label switch path, usethe ping mpls mldp p2mp command in EXEC mode.

pingmplsmldp p2mp root-address {IPv4 source-ipv4-address group-ipv4-address| IPv6 source-ipv6-addressgroup-ipv6-address| vpnv4 AS-number [ source-ipv4-address group-ipv4-address ]| vpnv6 AS-number[ source-ipv6-address group-ipv6-address ]|mdt oui:vpn-index mdt-number| global-id lsp-id} [options]

Syntax Description Verifies the ping capability for multicast labeldistribution protocol (mldp).

mldp

Indicates the Point-to-Multipoint (P2MP) labelswitch path.

p2mp

Specifies the root address.root-address

Defines IPv4 opaque encoding.IPv4 ipv4-address


Defines VPNv4 opaque encoding.vpnv4 AS-number [ source-ipv4-addressgroup-ipv4-address ]


Defines VPN ID opaque encoding. Range of 3-byteOUI is 0 to 16777215. Range of mdt-number is 0 to4294967295.

mdt oui:vpn-index mdt number

Defines 4 byte global LSP ID opaque encoding.global-id isp-id

Specifies the source address of target multicastaddress.

source-address

Specifies the target address of target multicastaddress.

group-address

Specifies the Autonomous system number asfollows:

AS-number

• 4-byte AS-number with asdot (X.Y) : aa.bb:ccformat (for example, 11.22:33)

• 2-byte AS-number or4-byte AS-number: aa:bbformat (for example, 11:22)

• IPv4 address and index:aa.bb.cc.dd:ee format(for example, 11.22.33.44:55)


MPLS OAM Commandsping mpls mldp (P2MP)

Specifies a set of various options:options

(Optional) Indicates that a downstreamdetailed mapping TLV (ddmap) shouldbe included in the LSP echo request.

ddmap

(Optional) Specifies a network 127/8address to be used as the destinationaddress in the echo request packet.

destination

start-address: Start of the networkaddress.

end-address: End of the networkaddress.

address increment: Incremental valueof the network address, which isexpressed as a decimal number valueor IP address.

(Optional) Specifies the MPLSexperimental field value in the MPLS

expexp-bits

header for echo replies. Range is 0 to7. Default is 0.

fec: (Optional) Specifies that forwardingequivalent class (FEC) stack checking is tobe performed at transit routers.

flags

no-ttl: (Optional) Specifies not to add TTLexpired flag in echo request.

(Optional) Forces anunsolicited explicit null label

force-explicit-null

to be added to the MPLS labelstack and allows LSP ping tobe used to detect LSPbreakages at the penultimatehop.

(Optional) Specifies a sendinterval, in milliseconds, between

intervalmin-send-delay

requests. Range is 0 to 3600000.Default is 0.

(Optional) Specifies a jitter value for acorresponding echo request, in

jitter

milliseconds. Range is 0 to 2147483647.Default is 200.



(Optional) Specifies the padpattern for an echo request.

pad pattern

(Optional) Specifies the number oftimes to resend a packet. Range is 1to 2147483647. Default is 5.

repeatcount

(Optional) Specifies the differentiatedservice codepoint value for an MPLSecho reply.

replydscpdscp-value

mode [ipv4 | router-alert ]

(Optional) Specifies the reply mode forthe echo request packet.

ipv4

Reply with an IPv4 UDP packet (thisis the default)

router-alert


(Optional) Adds responderidentifier into correspondingecho request.

responder-idipv4-address

(Optional) Specifies the packet sizeor number of bytes in each MPLS

sizepacketsize

echo request packet. Range is 100 to17986. Default is 100.

(Optional) Specifies the sourceaddress used in the echo requestpacket.

sourceipv4-address

(Optional)sweep

(Optional) Specifies the timeoutinterval, in seconds. Range is 0 to3600. Default is 2.

timeouttimeout

(Optional) Specifies the TTL value to beused in theMPLS labels (range is 1 to 255).Default is 255.

ttl



(Optional) Enables verbose outputinformation, including MPLS echo

verbose

reply, sender address of the packet, andreturn codes.


Command Modes EXEC




Task ID OperationTask ID

executebasic-services

readmpls-te

readmpls-ldp

Examples The following examples show how to check connectivity for P2MP by using the ping mpls mldp p2mpcommand.

RP/0/0/CPU0:routerping mpls mldp p2mp 192.168.0.1 ipv4 2.2.2.2 232.1.1.1

Sending 1, 100-byte MPLS Echos to mldp p2mp 192.168.0.1 ipv4 (2.2.2.2, 232.1.1.1),timeout is 2.2 seconds, send interval is 0 msec, jitter value is 200 msec:

Codes: '!' - success, 'Q' - request not sent, '.' - timeout,'L' - labeled output interface, 'B' - unlabeled output interface,'D' - DS Map mismatch, 'F' - no FEC mapping, 'f' - FEC mismatch,'M' - malformed request, 'm' - unsupported tlvs, 'N' - no rx label,'P' - no rx intf label prot, 'p' - premature termination of LSP,'R' - transit router, 'I' - unknown upstream index,'X' - unknown return code, 'x' - return code 0, 'd' - DDMAP

Type escape sequence to abort.

Request #1! reply addr 11.11.11.3! reply addr 12.12.12.4

Round-trip min/avg/max = 17/27/38 ms



RP/0/0/CPU0:router#ping mpls mldp p2mp 192.168.0.1 ipv4 2.2.2.2 232.1.1.1 ddmap ttl 1

Sending 1, 100-byte MPLS Echos to mldp p2mp 192.168.0.1 ipv4 (2.2.2.2, 232.1.1.1),timeout is 2.2 seconds, send interval is 0 msec, jitter value is 200 msec:



Request #1d reply addr 10.10.10.2[L] DDMAP 0: 11.11.11.3 11.11.11.3 MRU 1500 [Labels: 16016 Exp: 0][L] DDMAP 1: 12.12.12.4 12.12.12.4 MRU 1500 [Labels: 16016 Exp: 0]

This table describes the significant fields shown in the display:

SignalingSupported MulticastApplication

Opaque ValueOpaque Type

In-BandPIM-SSM transit of IPv4S, GIPv4


In-BandmVPN Default-MDT(MDT# = 0)

VPN-ID, MDT#MDT

mVPN Data-MDT(MDT# > 0)

Out-of-BandBGP Assigned LSPs4 byte valueGlobal ID

In-BandVPNv4(S,G), VPN-IDVPNv4



Verifies data plane and control plane for theMultipoint-to-Multipoint (MP2MP) label switch path.

ping mpls mldp (MP2MP), page 24

Verifies hop-by-hop fault localization and path tracingfor the point-to-multipoint path.

traceroute mpls mldp (P2MP), page 43

Verifies hop-by-hop fault localization and path tracingfor the multipoint-to-multipoint path.

traceroute mpls mldp (MP2MP), page 48



ping mpls mldp (MP2MP)To check data plane and control plane of MPLS for the Multipoint-to-Multipoint (MP2MP) label switch path,use the ping mpls mldp mp2mp command in exec mode.

ping mpls mldp mp2mp root-address {IPv4 source-ipv4-address group-ipv4-address| IPv6source-ipv6-address group-ipv6-address| vpnv4 AS-number [ source-ipv4-address group-ipv4-address ]|vpnv6 AS-number [ source-ipv6-address group-ipv6-address ]|mdt oui:vpn-index mdt-number| global-idlsp-id} [options]


mldp

Indicates the Multipoint-to-Multipoint (MP2MP)label switch path.

mp2mp





Defines VPNv6 opaque encoding.vpnv6 AS-number[ source-ipv6-addressgroup-ipv6-address ]



Defines 4 byte global LSP ID opaque encoding.global-id lsp-id


source-address


group-address


AS-number





MPLS OAM Commandsping mpls mldp (MP2MP)


(Optional) Indicates that a downstreamdetailed mapping TLV (ddmap) shouldbe included in the LSP echo request.

ddmap


destination





expexp-bits



flags



force-explicit-null


(Optional) Specifies a sendinterval, in milliseconds, between

intervalmin-send-delay

requests. Range is 0 to 3600000.Default is 0.


jitter




(Optional) Specifies the padpattern for an echo request.

pad pattern

(Optional) Specifies the number oftimes to resend a packet. Range is 1to 2147483647. Default is 5.

repeatcount


replydscpdscp-value



ipv4


router-alert




(Optional) Specifies the packet sizeor number of bytes in each MPLS

sizepacketsize

echo request packet. Range is 100 to17986. Default is 100.


sourceipv4-address

(Optional)sweep


timeouttimeout


ttl




verbose



Command Modes EXEC






readmpls-te

readmpls-ldp

Examples The following example shows how to check connectivity by using the ping mpls mldp command when aroot address is present.

RP/0/0/CPU0:routerping mpls mldp mp2mp 192.168.0.1 global-id 1Mon Jul 11 15:35:50.294 JST

Sending 1, 100-byte MPLS Echos to mldp mp2mp 192.168.0.1 global-id 1,timeout is 2.2 seconds, send interval is 0 msec, jitter value is 200 msec:



Request #1! reply addr 10.10.10.2! reply addr 12.12.12.4! reply addr 11.11.11.3



Round-trip min/avg/max = 72/112/135 ms

RP/0/0/CPU0:router#ping mpls mldp mp2mp 192.168.0.1 global-id 1 responder-id 11.11.11.3Mon Jul 11 15:36:16.038 JST

Sending 1, 100-byte MPLS Echos to mldp mp2mp 192.168.0.1 global-id 1,timeout is 2.2 seconds, send interval is 0 msec, jitter value is 200 msec:



Request #1! reply addr 11.11.11.3

Round-trip min/avg/max = 163/163/163 msThis table describes the significant fields shown in the display:

SignalingSupported MulticastApplication

Opaque ValueOpaque Type



In-BandmVPN Default-MDT(MDT# = 0)

VPN-ID, MDT#MDT

mVPN Data-MDT(MDT# > 0)

Out-of-BandBGP Assigned LSPs4 byte valueGlobal ID




Verifies data plane and control plane for thepoint-to-multipoint (P2MP) label switch path.

ping mpls mldp (P2MP), page 19







show mpls oamTo display MPLS OAM information, use the show mpls oam command in EXEC mode.

show mpls oam {client| counters {global| packet}| interface type interface-path-id}

Syntax Description Displays clients registered with LSPV server.client

Displays LSP verification global counters.counters global

Displays LSP verification packet counters.counters packet

Displays LSP verification information for a specific interface.counters interface


type

Physical interface or virtual interface.interface-path-id

Use the show interfaces command to see a list of all interfacescurrently configured on the router.

Note

For more information about the syntax for the router, use the question mark(?) online help function.


Command Modes EXEC





readmpls-te

readmpls-ldp

readmpls-static


MPLS OAM Commandsshow mpls oam

Examples The following example shows how to display MPLS OAM client information:

RP/0/0/CPU0:router# show mpls oam client

Client Process: l2vpn_mgr Node: 0/0/SP Pid: 418014Client Process: te_control Node: 0/0/SP Pid: 639227

This table describes the significant fields shown in the display.

Table 1: show mpls oam client Command Field Descriptions

DescriptionField

Process of client.Client Process


MPLS OAM Commandsshow mpls oam

show mpls oam databaseTo display MPLS OAM database information, use the show mpls oam database command in EXEC mode.

show mpls oam database { requests | tt-requests} [detail] [handle handle-value ]

Syntax Description Displays request databaserequests

Displays tree trace request databasett-requests

(Optional) Displays displayed information.detail

(Optional) Displays handle information.handle

Generic handle value. Range is from 0 to 4294967295.handle-value


Command Modes EXEC



The handle-value argument was added.Release 3.9.0

The replies keyword was removed.Release 4.0.0



readmpls-te

readmpls-ldp

readmpls-static


MPLS OAM Commandsshow mpls oam database

Examples The following example shows how to display detailed MPLS OAM database information:

RP/0/0/CPU0:router# show mpls oam database request detail


MPLS OAM Commandsshow mpls oam database

traceroute mpls ipv4To learn the routes that packets follow when traveling to their Label Distribution Protocol (LDP) IPv4destination, use the traceroute mpls command in EXEC mode.

traceroute mpls ipv4address/mask [destination start-address end-address address-increment] [exp exp-bits][flags fec] [force-explicit-null] [output interface type interface-path-id [nexthop nexthop-address]] [reply{dscp dscp-value | reply mode {ipv4 | router-alert}}] [revision version] [source source-address] [timeouttimeout] [ttl value] [verbose]

Syntax Description Specifies the destination type as a label distribution protocol (LDP) prefix.Address prefix of the target and number of bits in the target address networkmask.

address/mask

Specifies a network 127 address to be used as the destination address in theecho request packet.

destination start-addressend-addressaddress-increment

Start of the network address.start address

End of the network address.end address

Incremental value of the network address.address increment


exp exp-bits

(Optional) Specifies that forwarding equivalent class (FEC) stack checkingis to be performed at transit routers.

flags fec


force-explicit-null

(Optional) Specifies the output interface in which echo request packets aresent.

output interface


type

Physical interface or virtual interface.Use the show interfaces command to see a list of all interfacescurrently configured on the router.

Noteinterface-path-id

For more information, use the question mark (?) online help function.

(Optional) Specifies the IP address for the next hop.nexthop

(Optional) IP address for the next hop.nexthop-address


MPLS OAM Commandstraceroute mpls ipv4



(Optional) Specifies the reply mode for the echo request packet.reply mode { ipv4 |router-alert}

Reply with IPv4 UDP packet (this is the default)ipv4

Reply with IPv4 UDP packet with router alertrouter-alert







(Optional) Specifies the timeout interval, in seconds. Range is from 0 to 3600.Default is 2.

timeout timeoutt

(Optional) Specifies the maximum number of hops (range is 1 to 255).ttl value


verbose

Command Default exp exp-bits: 0

reply mode: IPv4

timeout timeout: 2

Command Modes EXEC






The traceroute mpls command is not supported on optical LSPs. If an optical LSP is encountered alongthe LSPs path, it is treated as a physical interface.

Note

For detailed configuration information aboutMPLS LSP trace operations, seeCisco IOS XR SystemMonitoringConfiguration Guide for the Cisco XR 12000 Series Router.


read, writempls-te

read, writempls-ldp

Examples The following example shows how to trace a destination:



traceroute mpls multipathTo discover all possible paths of an LSP between the ingress and egress routers, use the traceroute mplsmultipath command in EXEC mode.

traceroute mpls multipath ipv4 address/mask [destination start-address end-address address-increment][exp exp-bits] [flags fec] [force-explicit-null] [hashkey ipv4 bitmap bit-size] [interval min-send-delay][output interface type interface-path-id [nexthop nexthop-address] ] [reply {dscp dscp-value | replymode{ipv4 | router-alert}}] [retry-count count] [revision version] [source source-address] [timeouttimeout] [ttl value] [verbose]

Syntax Description Specifies the destination type as a Label Distribution Protocol (LDP) IPv4address.

ipv4

Address prefix of the target and number of bits in the target address networkmask.

address/mask

(Optional) Specifies a network 127 address to be used as the destinationaddress in the echo request packet.

destination start-addressend-address address-increment

Start of the network address.start-address

End of the network address.end-address

Incremental value of the network address.address-increment


exp exp-bits


flags fec


force-explicit-null

(Optional) Allows user control of the hash key/multipath settings. Range is0 to 256. The default is 32.

hashkey ipv4 bitmap bit-size

(Optional) Specifies a send interval, in milliseconds, between requests. Rangeis 0 to 3600000. Default is 0.


(Optional) Specifies the output interface where echo request packets are sent.output interface


type


MPLS OAM Commandstraceroute mpls multipath

Physical interface or virtual interface.Use the show interfaces command to see a list of all interfacescurrently configured on the router.

Noteinterface-path-id

For more information, use the question mark (?) online help function.

(Optional) Specifies the IP address for the next hop.nexthop

(Optional) IP address for the next hop.nexthop-address



(Optional) Specifies the reply mode for the echo request packet.reply mode [ ipv4 |router-alert]



(Optional) Specifies the number of retry attempts during multipath LSPtraceroute. A retry is attempted if an outstanding echo request

retry-count count

• times out waiting for the corresponding echo reply.

• fails to find a valid destination address set to exercise a specific outgoingpath. Range is 0 to 10. Default is 3.







(Optional) Specifies the timeout interval, in seconds. Range is from 0 to 3600.Default is 2.

timeout timeout



verbose

Command Default exp exp-bits : 0

hashkey ipv4 bitmap bit-size: 4




reply mode: IPv4

retry-count: 3

timeout timeout : 2

Command Modes EXEC




The hashkey ipv4 bitmap keyword and bit-size value control howmany addresses are encoded in the DSMAPmultipath field. Larger values allow more coverage of equal cost multiple paths throughout the network, butwith more processing at the head, mid, and tail routers.


read, writempls-te

read, writempls-ldp

Examples The following example shows how to specify the destination type as an LDP IPv4 prefix:

RP/0/0/CPU0:router# traceroute mpls multi ipv4 140.140.140.140/32 verbose force-explicit-null

Starting LSP Path Discovery for 140.140.140.140/32



LL!Path 0 found,output interface POS0/2/0/3 source 196.100.1.61 destination 127.0.0.10 196.100.1.61 196.100.1.62 MRU 4470 [Labels: 18/explicit-null Exp: 0/0] multipaths 0L 1 196.100.1.62 196.100.1.10 MRU 4470 [Labels: 17/explicit-null Exp: 0/0] ret code 8

multipaths 1L 2 196.100.1.10 196.100.1.18 MRU 4470 [Labels: implicit-null/explicit-null Exp: 0/0] retcode 8 multipaths 1! 3 196.100.1.1018, ret code 3 multipaths 0LL!Path 1 found,output interface GigabitEthernet0/3/0/0 source 196.100.1.5 destination 127.0.0.1



0 196.100.1.5 196.100.1.37 6 MRU 1500 [Labels: 18/explicit-null Exp: 0/0] multipaths 0L 1 196.100.1.6 196.100.1.10 MRU 4470 [Labels: 17/explicit-null Exp: 0/0] ret code 8

multipaths 1L 2 10196.0100.21.5 1010 196.0100.21.10 18 MRU 4470 [Labels: implicit-null/explicit-nullExp: 0/0] ret code 8 multipaths 1! 3 10196.0100.21.1018, ret code 3 multipaths 0

Paths (found/broken/unexplored) (2/0/0)Echo Request (sent/fail) (6/0)Echo Reply (received/timeout) (6/0)Total Time Elapsed 80 ms



traceroute mpls traffic-engTo specify the destination type as anMPLS traffic engineering (TE) tunnel, use the traceroutempls traffic-engcommand in EXEC mode.

traceroute mpls traffic-eng tunnel tunnel-ID [destination start-address end-address address-incrementincrement-mask] [exp exp-bits] [flags fec] [force-explicit-null] [reply {dscp dscp-value | reply mode {ipv4| router-alert}}] [revision version] [source source-address] [timeout timeout] [ttl value] [verbose]

Syntax Description Specifies the MPLS-TE tunnel type.tunnel

Tunnel interface.tunnel-ID

(Optional) Specifies a network 127 address to be used as the destinationaddress in the echo request packet.

destination start-addressend-address address -incrementincrement-mask

Start of the network address.start-address

End of the network address.end-address

Incremental value of the network address.address-increment

Incremental mask of the network address.increment-mask

(Optional) Specifies theMPLS experimental field value in theMPLS headerfor echo replies. Range is 0 to 7. Default is 0.

exp exp-bits


flags fec

(Optional) Forces an unsolicited explicit null label to be added to theMPLSlabel stack and allows LSP ping to be used to detect LSP breakages at thepenultimate hop.

force-explicit-null

(Optional) Specifies the differentiated service codepoint value for anMPLSecho reply.


(Optional) Specifies the reply mode for the echo request packet.reply mode [ ipv4 |router-alert]








MPLS OAM Commandstraceroute mpls traffic-eng



(Optional) Specifies the timeout interval, in seconds. Range is from 0 to3600. Default is 2.

timeout timeout


(Optional) Enables verbose output information, includingMPLS echo reply,sender address of the packet, and return codes.

verbose

Command Default exp exp-bits : 0

reply mode: IPv4

timeout timeout : 2

Command Modes EXEC





readmpls-te

readmpls-ldp

Examples The following example shows how to specify the destination as a MPLS-TE tunnel:

RP/0/0/CPU0:router# traceroute mpls traffic-eng tunnel 13

Tracing MPLS TE Label Switched Path on tunnel-te13, timeout is 2 seconds





0 0.0.0.0 11.0.0.1 MRU 1500 [Labels: 16003 Exp: 0]L 1 192.168.200.2 192.168.170.1 MRU 1500 [Labels: implicit-null Exp: 0] 110 ms! 2 192.168.170.1 0.0.0.0 MRU 0 [No Label] 169 ms


Displays information about MPLS-TE tunnel for apoint-to-point connection.

ping mpls traffic-eng tunnel-te (P2P)



traceroute mpls mldp (P2MP)To verify hop-by-hop fault localization and path tracing for the point-to-multipoint path, use the traceroutempls mldp p2mp command in EXEC mode.

traceroute mpls mldp p2mp root-address {IPv4 source-ipv4-address group-ipv4-address| IPv6source-ipv6-address group-ipv6-address| vpnv4 AS-number [ source-ipv4-address group-ipv4-address ]|vpnv6 AS-number [ source-ipv6-address group-ipv6-address ]|mdt oui:vpn-index mdt-number| global-idlsp-id} [options]


mldp

Indicates the Point-to-Multipoint (P2MP) labelswitch path.

p2mp








Defines 4 byte global LSP ID opaque encoding.global-id lsp-id


source-address


group-address


AS-number





MPLS OAM Commandstraceroute mpls mldp (P2MP)



destination





expexp-bits



flags



force-explicit-null



jitter



replydscpdscp-value



ipv4




router-alert





sourceipv4-address


timeouttimeout


ttl


verbose



Command Modes EXEC








readmpls-te or mpls-ldp

Examples The following examples show how to verify path tracing for P2MP by using the traceroute mpls mldp p2mpcommand.RP/0/0/CPU0:router#traceroute mpls mldp p2mp 192.168.0.1 ipv4 2.2.2.2 232.1.1.1 ttl 4Mon Jul 11 15:36:42.299 JST

Tracing MPLS Label Switched Path to mldp p2mp 192.168.0.1 ipv4 (2.2.2.2, 232.1.1.1),timeout is 2.2 seconds, jitter value is 200 msec



d 1 10.10.10.2 54 ms [Estimated Role: Branch][L] DDMAP 0: 11.11.11.3 11.11.11.3 MRU 1500 [Labels: 16016 Exp: 0][L] DDMAP 1: 12.12.12.4 12.12.12.4 MRU 1500 [Labels: 16016 Exp: 0]

! 2 11.11.11.3 47 ms [Estimated Role: Egress]! 2 12.12.12.4 68 ms [Estimated Role: Egress]. 3 *. 4 *

RP/0/0/CPU0:router#traceroute mpls mldp p2mp 192.168.0.1 ipv4 2.2.2.2 232.1.1.1 ttl 4 jitter300Mon Jul 11 15:37:18.976 JST

Tracing MPLS Label Switched Path to mldp p2mp 192.168.0.1 ipv4 (2.2.2.2, 232.1.1.1),timeout is 2.3 seconds, jitter value is 300 msec



d 1 10.10.10.2 77 ms [Estimated Role: Branch][L] DDMAP 0: 11.11.11.3 11.11.11.3 MRU 1500 [Labels: 16016 Exp: 0][L] DDMAP 1: 12.12.12.4 12.12.12.4 MRU 1500 [Labels: 16016 Exp: 0]





Verifies data plane and control plane for thepoint-to-multipoint (P2MP) label switch path.

ping mpls mldp (P2MP), page 19





traceroute mpls mldp (MP2MP)To verify hop-by-hop fault localization and path tracing for the multipoint-to-multipoint path (MP2MP), usethe traceroute mpls mldp mp2mp command in EXEC mode.

traceroute mpls mldp mp2mp root-address {IPv4 source-ipv4-address group-ipv4-address| IPv6source-ipv6-address group-ipv6-address| vpnv4 AS-number [ source-ipv4-address group-ipv4-address ]|vpnv6 AS-number [ source-ipv6-address group-ipv6-address ]|mdt oui:vpn-index mdt-number| global-idlsp-id} [options]


mldp

Indicates the Multipoint-to-Multipoint (MP2MP)label switch path.

mp2mp








Defines 4 byte global LSP ID opaque encoding.global-idlsp-id


source-address


group-address


AS-number





MPLS OAM Commandstraceroute mpls mldp (MP2MP)



destination





expexp-bits



flags



force-explicit-null



jitter



replydscp-value



ipv4




router-alert





sourceipv4-address


timeouttimeout


ttl


verbose


Command Default ttl255 jitter200

Command Modes EXEC








readmpls-te or mpls-ldp

Examples The following examples show how to verify path tracing for MP2MP by using the traceroute mpls mldpmp2mp command.RP/0/0/CPU0:router#traceroute mpls mldp mp2mp 192.168.0.1 global-id 1 ttl 4

Tracing MPLS Label Switched Path to mldp mp2mp 192.168.0.1 global-id 1,timeout is 2.2 seconds, jitter value is 200 msec



! 1 10.10.10.2 41 ms [Estimated Role: Bud][L] DDMAP 0: 11.11.11.3 11.11.11.3 MRU 1500 [Labels: 16020 Exp: 0][L] DDMAP 1: 12.12.12.4 12.12.12.4 MRU 1500 [Labels: 16020 Exp: 0]



Verifies data plane and control plane for themultipoint-to-multipoint (MP2MP) label switch path.

ping mpls mldp (MP2MP), page 24





mpls oam commands...'r' - transit router, 'x' - unknown return code,...

Documents