ping vpls

Function

The ping vpls command detects the status of the PW and reachability of the peer.

Format

Parameters

Parameter	Description	Value
-c echo-number	Specifies the number of sent Echo Request packets.	The value is an integer that ranges from 1 to 4294967295. The default value is 5.
-m time-value	Specifies the time to wait before sending the next packet.	The value is an integer that ranges from 1 to 10000, in milliseconds. The default value is 2000 milliseconds.
-s data-bytes	Specifies the number of bytes of an Echo Request packet to be sent.	The value is an integer that ranges from 65 to 8100. The default value is 100.
-t timeout-value	Specifies the timeout period of sending Echo Request packets.	The value is an integer that ranges from 0 to 65535. The default value is 2000.
-r reply-mode	Specifies the mode in which the peer sends MPLS Echo Reply packets. The value is a decimal integer. 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 ranges from 1 to 4. The default value is 2.
-exp exp-value	Specifies the EXP value of an Echo Request packet to be sent.	The value is an integer that ranges from 0 to 7.
-v	Displays detailed information.	-
vsi vsi-name	Specifies the name of a VSI.	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.
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 VPLS configurations are complete, you can run the ping vpls command to check the PW status and reachability of the peer.

To check the PW status on a Kompella VPLS network, run the following command:
ping vpls [ -c echo-number | -m time-value | -s data-bytes | -t timeout-value | -r reply-mode | -exp exp-value | -v ] ^* vsi vsi-name local-site-id remote-site-id

.
To check the PW status on a Martini or BGP AD VPLS network, run the following command:
ping vpls [ -c echo-number | -m time-value | -s data-bytes | -t timeout-value | -r reply-mode | -exp exp-value | -v ] ^* vsi vsi-name peer peer-address [ negotiate-vc-id vc-id ]

.

Prerequisites

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

Configuring Kompella VPLS
Configuring Martini VPLS
Configuring BGP AD VPLS

Precautions

The timeout period specified by -t is less than the waiting time specified by -m.

Note the following points when configuring VPLS:

If negotiate-vc-id is not specified in the peer command, vc-id is unique and equal to vsi-id. To perform the ping operation, you do not need to specify vc-id because the VC is unique when vsi vsi-name and peer peer-address are specified. In the same case, however, if negotiate-vc-id is specified and it is not equal to the actual vc-id (that is, vsi-id), an error message is displayed.
If negotiate-vc-id (multiple VC IDs can be specified) in the peer command, you need to specify negotiate-vc-id in addition to vsi vsi-name and peer peer-address when performing the ping. If negotiate-vc-id is not found or specified, an error message is displayed.

Example

# Run the ping vpls command on the PE to check connectivity of the VSI named bgp1 with remote site ID being 10.

<HUAWEI> ping vpls -c 10 -m 10 -s 65 -t 100 -v vsi bgp1 10 10
    Reply from 10.2.2.2: bytes=65 Sequence=1 time=2 ms Return Code 3, Subcode 1 
    Reply from 10.2.2.2: bytes=65 Sequence=2 time=2 ms Return Code 3, Subcode 1 
    Reply from 10.2.2.2: bytes=65 Sequence=3 time=3 ms Return Code 3, Subcode 1 
    Reply from 10.2.2.2: bytes=65 Sequence=4 time=2 ms Return Code 3, Subcode 1 
    Reply from 10.2.2.2: bytes=65 Sequence=5 time=3 ms Return Code 3, Subcode 1 
    Reply from 10.2.2.2: bytes=65 Sequence=6 time=41 ms Return Code 3, Subcode 1 
    Reply from 10.2.2.2: bytes=65 Sequence=7 time=4 ms Return Code 3, Subcode 1 
    Reply from 10.2.2.2: bytes=65 Sequence=8 time=4 ms Return Code 3, Subcode 1 
    Reply from 10.2.2.2: bytes=65 Sequence=9 time=3 ms Return Code 3, Subcode 1 
    Reply from 10.2.2.2: bytes=65 Sequence=10 time=6 ms Return Code 3, Subcode 1 

  --- FEC: L2 VPN ENDPOINT. Sender VEID = 10, Remote VEID = 10 ping statistics ---
    10 packet(s) transmitted
    10 packet(s) received
    0.00% packet loss
    round-trip min/avg/max = 2/7/41 ms

**Table 1** Description of the ping vpls command output
Item	Description
Return Code	Return code. Different values have different meanings: 0: indicates that no return code is received. 1: indicates that an incorrect request is received. 2: indicates that an unknown TLV is received. 3: indicates that there is the outbound interface of one LSP. 4: indicates that there is no mapping on the response router. 5: indicates that the mapping does not match that on the downstream device. 6: indicates that an unknown upstream interface exists. 7: indicates that the field is reserved. 8: indicates label switching. 9: indicates label switching without MPLS forwarding. 10: indicates mapping without labels. 11: indicates the entity without labels. 12: indicates that no protocol is loaded on the interface. 13: indicates that the ping operation terminates because there is only one label.
Subcode	Subcode, indicating the number of layers of the labels. Usually, the value is 1.

# Run the ping vpls command on the PE to check the connectivity of a PW in the Martini VPLS.

<HUAWEI> ping vpls vsi a2 peer 10.2.2.2
    Reply from 10.2.2.2: bytes=100 Sequence=1 time=3 ms
    Reply from 10.2.2.2: bytes=100 Sequence=2 time=6 ms
    Reply from 10.2.2.2: bytes=100 Sequence=3 time=6 ms
    Reply from 10.2.2.2: bytes=100 Sequence=4 time=6 ms
    Reply from 10.2.2.2: bytes=100 Sequence=5 time=6 ms
   
  --- FEC: FEC 128 PSEUDOWIRE (NEW). Type = vlan, ID = 10 ping statistics --- 
    5 packet(s) transmitted
    5 packet(s) received
    0.00% packet loss
    round-trip min/avg/max = 3/4/6 ms

**Table 2** Description of the ping vpls command output
Item	Description
Reply from x.x.x.x	Response from the destination host to each Echo Request packet: bytes: indicates the length of the response packet. sequence: indicates the sequence number of the response packet. time: indicates the response time, in ms. If no response packet is received after the timeout period, the message "Request time out" is displayed.
FEC: FEC 128 PSEUDOWIRE	Check on FEC 128, namely, check on a Martini VPLS PW.
Type = vlan	VLAN encapsulation on packets.
ID = 10	The VSI ID being 10.

# Run the ping vpls command on the PE to check the connectivity of a PW in the BGP AD VPLS.

<HUAWEI> ping vpls vsi ad peer 10.2.2.2
    Reply from 10.2.2.2: bytes=100 Sequence=1 time=30 ms
    Reply from 10.2.2.2: bytes=100 Sequence=2 time=60 ms
    Reply from 10.2.2.2: bytes=100 Sequence=3 time=60 ms
    Reply from 10.2.2.2: bytes=100 Sequence=4 time=60 ms
    Reply from 10.2.2.2: bytes=100 Sequence=5 time=60 ms
   
 --- FEC: FEC 129 PSEUDOWIRE. Sender = 1.1.1.1, Remote = 10.2.2.2 ping statisti
cs ---
    5 packet(s) transmitted
    5 packet(s) received
    0.00% packet loss
    round-trip min/avg/max = 30/54/60 ms

**Table 3** Description of the ping vpls command output
Item	Description
Reply from x.x.x.x	Response from the destination host to each Echo Request packet: bytes: indicates the length of the response packet. sequence: indicates the sequence number of the response packet. time: indicates the response time, in ms. If no response packet is received after the timeout period, the message "Request time out" is displayed.
FEC: FEC 129 PSEUDOWIRE	Check on FEC 129, namely, check on a BGP AD VPLS PW.
Sender = x.x.x.x	Address of the sender.
Remote = x.x.x.x	Address of the destination host.