ping evpn

Function

The ping evpn command checks EVPN connectivity and whether EVPN tunnels forward data properly.

Format

Parameters

Parameter	Description	Value
mac mac-address	Specifies a destination MAC address.	The value is in the format of H-H-H.
-a source-ip	Specifies a source IP address for EVPN 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 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 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.	Specifies the number of EVPN 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.
-m interval	Specifies the waiting period for sending the next EVPN echo request packet. By default, if a device does not receive an EVPN echo reply packet within 2000 ms after it sends an EVPN echo request packet, the device sends another EVPN 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 100 to 9568, in bytes. The default value is 110.
-t time-out	Specifies a timeout period for waiting an EVPN echo reply packet after an EVPN 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 echo reply messages.	The value is an integer ranging from 1 to 4. The default value is 2. 1: indicates no reply. 2: indicates a reply with an IPv4 or IPv6 UDP packet. 3: a reply with an IPv4 or IPv6 UDP packet carrying the router-alert option. 4: a reply through the control channel on the application plane. Currently, only modes 2 and 4 are supported.
-nexthop nexthop-address	Specifies a next hop IP address.	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.
bridge-domain bd-id	Specifies a bridge domain (BD) ID.	The value is an integer ranging from 1 to 16777215.
vlan vlan-id	Specify a VLAN ID.	The value is an integer ranging from 1 to 4094.
vpn-instance evpn-name	Specifies the name of an EVPN instance.	The value is a string of 1 to 31 characters.

Views

All views

Default Level

0: Visit level

Task Name and Operations

Task Name	Operations
sla	execute

Usage Guidelines

Usage Scenario

To check EVPN LSPs and fast locate an EVPN tunnel forwarding fault, run the ping evpn command.

EVPN MAC ping checks EVPN connectivity by sending EVPN echo request and EVPN 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 echo request and reply packets. An EVPN echo request message carries information about the forwarding equivalence class (FEC) for an EVPN tunnel to be monitored. The EVPN echo request message is forwarded with other service packets of the same FEC along the EVPN tunnel. This procedure enables EVPN connectivity check. EVPN echo request packets are transmitted to the destination along EVPN tunnels, whereas EVPN echo reply packets are transmitted to the source through IP.

EVPN MAC ping can check the following tunnels.

EVPN public network type is MPLS (MPLS networks support only LDP and TE).
EVPN public network type is VXLAN.
EVPN public network type is SR(SR-MPLS BE or SR-MPLS TE).
EVPN public network type is BGP.
EVPN public network type is SRv6(SRv6 BE or SRv6 TE Policy).

Example

# Ping destination MAC address 00e0-fc12-3456 with a specified BD ID, sending three 200-byte echo request packets.

<HUAWEI> ping evpn bridge-domain 101 mac 00e0-fc12-3456 -c 3 -s 200
  Ping bridge-domain 101 mac 00e0-fc12-3456 : 200 data bytes, press CTRL_C to break  
    Reply from 1.1.1.1: bytes=200 sequence=1 time = 11ms    
    Reply from 1.1.1.1: bytes=200 sequence=2 time = 10ms    
    Reply from 1.1.1.1: bytes=200 sequence=3 time = 10ms  
  --- bridge-domain: 101 00e0-fc12-3456 ping statistics ---    
    3 packet(s) transmitted    
    3 packet(s) received    
    0.00% packet loss    
    round-trip min/avg/max = 10/10/11 ms

# Ping destination MAC address 00e0-fc12-3456 with a specified EVPN instance name, sending three 200-byte echo request packets.

<HUAWEI> ping evpn vpn-instance evpna mac 00e0-fc12-3456 -c 3 -s 200
  Ping vpn-instance evpna mac 00e0-fc12-3456 : 200 data bytes, press CTRL_C to break  
    Reply from 1.1.1.1: bytes=200 sequence=1 time = 11ms    
    Reply from 1.1.1.1: bytes=200 sequence=2 time = 10ms    
    Reply from 1.1.1.1: bytes=200 sequence=3 time = 10ms  
  --- vpn-instance: evpna 00e0-fc12-3456 ping statistics ---    
    3 packet(s) transmitted    
    3 packet(s) received    
    0.00% packet loss    
    round-trip min/avg/max = 10/10/11 ms

**Table 1** Description of the **ping evpn** command output
Item	Description
press CTRL_C to break	You can press CTRL+C to stop the ongoing ping test.
Reply from x.x.x.x	Reply from the destination host to each echo request packet, including: bytes: length of an echo reply packet. sequence: sequence number of an echo reply packet. time: delay after which the destination host responds with an echo reply packet, in ms. If no echo reply packet is received after the timeout period expires, "Request time out" is displayed.
--- vpn-instance: xxxx ping statistics ------ bridge-domain: xxxx 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.