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 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
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)
|
|
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.
|
Command Default
exp
exp
bits : 0
interval
min-send-delay: 0
repeat
count
: 5
reply-mode : IPv4
timeout
timeout
: 2
Command History
|
Release
|
Modification
|
|
Release 3.7.2
|
This
command was introduced.
|
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user
group assignment is preventing you from using a command, contact your AAA administrator for assistance.
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
System
Monitoring Configuration Guide
.
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/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
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/RSP0/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
Feedback