ping evpn vpws

Function

The ping evpn vpws command checks EVPN VPWS network connectivity.

Format

Parameters

Parameter	Description	Value
local-ce-id	Specifies a local EVPN VPWS ID.	The value is an integer ranging from 1 to 16777215.
remote-ce-id	Specifies a remote EVPN VPWS ID.	The value is an integer ranging from 1 to 16777215.
vpn-instance evpn-name	Specifies the name of an EVPN instance. This parameter needs to be specified if the local service ID is not globally unique.	The value is a string of 1 to 31 characters.
end-op endOp	Specifies the ID of an End.	The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.
control-word	Specifies that the sent packet carries a control word. This parameter needs to be configured in a cross-domain scenario.	-
-a source-ip	Specifies a source IP address for EVPN VPWS echo request packets. If the source address is not specified, the encapsulation source-address address is preferentially used in the SRv6 BE scenario. In other scenarios, the address of the outbound interface is used as the source address of EVPN VPWS echo request packets.	The value is in dotted decimal notation or a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.
-c count	Specifies the number of EVPN VPWS echo request packets to be sent. If the network quality is low, you can increase the parameter value to determine the network quality based on the packet loss rate.	The value is an integer ranging from 1 to 4294967295. The default value is 5.
-exp exp-value	Specifies the EXP value of EVPN VPWS echo request packets to be sent.	The value is an integer ranging from 0 to 7. The default value is 0.
-m interval	Specifies the waiting period for sending the next EVPN VPWS echo request packet. By default, if a device does not receive an EVPN VPWS echo reply packet within 2000 ms after it sends an EVPN echo request packet, the device sends another EVPN VPWS echo request packet. This parameter specifies an EVPN echo request packet sending interval. If the network quality is low, setting this parameter greater than or equal to 2000 ms is recommended.	The value is an integer ranging from 1 to 10000, in milliseconds. The default value is 2000.
-s packet-size	Specifies the size of a payload packet to be sent without the IP header or UDP head.	The value is an integer ranging from 80 to 9600, in bytes. The default value is 100.
-t timeout	Specifies a timeout period for waiting an EVPN VPWS echo reply packet after an EVPN VPWS echo request packet is sent.	The value is an integer ranging from 0 to 65535, in milliseconds. The default value is 2000.
-r reply-mode	Specifies the mode in which the peer responds with EVPN VPWS echo reply messages.	The value is 2 or 4. 2: reply with an IPv4 or IPv6 UDP packet 4: reply through the control channel of the application plane The default value is 2.
-tc tc	Specifies a traffic class for ICMP echo request messages.	The value is an integer ranging from 0 to 255. The default value is 0.
-service-class classValue	Specifies the parameter used to select the corresponding path in an SRv6 TE Policy group scenario.	The value is of the enumerated type. The value range is as follows: {be,af1,af2,af3,af4,ef,cs6,cs7}.

Views

All views

Default Level

2: Configuration level

Task Name and Operations

Task Name	Operations
tailmode1	execute

Usage Guidelines

Usage Scenario

If an EVPN VPWS LSP fails, you can run the ping evpn vpws command to check link connectivity and use the tracert evpn vpws command to locate the specific failure point.

EVPN VPWS ping checks EVPN VPWS connectivity by sending EVPN VPWS echo request and EVPN VPWS echo reply messages. Both types of packets are UDP packets transmitted using port 3503. The receive end uses the UDP port number to identify EVPN VPWS echo request and reply packets. An EVPN VPWS echo request message carries information about the forwarding equivalence class (FEC) for an EVPN VPWS tunnel to be monitored. The EVPN VPWS echo request message is forwarded with other service packets of the same FEC along the EVPN VPWS tunnel. This procedure enables EVPN VPWS connectivity check. EVPN VPWS echo request packets are transmitted to the destination along EVPN VPWS tunnels, whereas EVPN VPWS echo reply packets are transmitted to the source through IP.

Currently, EVPN VPWS ping supports only the MPLS public network. MPLS public networks supported include the LDP, TE, BGP LSP, SR-MPLS TE, SR-MPLS BE, SRv6 BE, and SRv6 TE Policy.

Precautions

In an E-Line smooth evolution scenario, if a control word is specified, no error message is displayed when EVPN routes are iterated to an SRv6 tunnel, and the sent packets are the same as those when no control word is specified.

The EVPN VPWS ping operation is terminated in the following situations:

The packet reaches the egress node.
The TTL reached the upper limit.
In the E-Line smooth evolution scenario, -r 4 cannot be specified to initiate a ping test.

Example

# Perform a ping operation on the EVPN VPWS network.

<HUAWEI> ping evpn vpws 2 1
  EVPN VPWS PING FEC: Local Evpn Vpws Id = 2, Remote Evpn Vpws Id = 1 : 100  data bytes, press CTRL_C to break
    Reply from 111::100: bytes=100 Sequence=1 time=2 ms
    Reply from 111::100: bytes=100 Sequence=2 time=2 ms
    Reply from 111::100: bytes=100 Sequence=3 time=1 ms
    Reply from 111::100: bytes=100 Sequence=4 time=1 ms
    Reply from 111::100: bytes=100 Sequence=5 time=2 ms

  --- FEC: Local CeId = 2, Remote CeId = 1 ping statistics ---
    5 packet(s) transmitted
    5 packet(s) received
    0.00% packet loss
    round-trip min/avg/max = 1/1/2 ms

**Table 1** Description of the **ping evpn vpws** command output
Item	Description
Local Evpn Vpws Id	Local EVPN VPWS ID.
Remote Evpn Vpws Id	Remote EVPN VPWS ID.
press CTRL_C to break	You can press CTRL+C to stop the ongoing ping test.
Reply from x.x.x.x	Response from the destination host to each Echo Request packet: bytes: indicates the length of the ICMP Echo Reply message. Sequence: indicates the sequence number of the ICMP Echo Reply message. time: indicates the response time, in ms. If no ICMP Echo Reply message is received when the timeout period expires, the message "Request time out" is displayed.
--- FEC: Local CeId = xx, Remote CeId = xx ping statistics ---	Ping statistics, including: packet(s) transmitted: number of echo request packets sent. packet(s) received: number of echo reply packets received. % packet loss: percentage of the number of echo request messages with no replies to the total number of echo request messages sent. round-trip min/avg/max: minimum, average, or maximum response time, in ms.
xx data bytes	Length of a sent packet, in bytes.