tracert vpls

Function

The tracert vpls command detects the status of a PW or locates an abnormal node on a PW in Down state.

Format

tracert vpls [ -exp exp-value | -f first-ttl | -m max-ttl | -r reply-mode | -t timeout-value ]^* vsi vsi-name { local-site-id remote-site-id | peer peer-address [ negotiate-vc-id vc-id ] } [ full-lsp-path ]

Parameters

Parameter	Description	Value
-exp exp-value	Specifies the value of the EXP field in the outer label of an MPLS Echo Request packet.	The value is an integer that ranges from 0 to 7.
-f first-ttl	Specifies an initial TTL.	The value is an integer that ranges from 1 to 255 and must be smaller than the value of max-ttl. The default value is 1.
-m max-ttl	Specifies a maximum TTL.	The value is an integer that ranges from 1 to 255 and must be greater than the value of first-ttl. The default value is 30.
-r reply-mode	Specifies the mode for the peer end to return MPLS Echo Reply packets. The values are as follows: 1: indicates no reply. 2: indicates a reply with an IPv4 or IPv6 UDP datagram. 3: indicates a reply with an IPv4 or IPv6 UDP datagram carrying a router alert label. 4: indicates a reply through the control channel of the application plane.	The value is an integer that ranges from 1 to 4. The default value is 2.
-t timeout-value	Specifies the timeout period for waiting for an MPLS Echo Reply packet.	The value is an integer that ranges from 0 to 65535, in milliseconds. The default value is 5.
vsi vsi-name	Specifies the VPN name.	The value is an existing VSI.
local-site-id	Specifies the ID of the local CE.	The value is an integer that ranges from 0 to 65534.
remote-site-id	Specifies the ID of the remote CE.	The value is an integer that ranges from 0 to 65534.
full-lsp-path	Displays the responses from all nodes on the LSP that the MPLS Echo Request packets pass through. If this parameter is not specified, the responses from only the PW nodes along the LSP are displayed.	-
peer peer-address	Specifies the IP address of the peer PE.	-
negotiate-vc-id vc-id	Specifies the ID of the local PW.	The value is an integer that ranges from 1 to 4294967295.

Views

All views

Default Level

0: Visit level

Usage Guidelines

Usage Scenario

After the VPLS network is configured, if the VSI is in the Down state, you can run the tracert vpls command to locate the faulty device on the PW.

The tracert vpls command applies to the following networking scenarios:

VPLS networking
Based on VPLS types, VPLS PW tracert is classified into:
- Martini VPLS PW tracert
  
  Martini VPLS PW tracert only supports the label alert mode. On a Hierarchical Virtual Private LAN Service (HVPLS) network, only single-segment PWs can be detected. If a PW ID that is optional is set and specified, the PW with the specified PW ID is detected. If no PW ID is specified, the PW associated with the VSI ID is detected.
- Kompella VPLS PW tracert
  
  Kompella VPLS PW tracert only supports the label alert mode.
  
  After a faulty PW is detected using the ping vc command, run the tracert vc command to locate the fault. The ping vc and tracert vc commands can efficiently check PW connectivity and locate faults on PWs.

Prerequisites

One of the following operations has been performed before this command is used:

Configuring Kompella VPLS
Configuring Martini VPLS
Configuring BGP AD VPLS

Example

# Perform the tracert operation on the VPLS link with the remote site ID being 10.

<HUAWEI>tracert vpls vsi test 10 10 full-lsp-path
  TTL   Replier            Time    Type      Downstream 
  0                                Ingress   10.1.1.2/[4032 3 ]   
  1     10.0.0.181         7 ms    Egress

**Table 1** Description of the tracert vpls command output
Item	Description
TTL	TTL in an MPLS Echo Request packet. It indicates the number of hops through which an MPLS Echo Request packet passes from the source node to this node.
Replier	IP address of the node sending MPLS Echo Reply packets.
Time	Time that the packet is processed.
Type	Type of a node: Ingress: indicates an ingress node. Transit: indicates a transmit node. Egress: indicates an egress node.
Downstream	IP address and label of the downstream node.

# Perform the tracert operation to test the connectivity of the BGP AD VPLS PW.

<HUAWEI> tracert vpls vsi ad peer 10.2.2.2
  TTL   Replier            Time    Type      Downstream
  0                                Ingress   10.1.1.2/[1025 3 ]
  1     10.2.2.2            30 ms   Egress

**Table 2** Description of the tracert vpls command output
Item	Description
TTL	TTL in an MPLS Echo Request packet. It indicates the number of hops through which an MPLS Echo Request packet passes from the source node to this node.
Replier	IP address of the node sending MPLS Echo Reply packets.
Time	Time the packet is processed. That is, period from the time an MPLS Echo Request packet is sent to the time an MPLS Echo Reply packet is received.
Type	Type of a node: Ingress: indicates an ingress node. Transit: indicates a transmit node. Egress: indicates an egress node.
Downstream	IP address and label of the downstream node. The inner label and the outer label are arranged from left to right, both are outgoing labels.