Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?


ping vpls instance



Check the operability of virtual private LAN service (VPLS) connections. Type Ctrl+c to interrupt a ping vpls instance command.

When you issue a ping vpls instance command, a chassis MAC address is drawn from the ingress PE router's pool of MAC addresses and used to create the VPLS ping packet. The ping packet is then forwarded to the egress PE router. When the egress PE router receives the ping packet, it learns the MAC address from the VPLS ping packet. The MAC address is added to the egress PE router's MAC table.

The ping vpls instance command relies on the LSP ping and trace infrastructure defined in RFC 4379, Detecting Multi-Protocol Label Switched (MPLS) Data Plane Failures and further enhancements defined in Internet draft draft-stokes-vkompella-ppvpn-hvpls-oam-02, Testing Hierarchical Virtual Private LAN Services.


instance instance-name

Specify the name of the VPLS routing instance.

destination-mac address

Specify a destination MAC address for the ping echo requests.

source ip address

IP address of the outgoing interface.

bd-name name

(Optional) Name of the bridge domain.


(Optional) Request VPLS OAM responses using the control plane.

count number

(Optional) Number of ping requests to send. If count is not specified, five ping requests are sent. The range of values is 1 through 1,000,000. The default value is 5.


(Optional) Display detailed information about the echo requests sent and received.

learning-vlan-id number

(Optional) Specify a learning VLAN identifier for the ping echo requests. The range of values is 0 through 4094.

logical-system logical-system-name

(Optional) Specify a logical system name for the ping echo requests.

Additional Information

This statement is only supported on the MX Series routers, the M120 and M320 routers, and the T1600 router.

Required Privilege Level


Output Fields

When you enter this command, you are provided feedback on the status of your request. An exclamation point (!) indicates that an echo reply was received. A period (.) indicates that an echo reply was not received within the timeout period. An x indicates that an echo reply was received with an error code. Packets with an error code are not counted in the received packets count. They are accounted for separately.

Sample Output

ping vpls instance

Release Information

Command introduced in Junos OS Release 9.1.