BGP L2VPN Operational Commands
BGP L2VPN Show Commands
The following show commands display the BGP L2VPN-related information.
BGP Summary
This command displays BGP protocol parameters like attributes or timers that are generic to the BGP instance.
Syntax:
| Attribute | Description |
|---|---|
|
Without any option, the command displays the information for all instances. |
|
BGP summary information for the given instance. |
Example: BGP summary for instance l2vpn_ce1
supervisor@rtbrick: op> show bgp summary instance ce1-vrf
Instance: ce1-vrf
General information
Hostname: ce1-vrf instance, Domain name: ce1-vrf instance
Local AS: 64501, Version: 4
Local preference: 100, eBGP Protocol preference: 20, iBGP Protocol preference: 200
Router ID: 198.51.100.201, Cluster ID: 198.51.100.201
MED: 0, Enforce first AS: True
Address families configured:
ipv4: unicast
ipv6: unicast
l2vpn: vpls-vpws
Capabilities
Route refresh: True, AS4: True, Graceful restart: False, L2VPN VPLS-VPWS:True
Best route selection
Always compare MED: True, Ignore as path: False
Ignore local preference: False, Ignore origin: False
Ignore MED: False, Ignore route source: False
Ignore router ID: False, Ignore uptime: True
Ignore cluster length: False, Ignore peer IP: False
Route select parameter: 0
Timers
Connect retry: 30s, Keepalive: 30s, Holdtime: 90s
Statistics
Peers configured: 0, Peers auto discovery: 0
Peers in idle : 0
Peers in connect : 0
Peers in active : 0
Peers in opensent : 0
Peers in openconfirm : 0
Peers in established : 0BGP Peer
The 'show bgp peer' commands display information on BGP peers.
Syntax:
| Option | Description |
|---|---|
|
Without any option, the commands display all BGP peers in all instances in a summary table format. |
|
Detailed information on all BGP peers in all instances in a list view. |
|
Detailed information on the peer with the given name. |
|
Detailed information on the peer with the given IP address. |
|
Displays BGP peer history information such as the peer state down reasons. |
|
Displays BGP peer history information such as the peer state down reasons for a specified peer. |
|
Summary of all BGP peers in the given instance. |
|
Detailed information on all BGP peers in the given instance. |
|
Detailed information on the peer with the given name in the given instance. |
|
Detailed information on the peer with the given IP address in the given instance. |
|
Received and sent BGP prefixes per AFI/SAFI for all peers in all instances. |
|
Received and sent BGP prefixes per AFI/SAFI for the peer with the given name. |
|
Received and sent BGP prefixes per AFI/SAFI for the peer with the given IP address. |
|
Received and sent BGP prefixes per AFI/SAFI for the peer with the given name in the given instance. |
|
Received and sent BGP prefixes per AFI/SAFI for the peer with the given IP address in the given instance. |
Example 1: BGP Peer Information for instance default
supervisor@rtbrick: op> show bgp peer instance default
Instance: default
Peer Remote AS State Up/Down Time PfxRcvd PfxSent
PE2 65542 Established 0d:00h:00m:12s 14 24Example 2: Detailed view of BGP Peer Information
supervisor@rtbrick: op> show bgp peer detail
Peer: PE2, Peer IP: 192.0.2.2, Remote AS: 65542, Local IP: 192.0.2.1, Local AS: 65541, Any AS: False
Type: ebgp, State: Established, Up/Down Time: Wed Jul 15 19:02:42 GMT +0000 2026
Discovered on interface: -
Last transition: Wed Jul 15 19:02:42 GMT +0000 2026, Flap count: 0
Peer ID : 198.51.100.21, Local ID: 198.51.100.11
Instance : default, Peer group: PE2
6PE enabled : False
TTL security : False, TTL limit: -
Authentication:
ID: BGP_AUTH_HMAC-SHA-256-128, Algorithm: HMAC-SHA-256-128
Timer values:
Peer keepalive : 30s, Local keepalive: 30s
Peer holddown : 90s, Local holddown : 90s
Connect retry : 30s
Timers:
Connect retry timer : 0
Keepalive timer : expires in 10s 994697us
Holddown timer : expires in 1m 16s 623288us
NLRIs:
Sent : ['l2vpn-vpls', 'ipv4-vpn-unicast', 'ipv6-vpn-unicast', 'ipv4-labeled-unicast', 'ipv6-labeled-unicast']
Received : ['l2vpn-vpls', 'ipv4-vpn-unicast', 'ipv6-vpn-unicast', 'ipv4-labeled-unicast', 'ipv6-labeled-unicast']
Negotiated : ['l2vpn-vpls', 'ipv4-vpn-unicast', 'ipv6-vpn-unicast', 'ipv4-labeled-unicast', 'ipv6-labeled-unicast']
Capabilities:
Addpath sent : None
Addpath received : None
Addpath negotiated : None
Extended nexthop sent : None
Extended nexthop received : None
Extended nexthop negotiated : None
Multiple labels sent : None
Multiple labels received : None
Multiple labels negotiated : None
Capabilities:
Feature Sent Received Negotiated
Route refresh True True True
4 byte AS True True True
Graceful restart False False False
Link local only False False False
Prefix Limit:
End of RIB:
Address family Sent Received
IPv4 unicast never never
IPv4 labeled-unicast Wed Jul 15 19:02:47 GMT +0000 2026 Wed Jul 15 19:02:47 GMT +0000 2026
IPv6 unicast never never
IPv6 labeled-unicast Wed Jul 15 19:02:47 GMT +0000 2026 Wed Jul 15 19:02:47 GMT +0000 2026
IPv4 VPN-unicast Wed Jul 15 19:02:47 GMT +0000 2026 Wed Jul 15 19:02:47 GMT +0000 2026
IPv6 VPN-unicast Wed Jul 15 19:02:47 GMT +0000 2026 Wed Jul 15 19:02:47 GMT +0000 2026
IPv4 flowspec never never
IPv6 flowspec never never
IPv4 VPN-multicast never never
L2VPN VPLS Wed Jul 15 19:02:47 GMT +0000 2026 Wed Jul 15 19:02:47 GMT +0000 2026
L2VPN EVPN never never
Message stats:
Session stats:
Direction Open Update Keepalive Notify Route refresh
Input 1 11 1 0 0
Output 1 11 1 0 0
Total stats:
Input 1 11 1 0 0
Output 1 11 1 0 0
Route stats:
Address family Received Sent Prefix limit Idle timeout
IPv4 unicast 0 0 0 0
IPv4 labeled-unicast 4 6 0 0
IPv6 unicast 0 0 0 0
IPv6 labeled-unicast 4 6 0 0
IPv4 VPN-unicast 2 4 0 0
IPv6 VPN-unicast 2 4 0 0
IPv4 multicast 0 0 0 0
IPv4 VPN-multicast 0 0 0 0
L2VPN VPLS 2 4 0 0
L2VPN EVPN 0 0 0 0
IPv4 Flowspec 0 0 0 0
IPv6 Flowspec 0 0 0 0Example 3: BGP Peer Statistics for a specific peer
supervisor@rtbrick: op> show bgp peer statistics peer address 192.0.2.2
Instance: default
Peer AFI SAFI PfxRcvd PfxSent
PE2 ipv4 unicast 0 0
ipv4 labeled-unicast 4 6
ipv6 unicast 0 0
ipv6 labeled-unicast 4 6
ipv4 vpn-unicast 2 4
ipv6 vpn-unicast 2 4
ipv4 multicast 0 0
ipv4 vpn-multicast 0 0
l2vpn vpls 2 4
l2vpn evpn 0 0
ipv4 flowspec 0 0
ipv6 flowspec 0 0Example 4: BGP Peer history for a specified peer
supervisor@rtbrick: op> show bgp peer history peer address 192.0.2.2
Instance: default
Peer Address Source Address Type Last Reset Reason Update Time
192.0.2.2 192.0.2.1 TCP Error Cease, Sub-Cod... Wed Jul 15 19:02:12
192.0.2.2 192.0.2.1 Config C... Cease, Sub-Cod... Wed Jul 15 19:02:12
192.0.2.2 192.0.2.1 Config C... Cease, Sub-Cod... Wed Jul 15 19:01:24
192.0.2.2 192.0.2.1 TCP Error Cease, Sub-Cod... Wed Jul 15 19:00:33
192.0.2.2 192.0.2.1 Config C... Cease, Sub-Cod... Wed Jul 15 19:00:33
192.0.2.2 192.0.2.1 Notifica... Cease, Sub-Cod... Wed Jul 15 18:59:40
192.0.2.2 192.0.2.1 Clear BG... Cease, Sub-Cod... Wed Jul 15 18:59:37BGP RIB-in
This command displays the received routes.
Syntax:
| Option | Description |
|---|---|
|
Without any option, the command displays information on the received BGP routing table on all instances in a summary table format. |
|
BGP routing table summary for the given address family (AFI), all sub-address families and all instances. Supported AFI values are 'ipv4', 'ipv6' and |
|
BGP routing table summary for the given address family (AFI) and sub-address family (SAFI), and all instances. Supported SAFI values are |
|
Detailed list view of the BGP routing table for the given address family (AFI) and sub-address family (SAFI), and all instances. |
|
BGP routing table entry for the given prefix and all instances. |
|
BGP routing table summary for the given AFI, SAFI, and instance. |
|
Detailed list view of BGP routing table for the given AFI, SAFI, and instance. |
|
BGP routing table entry for the given prefix and instance. |
|
BGP community details for the given AFI, SAFI, and instance. |
|
BGP route with error status for the given AFI, SAFI, and instance. |
|
Peer name or address |
Example 1: Summary view of the BGP rib-in where you can find received information for the BGP L2VPN instances like l2vpn_ce1, l2vpn_ce2, and l2vpn_ce3.
supervisor@rtbrick: op> show bgp rib-in
Instance: ce1-vrf, AFI: ipv4, SAFI: unicast
Hostname: Local, Peer IP: 0.0.0.0
Source IP: 0.0.0.0, Total routes: 2
Prefix Next Hop MED Lpref AS Path
198.51.100.201/32 - 0 - -
198.51.100.202/32 - 0 - -
Instance: default, AFI: ipv4, SAFI: labeled-unicast
Hostname: Local, Peer IP: 0.0.0.0
Source IP: 0.0.0.0, Total routes: 4
Prefix Next Hop MED Lpref AS Path
192.0.2.0/30 - 0 - -
192.0.2.4/30 - 0 - -
198.51.100.11/32 - 0 - -
198.51.100.12/32 - 0 - -
Instance: default, AFI: ipv4, SAFI: labeled-unicast
Hostname: PE2, Peer IP: 192.0.2.2
Source IP: 192.0.2.1, Total routes: 4
Prefix Next Hop MED Lpref AS Path
192.0.2.0/30 192.0.2.2 0 - 65542
192.0.2.4/30 192.0.2.2 0 - 65542
198.51.100.21/32 192.0.2.2 0 - 65542
198.51.100.22/32 192.0.2.2 0 - 65542
Instance: default, AFI: ipv4, SAFI: vpn-unicast
Hostname: PE2, Peer IP: 192.0.2.2
Source IP: 192.0.2.1, Total routes: 2
Prefix Next Hop MED Lpref AS Path
198.51.100.221/32 198.51.100.21 0 - 65542
198.51.100.222/32 198.51.100.21 0 - 65542
Instance: ce1-vrf, AFI: ipv6, SAFI: unicast
Hostname: Local, Peer IP: ::
Source IP: ::, Total routes: 2
Prefix Next Hop MED Lpref AS Path
2001:db8:0:1::201/128 - 0 - -
2001:db8:0:1::202/128 - 0 - -
Instance: default, AFI: ipv6, SAFI: labeled-unicast
Hostname: PE2, Peer IP: 192.0.2.2
Source IP: 192.0.2.1, Total routes: 4
Prefix Next Hop MED Lpref AS Path
2001:db8:1:1::/64 192.0.2.2 0 - 65542
2001:db8:2:1::/64 192.0.2.2 0 - 65542
2001:db8:0:1::21/128 192.0.2.2 0 - 65542
2001:db8:0:1::22/128 192.0.2.2 0 - 65542
Instance: default, AFI: ipv6, SAFI: labeled-unicast
Hostname: Local, Peer IP: ::
Source IP: ::, Total routes: 4
Prefix Next Hop MED Lpref AS Path
2001:db8:1:1::/64 - 0 - -
2001:db8:2:1::/64 - 0 - -
2001:db8:0:1::11/128 - 0 - -
2001:db8:0:1::12/128 - 0 - -
Instance: default, AFI: ipv6, SAFI: vpn-unicast
Hostname: PE2, Peer IP: 192.0.2.2
Source IP: 192.0.2.1, Total routes: 2
Prefix Next Hop MED Lpref AS Path
2001:db8:0:1::221/128 198.51.100.21 0 - 65542
2001:db8:0:1::222/128 198.51.100.21 0 - 65542
Instance: ce1-vrf, AFI: l2vpn, SAFI: vpls-vpws
Hostname: Local, Peer IP: 0.0.0.0
Source IP: 0.0.0.0, Total routes: 2
Prefix Next Hop MED Lpref AS Path
00.00.00.00.00.00.00.00.00.00:2000/112 - 0 - -
00.00.00.00.00.00.00.00.00.00:1000/112 - 0 - -
Instance: default, AFI: l2vpn, SAFI: vpls
Hostname: PE2, Peer IP: 192.0.2.2
Source IP: 192.0.2.1, Total routes: 2
Prefix Next Hop MED Lpref AS Path
00.00.00.00.00.00.00.00.00.00:2001/112 198.51.100.21 0 - 65542
00.00.00.00.00.00.00.00.00.00:1001/112 198.51.100.21 0 - 65542Example 2: Summary view of the BGP rib-in where you can find received information for address family l2vpn vpls.
supervisor@rtbrick: op> show bgp rib-in l2vpn vpls
Instance: default, AFI: l2vpn, SAFI: vpls
Hostname: PE2, Peer IP: 192.0.2.2
Source IP: 192.0.2.1, Total routes: 2
Prefix Next Hop MED Lpref AS Path
00.00.00.00.00.00.00.00.00.00:2001/112 198.51.100.21 0 - 65542
00.00.00.00.00.00.00.00.00.00:1001/112 198.51.100.21 0 - 65542BGP FIB
The 'show bgp fib' commands display the BGP forwarding table.
Syntax:
| Option | Description |
|---|---|
|
Without any option, the commands display the BGP forwarding table for all address families and all instances in a summary table format. |
|
BGP forwarding table summary for the given address family (AFI), all sub-address families and all instances. Supported AFI values are |
|
BGP forwarding table summary for the given address family (AFI) and sub-address family (SAFI), and all instances. Supported SAFI values are 'unicast', 'labeled-unicast', 'vpn-multicast', 'vpn-unicast', 'evpn-vpws', and 'vpls-vpws'. |
|
Detailed list view of the BGP forwarding table for the given address family (AFI) and sub-address family (SAFI), and all instances. |
|
BGP forwarding table entry for the given prefix and all instances. |
|
BGP forwarding table summary for the given AFI, SAFI, and instance. |
|
Detailed list view of BGP forwarding table for the given AFI, SAFI, and instance. |
|
BGP forwarding table entry for the given prefix and instance. |
Example: Summary view of the BGP FIB
supervisor@rtbrick: op> show bgp fib
Instance: ce1-vrf, AFI: ipv4, SAFI: unicast, Total routes: 2
Prefix Preference Label Next Hop
198.51.100.221/32 20 519938,bos:1 198.51.100.21
198.51.100.222/32 20 519938,bos:1 198.51.100.21
Instance: default, AFI: ipv4, SAFI: labeled-unicast, Total routes: 2
Prefix Preference Label Next Hop
198.51.100.21/32 20 - 192.0.2.2
198.51.100.22/32 20 - 192.0.2.2
Instance: default, AFI: ipv4, SAFI: vpn-unicast, Total routes: 4
Prefix Preference Label Next Hop
198.51.100.201/32 200 519938,bos:1 -
198.51.100.202/32 200 519938,bos:1 -
198.51.100.221/32 20 519938,bos:1 198.51.100.21
198.51.100.222/32 20 519938,bos:1 198.51.100.21
Instance: ce1-vrf, AFI: ipv6, SAFI: unicast, Total routes: 2
Prefix Preference Label Next Hop
2001:db8:0:1::221/128 20 519939,bos:1 198.51.100.21
2001:db8:0:1::222/128 20 519939,bos:1 198.51.100.21
Instance: default, AFI: ipv6, SAFI: labeled-unicast, Total routes: 2
Prefix Preference Label Next Hop
2001:db8:0:1::21/128 20 - 192.0.2.2
2001:db8:0:1::22/128 20 - 192.0.2.2
Instance: default, AFI: ipv6, SAFI: vpn-unicast, Total routes: 4
Prefix Preference Label Next Hop
2001:db8:0:1::201/128 200 519939,bos:1 -
2001:db8:0:1::202/128 200 519939,bos:1 -
2001:db8:0:1::221/128 20 519939,bos:1 198.51.100.21
2001:db8:0:1::222/128 20 519939,bos:1 198.51.100.21
Instance: ce1-vrf, AFI: l2vpn, SAFI: vpls-vpws, Total routes: 2
Prefix Preference Label Next Hop
00.00.00.00.00.00.00.00.00.00:2001/112 20 202002 198.51.100.21
00.00.00.00.00.00.00.00.00.00:1001/112 20 201002 198.51.100.21
Instance: default, AFI: l2vpn, SAFI: vpls, Total routes: 4
Prefix Preference Label Next Hop
00.00.00.00.00.00.00.00.00.00:2000/112 200 202001,bos:1 -
00.00.00.00.00.00.00.00.00.00:2001/112 20 202002 198.51.100.21
00.00.00.00.00.00.00.00.00.00:1000/112 200 201001,bos:1 -
00.00.00.00.00.00.00.00.00.00:1001/112 20 201002 198.51.100.21BGP RIB-out
This command displays the routes that were advertised to peers.
Syntax:
| Option | Description |
|---|---|
|
Without any option, the command displays advertised BGP routes for all instances. |
|
BGP routing table summary for the given address family (AFI), all sub-address families and all instances. Supported AFI values are |
|
BGP routing table summary for the given address family (AFI) and sub-address family (SAFI), and all instances. Supported SAFI values are |
|
Detailed list view of the BGP routing table for the given address family (AFI) and sub-address family (SAFI), and all instances. |
|
BGP routing table entry for the given prefix and all instances. |
|
BGP routing table summary for the given AFI, SAFI, and instance. |
|
Detailed list view of BGP routing table for the given AFI, SAFI, and instance. |
|
BGP routing table entry for the given prefix and instance. |
|
Peer name or address |
Example: Summary view of the routes advertised to a peer
supervisor@rtbrick: op> show bgp rib-out
Flags: N - RPKI Unknown, I - RPKI Invalid, V - RPKI Valid
Instance: default, AFI: ipv4, SAFI: labeled-unicast
Peer-group: PE2, Sent routes: 6
Flags Prefix MED Lpref Origin Next Hop AS Path
192.0.2.0/30 0 - Incomplete - 65541
192.0.2.4/30 0 - Incomplete - 65541
198.51.100.11/32 0 - Incomplete - 65541
198.51.100.12/32 0 - Incomplete - 65541
198.51.100.21/32 0 - Incomplete - 65541, 65542
198.51.100.22/32 0 - Incomplete - 65541, 65542
Instance: default, AFI: ipv4, SAFI: vpn-unicast
Peer-group: PE2, Sent routes: 4
Flags Prefix MED Lpref Origin Next Hop AS Path
198.51.100.201/32 0 - Incomplete 198.51.100.11 65541
198.51.100.202/32 0 - Incomplete 198.51.100.11 65541
198.51.100.221/32 0 - Incomplete 198.51.100.11 65541, 65542
198.51.100.222/32 0 - Incomplete 198.51.100.11 65541, 65542
Instance: default, AFI: ipv6, SAFI: labeled-unicast
Peer-group: PE2, Sent routes: 6
Flags Prefix MED Lpref Origin Next Hop AS Path
2001:db8:1:1::/64 0 - Incomplete - 65541
2001:db8:2:1::/64 0 - Incomplete - 65541
2001:db8:0:1::11/128 0 - Incomplete - 65541
2001:db8:0:1::12/128 0 - Incomplete - 65541
2001:db8:0:1::21/128 0 - Incomplete - 65541, 65542
2001:db8:0:1::22/128 0 - Incomplete - 65541, 65542
Instance: default, AFI: ipv6, SAFI: vpn-unicast
Peer-group: PE2, Sent routes: 4
Flags Prefix MED Lpref Origin Next Hop AS Path
2001:db8:0:1::201/128 0 - Incomplete ::ffff:198.51.100.11 65541
2001:db8:0:1::202/128 0 - Incomplete ::ffff:198.51.100.11 65541
2001:db8:0:1::221/128 0 - Incomplete ::ffff:198.51.100.11 65541, 65542
2001:db8:0:1::222/128 0 - Incomplete ::ffff:198.51.100.11 65541, 65542
Instance: default, AFI: l2vpn, SAFI: vpls
Peer-group: PE2, Sent routes: 4
Flags Prefix MED Lpref Origin Next Hop AS Path
00.00.00.00.00.00.00.00.00.00:2000/112 0 - Incomplete 198.51.100.11 65541
00.00.00.00.00.00.00.00.00.00:2001/112 0 - Incomplete 198.51.100.11 65541, 65542
00.00.00.00.00.00.00.00.00.00:1000/112 0 - Incomplete 198.51.100.11 65541
00.00.00.00.00.00.00.00.00.00:1001/112 0 - Incomplete 198.51.100.11 65541, 65542BGP L2VPN
This command displays the BGP L2VPN information.
Syntax:
| Option | Description |
|---|---|
|
Displays pseudowire peer IP information for all instances. |
|
Displays pseudowire peer IP information for the specified instance. |
pseudowire detail |
Displays detailed pseudowire peer IP information for all instances. |
Example 1: Display L2VPN pseudowire information for instance l2vpn_ce1
supervisor@rtbrick: op> show bgp l2vpn pseudowire instance ce1-vrf
Instance: ce1-vrf, AFI: l2vpn, SAFI: vpls-vpws
Route distinguisher: 198.51.100.201:64501
Number of local interfaces: 2
Peer IP Interface Name Prefix Status Local SID Remote SID Pop Label Push Label
192.0.2.2 ifl-0/1/29/1000 00.00.00.00.00.00.00.00.00.00:1000/112 Up 1000 1001 label:201001,bos:1 label:201002
192.0.2.2 ifl-0/1/29/2000 00.00.00.00.00.00.00.00.00.00:2000/112 Up 2000 2001 label:202001,bos:1 label:202002Example 2: Display L2VPN pseudowire information
supervisor@rtbrick: op> show bgp l2vpn pseudowire
Instance: ce1-vrf, AFI: l2vpn, SAFI: vpls-vpws
Route distinguisher: 198.51.100.201:64501
Number of local interfaces: 2
Peer IP Interface Name Prefix Status Local SID Remote SID Pop Label Push Label
192.0.2.2 ifl-0/1/29/1000 00.00.00.00.00.00.00.00.00.00:1000/112 Up 1000 1001 label:201001,bos:1 label:201002
192.0.2.2 ifl-0/1/29/2000 00.00.00.00.00.00.00.00.00.00:2000/112 Up 2000 2001 label:202001,bos:1 label:202002Example 3: Detailed view of L2VPN pseudowire information
supervisor@rtbrick: op> show bgp l2vpn pseudowire detail
Instance: ce1-vrf, AFI: l2vpn, SAFI: vpls-vpws
Route distinguisher: 198.51.100.201:64501, Number of local interfaces: 2
Prefix: 00.00.00.00.00.00.00.00.00.00:1000/112
Peer IP: 192.0.2.2, Interface name: ifl-0/1/29/1000, Status: Up
Local SID: 1000, Remote SID: 1000, Pseudowire type: Remote cross connect
Pop label: label:201001,bos:1, Push label: label:201002, Control Word: False
Prefix: 00.00.00.00.00.00.00.00.00.00:2000/112
Peer IP: 192.0.2.2, Interface name: ifl-0/1/29/2000, Status: Up
Local SID: 2000, Remote SID: 2000, Pseudowire type: Remote cross connect
Pop label: label:202001,bos:1, Push label: label:202002, Control Word: False