mpls-relay remoteIpAddress [ vc-id ] vcidValue [ group-id groupIdValue ]
[ control-word | no-control-word ] [ sequencing | no-sequencing ]
[ relay-format { ethernet | frame-relay | ppp | vlan | ethernet-raw-mode } ]

no mpls-relay

Release Information

Command introduced before JunosE Release 7.1.0.
control-word, no-control-word, no-sequencing, and vlan keywords added in JunosE Release 7.1.0.
frame-relay keyword added in JunosE Release 9.1.0.
ethernet-raw-mode keyword added in JunosE Release 10.0.0.


Routes layer 2 traffic to the specified router by creating an MPLS shim interface on the layer 2 interface. The router can use any MPLS LSP to the remote destination address that you specify. You must issue this command in the virtual router where the remote address can be reached; that is, in the virtual router providing core connections. The no version removes the shim interface. See also the route interface command.

Note: This command is supported for configuration on an ATM port (ATM Adaptation Layer 5 [AAL5] over an ATM major interface). Before you can specify VPI/VCI ranges and cell concatenation parameters on the ATM port to enable transmission of multiple ATM virtual circuits over a single pseudowire, you must associate the ATM port with the corresponding pseudowire using the mpls-relay or router interface tunnel command. For more information about the support for multiple VCs over a single pseudowire, see Multiple ATM Virtual Circuits over a Single Pseudowire Overview in the JunosE BGP and MPLS Configuration Guide

Note: If you configured a layer 2 interface as a member of a VPWS L2VPN, you cannot use the mpls-relay command to create MPLS shim interfaces or local cross-connects for MPLS tunneling on the same layer 2 interface. An error message is displayed if you attempt to configure a MPLS shim interface on a layer 2 interface that is a member of a VPWS L2PN.


Note: The relay-format keyword determines the pseudowire PW Type value that is used in LDP protocol messages. For a complete list of pseudowire Type values, see

If you do not specify the relay-format keyword in the mpls-relay or route interface command, the pseudowire Type value is chosen based on the type of the interface. For Ethernet interfaces, the pseudowire Type value is chosen as Ethernet (0x0005). For VLAN interfaces, the pseudowire Type value is chosen as Ethernet Tagged Mode (0x0004)


Interface Configuration, Subinterface Configuration

Related Documentation