Login
- Table of Contents
-
- 08-MPLS Command Reference
- 00-Preface
- 01-Basic MPLS commands
- 02-Static LSP commands
- 03-LDP commands
- 04-MPLS TE commands
- 05-Static CRLSP commands
- 06-RSVP commands
- 07-Tunnel policy commands
- 08-MPLS L3VPN commands
- 09-IPv6 MPLS L3VPN commands
- 10-MPLS L2VPN commands
- 11-VPLS commands
- 12-MPLS OAM commands
- 13-MCE commands
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 12-MPLS OAM commands | 183.76 KB |
MPLS OAM commands
MPLS OAM is not available on the S9825 switch series.
To use MPLS OAM on an MPLS-capable device, set the hardware resource mode to the routing mode by using the hardware-resource switch-mode command. For more information about this command, see hardware resource management commands in System Management Command Reference.
mpls periodic-tracert (for LSP)
Use mpls periodic-tracert to enable periodic tracert of LSPs for a FEC.
Use undo mpls periodic-tracert to disable periodic tracert of LSPs for a FEC.
Syntax
mpls periodic-tracert dest-addr mask-length [ -a source-ip | -exp exp-value | -h ttl-value | -m wait-time | -rtos tos-value | -t time-out | -u retry-attempt | fec-check ] *
undo mpls periodic-tracert dest-addr mask-length
Default
Periodic tracert of LSPs for a FEC is disabled.
Views
System view
Predefined user roles
network-admin
Parameters
dest-addr mask-length: Specifies a FEC by a destination IP address and mask length. The mask length is in the range of 0 to 32.
-a source-ip: Specifies the source address for MPLS echo request packets. If you do not specify this option, the device uses the MPLS LSR ID as the source address for MPLS echo requests.
-exp exp-value: Specifies the EXP value for MPLS echo request packets, in the range of 0 to 7. The default is 0.
-h ttl-value: Specifies the maximum TTL value for MPLS echo request packets (the maximum number of hops to be inspected). The value range for the ttl-value argument is 1 to 255, and the default is 30.
-m wait-time: Specifies the interval at which tracert is performed. The value range is 15 to 120 minutes. The default is 60 minutes.
-rtos tos-value: Specifies the ToS value in the IP header of an MPLS echo reply packet. The value range is 0 to 7, and the default value is 6.
-t time-out: Specifies the timeout interval for the reply to an MPLS echo request. The value range is 0 to 65535 milliseconds, and the default is 2000 milliseconds.
-u retry-attempt: Specifies the maximum number of retransmissions of an MPLS echo request if no reply is received. The value range is 1 to 9, and the default value is 3.
fec-check: Checks the FEC stack at transit nodes.
Usage guidelines
The periodic MPLS tracert feature automatically traces an LSP tunnel at intervals. It locates errors on the LSP tunnel, verifies the consistency of the data plane and control plane, and records the detected errors into system logs. You can check the logs to monitor LSP connectivity.
If both BFD and periodic MPLS tracert are configured for an LSP, both feature take effect. When periodic MPLS tracert detects a data plane failure or an inconsistency between data plane and control plane, the device performs the following operations:
1. Deletes the BFD session for the LSP.
2. Re-establishes the BFD session based on the control plane.
Before you execute this command, execute the mpls bfd enable command.
Examples
# Enable periodic tracert for LSPs to destination 11.11.1.1/32.
<Sysname> system-view
[Sysname] mpls bfd enable
[Sysname] mpls periodic-tracert 11.11.1.1 32
Related commands
mpls bfd enable
mpls bfd (for LSP)
mpls tunnel-bfd detect-multiplier
Use mpls tunnel-bfd detect-multiplier to set the tunnel BFD and tunnel SBFD detection time multiplier for an MPLS TE tunnel.
Use undo mpls tunnel-bfd detect-multiplier to restore the default.
Syntax
mpls tunnel-bfd detect-multiplier value
undo mpls tunnel-bfd detect-multiplier
Default
The tunnel BFD and tunnel SBFD detection time multiplier is not set for an MPLS TE tunnel.
Views
Tunnel interface view
Predefined user roles
network-admin
Parameters
value: Specifies a detection time multiplier, which is the maximum number of consecutive BFD packets that can be discarded. The value range for this argument is 3 to 50.
Usage guidelines
For tunnel BFD on an MPLS TE tunnel:
· If the mpls tunnel-bfd detect-multiplier command and the mpls tunnel-bfd command with the template keyword are both executed in the tunnel interface view, the mpls tunnel-bfd command takes effect.
· If that two commands are both not executed in the tunnel interface view, the bfd multi-hop detect-multiplier command's configuration is used.
For tunnel SBFD on an MPLS TE tunnel:
· If the mpls bfd detect-multiplier command and the mpls tunnel-sbfd command with the template keyword are both executed in the tunnel interface view, the mpls tunnel-sbfd command takes effect.
· If that two commands are both not executed in the tunnel interface view, the bfd multi-hop detect-multiplier command's configuration is used.
Examples
# Set the tunnel BFD and tunnel SBFD detection time multiplier to 3 for MPLS TE tunnel 1.
<Sysname> system-view
[Sysname] mpls bfd enable
[Sysname] interface tunnel 1 mode mpls-te
[Sysname-Tunnel1] mpls tunnel-bfd detect-multiplier 3
Related commands
bfd detect-multiplier (High Availability Command Reference)
bfd multi-hop detect-multiplier (High Availability Command Reference)
display mpls bfd
display mpls sbfd
mpls bfd enable
mpls tunnel-bfd (for TE tunnel)
mpls tunnel-sbfd (for TE tunnel)
ping mpls ipv4
Use ping mpls ipv4 to verify MPLS LSP connectivity for an IPv4 prefix.
Syntax
ping mpls [ -a source-ip | -c count | -exp exp-value | -h ttl-value | -m wait-time | -r reply-mode | -rtos tos-value | -s packet-size | -t time-out | -v ] * ipv4 ipv4-address mask-length [ destination start-address [ end-address [ address-increment ] ] ] [ fec-type { generic | isis | ldp | ospf } ]
Views
Any view
Predefined user roles
network-admin
Parameters
-a source-ip: Specifies the source address for MPLS echo request packets. If you do not specify this option, the device uses the primary IP address of the outgoing interface as the source address for MPLS echo requests.
-c count: Specifies the number of MPLS echo request packets to be sent with the same destination address in the IP header. The value range is 1 to 4294967295. The default is 5.
-exp exp-value: Specifies the EXP value for MPLS echo request packets, in the range of 0 to 7. The default is 0.
-h ttl-value: Specifies the TTL value for MPLS echo request packets, in the range of 1 to 255. The default is 255.
-m wait-time: Specifies the interval for sending MPLS echo request packets, in the range of 1 to 10000 milliseconds. The default is 200 milliseconds.
-r reply-mode: Specifies the reply mode of the receiver in response to MPLS echo request packets. The reply-mode argument can be 1, 2, 3, or 4. 1 means "Do not reply." 2 means "Reply by using a UDP packet." 3 means "Reply by using a UDP packet that carries the Router Alert option." 4 means "Reply by using a VCCV packet." The default is 2. The reply mode 4 is not available for MPLS LSP connectivity verification. If the reply mode 4 is specified, the remote end does not reply.
-rtos tos-value: Specifies the ToS value in the IP header of an MPLS echo reply packet. The value range is 0 to 7, and the default value is 6.
-s packet-size: Specifies the length (excluding the IP header and UDP header) of an MPLS echo request packet. The value for the packet-size argument is 65 to 8100 bytes, and the default is 100 bytes.
-t time-out: Specifies the timeout interval for the reply to an MPLS echo request. The value range is 0 to 65535 milliseconds, and the default is 2000 milliseconds.
-v: Displays detailed reply information. If you do not specify this keyword, the command displays brief reply information.
ipv4-address mask-length: Specifies a FEC by a destination IP address and mask length. The mask length is in the range of 0 to 32.
destination: Specifies the destination address in the IP header of MPLS echo requests. The default is 127.0.0.1.
start-address: Specifies the destination address or the start destination address. This address must be an address on subnet 127.0.0.0/8—a local loopback address. If you specify the start-address argument without the end-address argument, the start-address is the destination address in the IP header. The number of MPLS echo requests to be sent is determined by the -c count keyword. If you specify both start-address and end-address, you specify a range of destination addresses. The destination address increments by the value specified for the address-increment argument, starting from the start-address to the end-address. The number of MPLS echo requests to be sent with each of the destination addresses is determined by the -c count keyword.
end-address: Specifies the end destination address. This address must be an address on subnet 127.0.0.0/8—a local loopback address.
address-increment: Specifies the increment value by which the destination address in the IP header increases in turn. The value range is 1 to 16777215 and the default value is 1.
fec-type: Specifies the FEC type of the MPLS LSPs to be verified. If you do not specify this keyword, the FEC type is the protocol type of the specified FEC in the routing table.
generic: Represents LSPs of any FEC type.
is-is: Represents IS-IS signaled SRLSPs.
ldp: Represents LDP signaled LSPs.
ospf: Represents OSPF signaled SRLSPs.
Examples
# Verify the connectivity of LSPs to destination 3.3.3.9/32.
<Sysname> ping mpls ipv4 3.3.3.9 32
MPLS ping FEC 3.3.3.9/32 with 100 bytes of data:
100 bytes from 100.1.2.1: Sequence=1 time=49 ms
100 bytes from 100.1.2.1: Sequence=2 time=44 ms
100 bytes from 100.1.2.1: Sequence=3 time=60 ms
100 bytes from 100.1.2.1: Sequence=4 time=60 ms
100 bytes from 100.1.2.1: Sequence=5 time=76 ms
--- Ping statistics for FEC 3.3.3.9/32 ---
5 packets transmitted, 5 packets received, 0.0% packet loss
Round-trip min/avg/max = 44/57/76 ms
# Verify the connectivity of LSPs to destination 3.3.3.9/32, and specify the following parameters:
· Set the number of MPLS echo requests to be sent with the same destination address to 3.
· Display detailed reply information.
· Specify the range of destination addresses in IP headers as 127.0.0.1 to 127.0.0.3, and set the destination address increment value to 2. With these settings, the destination addresses are 127.0.0.1 and 127.0.0.3.
<Sysname> ping mpls –c 3 –v ipv4 3.3.3.9 32 destination 127.0.0.1 127.0.0.3 2
MPLS ping FEC 3.3.3.9/32 with 100 bytes of data:
Destination address 127.0.0.1
100 bytes from 100.1.2.1: Sequence=1 time=49 ms Return Code=3(1)
Destination address 127.0.0.3
100 bytes from 100.1.2.1: Sequence=2 time=44 ms Return Code=3(1)
Destination address 127.0.0.1
100 bytes from 100.1.2.1: Sequence=3 time=60 ms Return Code=3(1)
Destination address 127.0.0.3
100 bytes from 100.1.2.1: Sequence=4 time=60 ms Return Code=3(1)
Destination address 127.0.0.1
100 bytes from 100.1.2.1: Sequence=5 time=76 ms Return Code=3(1)
Destination address 127.0.0.3
100 bytes from 100.1.2.1: Sequence=6 time=57 ms Return Code=3(1)
--- Ping statistics for FEC 3.3.3.9/32 ---
6 packets transmitted, 6 packets received, 0.0% packet loss
Round-trip min/avg/max = 44/57/76 ms
|
Field |
Description |
|
MPLS Ping FEC: 3.3.3.9/32 with 100 bytes of data |
Verify LSP connectivity for FEC 3.3.3.9/32 by sending 100-byte MPLS echo requests. |
|
Destination address |
Destination IP address in the IP header. |
|
100 bytes from 100.1.2.1 |
Received a 100-byte reply from 100.1.2.1. |
|
Sequence |
Sequence number of the reply, for determination of packet loss, disorder, or duplicate. |
|
time |
Packet round-trip delay. |
|
Return Code |
Return code. The number in parentheses represents a return subcode. · 1—The received MPLS echo request packet has content errors. · 2—The packet contains an unsupported TLV. · 3—Reply from the egress node. · 5—Unmatching downstream mapping. · 6—The upstream did not provide the outgoing interface. · 8—Reply from the label switching node. · 10—The outgoing label for the FEC is inconsistent with that in the packet label stack. · 11—The label in the packet label stack does not have a matching forwarding entry. · 12—The protocol type of the FEC is inconsistent with that in the label forwarding table for the packet. |
|
Ping statistics for FEC 3.3.3.9/32 |
LSP verification statistics. |
|
packets transmitted |
Number of MPLS echo requests sent. |
|
packets received |
Number of MPLS echo replies received. |
|
packet loss |
Percentage of unreplied packets to total request packets. |
|
Round-trip min/avg/max |
Minimum, average, and maximum round-trip delays. |
ping mpls ipv6
Use ping mpls ipv6 to verify MPLS LSP connectivity for an IPv6 prefix.
Syntax
ping mpls [ -a source-ip6 | -c count | -tc traffic-class | -h ttl-value | -m wait-time | -r reply-mode | -s packet-size | -t time-out | -v ] * ipv6 ipv6-address prefix-length nexthop nexthop-address6 ] [ fec-type { generic | isis | ldp } ] [ nil-fec ]
Views
Any view
Predefined user roles
network-admin
Parameters
-a source-ip6: Specifies the source IPv6 address for MPLS echo request packets. If you do not specify this option, the device uses an IPv6 address of the outgoing interface as the source address for MPLS echo requests.
-c count: Specifies the number of MPLS echo requests to be sent with the same destination address in the IPv6 header. The value range is 1 to 4294967295. The default is 5.
-tc traffic-class: Specifies the traffic class (TC) value for MPLS echo request packets. The value range is 0 to 255. The default is 0.
-h ttl-value: Specifies the TTL value for MPLS echo request packets. The value range is 1 to 255. The default is 255.
-m wait-time: Specifies the interval (in milliseconds) for sending consecutive MPLS echo request packets. The value range is 1 to 10000. The default is 200.
-r reply-mode: Specifies the reply mode of the receiver in response to MPLS echo request packets. The value range for the reply-mode argument is 1 to 3. A value of 1 means "Do not reply." A value of 2 means "Reply by using a UDP packet." A value of 3 means "Reply by using a UDP packet that carries the Router Alert option. The default is 2.
-s packet-size: Specifies the length (in bytes) of an MPLS echo request packet, excluding the IPv6 and UDP headers. The value range for the packet-size argument is 65 to 8100. The default is 100.
-t time-out: Specifies the timeout interval (in milliseconds) for the reply to an MPLS echo request. The value range is 0 to 65535. The default is 2000.
-v: Displays detailed reply information. If you do not specify this keyword, the command displays brief reply information.
ipv6-address prefix-length: Checks the connectivity of the specified IPv6 LSP. The ipv6-address argument specifies the destination address of the FEC. The prefix-length argument specifies the prefix length of the destination address, in the range of 0 to 128.
nexthop nexthop-address6: Specifies the IPv6 address of a next hop. When a FEC has multiple next hops, use this option to specify a particular next hop.
fec-type: Specifies the FEC type used for checking the connectivity of the MPLS LSPs to the specified IPv6 prefix. If you do not specify this parameter, the FEC type is the protocol type for the FEC in the routing table.
· generic: Specifies any types of IPv6 LSPs.
· isis: Specifies IPv6 IS-IS SRLSPs.
· ldp: Specifies IPv6 LDP LSPs.
Examples
# Check the connectivity of the LSP to 3::9/128.
<Sysname> ping mpls ipv6 3::9 128
MPLS ping FEC 3::9/128 with 100 bytes of data:
100 bytes from 100::1: Sequence=1 time=49 ms
100 bytes from 100::1: Sequence=2 time=44 ms
100 bytes from 100::1: Sequence=3 time=60 ms
100 bytes from 100::1: Sequence=4 time=60 ms
100 bytes from 100::1: Sequence=5 time=76 ms
--- Ping statistics for FEC 3::9/128 ---
5 packets transmitted, 5 packets received, 0.0% packet loss
Round-trip min/avg/max = 44/57/76 ms
# Check the connectivity of the LSP to 3::9/128, with the following parameters specified:
· Resend MPLS echo requests with the same destination address in the IPv6 header three times.
· Display detailed reply information.
· Set the next hop address to 20::2.
<Sysname> ping mpls –c 3 –v ipv6 3::9 128 nexthop 20::2
MPLS ping FEC 3::9/128 with 100 bytes of data:
100 bytes from 100::1: Sequence=1 time=49 ms
100 bytes from 100::1: Sequence=2 time=44 ms
100 bytes from 100::1: Sequence=3 time=60 ms
--- Ping statistics for FEC 3::9/128 ---
3 packets transmitted, 3 packets received, 0.0% packet loss
Round-trip min/avg/max = 44/57/76 ms
Table 2 Command output
|
Field |
Description |
|
MPLS Ping FEC: 3::9/128 with 100 bytes of data |
The device sent a 100-byte MPLS echo request to check the connectivity of the IPv6 LSP for the FEC with destination address 3::9/128. |
|
100 bytes from 100::1 |
The device received a 100-byte reply from 100::1. |
|
Sequence |
Sequence number of the reply. This information helps detect packet loss, disorder, or duplication. |
|
time |
Packet round-trip delay. |
|
Return Code |
Return code. The number in parentheses represents a return subcode. · 1—The received MPLS echo request packet has content errors. · 2—The packet contains an unsupported TLV. · 3—Reply from the egress node. · 5—Downstream mapping mismatch. · 6—The upstream did not provide outgoing interface information. · 8—Reply from a label switching node. · 10—The outgoing label for the FEC is inconsistent with that in the packet label stack. · 11—The label in the packet label stack does not have a matching forwarding entry. · 12—The protocol type of the FEC is inconsistent with that in the label forwarding table for the packet. |
|
Ping statistics for FEC 3::9/128 |
LSP verification statistics. |
|
packets transmitted |
Number of MPLS echo requests sent. |
|
packets received |
Number of MPLS echo replies received. |
|
packet loss |
Percentage of unreplied packets in total request packets. |
|
Round-trip min/avg/max |
Minimum, average, and maximum round-trip delays. |
ping mpls out-labels
Use ping mpls out-labels to verify the MPLS LSP of the specified outgoing labels.
Syntax
ping mpls [ -a source-ip | -c count | -exp exp-value | -h ttl-value | -m wait-time | -r reply-mode | -rtos tos-value | -s packet-size | -t time-out | -v ] * out-labels out-label-value&<1-n> interface interface-type interface-number [ nexthop nexthop-address ]
Views
Any view
Predefined user roles
network-admin
Parameters
-a source-ip: Specifies the source address of MPLS echo request packets. If you do not specify this option, the device uses the primary IP address of the outgoing interface as the source address of MPLS echo requests.
-c count: Specifies the number of MPLS echo request packets to be sent with the same destination address in the IP header. The value range is 1 to 4294967295. The default is 5.
-exp exp-value: Specifies the EXP value of MPLS echo request packets, in the range of 0 to 7. The default is 0.
-h ttl-value: Specifies the TTL value of MPLS echo request packets, in the range of 1 to 255. The default is 255.
-m wait-time: Specifies the interval for sending MPLS echo request packets, in the range of 1 to 10000 milliseconds. The default is 200 milliseconds.
-r reply-mode: Specifies the reply mode of the receiver in response to MPLS echo request packets. The reply-mode argument can be 1, 2, 3, or 4. The default is 2.
· 1—Do not reply.
· 2—Reply by using a UDP packet.
· 3—Reply by using a UDP packet that carries the Router Alert option.
· 4—Reply by using a VCCV packet. The reply mode 4 is not available for MPLS LSP connectivity verification. If the reply mode 4 is specified, the remote end does not reply.
-rtos tos-value: Specifies the ToS value in the IP header of an MPLS echo reply packet. The value range is 0 to 7, and the default value is 6.
-s packet-size: Specifies the length (excluding the IP header and UDP header) of an MPLS echo request packet. The value for the packet-size argument is 65 to 8100 bytes, and the default is 100 bytes.
-t time-out: Specifies the timeout interval for the reply to an MPLS echo request. The value range is 0 to 65535 milliseconds, and the default is 2000 milliseconds.
-v: Displays detailed reply information. If you do not specify this keyword, the command displays brief reply information.
out-labels out-label-value&<1-n>: Specifies a space-separated list of up to n outgoing labels, corresponding to the labels from top to bottom in the label stack. The value range for the out-label-value argument is 0, 3, and 16 to 1048575. The value for n is 5.
interface interface-type interface-number: Specifies the outgoing interface by the interface type and number.
nexthop nexthop-address: Specifies the next hop IP address.
Usage guidelines
To verify connectivity of a specific LSP, first execute the display mpls lsp command to identify the outgoing interface and next hop for the outgoing labels to be specified.
Examples
# In an LDP network, verify the connectivity of the LSP with outgoing label 2173, outgoing interface VLAN-interface 10, and next hop IP address 10.1.1.2/32.
<Sysname> ping mpls out-labels 2173 interface vlan-interface 10 nexthop 10.1.1.2
MPLS ping out-labels 2173 with 100 bytes of data:
100 bytes from 20.1.1.2: Sequence=1 time=1 ms
100 bytes from 20.1.1.2: Sequence=2 time=1 ms
100 bytes from 20.1.1.2: Sequence=3 time=1 ms
100 bytes from 20.1.1.2: Sequence=4 time=1 ms
100 bytes from 20.1.1.2: Sequence=5 time=1 ms
--- Ping statistics for out-labels ---
5 packets transmitted, 5 packets received, 0.0% packet loss
Round-trip min/avg/max = 1/1/1 ms
<Sysname>%Oct 11 09:26:52:882 2018 Sysname LSPV/6/LSPV_PING_STATIS_INFO: Ping statistics for out-labels 2173: 5 packets transmitted, 5 packets received, 0.0% packets loss, round-trip min/avg/max = 1/1/1 ms.
# In an SR-MPLS to LDP interworking network, configure the source node to verify the LSP with outgoing label 17030, outgoing interface VLAN-interface 20, and next hop 100.1.1.2/32.
<Sysname> ping mpls out-labels 17030 interface vlan-interface 20 nexthop 100.1.1.2
MPLS ping out-labels 17030 with 100 bytes of data:
100 bytes from 20.1.1.2: Sequence=1 time=3 ms
100 bytes from 20.1.1.2: Sequence=2 time=2 ms
100 bytes from 20.1.1.2: Sequence=3 time=2 ms
100 bytes from 20.1.1.2: Sequence=4 time=2 ms
100 bytes from 20.1.1.2: Sequence=5 time=1 ms
--- Ping statistics for out-labels ---
5 packets transmitted, 5 packets received, 0.0% packet loss
Round-trip min/avg/max = 1/2/3 ms
<Sysname>%Oct 11 10:12:45:434 2018 Sysname LSPV/6/LSPV_PING_STATIS_INFO: Ping statistics for out-labels 17030: 5 packets transmitted, 5 packets received, 0.0% packets loss, round-trip min/avg/max = 1/2/3 ms.
Table 3 Command output
|
Field |
Description |
|
MPLS ping out-labels out-label-value with 100 bytes of data |
Verify LSP connectivity for the specified outgoing labels (out-label-value) by sending 100-byte MPLS echo requests. |
|
100 bytes from 20.1.1.2 |
Received a 100-byte reply from 20.1.1.2. |
|
Sequence |
Sequence number of the reply, for determination of packet loss, disorder, or duplicate. |
|
time |
Packet round-trip delay. |
|
Return Code |
Return code. The number in parentheses represents a return subcode. · The received MPLS echo request packet has content errors. · 2—The packet contains an unsupported TLV. · 3—Reply from the egress node. · 5—Unmatching downstream mapping. · 6—The upstream did not provide the outgoing interface. · 8—Reply from the label switching node. · 10—The outgoing label for the FEC is inconsistent with that in the packet label stack. · 11—The label in the packet label stack does not have a matching forwarding entry. · 12—The protocol type of the FEC is inconsistent with that in the label forwarding table for the packet. |
|
Ping statistics for out-labels |
LSP verification statistics. |
|
packets transmitted |
Number of MPLS echo requests sent. |
|
packets received |
Number of MPLS echo replies received. |
|
packet loss |
Percentage of unreplied packets to total request packets. |
|
Round-trip min/avg/max |
Minimum, average, and maximum round-trip delay. |
ping mpls te
Use ping mpls te to verify MPLS TE tunnel connectivity.
Syntax
ping mpls [ -a source-ip | -c count | -exp exp-value | -h ttl-value | -m wait-time | -r reply-mode | -rtos tos-value | -s packet-size | -t time-out | -v ] * te tunnel interface-number
Views
Any view
Predefined user roles
network-admin
Parameter
-a source-ip: Specifies the source address of MPLS echo request packets. If you do not specify this option, the device uses the primary IP address of the outgoing interface as the source address of MPLS echo requests.
-c count: Specifies the number of MPLS echo request packets to be sent, in the range of 1 to 4294967295. The default is 5.
-exp exp-value: Specifies the EXP value of MPLS echo request packets, in the range of 0 to 7. The default is 0.
-h ttl-value: Specifies the TTL value of MPLS echo request packets, in the range of 1 to 255. The default is 255.
-m wait-time: Specifies the interval for sending MPLS echo request packets, in the range of 1 to 10000 milliseconds. The default is 200 milliseconds.
-r reply-mode: Specifies the reply mode of the receiver in response to MPLS echo request packets. The reply-mode argument can be 1, 2, 3, or 4. The default is 2.
· 1—Do not reply.
· 2—Reply by using a UDP packet.
· 3—Reply by using a UDP packet that carries the Router Alert option.
· 4—Reply by using a VCCV packet. The reply mode 4 is not available for MPLS TE tunnel connectivity verification. If the mode is specified, the remote end does not reply.
-rtos tos-value: Specifies the ToS value in the IP header of an MPLS echo reply packet. The value range is 0 to 7, and the default is 6.
-s packet-size: Specifies the length (excluding the IP header and UDP header) of an MPLS echo request packet. The value range for the packet-size argument is 65 to 8100 bytes, and the default is 100 bytes.
-t time-out: Specifies the timeout interval for the reply to an MPLS echo request. The value range is 0 to 65535 milliseconds, and the default is 2000 milliseconds.
-v: Displays detailed reply information. If you do not specify this keyword, the command displays brief reply information.
tunnel interface-number: Specifies an MPLS TE tunnel interface by the interface number. The specified MPLS TE tunnel interface must have already been created.
Examples
# Verify the connectivity of the MPLS TE tunnel for Tunnel 1.
<Sysname> ping mpls te tunnel 1
MPLS ping TE tunnel Tunnel1 with 100 bytes of data:
100 bytes from 100.1.2.1: Sequence=1 time=49 ms
100 bytes from 100.1.2.1: Sequence=2 time=44 ms
100 bytes from 100.1.2.1: Sequence=3 time=60 ms
100 bytes from 100.1.2.1: Sequence=4 time=60 ms
100 bytes from 100.1.2.1: Sequence=5 time=76 ms
--- Ping statistics for TE tunnel Tunnel1 ---
5 packets transmitted, 5 packets received, 0.0% packet loss
Round-trip min/avg/max = 44/57/76 ms
For the command output, see Table 1.
tracert mpls ipv4
Use tracert mpls ipv4 to trace MPLS LSPs from the ingress node to the egress node for an IPv4 prefix. You can locate the error node according to the reply information.
Syntax
tracert mpls [ -a source-ip | -exp exp-value | -h ttl-value | -r reply-mode | -rtos tos-value | -t time-out | -v | ddmap | fec-check ] * ipv4 ipv4-address mask-length [ destination start-address [ end-address [ address-increment ] ] ] [ fec-type { generic | isis | ldp | ospf } ]
Views
Any view
Predefined user roles
network-admin
Parameters
-a source-ip: Specifies the source address for MPLS echo request packets. If you do not specify this option, the command uses the primary IP address of the outgoing interface as the source address for MPLS echo requests.
-exp exp-value: Specifies the EXP value for MPLS echo request packets, in the range of 0 to 7. The default is 0.
-h ttl-value: Specifies the maximum TTL value for MPLS echo request packets (the maximum number of hops to be inspected). The value range for the ttl-value argument is 1 to 255, and the default is 30.
-r reply-mode: Specifies the reply mode of the receiver in response to MPLS echo request packets. The reply-mode argument can be 1, 2, or 3. 1 means "Do not reply," 2 means "Reply by using a UDP packet," and 3 means "reply by using a UDP packet that carries the Router Alert option." The default is 2.
-rtos tos-value: Specifies the ToS value in the IP header of an MPLS echo reply packet. The value range is 0 to 7, and the default value is 6.
-t time-out: Specifies the timeout interval for the reply to an MPLS echo request. The value range is 0 to 65535 milliseconds, and the default is 2000 milliseconds.
-v: Displays detailed reply information. If you do not specify this keyword, the command displays brief reply information.
ddmap: Encapsulates the Downstream Detailed Mapping (DDMAP) TLV in MPLS echo reply and MPLS echo request packets. If you do not specify this keyword, Downstream Mapping TLV (DSMAP) will be encapsulated in these packets. DDMAP TLV and DSMAP TLV carry the downstream information of the current node, including the next hop address and outgoing label. When you perform MPLS tracert operations, the device will verify the next hop address and outgoing label in the DDMAP TLV and DSMAP TLV. If both the address and label are correct, the device sends a normal MPLS echo reply to the ingress node. If the address or label is incorrect, the device sends an MPLS echo reply with an error code to the ingress node.
fec-check: Checks the FEC stack at transit nodes.
ipv4-address mask-length: Specifies a FEC by an IPv4 destination address and a mask length. The value range for the mask-length argument is 0 to 32.
destination: Specifies the destination address in the IP header of MPLS echo requests. The default is 127.0.0.1.
start-address: Specifies the destination address or the start destination address. This address must be an address on subnet 127.0.0.0/8—a local loopback address. If you specify the start-address argument without the end-address argument, the start-address is the destination address in the IP header. If you specify both start-address and end-address, you specify a range of destination addresses. The destination address increments by the value specified for the address-increment argument, starting from the start-address to the end-address. The command performs a tracert for each of the destination addresses.
end-address: Specifies the end destination address. This address must be an address on subnet 127.0.0.0/8—a local loopback address.
address-increment: Specifies the increment value by which the destination address in the IP header increases in turn. The value range is 1 to 16777215 and the default value is 1.
fec-type: Specifies the FEC type to be carried in an MPLS echo request packet. If you do not specify this keyword, the FEC type is the protocol type of the specified FEC in the routing table.
generic: Represents LSPs of any FEC type.
is-is: Represents IS-IS signaled SRLSPs.
ldp: Represents LDP signaled LSPs.
ospf: Represents OSPF signaled SRLSPs.
Examples
# Trace the path that the LSP (for FEC 5.5.5.9/32) traverses from the ingress node to the egress node. Specify the IP header destination address range as 127.1.1.1 to 127.1.1.2 and set the address increment value to 1. With these settings, the device performs a tracert for 127.1.1.1 and 127.1.1.2.
<Sysname> tracert mpls ipv4 5.5.5.9 32 destination 127.1.1.1 127.1.1.2 1
MPLS trace route FEC 5.5.5.9/32
Destination address 127.1.1.1
TTL Replier Time Type Downstream
0 Ingress 100.1.2.1/[1025]
1 100.1.2.1 1 ms Transit 100.2.4.1/[1024]
2 100.2.4.1 63 ms Transit 100.4.5.1/[3]
3 100.4.5.1 129 ms Egress
Destination address 127.1.1.2
TTL Replier Time Type Downstream
0 Ingress 100.1.3.1/[1030]
1 100.1.3.1 1 ms Transit 100.3.4.1/[1024]
2 100.3.4.1 51 ms Transit 100.4.5.1/[3]
3 100.4.5.1 80 ms Egress
# Trace the path that the LSP (for FEC 5.5.5.9/32) traverses from the ingress node to the egress node. Display detailed reply information, specify the IP header destination address range as 127.1.1.1 to 127.1.1.2, and set the address increment value to 1. With these settings, the device performs a tracert for 127.1.1.1 and 127.1.1.2.
<Sysname> tracert mpls –v ipv4 5.5.5.9 32 destination 127.1.1.1 127.1.1.2 1
MPLS trace route FEC 5.5.5.9/32
Destination address 127.1.1.1
TTL Replier Time Type Downstream
0 Ingress 100.1.2.1/[1025]
1 100.1.2.1 1 ms Transit 100.2.4.1/[1024] ReturnCode 8(1)
2 100.2.4.1 63 ms Transit 100.4.5.1/[3] ReturnCode 8(1)
3 100.4.5.1 129 ms Egress ReturnCode 3(1)
Destination address 127.1.1.2
TTL Replier Time Type Downstream
0 Ingress 100.1.3.1/[1030]
1 100.1.3.1 1 ms Transit 100.3.4.1/[1024] ReturnCode 8(1)
2 100.3.4.1 51 ms Transit 100.4.5.1/[3] ReturnCode 8(1)
3 100.4.5.1 80 ms Egress ReturnCode 3(1)
|
Field |
Description |
|
MPLS trace route FEC |
Trace the LSPs for the specified FEC. |
|
Destination address |
Destination IP address in the IP header. |
|
TTL |
Number of hops. |
|
Replier |
Address of the LSR that replied the request. |
|
Time |
Time used to receive the reply, in milliseconds. |
|
Type |
LSR type: Ingress, Transit, or Egress. |
|
Downstream |
Address of the downstream LSR and the label assigned by the downstream LSR. |
|
ReturnCode |
Return code. The number in parentheses represents a return subcode. · The received MPLS echo request packet has content errors. · 2—The packet contains an unsupported TLV. · 3—Reply from the egress node. · 5—Unmatching downstream mapping. · 6—The upstream did not provide the outgoing interface. · 8—Reply from the label switching node. · 10—The outgoing label for the FEC is inconsistent with that in the packet label stack. · 11—The label in the packet label stack does not have a matching forwarding entry. · 12—The protocol type of the FEC is inconsistent with that in the label forwarding table for the packet. |
tracert mpls ipv6
Use tracert mpls ipv6 to trace the paths of MPLS LSPs from the ingress node to the egress node for an IPv6 prefix. Then, use the reply information to locate the error node.
Syntax
tracert mpls [ -a source-ip6 | -tc traffic-class | -h ttl-value | -r reply-mode | -t time-out | -v ] * ipv6 ipv6-address prefix-length [ nexthop nexthop-address6 ] [ fec-type { generic | isis | ldp } ] [ nil-fec ]
Views
Any view
Predefined user roles
network-admin
Parameters
-a source-ip6: Specifies the source IPv6 address for MPLS echo request packets. If you do not specify this option, the device uses an IPv6 address of the outgoing interface as the source address for MPLS echo requests.
-tc traffic-class: Specifies the traffic class (TC) value for MPLS echo request packets. The value range is 0 to 255. The default is 0.
-h ttl-value: Specifies the maximum number of hops to inspect by specifying a TTL value for MPLS echo request packets. The value range is 1 to 255. The default is 30.
-r reply-mode: Specifies the reply mode of the receiver in response to MPLS echo request packets. The reply-mode argument can be set to 2 or 3. A value of 2 means "Reply by using a UDP packet." A value of 3 means "Reply by using a UDP packet that carries the Router Alert option. The default is 2.
-t time-out: Specifies the timeout interval (in milliseconds) for the reply to an MPLS echo request. The value range is 0 to 65535. The default is 2000.
-v: Displays detailed reply information. If you do not specify this keyword, the command displays brief reply information.
ipv6-address prefix-length: Checks the connectivity of the specified IPv6 LSP. The ipv6-address argument specifies the destination address of the FEC. The prefix-length argument specifies the prefixes in of the destination address, in the range of 0 to 128.
nexthop nexthop-address6: Specifies the IPv6 address of a next hop. When a FEC has multiple next hops, use this option to specify a particular next hop.
fec-type: Specifies the FEC type set in the MPLS echo requests sent. If you do not specify this parameter, the FEC type is the protocol type for the FEC in the routing table.
· generic: Specifies any types of IPv6 LSPs.
· isis: Specifies IPv6 IS-IS SRLSPs.
· ldp: Specifies IPv6 LDP LSPs.
Examples
# Trace the path of the LSP from the ingress node to the egress node for reaching destination address 5::9/128.
<Sysname> tracert mpls ipv6 5::9 128
MPLS trace route FEC 5::9/128
Hop Replier Time Type Downstream
0 Ingress 100:1::1/[1025]
1 100:1::1 1 ms Transit 100:2::1/[1024]
2 100:2::1 63 ms Transit 100:4::1/[1023]
3 100:4::1 129 ms Egress
Table 5 Command output
|
Field |
Description |
|
MPLS trace route FEC |
Traced the LSPs for the specified FEC. |
|
Hop |
Hop count. |
|
Replier |
Address of the responding LSR. |
|
Time |
Delay to receive the response, in milliseconds. |
|
Type |
LSR type: · Ingress—Ingress node. · Transit—Transit node. · Egress—Egress node. |
|
Downstream |
Address of the downstream LSR and outgoing label value (the label assigned by the downstream LSR). |
|
ReturnCode |
Return code. The number in parentheses represents a return subcode. · 1—The received MPLS echo request packet has content errors. · 2—The packet contains an unsupported TLV. · 3—Reply from the egress node. · 5—Downstream mapping mismatch. · 6—The upstream did not provide outgoing interface information. · 8—Reply from a label switching node. · 10—The outgoing label for the FEC is inconsistent with that in the packet label stack. · 11—The label in the packet label stack does not have a matching forwarding entry. · 12—The protocol type of the FEC is inconsistent with that in the label forwarding table for the packet. |
tracert mpls out-labels
Use tracert mpls out-labels to trace MPLS LSPs of the specified outgoing labels from the ingress node to the egress node of the LSPs. You can locate the error node according to the reply information.
Syntax
tracert mpls [ -a source-ip | -exp exp-value | -h ttl-value | -r reply-mode | -rtos tos-value | -t time-out | -v | fec-check ]* out-labels out-label-value&<1-n> interface interface-type interface-number [ nexthop nexthop-address ]
Views
Any view
Predefined user roles
network-admin
Parameters
-a source-ip: Specifies the source address of MPLS echo request packets. If you do not specify this option, the device uses the primary IP address of the outgoing interface as the source address of MPLS echo requests.
-exp exp-value: Specifies the EXP value of MPLS echo request packets, in the range of 0 to 7. The default is 0.
-h ttl-value: Specifies the maximum TTL value of MPLS echo request packets (the maximum number of hops to be inspected). The value range for the ttl-value argument is 1 to 255, and the default is 30.
-r reply-mode: Specifies the reply mode of the receiver in response to MPLS echo request packets. The reply-mode argument can be 2 or 3. The default is 2.
· 2—Reply by using a UDP packet.
· 3—Reply by using a UDP packet that carries the Router Alert option.
-rtos tos-value: Specifies the ToS value in the IP header of an MPLS echo reply packet. The value range is 0 to 7, and the default value is 6.
-t time-out: Specifies the timeout interval for the reply to an MPLS echo request. The value range is 0 to 65535 milliseconds, and the default is 2000 milliseconds.
-v: Displays detailed reply information. If you do not specify this keyword, the command displays brief reply information.
out-labels out-label-value&<1-n>: Specifies a space-separated list of up to n outgoing labels, corresponding to the labels from top to bottom in the label stack. The value range for the out-label-value argument is 0, 3, and 16 to 1048575. The value for n is 5.
interface interface-type interface-number: Specifies the outgoing interface by the interface type and number.
nexthop nexthop-address: Specifies the next hop IP address.
Usage guidelines
To trace a specific LSP, first execute the display mpls lsp command to identify the outgoing interface and next hop for the outgoing labels to be specified.
Examples
# In an LDP network, trace the path of the LSP with outgoing label 2173, outgoing interface VLAN-interface 10, and next hop IP address 10.1.1.2/32.
<Sysname> tracert mpls out-labels 2173 interface vlan-interface 10 nexthop 10.1.1.2
MPLS trace route out-labels 2173
TTL Replier Time Type Downstream
0 Ingress 10.1.1.2/[2173]
1 10.1.1.2 1 ms Transit 20.1.1.2/[1040127]
2 20.1.1.2 1 ms Egress
# In an SR-MPLS to LDP interworking network, trace the LSP with outgoing label 17030, outgoing interface VLAN-interface 20, and next hop 100.1.1.2/32 on the source node.
<Sysname> tracert mpls out-labels 17030 interface vlan-interface 20 nexthop 100.1.1.2
MPLS trace route out-labels 17030
TTL Replier Time Type Downstream
0 Ingress 100.1.1.2/[17030]
1 100.1.1.2 1 ms Transit 10.1.1.2/[2173]
2 10.1.1.2 2 ms Transit 20.1.1.2/[1040127]
3 20.1.1.2 1 ms Egress
Table 6 Command output
|
Field |
Description |
|
MPLS trace route out-labels out-label-value |
Trace the LSPs for the specified outgoing labels. |
|
TTL |
Number of hops. |
|
Replier |
IP address of the LSR that replied the request. |
|
Time |
Packet round-trip delay, in milliseconds. |
|
Type |
LSR type: Ingress, Transit, or Egress. |
|
Downstream |
Address of the downstream LSR and the outgoing label (label assigned by the downstream LSR). |
|
Return Code |
Return code. The number in parentheses represents a return subcode. · The received MPLS echo request packet has content errors. · 2—The packet contains an unsupported TLV. · 3—Reply from the egress node. · 5—Unmatching downstream mapping. · 6—The upstream did not provide the outgoing interface. · 8—Reply from the label switching node. · 10—The outgoing label for the FEC is inconsistent with that in the packet label stack. · 11—The label in the packet label stack does not have a matching forwarding entry. · 12—The protocol type of the FEC is inconsistent with that in the label forwarding table for the packet. |
tracert mpls te
Use tracert mpls te to trace an MPLS TE tunnel from the ingress node to the egress node. You can locate the error node according to the reply information.
Syntax
tracert mpls [ -a source-ip | -exp exp-value | -h ttl-value | -r reply-mode | -rtos tos-value | -t time-out | -v | fec-check ] * te tunnel interface-number
Views
Any view
Predefined user roles
network-admin
Parameters
-a source-ip: Specifies the source address of MPLS echo request packets. If you do not specify this option, the command uses the primary IP address of the outgoing interface as the source address of MPLS echo requests.
-exp exp-value: Specifies the EXP value of MPLS echo request packets, in the range of 0 to 7. The default is 0.
-h ttl-value: Specifies the maximum TTL value of MPLS echo request packets (the maximum number of hops to be inspected). The value range for the ttl-value argument is 1 to 255, and the default is 30.
-r reply-mode: Specifies the reply mode of the receiver in response to MPLS echo request packets. The reply-mode argument can be 2 or 3. 2 means "Reply by using a UDP packet," and 3 means "reply by using a UDP packet that carries the Router Alert option." The default is 2.
-rtos tos-value: Specifies the ToS value in the IP header of an MPLS echo reply packet. The value range is 0 to 7, and the default value is 6.
-t time-out: Specifies the timeout interval for the reply to an MPLS echo request. The value range is 0 to 65535 milliseconds, and the default is 2000 milliseconds.
-v: Displays detailed reply information. If you do not specify this keyword, the command displays brief reply information.
fec-check: Checks the FEC stack at transit nodes.
tunnel interface-number: Specifies an existing MPLS TE tunnel interface by the interface number.
Examples
# Trace the path that MPLS TE tunnel 1 traverses from the ingress node to the egress node.
<Sysname> tracert mpls te tunnel 1
MPLS trace route TE tunnel Tunnel1
TTL Replier Time Type Downstream
0 Ingress 10.4.5.1/[1025]
1 10.4.5.1 1 ms Transit 100.3.4.1/[1024]
2 100.3.4.1 63 ms Transit 100.1.2.1/[3]
3 100.1.2.1 129 ms Egress
For the command output, see Table 4.
