To check MPLS host reachability and network connectivity by specifying the destination type as a Label Distribution Protocol
(LDP) IPv4 address, use the ping mpls ipv4 command in XR 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 type interface-path-id [nexthop nexthop-address]] [pad pattern] [repeat count] [reply {dscp dscp-value | reply mode {ipv4 | no-reply | router-alert} | reply pad-tlv}] [revision version] [size packet-size] [source source-address] [sweep min value max value increment] [timeout timeout] [ttl value] [verbose] [fec-type {bgp | generic | ldp}]
Syntax Description
address/mask
|
Address prefix of the target and number of bits in the target address network mask.
|
destination
start address
end address
address increment
|
(Optional) Specifies a network 127/8 address to be used as the destination address in the echo request packet.
- start address
-
Start of the network address.
- end address
-
Start of the ending network address.
- address increment
-
Incremental value of the network address, which is expressed as a decimal number value or IP address.
|
dsmap
|
(Optional) Indicates that a downstream mapping (DSMAP) type length and value should be included in the LSP echo request.
|
exp
exp-bits
|
(Optional) Specifies the MPLS experimental field value in the MPLS header for echo replies. Range is 0 to 7. Default is 0.
|
force-explicit-null
|
(Optional) Forces an unsolicited explicit null label to be added to the MPLS label stack and allows LSP ping to be used to
detect LSP breakages at the penultimate hop.
|
interval
min-send-delay
|
(Optional) Specifies a send interval, in milliseconds, between requests. Range is 0 to 3600000. Default is 0.
|
output interface
|
(Optional) Specifies the output interface where echo request packets are sent.
|
type
|
Interface type. For more information, use the question mark (?) online help function.
|
interface-path-id
|
Physical interface or virtual interface.
Note
|
Use the show interfaces command to see a list of all interfaces currently configured on the router.
|
For more information, use the question mark (?) online help function.
|
nexthop
|
(Optional) Specifies the nextop as an IP address.
|
nexthop-iaddress
|
(Optional) IP address for the next hop.
|
pad
pattern
|
(Optional) Specifies the pad pattern for an echo request.
|
repeat
count
|
(Optional) Specifies the number of times to resend a packet. Range is 1 to 2147483647. Default is 5.
|
reply dscp
dscp-value
|
Specifies the differentiated service codepoint value for an MPLS echo reply.
|
reply mode [
ipv4 | router-alert | no-reply ]
|
Specifies the reply mode for the echo request packet.
- no-reply
-
Do not reply
- ipv4
-
Reply with an IPv4 UDP packet (this is the default)
- router-alert
-
Reply with an IPv4 UDP packet with the IP router alert set
|
reply pad-tlv
|
Indicates that a pad TLV should be included.
|
revision
version
|
(Optional) Specifies the Cisco extension TLV versioning field:
- 1 RFC-ietf-mpls-lsp-ping-03 (initial)
- 2 RFC-ietf-mpls-lsp-ping-03 (rev 1)
- 3 RFC-ietf-mpls-lsp-ping-03 (rev 2)
- 4 RFC-ietf-mpls-lsp-ping-09 (initial)
|
size
packet size
|
(Optional) Specifies the packet size or number of bytes in each MPLS echo request packet. Range is 100 to 17986. Default is
100.
|
source
source-address
|
(Optional) Specifies the source address used in the echo request packet.
|
sweep
min value
max value
interval
|
(Optional) Specifies a range of sizes for the echo packets sent.
- min value
-
Minimum or start size for an echo packet (range is 100 to 17986)
- max value
-
Maximum or end size for an echo packet(range is 100 to 17986)
- interval
-
Number used to increment an echo packet size(range is 1 to 8993)
|
timeout
timeout
|
(Optional) Specifies the timeout interval, in seconds. Range is 0 to 3600. Default is 2.
|
ttl
value
|
(Optional) Specifies the TTL value to be used in the MPLS labels (range is 1 to 255).
|
verbose
|
(Optional) Enables verbose output information, including MPLS echo reply, sender address of the packet, and return codes.
|
fec-type
|
(Optional) Specifies FEC type to be used.
- bgp
-
Use FEC type as BGP
- generic
-
Use FEC type as generic
- ldp
-
Use FEC type as LDP
|
Command Default
exp
exp bits : 0
interval
min-send-delay: 0
repeat
count
: 5
reply-mode : IPv4
timeout
timeout
: 2
Command Modes
XR EXEC mode
Command History
Release
|
Modification
|
Release 7.0.12
|
This command was introduced.
|
Usage Guidelines
The output interface keyword specifies the output interface on which the MPLS echo request packets are sent. 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’s MTU are not transmitted.
The ping command sends an echo request packet to an address, and then awaits a reply. Ping output can help you evaluate path-to-host
reliability, delays over the path, and whether the host can be reached or is functioning.
Note
|
The ping mpls command is not supported on optical LSPs. If an optical LSP is encountered along the LSP's path, it is treated as a physical
interface.
|
For detailed configuration information about the MPLS ping command, see
Cisco ASR 9000 Series Router
Cisco IOS XR
System Monitoring Configuration Guide
for the
CRS-1 Router
Cisco XR 12000 Series Router.
Task ID
Task ID
|
Operations
|
mpls-te
|
read, write
|
mpls-ldp
|
read, write
|
Examples
The following example shows the destination type as a label distribution protocol (LDP) prefix and specifies a range of sizes
for the echo packets sent:
RP/0/RP0/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
The following example shows the destination type as a label distribution protocol (LDP) prefix and specifies FEC type as generic
and verbose option:
RP/0/RP0/CPU0:router# ping mpls ipv4 11.11.11.11/32 fec-type generic output interface gigabitEthernet 0/0/0/3
nexthop 172.40.103.2 verbose
Sending 5, 100-byte MPLS Echos to 11.11.11.11/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 11.101.11.11, return code 3
! size 100, reply addr 11.101.11.11, return code 3
! size 100, reply addr 11.101.11.11, return code 3
! size 100, reply addr 11.101.11.11, return code 3
! size 100, reply addr 11.101.11.11, return code 3
Success rate is 100 percent (5/5), round-trip min/avg/max = 3/4/6 ms