ping vpls mac

Function

The ping vpls mac command checks the connectivity of Layer 2 forwarding links on the VPLS network.

Format

Parameters

Parameter	Description	Value
mac-address	Specifies a unicast destination MAC address for a VPLS MAC ping.	The value is a hexadecimal number in the format of H-H-H. Each H contains one to four digits, such as 00e0 or fc01. If an H contains less than four digits, the left-most digits are padded with zeros. For example, e0 is displayed as 00e0. The value cannot be a broadcast or multicast MAC address.
vsi vsi-name	Specifies the name of a VSI to be detected.	The value is a string of 1 to 31 case-sensitive characters. It cannot contain spaces.
vlan vlan-id	Specifies a VLAN ID.	The value is an integer ranging from 1 to 4094.
-c count	Specifies the number of times MPLS Echo Request packets are sent in a common VPLS MAC ping. If the network quality is poor, 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.
-c rapidCount	Specifies the number of packets sent in fast mode.	The value is an integer ranging from 1 to 1000. The default value is 5.
-m time-value	Specifies the time to wait before sending the next MPLS Echo Request packet in a common VPLS MAC ping. If network quality is poor, setting this parameter to a value 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. The value of -m time-value must be greater than or equal to the value of -t timeout.
-s packetsize	Specifies the number of bytes of MPLS Echo Request packets to be sent.	The value is an integer ranging from 142 to 1442, in bytes. The default value is 142.
-t timeout	Specifies the timeout period for sending MPLS Echo Request packets.	The value is an integer ranging from 0 to 65535, in milliseconds. The default value is 2000.
-exp exp	Specifies the EXP value of the MPLS Echo Request packets to be sent.	The value is an integer ranging from 0 to 7. The default value is 0.
-r replymode	Specifies a mode in which the peer sends MPLS Echo Reply packets in response.	The value is an integer ranging from 1 to 5. The default value is 5. 1: Do not reply. 2: reply with an IPv4 or IPv6 UDP packet. 3: reply with an IPv4 or IPv6 UDP packet carrying the router-alert option. 4: reply through the control channel of the application plane. 5: reply with a VPLS UDP packet. Currently, only values 1, 2, and 5 are supported.
-h ttl	Specifies the TTL value of the Echo Request packets to be sent.	The value is an integer ranging from 1 to 255. The default value is 255.
-a source-ip-address	Specifies a source IP address.	The value is in dotted decimal notation.
-g	Indicates MPLS packet fragmentation.	-
rapid	Indicates VPLS MAC ping in fast mode. In this mode, all packets are sent at the same time and only summary information is displayed.	-

Views

All views

Default Level

0: Visit level

Task Name and Operations

Task Name	Operations
sla	execute

Usage Guidelines

Usage Scenario

Using the ping vpls mac command, you can check the connectivity of Layer 2 forwarding links on the VPLS network.

If you do not care about the details of each reply packet and expect more intensive detection, you can specify the rapid parameter. In this case, all packets are sent at the same time and only the summary information is displayed in the result.

Prerequisites

A VSI has been configured and is in the up state.

Example

# On a VPLS network, check whether the path with the VSI name a1 and MAC address 00e0-fc12-3456 is reachable and specify the rapid parameter. '!' indicates that the path is reachable; '.' indicates that the path is unreachable.

<HUAWEI> ping vpls mac 00e0-fc12-3456 vsi a1 rapid
 Ping mac 00e0-fc12-3456 vsi a1: 142 data bytes, press CTRL_C to break

!!!!!

  --- vsi: a1, mac: 00e0-fc12-3456 ping statistics---
    5 packet(s) transmitted
    5 packet(s) received
    0.00% packet loss
    round-trip min/avg/max=16/16/17 ms

# On a VPLS network, check whether the path with the VSI name being a1 and MAC address being 00e0-fc12-3456 is reachable.

<HUAWEI> ping vpls mac 00e0-fc12-3456 vsi a1
 Ping mac 00e0-fc12-3456 vsi a1: 142 data bytes, press CTRL_C to break
    Reply from 10.1.1.2: bytes=142 Sequence=1 time=16 ms
    Reply from 10.1.1.2: bytes=142 Sequence=2 time=4 ms
    Reply from 10.1.1.2: bytes=142 Sequence=3 time=7 ms
    Reply from 10.1.1.2: bytes=142 Sequence=4 time=8 ms
    Reply from 10.1.1.2: bytes=142 Sequence=5 time=8 ms
 The IP address of the PE is 192.168.2.9.

  --- vsi: a1, mac: 00e0-fc12-3456 ping statistics---
    5 packet(s) transmitted
    5 packet(s) received
    0.00% packet loss
    round-trip min/avg/max=4/8/16 ms

**Table 1** Description of the **ping vpls mac** command output
Item	Description
00e0-fc12-3456 ping statistics	Statistics collected after the VPLS MA ping test on a destination host, including: packets transmitted: indicates the number of sent MPLS Echo Request packets. packets received: indicates the number of received MPLS Echo Reply packets. % packet loss: percentage of sent packets with failed responses. round-trip min/avg/max: minimum, average, and maximum response time.
Ping mac 00e0-fc12-3456 vsi a1	Destination MAC address and VSI name.
142 data bytes	Length of Echo Request packets.
press CTRL_C to break	You can press Ctrl+C to stop the ongoing VPLS MAC ping test.
Reply from 10.1.1.2	Response from the destination host to each MPLS Echo Request packet: bytes: indicates the length of the response packet. sequence: indicates the sequence number of the response packet. time: indicates the timeout period for receiving the response packet, in ms. If no response packet is received after the timeout period, the message "Request time out" is displayed.