mpls oam commands on cisco asr 9000 series router · •pingmplsipv4,page10...

MPLS OAM Commands on Cisco ASR 9000 SeriesRouter

This module describes Multiprotocol Label Switching (MPLS) label switched path (LSP) verificationcommands on Cisco ASR 9000 Series Aggregation Services Routers . These commands provide a meansto detect and diagnose data plane failures and are the first set of commands in the MPLS Operations,Administration, and Maintenance (OAM) solution.

For detailed information about MPLS concepts, configuration tasks, and examples, see Cisco ASR 9000Series Aggregation Services Router MPLS Configuration Guide.

• clear mpls oam counters, page 2

• clear mpls oam echo, page 4

• echo disable-vendor-extension, page 6

• echo revision, page 7

• mpls oam, page 9

• ping mpls ipv4, page 10

• ping mpls traffic-eng, page 14

• ping pseudowire, page 17

• ping pseudowire multisegment, page 21

• show mpls oam, page 26

• show mpls oam database, page 28

• traceroute mpls, page 30

• traceroute mpls multipath, page 33

• traceroute mpls traffic-eng, page 37

• traceroute pseudowire multisegment, page 40

Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.9 OL-20402-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 | all ] | 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 all interface counters.all

Clears global packet counters.packet

Command Default No default behavior or values

Command Modes EXEC

Command History ModificationRelease

This command was introduced.Release 3.7.2

No modification.Release 3.8.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

Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.92 OL-20402-01

MPLS OAM Commands on Cisco ASR 9000 Series Routerclear mpls oam counters

OperationsTask ID

executempls-ldp

executempls-static

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

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


MPLS OAM Commands on Cisco ASR 9000 Series Routerclear mpls oam counters

clear mpls oam echoTo clear MPLS OAM echo requests, use the clear mpls oam echo command in EXEC mode.

clear mpls oam echo { disable-vendor-extension | revision { 1 | 2 | 3 | 4 } }

Syntax Description Disables sending TLV vendor extensions with echo requests.disable-vendor-extension

Revises the echo packet default.revision

Draft revision number:1 | 2 | 3 | 4

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

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




Command Modes EXEC







executempls-te

executempls-ldp

executempls-static


MPLS OAM Commands on Cisco ASR 9000 Series Routerclear mpls oam echo

Examples The following example shows how to disable sending TLV vendor extensions with echo requests:

RP/0/RSP0/CPU0:router# clear mpls oam echo disable-vendor-extension


MPLS OAM Commands on Cisco ASR 9000 Series Routerclear mpls oam echo

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 By default, the vendor extension TLV is sent in each request. 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/RSP0/CPU0:router# configureRP/0/RSP0/CPU0:router(config)# mpls oamRP/0/RSP0/CPU0:router(config-oam)# echo disable-vendor-extension


MPLS OAM Commands on Cisco ASR 9000 Series Routerecho 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





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

Command Modes MPLS OAM configuration mode







read, writempls-te

read, writempls-ldp



MPLS OAM Commands on Cisco ASR 9000 Series Routerecho revision

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

RP/0/RSP0/CPU0:router# configureRP/0/RSP0/CPU0:router(config)# mpls oamRP/0/RSP0/CPU0:router(config-oam)# echo revision 1


MPLS OAM Commands on Cisco ASR 9000 Series Routerecho 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






The mpls 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/RSP0/CPU0:router# configureRP/0/RSP0/CPU0:router(config)# mpls oamRP/0/RSP0/CPU0:router(config-oam)#


MPLS OAM Commands on Cisco ASR 9000 Series Routermpls 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] [repeat count] [reply{dscp dscp-value | mode{ipv4 | no-reply | router-alert}| pad-tlv}] [revision version] [size packet-size][source source-address] [sweep min value max value increment] [timeout timeout] [ttl value] [verbose]

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

address/mask

Specifies a network 127/8 address to be used as the destination address inthe echo request packet.

destination start address endaddress address increment

Start of the network address.start address

Start of the ending network address.end address

Incremental value of the network address, whichis expressed as a decimal number value or IPaddress.

address increment

Indicates that a downstream mapping (DSMAP) type length and valueshould be included in the LSP echo request.

dsmap

Specifies the MPLS experimental field value in the MPLS header for echoreplies. Range is 0 to 7. Default is 0.

exp exp-bits

Forces an unsolicited explicit null label to be added to theMPLS label stackand allows LSP ping to be used to detect LSP breakages at the penultimatehop.

force-explicit-null

Specifies a send interval, in milliseconds, between requests. Range is 0 to3600000. Default is 0.

interval min-send-delay

Specifies the output interface where echo request packets are sent.output interface outputinterface

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

repeat count

Specifies the differentiated service codepoint value for anMPLS echo reply.reply dscp dscp-value

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

Do not replyno-reply


MPLS OAM Commands on Cisco ASR 9000 Series Routerping mpls ipv4

Reply with an IPv4UDP packet (this is the default)ipv4

Reply with an IPv4 UDP packet with the IP routeralert set

router-alert

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

Specifies the Cisco extension TLV versioning field:revision version

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

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



Specifies the packet size or number of bytes in each MPLS echo requestpacket. Range is 100 to 17986. Default is 100.

size packet size

Specifies the source address used in the echo request packet.source source-address

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

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

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

Enables verbose output information, including MPLS echo reply, senderaddress of the packet, and return codes.

verbose

Specifies the pad pattern for an echo request.pad pattern

Command Default exp exp bits: 0

interval min-send-delay: 0

repeat count : 5

reply-mode: IPv4

timeout timeout : 2



Command Modes EXEC






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 the MPLS ping command, see Cisco ASR 9000 Series RouterSystem Monitoring Configuration Guide .


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/RSP0/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 | mode {ipv4 | no-reply | router-alert}| pad-tlv}][revision version] [size packet-size] [source source-address] [sweepmin-value max-value increment] [timeouttimeout] [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.

reply dscp dscp-value

(Optional) Specifies the reply mode for the echo request packet.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 Commands on Cisco ASR 9000 Series Routerping 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








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/RSP0/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



ping pseudowireTo 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] [force-control-channel {control-word |ra-label | ttl-expiry}] [intervalmin-send-delay] [pad pattern] [repeat count] [reply {dscp dscp-value |mode{ipv4 | no-reply | router-alert | control-channel}| pad-tlv}] [size packet-size] [source source-address][sweep min-value max-value increment] [timeout timeout] [ttl value] [verbose]

Syntax Description (Optional) Verifies the LabeledSwitch Path (LSP).

mpls

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

Pseudowire ID that identifies thepseudowire in which MPLS

pw-id

connectivity is being verified. Thepseudowire is used to send the echorequest packets. The range is from1 to 4294967295.

(Optional) Specifies the MPLSexperimental field value in the

exp exp-bits

MPLS header for echo replies.Range is 0 to 7. Default is 0.

(Optional) Specifies the force ofthe a Virtual Circuit Connection

force-control-channel

Verification (VCCV) controlchannel.

(Optional) Specifies an end-to-endcontrol word setting for amultisegment pseudowire.

control-word

(Optional) Specifies the label forthe router alert.

ra-label

(Optional) Specifies the VC labelTime-to-Live (TTL) expiry.

ttl-expiry

(Optional) Specifies a send interval,in milliseconds, between requests.


Range is 0 to 3600000. Default is0.

(Optional) Specifies the pad patternfor an echo request.

pad pattern


MPLS OAM Commands on Cisco ASR 9000 Series Routerping pseudowire

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

repeat count

(Optional) Specifies thedifferentiated service codepointvalue for an MPLS echo reply.


(Optional) Specifies the replymodefor the echo request packet.

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


Reply with anIPv4 UDP

ipv4

packet (thedefault)


router-alert

packet with theIP router alertset

Force the use ofa VCCV controlchannel.

control-channel

Reply using an application for adefined control channel. Thisapplies only to pseudowires inwhich VCCV is used in the replypath. This is the default choice forpseudowire ping.

(Optional) Indicates that a pad TLVshould be included.

pad-tlv

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

size packet-size

echo request packet. Range is 100to 17986. Default is 100.

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

source source-address

Specifies a range of sizes for theecho packets sent.

sweep min-value max-value interval

Minimum or start sizefor an echo packet

min-value



(range is 100 to17986)

Maximum or end sizefor an echo

max-value

packet(range is 100 to17986)

Number used toincrement an echo

interval

packet size(range is 1to 8993)

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

timeout timeout

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

ttl value

(Optional) Enables verbose outputinformation, includingMPLS echo

verbose

reply, sender address of the packet,and return codes.

Command Default exp exp bits: 0


repeat count: 5

reply-mode: IPv4

timeout timeout : 2

Command Modes EXEC




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 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/RSP0/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 pseudowire multisegmentTo verify the ping over the multisegment pseudowire, use the ping pseudowire multisegment command inEXEC mode.

ping [mpls] pseudowire multisegment end-address pw-id [destinationfec sender-address remote-addresspw-id-address] [exp exp-bits] [force-control-channel {control-word | ttl-expiry}] [intervalmin-send-delay][pad pattern] [repeat count] [segment-count segment-number] [reply {dscp dscp-value | mode {ipv4 |no-reply | router-alert | control-channel}| pad-tlv}] [size packet-size] [source source-address] [sweepminvalue max value increment] [timeout timeout] [verbose]

Syntax Description (Optional) Verifies the LabelSwitched Path (LSP).

mpls

Target end address.end-address

Virtual circuit of the pseudowireID that identifies the pseudowire in

pw-id

which MPLS connectivity is beingverified. The pseudowire sends theecho request packets. Range is from1 to 4294967295.

(Optional) Specifies the destinationfor the Forwarding EquivalenceClass (FEC) .

destinationfec sender-address remote-address pw-id-address

Sender-PE(S-PE) address

sender-address

for thedestination FEC.The S-PE addressis placed in theS-PE addressfield of the FEC128 Pseudowire(RFC 4379).

Remote address(S-PE address for

remote-address

the partial ping)for thedestination FEC.The address isplaced in theremote PEaddress of theFEC 128


MPLS OAM Commands on Cisco ASR 9000 Series Routerping pseudowire multisegment

Pseudowire (RFC4379).

Pseudowire ID ofthe pseudowire

pw-id-address

segment to theremote T-PEaddress (S-PEaddress for thepartial ping).

(Optional) Specifies the MPLSexperimental field value in the

exp exp-bits

MPLS header for echo replies.Range is 0 to 7. Default is 0.

(Optional) Specifies the force ofthe a Virtual Circuit Connection

force-control-channel

Verification (VCCV) controlchannel.

(Optional) Specifies an end-to-endcontrol word setting for amultisegment pseudowire.

control-word

(Optional) Specifies the VirtualCircuit (VC) label Time-to-Live(TTL) expiry.

ttl-expiry

(Optional) Specifies a send intervalbetween requests (in milliseconds).


Range is 0 to 3600000. Default is0.

(Optional) Specifies the pad patternfor an echo request.

pad pattern

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

repeat count

(Optional) Specifies thedifferentiated service codepointvalue for an MPLS echo reply.


(Optional) Specifies the replymodefor the echo request packet.

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





ipv4

packet (thedefault)


router-alert

packet with theIP router alertset

Force the use ofa VCCV controlchannel.

control-channel

Reply using an application for adefined control channel. Thisapplies only to pseudowires inwhich VCCV is used in the replypath. This is the default choice forpseudowire ping.

(Optional) Specifies the segmentcount for the FEC destination of the

segment-count

multisegment pseudowire . Thesegment count is used for thepseudowire label for the TTL value.

(Optional) Value of the segmentcount. Range is 1 to 255.

segment-number

(Optional) Indicates that a pad TLVshould be included.

pad-tlv

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

size packet-size

echo request packet. Range is 100to 17986. Default is 100.

Specifies a range of sizes for theecho packets sent.

sweep min value max value interval

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

minvalue

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

maxvalue



Number used toincrement an echo

interval

packet size(range is 1to 8993)

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

source source-address

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

timeout timeout

(Optional) Enables verbose outputinformation, includingMPLS echo

verbose

reply, sender address of the packet,and return codes.

Command Default exp exp-bits : 0

interval min-send-delay : 0

repeat count: 5

reply-mode: ipv4

size packet-size : 100

timeout timeout : 2 seconds

Command Modes EXEC





The partial ping works only if the destinationfec keyword is used.

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 the local pseudowire segment from T-PE1 is set to S-PE1 80.80.80.80 and thepseudowire ID is set to 100. The last pseudowire segment of the multisegment pseudowire is from S-PE180.80.80.80 to T-PE2 90.90.90.90 and the pseudowire ID is set to 300.

RP/0/RSP0/CPU0:router# ping pseudowire multisegment 80.80.80.80 100 destinationfec80.80.80.80 90.90.90.90 300 segment-count 2

Sending 5, 100-byte MPLS Echos to 80.80.80.80 VC: 100, 90.90.90.90 VC: 300timeout is 2 seconds, send interval is 0 msec, PW Label TTL is 2:


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



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

Displays global counters.global

Displays packet counters.packet

Displays selected information on a specified interface.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







MPLS OAM Commands on Cisco ASR 9000 Series Routershow mpls oam


readmpls-te

readmpls-ldp

readmpls-static

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

RP/0/RSP0/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

Table 1: show mpls oam client Command Field Descriptions, page 27 describes the significant fields shownin the display.

Table 1: show mpls oam client Command Field Descriptions

DescriptionField

Process of client.Client Process


MPLS OAM Commands on Cisco ASR 9000 Series Routershow 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 { replies | requests | tt-requests } [detail] [handle handle-value ]

Syntax Description Displays replies database.replies

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



readmpls-te

readmpls-ldp

readmpls-static


MPLS OAM Commands on Cisco ASR 9000 Series Routershow mpls oam database

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

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


MPLS OAM Commands on Cisco ASR 9000 Series Routershow mpls oam database

traceroute mplsTo learn the routes that packets followwhen traveling to their destinations, use the traceroute mpls commandin EXEC mode.

traceroutempls ipv4 address/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 | 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.ipv4

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 Commands on Cisco ASR 9000 Series Routertraceroute mpls



(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 to3600. 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 nexthop keyword and nexthop-address argument were added.Release 3.9.0




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 about MPLS LSP trace operations, see Cisco ASR 9000 SeriesAggregation Services Router System Monitoring Configuration Guide.


read, writempls-te

read, writempls-ldp

Examples The following example shows how to trace a destination:

RP/0/RSP0/CPU0:router# traceroute mpls

Protocol [ipv4]: mplsTarget IPv4 or traffic-eng [ipv4]:Target IPv4 address: 140.140.140.140Target mask: 255.255.255.255Timeout in seconds [2]:Extended commands? [no]: yesDestination address or destination start address: 127.0.0.10Destination end address: 127.0.0.15Destination address increment: 1Source address:EXP bits in mpls header [0]:Maximum Time To Live [30]:Reply mode (2-ipv4 via udp, 3-ipv4 via udp with router alert) [2]:LSP ping/trace revision (1-draft 3 initial, 2-draft 3 rev 1, 3-draft 3 rev 2, 4-draft 9

initial) [4]:Force explicit null label? [no]:Reply IP header DSCP bits [0]:Check the FEC stack at transit routers? [no]:

Tracing MPLS Label Switched Path to 140.140.140.140/2732, timeout is 2 seconds


Type escape sequence to abort.

Destination address 127.0.0.10

0 196.100.1.41 MRU 4470 [Labels: 19 Exp: 0]L 1 196.100.1.42 MRU 4470 [Labels: 86 Exp: 0] 360 msL 2 196.100.1.50 MRU 4470 [Labels: implicit-null Exp: 0] 8 ms! 3 196.100.1.18 9 ms



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 |mode{ipv4| router-alert}}] [retry-count count] [revision version] [source source-address] [timeout timeout] [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 Commands on Cisco ASR 9000 Series Routertraceroute 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


hashkey ipv4 bitmap bit-size: 4




reply-mode: IPv4

retry-count: 3

timeout timeout : 2

Command Modes EXEC




The nexthop keyword and nexthop-address argument were added.Release 3.9.0


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/RSP0/CPU0:router# traceroute mpls multi ipv4 140.140.140.140/32 verboseforce-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] ret



code 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.10 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 | 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 Commands on Cisco ASR 9000 Series Routertraceroute 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


reply-mode: IPv4

timeout timeout : 2

Command Modes EXEC




Task ID OperationTask ID

readmpls-te

readmpls-ldp

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

RP/0/RSP0/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



traceroute pseudowire multisegmentTo verify the Labeled Switch Path (LSP) for the multisegment pseudowire, use the traceroute pseudowiremultisegment command in EXEC mode.

traceroute pseudowire multisegment address pw-id [exp exp-bits] [flags fec] [reply {dscp dscp-value |mode {ipv4 | no-reply | router-alert | control-channel}| pad-tlv}] [source source-address] [timeout timeout][verbose]

Syntax Description Address of the next S-PE.address

Pseudowire ID of the pseudowire segment to the next S-PE.pw-id


exp exp-bits


flags fec



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


Reply with an IPv4 UDP packet (the default)ipv4

Reply with an IPv4UDP packet with the IP routeralert set

router-alert

Force the use of a VCCV control channel.control-channel

Reply using an application for a defined control channel. This applies onlyto pseudowires in which VCCV is used in the reply path. This is the defaultchoice for pseudowire ping.

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


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

timeout timeout


verbose



MPLS OAM Commands on Cisco ASR 9000 Series Routertraceroute pseudowire multisegment

reply-mode: ipv4

timeout timeout : 2 seconds

Command Modes EXEC



No modificationRelease 3.9.0


Task ID OperationTask ID

readmpls-te

readmpls-ldp

Examples The following example shows that the next pseudowire segment and traceroute go through each hop in whicheach hop is a S-PE or remote T-PE. The local segment from T-PE1 is set to S-PE1 80.80.80.80 and thepseudowire ID is set to 100. The last pseudowire segment of the multisegment pseudowire is from S-PE180.80.80.80 to T-PE2 90.90.90.90 and the pseudowire ID is set to 300.

RP/0/RSP0/CPU0:router# traceroute pseudowire multisegment 80.80.80.80 100

Tracing MS-PW to 80.80.80.80 VC: 100, timeout is 2 seconds



0 1.2.1.2 MRU 1500 [Outgoing Labels: 20495 Exp: 0]L 1 1.2.1.1 MRU 1500 [Outgoing Labels: 24587 Exp: 0] 13 ms

local 70.70.70.70 remote 80.80.80.80 pw-id 100! 2 1.4.1.1 9 ms

local 80.80.80.80 remote 90.90.90.90 pw-id 300



mpls oam commands on cisco asr 9000 series router · •pingmplsipv4,page10...

Documents