Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

header-navigation
keyboard_arrow_up
close
keyboard_arrow_left
Junos CLI Reference
Table of Contents Expand all
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
keyboard_arrow_right

show vpls connections

date_range 19-Nov-23

Syntax

content_copy zoom_out_map
show vpls connections
<brief | extensive>
<down | up | up-down>
<history>
<instance instance-name local-site local-site-name remote-site remote-site-name>
<instance-history>
<logical-system (all | logical-system-name)>
<status>
<summary>

Description

(T Series and M Series routers, except for the M160 router) Display virtual private LAN service (VPLS) connection information.

Options

none

Display information about all VPLS connections for all routing instances.

brief | extensive

(Optional) Display the specified level of output.

down | up | up-down

(Optional) Display nonoperational, operational, or both types of connections.

history

(Optional) Display information about connection history.

instance instance-name

(Optional) Display the VPLS connections for the specified routing instance only.

instance-history

(Optional) Display information about connection history for a particular instance.

local-site local-site-name

(Optional) Display the VPLS connections for the specified local site name or ID only.

remote-site remote-site-name

(Optional) Display the VPLS connections for the specified remote site name or ID only. Label block size information is always shown as 0 when using this option.

logical-system (all | logical-system-name)

(Optional) Perform this operation on all logical systems or on a particular logical system.

status

(Optional) Display information about the connection and interface status.

summary

(Optional) Display summary of all VPLS connections information.

Required Privilege Level

view

Output Fields

Table 1 lists the output fields for the show vpls connections command. Output fields are listed in the approximate order in which they appear.

Table 1: show vpls connections Output Fields

Field Name

Field Description

Instance

Name of the VPLS instance.

Local site

Name of the local site.

VPLS-id

Identifier for the VPLS site.

Number of local interfaces

Number of interfaces configured for the local site.

Number of local interfaces up

Number of interfaces configured for the local site that are currently up.

IRB interface present

Indicates whether or not an integrated routing and bridging (IRB) interface is present (yes or no).

Intf

List of all of the interfaces configured for the local site. The types of interfaces can include VPLS virtual loopback tunnel interfaces and label-switched interfaces. Any interface that supports VPLS could be listed here.

Virtual loopback tunnel interfaces are displayed using the vt-fpc/pic/port.nnnnn format. Label-switched interfaces are displayed using the lsi.nnnnn format. In both cases, nnnnn is a dynamically generated virtual port used to transport and receive packets from other provider edge (PE) routers in the VPLS domain.

Each interface might include the following information:

  • Identification as a VPLS interface

  • Name of the associated VPLS routing instance

  • Local site number

  • Remote site number

  • VPLS neighbor address

  • VPLS identifier

Interface flags

Flag associated with the interface. Can include the following:

  • VC-Down—The virtual circuit associated with this interface is down.

Label-base

First label in a block of labels. A remote PE router uses this first label when sending traffic toward the advertising PE router.

Offset

Displays the VPLS Edge (VE) block offset in the Layer 2 VPN NLRI. The VE block offset is used to identify a label block from which a particular label value is selected to setup a pseduowire for a remote site. The block offset value itself indicates the starting VE ID that maps to the label base contained in the VPLS NLRI advertisement.

Size

Label block size. A configurable value that represents the number of label blocks required to cover all the pseudowires for the remote peer. Acceptable configuration values are: 2, 4, 8 and 16. The default value is 2. A value of 0 will be displayed when using the remote-site option.

Range

Label block range. A value that keeps track of the numbers of remote sites discovered within each label block.

Preference

Preference value advertised for a VPLS site. When multiple PE routers are assigned the same VE ID for multihoming, you might need to specify that a particular PE router acts as the designated forwarder by configuring the site preference value. The site preference indicates the degree of preference for a particular customer site. The site preference is one of the tie-breaking criteria used in a designated forwarder election.

status-vector

Bit vector advertising the state of local PE-CE circuits to remote PE routers. A bit value of 0 indicates that the local circuit and LSP tunnel to the remote PE router are up, whereas a value of 1 indicates either one or both are down.

connection-site

Name of the connection site.

Neighbor

IP address and VPLS identifier for the VPLS neighbor. If multiple pseudowires have been configured, the IP address will also show the PW-specific vpls-id-list, for example, 203.0.113.144 (vpls-id 200).

Type

Type of connection: loc (local) or rmt (remote).

St

Status of the VPLS connection (corresponds with Legend for Connection Status):

  • EI—The local VPLS interface is configured with an encapsulation that is not supported.

  • EM—The encapsulation type received on this VPLS connection from the neighbor does not match the local VPLS connection interface encapsulation type.

  • VC-Dn—The virtual circuit is currently down.

  • CM—The two routers do not agree on a control word, which causes a control word mismatch.

  • CN—The virtual circuit is not provisioned properly.

  • OR—The label associated with the virtual circuit is out of range.

  • OL—No advertisement has been received for this virtual circuit from the neighbor. There is no outgoing label available for use by this virtual circuit.

  • LD—All of the CE-facing interfaces to the local site are down. Therefore, the connection to the local site is signaled as down to the other PE routers. No pseudowires can be established.

  • RD—All the interfaces to the remote neighbor are down. Therefore, the remote site has been signaled as down to the other PE routers. No pseudowires can be established.

  • LN—The local site has lost path selection to the remote site and therefore no pseduowires can be established from this local site.

  • RN—The remote site has lost path selection to a local site or other remote site and therefore no pseudowires are established to this remote site.

    In a multihoming configuration, one multihomed PE site displays the state LN, and the other multihomed PE site displays the state RN in the following circumstances:

    • The multihomed links are both configured to be the backup site.

    • The two multihomed PE routers have the same site ID, but have a peering relationship with a route reflector (RR) that has a different site ID.

  • XX—The VPLS connection is down for an unn reason. This is a programming error.

  • MM—The MTU for the local site and the remote site do not match.

  • BK—The router is using a backup connection.

  • PF—Profile parse failure.

  • RS—The remote site is in a standby state.

  • NC—The interface encapsulation is not configured as an appropriate CCC, TCC, or VPLS encapsulation.

  • WE—The encapsulation configured for the interface does not match the encapsulation configured for the associated connection within the VPLS routing instance.

  • NP—The router detects that interface hardware is not present. The hardware might be offline, a PIC might not be of the desired type, or the interface might be configured in a different routing instance.

  • -->—Only the outbound connection is up.

  • <-—Only the inbound connection is up.

  • Up—The VPLS connection is operational.

  • Dn—The VPLS connection is down.

  • CF—The router cannot find enough bandwidth to the remote router to satisfy the VPLS connection bandwidth requirement.

  • SC—The local site identifier matches the remote site identifier. No pseudowire can be established between these two sites. You should configure different values for the local and remote site identifiers.

  • LM—The local site identifier is not the minimum designated, meaning it is not the lowest. There is another local site with a lower site identifier. Pseudowires are not being established to this local site. and the associated local site identifier is not being used to distribute VPLS label blocks. However, this is not an error state. Traffic continues to be forwarded to the PE router interfaces connected to the local sites when the local sites are in this state.

  • RM—The remote site identifier is not the minimum designated, meaning it is not the lowest. There is another remote site connected to the same PE router which has lower site identifier. The PE router cannot established a pseudowire to this remote site and the associated remote site identifier cannot be used to distribute VPLS label blocks. However, this is not an error state. Traffic can continue to be forwarded to the PE router interface connected to this remote site when the remote site is in this state.

  • IL—The incoming packets for the VPLS connection have no MPLS label.

  • MI—The configured mesh group identifier is in use by another system in the network.

  • ST—The router has switched to a standby connection.

  • PB—Profile busy.

  • SN—The VPLS neighbor is static.

Time last up

Time connection was last in the Up condition.

# Up trans

Number of transitions from Down to Up condition.

Status

Status of the (local or remote circuit) local interface:

  • Up—Operational

  • Dn—Down

  • NP—Not present

  • DS—Disabled

  • WE—Wrong encapsulation

  • UN—Uninitialized

Encapsulation

Type of encapsulation: VPLS.

Remote PE

Address of the remote provider edge router.

Negotiated control-word

Whether a control word has been negotiated: Yes or No.

Incoming label

Name of the incoming label.

Outgoing label

Name of the outgoing label.

Negotiated PW status TLV

Indicates whether or not the pseudowire status TLV has been negotiated for the VPLS connection.

Local interface

Provides the following information about the local interface configured for the VPLS neighbor:

  • Name of the local interface

  • Status—Interface status (Up or Down)

  • Encapsulation—Interface encapsulation (for example, ETHERNET)

  • Description—Includes the VPLS instance name, the VPLS neighbor address, and the VPLS identifier

Time

Date and time of VPLS connection event.

Event

Type of event.

Interface/Lbl/PE

Interface, label, or PE router.

Connection History

Each entry can include the date, time, year, and the connection event. Connection events include any of a variety of events related to VPLS connections, such as route changes, label updates, and interfaces going down or coming up.

Sample Output

show vpls connections

content_copy zoom_out_map
user@host> show vpls connections    
Layer-2 VPN connections:

Legend for connection status (St)   
EI -- encapsulation invalid      NC -- interface encapsulation not CCC/TCC/VPLS
EM -- encapsulation mismatch     WE -- interface and instance encaps not same
VC-Dn -- Virtual circuit down    NP -- interface hardware not present 
CM -- control-word mismatch      -< -- only outbound connection is up
CN -- circuit not provisioned    >- -- only inbound connection is up
OR -- out of range               Up -- operational
OL -- no outgoing label          Dn -- down                      
LD -- local site signaled down   CF -- call admission control failure      
RD -- remote site signaled down  SC -- local and remote site ID collision
LN -- local site not designated  LM -- local site ID not minimum designated
RN -- remote site not designated RM -- remote site ID not minimum designated
XX -- unn connection status  IL -- no incoming label
MM -- MTU mismatch               MI -- Mesh-Group ID not available
BK -- Backup connection          ST -- Standby connection
PF -- Profile parse failure      PB -- Profile busy

Legend for interface status 
Up -- operational           
Dn -- down

Instance: vpls-1
  Local site: 1 (11)
    Number of local interfaces: 1
    Number of local interfaces up: 1
    IRB interface present: no
    lt-1/3/0.10496     
    vt-1/3/0.1048588    1         Intf - vpls vpls-1 local site 11 remote site 1
    vt-1/2/0.1048591    2         Intf - vpls vpls-1 local site 11 remote site 2
    vt-1/2/0.1048585    3         Intf - vpls vpls-1 local site 11 remote site 3
    vt-1/2/0.1048587    4         Intf - vpls vpls-1 local site 11 remote site 4
    vt-1/2/0.1048589    5         Intf - vpls vpls-1 local site 11 remote site 5
    vt-1/3/0.1048586    6         Intf - vpls vpls-1 local site 11 remote site 6
    vt-1/3/0.1048590    7         Intf - vpls vpls-1 local site 11 remote site 7
    vt-1/3/0.1048584    8         Intf - vpls vpls-1 local site 11 remote site 8
    Label-base        Offset     Size  Range     Preference
    800256            1          16     16        100   
    Timer Values:
        Startup wait time: 120 seconds
        New site wait-time: 20 seconds
        Collision detect time: 30 seconds
        Reclaim wait time: 748 milliseconds
    connection-site           Type  St     Time last up          # Up trans
    1                         rmt   Up     Apr 28 13:28:24 2009           2
      Remote PE: 192.0.2.1, Negotiated control-word: No
      Incoming label: 800256, Outgoing label: 800026
      Local interface: vt-1/3/0.1048588, Status: Up, Encapsulation: VPLS
        Description: Intf - vpls vpls-1 local site 11 remote site 1
    Connection History:
        Apr 28 13:28:24 2009  status update timer  
        Apr 28 13:28:24 2009  PE route down        
        Apr 28 13:24:27 2009  status update timer  
        Apr 28 13:24:27 2009  loc intf up             vt-1/3/0.1048588
        Apr 28 13:24:27 2009  PE route changed     
        Apr 28 13:24:27 2009  Out lbl Update                    800026
        Apr 28 13:24:27 2009  In lbl Update                     800256
        Apr 28 13:24:27 2009  loc intf down        
    2                         rmt   Up     Apr 28 13:28:24 2009           2
      Remote PE: 192.0.2.71, Negotiated control-word: No
      Incoming label: 800257, Outgoing label: 800034
      Local interface: vt-1/2/0.1048591, Status: Up, Encapsulation: VPLS
        Description: Intf - vpls vpls-1 local site 11 remote site 2
    Connection History:
        Apr 28 13:28:24 2009  status update timer  
        Apr 28 13:28:24 2009  PE route down        
        Apr 28 13:24:28 2009  status update timer  
        Apr 28 13:24:28 2009  loc intf up             vt-1/2/0.1048591
        Apr 28 13:24:28 2009  PE route changed     
        Apr 28 13:24:28 2009  Out lbl Update                    800034
        Apr 28 13:24:28 2009  In lbl Update                     800257
        Apr 28 13:24:28 2009  loc intf down        

show vpls connections (with FEC128 and FEC129 in the same routing-instance)

content_copy zoom_out_map
user@host> show vpls connections 
Instance: fec129
  L2vpn-id: 1:1
  Local-id: 203.0.113.0
FEC129-VPLS State:
  Mesh-group connections: __ves__
    Remote-id                 Type  St     Time last up          # Up trans
    203.0.3.3                  rmt   Up     Sep 19 09:59:56 2017           1
      Remote PE: 203.0.3.3, Negotiated control-word: No
      Incoming label: 262155, Outgoing label: 262164
      Negotiated PW status TLV: No
      Local interface: lsi.1048844, Status: Up, Encapsulation: ETHERNET
        Description: Intf - vpls fec129 local-id 10.4.4.4 remote-id 203.0.3.3 neighbor 203.0.3.3
      Flow Label Transmit: No, Flow Label Receive: No
    203.0.2.2                  rmt   Up     Sep 19 09:59:52 2017           1
      Remote PE: 203.0.2.2, Negotiated control-word: No
      Incoming label: 262154, Outgoing label: 262157
      Negotiated PW status TLV: No
      Local interface: lsi.1048846, Status: Up, Encapsulation: ETHERNET
        Description: Intf - vpls fec129 local-id 10.4.4.4 remote-id 203.0.2.2 neighbor 203.0.2.2
      Flow Label Transmit: No, Flow Label Receive: No
    203.0.1.1                  rmt   Up     Sep 19 09:59:48 2017           1
      Remote PE: 203.0.1.1, Negotiated control-word: No
      Incoming label: 262156, Outgoing label: 262157
      Negotiated PW status TLV: No
      Local interface: lsi.1048845, Status: Up, Encapsulation: ETHERNET
        Description: Intf - vpls fec129 local-id 10.4.4.4 remote-id 203.0.1.1 neighbor 203.0.1.1
      Flow Label Transmit: No, Flow Label Receive: No
	  
LDP-VPLS State
   Mesh-group connections: MG1
     Neighbor                  Type  St     Time last up          # Up trans
     203.0.6.6(vpls-id 1)       rmt   Up     Sep 17 19:17:11 2017           1
       Remote PE: 203.0.6.6, Negotiated control-word: No
       Incoming label: 262423, Outgoing label: 262145
       Negotiated PW status TLV: No
       Local interface: lsi.1049859, Status: Up, Encapsulation: ETHERNET
         Description: Intf - vpls bgp-vpls neighbor 203.0.6.6 vpls-id 1
       Flow Label Transmit: No, Flow Label Receive: No
     203.0.7.7(vpls-id 1)       rmt   Up     Sep 17 19:17:04 2017           1
       Remote PE: 203.0.7.7, Negotiated control-word: No
       Incoming label: 262424, Outgoing label: 262145
       Negotiated PW status TLV: No
       Local interface: lsi.1049857, Status: Up, Encapsulation: ETHERNET
         Description: Intf - vpls bgp-vpls neighbor 203.0.7.7 vpls-id 1
       Flow Label Transmit: No, Flow Label Receive: No
   Mesh-group connections: MG2
     Neighbor                  Type  St     Time last up          # Up trans
     203.0.5.5(vpls-id 1)       rmt   Up     Sep 17 19:17:00 2017           1
       Remote PE: 203.0.5.5, Negotiated control-word: No
       Incoming label: 262425, Outgoing label: 299872
       Negotiated PW status TLV: No
       Local interface: lsi.1049856, Status: Up, Encapsulation: ETHERNET
         Description: Intf - vpls bgp-vpls neighbor 203.0.5.5 vpls-id 1
       Flow Label Transmit: No, Flow Label Receive: No

show vpls connections (with multiple pseudowires)

content_copy zoom_out_map
user@host> show vpls connections 
Layer-2 VPN connections:
 
Legend for connection status (St)   
EI -- encapsulation invalid      NC -- interface encapsulation not CCC/TCC/VPLS
EM -- encapsulation mismatch     WE -- interface and instance encaps not same
VC-Dn -- Virtual circuit down    NP -- interface hardware not present 
CM -- control-word mismatch      -> -- only outbound connection is up
CN -- circuit not provisioned    <- -- only inbound connection is up
OR -- out of range               Up -- operational
OL -- no outgoing label          Dn -- down                      
LD -- local site signaled down   CF -- call admission control failure      
RD -- remote site signaled down  SC -- local and remote site ID collision
LN -- local site not designated  LM -- local site ID not minimum designated
RN -- remote site not designated RM -- remote site ID not minimum designated
XX -- unknown connection status  IL -- no incoming label
MM -- MTU mismatch               MI -- Mesh-Group ID not available
BK -- Backup connection          ST -- Standby connection
PF -- Profile parse failure      PB -- Profile busy
RS -- remote site standby        SN -- Static Neighbor
LB -- Local site not best-site   RB -- Remote site not best-site
VM -- VLAN ID mismatch

Legend for interface status 
Up -- operational           
Dn -- down

Instance: vpls
  VPLS-id: 100
  Mesh-group connections: __ves__
    Neighbor                  Type  St     Time last up          # Up trans
    10.255.114.3 (vpls-id 100)  rmt   Up     Apr 11 23:38:38 2013           1
      Remote PE: 10.255.114.3, Negotiated control-word: No
      Incoming label: 262145, Outgoing label: 262145
      Negotiated PW status TLV: No
      Local interface: lsi.1049090, Status: Up, Encapsulation: ETHERNET
        Description: Intf - vpls h-vpls neighbor 10.255.114.3 vpls-id 100

  Mesh-group connections: spokes
    Neighbor                  Type  St     Time last up          # Up trans
    10.255.114.4 (vpls-id 200)  rmt   Up     Apr 11 23:39:25 2013           1
      Remote PE: 10.255.114.4, Negotiated control-word: No
      Incoming label: 262148, Outgoing label: 304224
      Negotiated PW status TLV: Yes
      local PW status code: 0x00000000, Neighbor PW status code: 0x00000000
      Local interface: lsi.1049091, Status: Up, Encapsulation: ETHERNET
        Description: Intf - vpls h-vpls neighbor 10.255.114.4 vpls-id 200
      10.255.114.4 (vpls-id 201)  rmt   Up     Apr 11 23:39:25 2013           1
        Remote PE: 10.255.114.4, Negotiated control-word: No
        Incoming label: 262149, Outgoing label: 304225
        Negotiated PW status TLV: Yes
        local PW status code: 0x00000000, Neighbor PW status code: 0x00000000
        Local interface: lsi.1049096, Status: Up, Encapsulation: ETHERNET
        Description: Intf - vpls h-vpls neighbor 10.255.114.4 vpls-id 201

show vpls connections extensive (Static VPLS Neighbors)

content_copy zoom_out_map
user@host> show vpls connections extensive instance red
Layer-2 VPN connections:
 
Legend for connection status (St)   
EI -- encapsulation invalid      NC -- interface encapsulation not CCC/TCC/VPLS
EM -- encapsulation mismatch     WE -- interface and instance encaps not same
VC-Dn -- Virtual circuit down    NP -- interface hardware not present 
CM -- control-word mismatch      -> -- only outbound connection is up
CN -- circuit not provisioned    <- -- only inbound connection is up
OR -- out of range              Up -- operational
OL -- no outgoing label          Dn -- down                     
LD -- local site signaled down   CF -- call admission control failure      
RD -- remote site signaled down  SC -- local and remote site ID collision
LN -- local site not designated  LM -- local site ID not minimum designated
RN -- remote site not designated RM -- remote site ID not minimum designated
XX -- unn connection status  IL -- no incoming label
MM -- MTU mismatch              MI -- Mesh-Group ID not available
BK -- Backup connection                ST -- Standby connection
PF -- Profile parse failure      PB -- Profile busy
RS -- remote site standby       SN -- Static Neighbor
 
Legend for interface status 
Up -- operational           
Dn -- down                             
 
Instance: static
  VPLS-id: 1
   Number of local interfaces: 1
   Number of local interfaces up: 1
   ge-0/0/5.0         
   lsi.1049344                  Intf - vpls static neighbor 10.255.114.3 vpls-id 1
   Neighbor                 Type  St     Time last up          # Up trans
   10.255.114.3(vpls-id 1)(SN) rmt Up     Mar  4 08:48:41 2010           1
     Remote PE: 10.255.114.3, Negotiated control-word: No
     Incoming label: 29696, Outgoing label: 29697
     Negotiated PW status TLV: No
     Local interface: lsi.1049344, Status: Up, Encapsulation: ETHERNET
       Description: Intf - vpls static neighbor 10.255.114.3 vpls-id 1
   Connection History:
       Mar  4 08:48:41 2010  status update timer  
       Mar  4 08:48:41 2010  PE route changed     
       Mar  4 08:48:41 2010  Out lbl Update                    29697
       Mar  4 08:48:41 2010  In lbl Update                     29696
       Mar  4 08:48:41 2010  loc intf up                 lsi.1049344

command-name

content_copy zoom_out_map
user@PE1> show vpls connections extensive (Multihoming with FEC 129)
Layer-2 VPN connections:

Legend for connection status (St)   
EI -- encapsulation invalid      NC -- interface encapsulation not CCC/TCC/VPLS
EM -- encapsulation mismatch     WE -- interface and instance encaps not same
VC-Dn -- Virtual circuit down    NP -- interface hardware not present 
CM -- control-word mismatch      -> -- only outbound connection is up
CN -- circuit not provisioned    <- -- only inbound connection is up
OR -- out of range               Up -- operational
OL -- no outgoing label          Dn -- down                      
LD -- local site signaled down   CF -- call admission control failure      
RD -- remote site signaled down  SC -- local and remote site ID collision
LN -- local site not designated  LM -- local site ID not minimum designated
RN -- remote site not designated RM -- remote site ID not minimum designated
XX -- unknown connection status  IL -- no incoming label
MM -- MTU mismatch               MI -- Mesh-Group ID not available
BK -- Backup connection          ST -- Standby connection
PF -- Profile parse failure      PB -- Profile busy
RS -- remote site standby        SN -- Static Neighbor
LB -- Local site not best-site   RB -- Remote site not best-site
VM -- VLAN ID mismatch

Legend for interface status 
Up -- operational           
Dn -- down

Instance: green
  L2vpn-id: 100:100
  Local-id: 192.0.2.2
    Number of local interfaces: 2
    Number of local interfaces up: 2
    ge-0/3/1.0         
    ge-0/3/3.0         
    lsi.101711873                 Intf - vpls green local-id 192.0.2.2 remote-id 192.0.2.4 neighbor 192.0.2.4
    Remote-id                 Type  St     Time last up          # Up trans
    192.0.2.4                   rmt   Up     Jan 31 13:49:52 2012           1
      Remote PE: 192.0.2.4, Negotiated control-word: No
      Incoming label: 262146, Outgoing label: 262146
      Local interface: lsi.101711873, Status: Up, Encapsulation: ETHERNET
        Description: Intf - vpls green local-id 192.0.2.2 remote-id 192.0.2.4 neighbor 192.0.2.4
    Connection History:
        Jan 31 13:49:52 2012  status update timer  
        Jan 31 13:49:52 2012  PE route changed     
        Jan 31 13:49:52 2012  Out lbl Update                    262146
        Jan 31 13:49:52 2012  In lbl Update                     262146
        Jan 31 13:49:52 2012  loc intf up                lsi.101711873
  Multi-home:
    Local-site                Id     Pref   State
    test                      1      100    Up
      Number of interfaces: 1
      Number of interfaces up: 1
        ge-0/3/1.0         
      Received multi-homing advertisements:
        Remote-PE         Pref   flag   Description
        192.0.2.4           100    0x0   

Release Information

Command introduced before Junos OS Release 7.4.

instance-history option introduced in Junos OS Release 12.3R2.

footer-navigation