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
No modification.Release 3.9.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
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.9 OL-20402-01 3
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)
• 3: draft-ietf-mpls-lsp-ping-03 (rev 2)
• 4: draft-ietf-mpls-lsp-ping-09 (initial)
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
No modification.Release 3.9.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 ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.94 OL-20402-01
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
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.9 OL-20402-01 5
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
Command History ModificationRelease
This command was introduced.Release 3.7.2
No modification.Release 3.8.0
No modification.Release 3.9.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
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
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.96 OL-20402-01
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
• 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
Command History ModificationRelease
This command was introduced.Release 3.7.2
No modification.Release 3.8.0
No modification.Release 3.9.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
read, writempls-te
read, writempls-ldp
read, writempls-static
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.9 OL-20402-01 7
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
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.98 OL-20402-01
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
Command History ModificationRelease
This command was introduced.Release 3.7.2
No modification.Release 3.8.0
No modification.Release 3.9.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.
The mpls oam command and OAM functionality is described in the IETF LSP ping draft.
Task ID OperationsTask ID
read, writempls-te
read, writempls-ldp
read, writempls-static
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)#
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.9 OL-20402-01 9
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
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.910 OL-20402-01
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)
• 3 draft-ietf-mpls-lsp-ping-03 (rev 2)
• 4 draft-ietf-mpls-lsp-ping-09 (initial)
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
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.9 OL-20402-01 11
MPLS OAM Commands on Cisco ASR 9000 Series Routerping mpls ipv4
Command Modes EXEC
Command History ModificationRelease
This command was introduced.Release 3.7.2
No modification.Release 3.8.0
No modification.Release 3.9.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.
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 .
Task ID OperationsTask ID
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,
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.912 OL-20402-01
MPLS OAM Commands on Cisco ASR 9000 Series Routerping mpls ipv4
'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
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.9 OL-20402-01 13
MPLS OAM Commands on Cisco ASR 9000 Series Routerping mpls ipv4
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.
interval min-send-delay
(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 ]
Do not replyno-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
• 1 draft-ietf-mpls-lsp-ping-03 (initial)
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.914 OL-20402-01
MPLS OAM Commands on Cisco ASR 9000 Series Routerping mpls traffic-eng
• 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)
(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
interval min-send-delay: 0
repeat count: 5
reply-mode: IPv4
timeout timeout : 2
Command Modes EXEC
Command History ModificationRelease
This command was introduced.Release 3.7.2
No modification.Release 3.8.0
No modification.Release 3.9.0
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.9 OL-20402-01 15
MPLS OAM Commands on Cisco ASR 9000 Series Routerping mpls traffic-eng
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.
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 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
Task ID OperationsTask ID
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
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.916 OL-20402-01
MPLS OAM Commands on Cisco ASR 9000 Series Routerping mpls traffic-eng
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.
interval min-send-delay
Range is 0 to 3600000. Default is0.
(Optional) Specifies the pad patternfor an echo request.
pad pattern
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.9 OL-20402-01 17
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.
reply dscp dscp-value
(Optional) Specifies the replymodefor the echo request packet.
mode {ipv4 | router-alert | no-reply | control-channel}
Do not replyno-reply
Reply with anIPv4 UDP
ipv4
packet (thedefault)
Reply with anIPv4 UDP
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
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.918 OL-20402-01
MPLS OAM Commands on Cisco ASR 9000 Series Routerping pseudowire
(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
interval min-send-delay: 0
repeat count: 5
reply-mode: IPv4
timeout timeout : 2
Command Modes EXEC
Command History ModificationRelease
This command was introduced.Release 3.7.2
No modification.Release 3.8.0
The following keywords and arguments were added:Release 3.9.0
• force-control-channel, control-word, ra-label and ttl-expirykeywords were added.
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.9 OL-20402-01 19
MPLS OAM Commands on Cisco ASR 9000 Series Routerping pseudowire
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.
In cases in which the sweep keyword is used, values larger than the outgoing interface’s MTU are nottransmitted.
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
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.
Task ID OperationsTask ID
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
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.920 OL-20402-01
MPLS OAM Commands on Cisco ASR 9000 Series Routerping pseudowire
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
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.9 OL-20402-01 21
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).
interval min-send-delay
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.
reply dscp dscp-value
(Optional) Specifies the replymodefor the echo request packet.
mode {ipv4 | router-alert | no-reply | control-channel}
Do not replyno-reply
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.922 OL-20402-01
MPLS OAM Commands on Cisco ASR 9000 Series Routerping pseudowire multisegment
Reply with anIPv4 UDP
ipv4
packet (thedefault)
Reply with anIPv4 UDP
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
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.9 OL-20402-01 23
MPLS OAM Commands on Cisco ASR 9000 Series Routerping pseudowire multisegment
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
Command History ModificationRelease
This command was introduced.Release 3.7.2
No modification.Release 3.9.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.
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.
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.924 OL-20402-01
MPLS OAM Commands on Cisco ASR 9000 Series Routerping pseudowire multisegment
Task ID OperationsTask ID
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:
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 (5/5), round-trip min/avg/max = 6/10/18 ms
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.9 OL-20402-01 25
MPLS OAM Commands on Cisco ASR 9000 Series Routerping pseudowire multisegment
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
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 interfacescurrently configured on the router.
Note
For more information about the syntax for the router, use the question mark(?) online help function.
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
No modification.Release 3.9.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.
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.926 OL-20402-01
MPLS OAM Commands on Cisco ASR 9000 Series Routershow mpls oam
Task ID OperationsTask ID
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
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.9 OL-20402-01 27
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 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
The handle-value argument was added.Release 3.9.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
readmpls-te
readmpls-ldp
readmpls-static
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.928 OL-20402-01
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
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.9 OL-20402-01 29
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
(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) Specifies that forwarding equivalent class (FEC) stack checkingis to be performed at transit routers.
flags fec
(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 the output interface in which echo request packets aresent.
output interface
Interface type. For more information, use the question mark (?) online helpfunction.
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
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.930 OL-20402-01
MPLS OAM Commands on Cisco ASR 9000 Series Routertraceroute mpls
(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.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 Cisco extension TLV versioning field:revision version
• 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)
(Optional) Specifies the source address used in the echo request packet.source source-address
(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
(Optional) Enables verbose output information, including MPLS 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
Command History ModificationRelease
This command was introduced.Release 3.7.2
No modification.Release 3.8.0
The nexthop keyword and nexthop-address argument were added.Release 3.9.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.
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.9 OL-20402-01 31
MPLS OAM Commands on Cisco ASR 9000 Series Routertraceroute mpls
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.
Task ID OperationsTask ID
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
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.
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
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.932 OL-20402-01
MPLS OAM Commands on Cisco ASR 9000 Series Routertraceroute mpls
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
(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) Specifies that forwarding equivalent class (FEC) stack checkingis to be performed at transit routers.
flags fec
(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) 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.
interval min-send-delay
(Optional) Specifies the output interface where echo request packets are sent.output interface
Interface type. For more information, use the question mark (?) online helpfunction.
type
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.9 OL-20402-01 33
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 differentiated service codepoint value for an MPLSecho reply.
reply dscp dscp-value
(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 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 Cisco extension TLV versioning field:revision version
• 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)
(Optional) Specifies the source address used in the echo request packet.source source-address
(Optional) Specifies the timeout interval, in seconds. Range is from 0 to 3600.Default is 2.
timeout timeout
(Optional) Specifies the maximum number of hops (range is 1 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
hashkey ipv4 bitmap bit-size: 4
interval min-send-delay: 0
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.934 OL-20402-01
MPLS OAM Commands on Cisco ASR 9000 Series Routertraceroute mpls multipath
reply-mode: IPv4
retry-count: 3
timeout timeout : 2
Command Modes EXEC
Command History ModificationRelease
This command was introduced.Release 3.7.2
No modification.Release 3.8.0
The nexthop keyword and nexthop-address argument were added.Release 3.9.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.
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.
Task ID OperationsTask ID
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
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.
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
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.9 OL-20402-01 35
MPLS OAM Commands on Cisco ASR 9000 Series Routertraceroute mpls multipath
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
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.936 OL-20402-01
MPLS OAM Commands on Cisco ASR 9000 Series Routertraceroute mpls multipath
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
(Optional) Specifies that forwarding equivalent class (FEC) stack checkingis to be performed at transit routers.
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.
reply dscp dscp-value
(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 Cisco extension TLV versioning field:revision version
• 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)
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.9 OL-20402-01 37
MPLS OAM Commands on Cisco ASR 9000 Series Routertraceroute mpls traffic-eng
• 4 draft-ietf-mpls-lsp-ping-09 (initial)
(Optional) Specifies the source address used in the echo request packet.source source-address
(Optional) Specifies the timeout interval, in seconds. Range is from 0 to3600. Default is 2.
timeout timeout
(Optional) Specifies the maximum number of hops (range is 1 to 255).ttl value
(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
Command History ModificationRelease
This command was introduced.Release 3.9.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 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
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
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.938 OL-20402-01
MPLS OAM Commands on Cisco ASR 9000 Series Routertraceroute mpls traffic-eng
Type escape sequence to abort.
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
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.9 OL-20402-01 39
MPLS OAM Commands on Cisco ASR 9000 Series Routertraceroute mpls traffic-eng
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
(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) Specifies that forwarding equivalent class (FEC) stack checkingis to be performed at transit routers.
flags fec
(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 | control-channel}
Do not replyno-reply
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 source address used in the echo request packet.source source-address
(Optional) Specifies the timeout interval in seconds. Range is 0 to 3600.Default is 2 seconds.
timeout timeout
(Optional) Enables verbose output information, including MPLS echo reply,sender address of the packet, and return codes.
verbose
Command Default exp exp-bits : 0
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.940 OL-20402-01
MPLS OAM Commands on Cisco ASR 9000 Series Routertraceroute pseudowire multisegment
reply-mode: ipv4
timeout timeout : 2 seconds
Command Modes EXEC
Command History ModificationRelease
This command was introduced.Release 3.7.2
No modificationRelease 3.9.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 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
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.
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
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.9 OL-20402-01 41
MPLS OAM Commands on Cisco ASR 9000 Series Routertraceroute pseudowire multisegment
Cisco ASR 9000 Series Aggregation Services Router MPLS Command Reference, Release 3.942 OL-20402-01
MPLS OAM Commands on Cisco ASR 9000 Series Routertraceroute pseudowire multisegment