ping mpls l2circuit

Syntax

Release Information

Command introduced before JUNOS Release 7.4.

The size and sweep options were introduced in JUNOS Release 9.6.

Description

Check the operability of the MPLS Layer 2 circuit connections. Type Ctrl+c to interrupt a ping mpls l2circuit command.

Options

interface interface-name — Ping an interface configured for the Layer 2 circuit on the egress provider edge (PE) router.

virtual-circuit virtual-circuit-id neighbor address — Ping a combination of the virtual circuit identifier on the egress PE router and the IPv4 prefix, testing the integrity of the Layer 2 circuit between the ingress and egress PE routers.

count count — (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.

destination address — (Optional) Specify an address other than the default (127.0.0.1/32) for the ping echo requests. The address can be anything within the 127/8 subnet.

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

exp forwarding-class — (Optional) Value of the forwarding class for the MPLS ping packets.

logical-system (all | logical-system-name) — (Optional) Perform this operation on all logical systems or on the specified logical system.

size bytes — (Optional) Size of the label-switched (LSP) ping request packet (96 through 65468 bytes). Packets are 4-byte aligned. For example, If you enter a size of 97, 98, 99, or 100, the router uses a size value of 100 bytes. If you enter a packet size that is smaller than the minimum size, an error message is displayed reminding you of the 96-byte minimum.

source source-address — (Optional) IP address of the outgoing interface. This address is sent in the IP source address field of the ping request. If this option is not specified, the default address is usually the loopback interface (lo.0).

sweep — (Optional) Automatically determine the size of the maximum transmission unit (MTU).

v1 — (Optional) Use the type 9 Layer 2 circuit type, length, and value (TLV).

Additional Information

You must configure MPLS at the [edit protocols mpls] hierarchy level on the egress PE router (the router receiving the MPLS echo packets) to ping a Layer 2 circuit.

In asymmetric MTU scenarios, the echo response may be dropped. For example, if the MTU from system A to system B is 1000 bytes, the MTU from system B to system A is 500 bytes, and the ping request packet size is 1000 bytes, the echo response is dropped because the PAD TLV is included in the echo response, making it too large.

Required Privilege Level

network

List of Sample Output

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

Request for seq 1, to interface 69, labels <100000, 100208>, packet size 100
Reply for seq 1, return code: Egress-ok, time: 0.439 ms 

Request for seq 1, to interface 68, labels <100048, 100128>, packet size 100

Reply for seq 1, return code: Egress-ok time: 0.539 ms