L3VPN Operational Commands
L3VPN Show Commands
BGP Summary
This command displays BGP protocol parameters like attributes or timers that are generic to the BGP instance.
Syntax:
show bgp summary <option>
| Attribute | Description |
|---|---|
Option |
Description |
- |
Without any option, the command displays the information for all instances. |
Example 1: BGP summary for L3VPN VRF instance
supervisor@rtbrick: op> show bgp summary instance l3vpn-ce1
Instance: l3vpn-ce1
General information
Hostname: PE1, Domain name: PE1
Local AS: 65001, Version: 4
Local preference: 100, eBGP Protocol preference: 20, iBGP Protocol preference: 200
Router ID: 172.16.3.10, Cluster ID: 172.16.3.10
MED: 0, Enforce first AS: True
Address families configured:
ipv4: unicast
ipv6: unicast
Capabilities
Route refresh: True, AS4: True, Graceful restart: False,
Best route selection
Always compare MED: False, 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: 1, 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 : 1
Example 2: BGP summary for L3VPN default instance
supervisor@rtbrick: op> show bgp summary instance default
Instance: default
General information
Hostname: PE1, Domain name: PE1-BGP-Peers
Local AS: 4200000001, Version: 4
Local preference: 100, eBGP Protocol preference: 20, iBGP Protocol preference: 200
Router ID: 192.168.0.20, Cluster ID: 192.168.0.20
MED: 0, Enforce first AS: True
Address families configured:
ipv4: vpn-unicast
ipv6: vpn-unicast
Capabilities
Route refresh: True, AS4: True, Graceful restart: False,
Best route selection
Always compare MED: False, 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: 1, 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 : 1
BGP Peer
The 'show bgp peer' commands display information on BGP peers.
Syntax:
show bgp peer <option>
| Option | Description |
|---|---|
- |
Without any option, the commands display all BGP peers in all instances in a summary table format. |
detail |
Detailed information on all BGP peers in all instances in a list view. |
<peer-name> |
Detailed information on the peer with the given name. |
address <peer-address> |
Detailed information on the peer with the given IP address. |
history |
Displays BGP peer history information such as the peer state down reasons. |
history <peer-address> |
Displays BGP peer history information such as the peer state down reasons for a specified peer. |
instance <instance-name> |
Summary of all BGP peers in the given instance. |
instance <instance-name> detail |
Detailed information on all BGP peers in the given instance. |
instance <instance-name> detail <peer-name> |
Detailed information on the peer with the given name in the given instance. |
instance <instance-name> detail address <peer-address> |
Detailed information on the peer with the given IP address in the given instance. |
statistics |
Received and sent BGP prefixes per AFI/SAFI for all peers in all instances. |
statistics peer <peer-name> |
Received and sent BGP prefixes per AFI/SAFI for the peer with the given name. |
statistics peer address <peer-address> |
Received and sent BGP prefixes per AFI/SAFI for the peer with the given IP address. |
statistics instance <instance-name> peer <peer-name> |
Received and sent BGP prefixes per AFI/SAFI for the peer with the given name in the given instance. |
statistics instance <instance-name> peer address <peer-address> |
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 L3VPN VRF instance
supervisor@rtbrick: op> show bgp peer instance l3vpn-ce1 Instance: l3vpn-ce1 Peer Remote AS State Up/Down Time PfxRcvd PfxSent CE1 65009 Established 0d:07h:04m:09s 7 14
Example 2: BGP Peer Information for L3VPN default instance
supervisor@rtbrick: op> show bgp peer instance default Instance: default Peer Remote AS State Up/Down Time PfxRcvd PfxSent PE2 4200000002 Established 0d:07h:03m:03s 7 14
Example 3: Detailed view of BGP Peer Information for L3VPN VRF instance
supervisor@rtbrick: op> show bgp peer instance l3vpn-ce1 detail
Peer: CE1, Peer IP: 10.0.0.9, Remote AS: 65009, Local: 10.0.0.1, Local AS: 65001, Any AS: False
Type: ebgp, State: Established, Up/Down Time: Thu Dec 05 05:22:33 GMT +0000 2024, Reason: Cease, Sub-Code: Admin reset
Discovered on interface: -
Last transition: Thu Dec 05 05:22:33 GMT +0000 2024, Flap count: 1
Peer ID : 172.16.2.10, Local ID : 172.16.3.10
Instance : l3vpn-ce1, Peer group: ce1
6PE enabled : False,
TTL Security : False, TTL Limit : -
Timer values:
Peer keepalive : 30s, Local keepalive: 30s
Peer holddown : 90s, Local holddown : 90s
Connect retry : 30s
Timers:
Connect retry timer : 0s
Keepalive timer : expires in 3s 266331us
Holddown timer : expires in 1m 26s 901069us
NLRIs:
Sent : ['ipv4-unicast', 'ipv6-unicast']
Received : ['ipv4-unicast', 'ipv6-unicast']
Negotiated : ['ipv4-unicast', 'ipv6-unicast']
Capabilities:
Addpath sent : None
Addpath received : None
Addpath negotiated : None
Extended nexthop sent : None
Extended nexthop received : None
Extended nexthop 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 Thu Dec 05 05:22:38 GMT +0000 2024 Thu Dec 05 05:22:38 GMT +0000 2024
IPv4 labeled-unicast never never
IPv6 unicast Thu Dec 05 05:22:38 GMT +0000 2024 Thu Dec 05 05:22:38 GMT +0000 2024
IPv6 labeled-unicast never never
IPv4 VPN-unicast never never
IPv6 VPN-unicast never never
IPv4 flowspec never never
IPv6 flowspec never never
IPv4 VPN-multicast never never
L2VPN VPLS never never
L2VPN EVPN never never
RPKI Validation Stats:
Address family Valid Invalid Unknown
IPv4 unicast 0 0 0
IPv6 unicast 0 0 0
Message stats:
Session stats:
Direction Open Update Keepalive Notify Route refresh
Input 1 4 1035 0 0
Output 1 9 1032 0 0
Total stats:
Input 2 8 1101 0 0
Output 3 11 1097 1 0
Route stats:
Address family Received Sent Prefix limit Idle timeout
IPv4 unicast 4 4 0 0
IPv4 labeled-unicast 0 0 0 0
IPv6 unicast 3 3 0 0
IPv6 labeled-unicast 0 0 0 0
IPv4 VPN-unicast 0 0 0 0
IPv6 VPN-unicast 0 0 0 0
IPv4 VPN-multicast 0 0 0 0
L2VPN VPLS 0 0 0 0
L2VPN EVPN 0 0 0 0
IPv4 flowspec 0 0 0 0
IPv6 flowspec 0 0 0 0
Example 4: Detailed view of BGP Peer Information for L3VPN default instance
supervisor@rtbrick: op> show bgp peer instance default detail
Peer: PE2, Peer IP: 192.168.0.30, Remote AS: 4200000002, Local: 192.168.0.20, Local AS: 4200000001, Any AS: False
Type: ebgp, State: Established, Up/Down Time: Thu Dec 05 05:24:03 GMT +0000 2024
Discovered on interface: -
Last transition: Thu Dec 05 05:24:03 GMT +0000 2024, Flap count: 0
Peer ID : 192.168.0.30, Local ID : 192.168.0.20
Instance : default, Peer group: PE2
6PE enabled : False,
TTL Security : False, TTL Limit : -
Timer values:
Peer keepalive : 30s, Local keepalive: 30s
Peer holddown : 90s, Local holddown : 90s
Connect retry : 30s
Timers:
Connect retry timer : 0s
Keepalive timer : expires in 15s 663139us
Holddown timer : expires in 1m 15s 207239us
NLRIs:
Sent : ['ipv4-vpn-unicast', 'ipv6-vpn-unicast']
Received : ['ipv4-vpn-unicast', 'ipv6-vpn-unicast']
Negotiated : ['ipv4-vpn-unicast', 'ipv6-vpn-unicast']
Capabilities:
Addpath sent : None
Addpath received : None
Addpath negotiated : None
Extended nexthop sent : None
Extended nexthop received : None
Extended nexthop 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 never never
IPv6 unicast never never
IPv6 labeled-unicast never never
IPv4 VPN-unicast Thu Dec 05 05:24:08 GMT +0000 2024 Thu Dec 05 05:24:08 GMT +0000 2024
IPv6 VPN-unicast Thu Dec 05 05:24:08 GMT +0000 2024 Thu Dec 05 05:24:08 GMT +0000 2024
IPv4 flowspec never never
IPv6 flowspec never never
IPv4 VPN-multicast never never
L2VPN VPLS never never
L2VPN EVPN never never
Message stats:
Session stats:
Direction Open Update Keepalive Notify Route refresh
Input 1 9 1033 0 0
Output 1 4 1035 0 0
Total stats:
Input 1 9 1033 0 0
Output 2 4 1035 0 0
Route stats:
Address family Received Sent Prefix limit Idle timeout
IPv4 unicast 0 0 0 0
IPv4 labeled-unicast 0 0 0 0
IPv6 unicast 0 0 0 0
IPv6 labeled-unicast 0 0 0 0
IPv4 VPN-unicast 4 4 0 0
IPv6 VPN-unicast 3 3 0 0
IPv4 VPN-multicast 0 0 0 0
L2VPN VPLS 0 0 0 0
L2VPN EVPN 0 0 0 0
IPv4 flowspec 0 0 0 0
IPv6 flowspec 0 0 0 0
BGP RIB-in
This command displays the received routes.
Syntax:
show bgp rib-in <option>
| Option | Description |
|---|---|
- |
Without any option, the command displays information on the received BGP routing table on all instances in a summary table format. |
<afi> |
BGP routing table summary for the given address family (AFI), all sub-address families and all instances. Supported AFI values are 'ipv4', 'ipv6' and 'l2vpn'. |
<afi> <safi> |
BGP routing table summary for the given address family (AFI) and sub-address family (SAFI), and all instances. Supported SAFI values are 'evpn', 'labeled-unicast', 'unicast', 'vpn-multicast', 'vpn-unicast', and 'vpls'. |
<afi> <safi> detail |
Detailed list view of the BGP routing table for the given address family (AFI) and sub-address family (SAFI), and all instances. |
<afi> <safi> <prefix> |
BGP routing table entry for the given prefix and all instances. |
<afi> <safi> instance <instance-name> |
BGP routing table summary for the given AFI, SAFI, and instance. |
<afi> <safi> instance <instance-name> detail |
Detailed list view of BGP routing table for the given AFI, SAFI, and instance. |
<afi> <safi> instance <instance-name> <prefix> |
BGP routing table entry for the given prefix and instance. |
<afi> <safi> community <community-name> |
BGP community details for the given AFI, SAFI, and instance. |
<afi> <safi> error |
BGP route with error status for the given AFI, SAFI, and instance. |
<afi> <safi> peer <name> / peer address <ip> |
Peer name or address |
Example 1: Summary view of the BGP rib-in where you can find received information for the L3VPN VRF instance `l3vpn-ce1 ` of IPv4/IPv6 prefixes.
supervisor@rtbrick: op> show bgp rib-in ipv4 unicast
Flags: & - Imported, ! - Error, N - RPKI Unknown, I - RPKI Invalid, V - RPKI Valid
Instance: l3vpn-ce1, AFI: ipv4, SAFI: unicast
Hostname: ce1, Peer IP: 10.0.0.9
Source IP: 10.0.0.1, Total routes: 4
Flags Prefix Next Hop MED Lpref AS Path
10.0.0.0/24 10.0.0.9 0 - 65009
172.16.2.10/32 10.0.0.9 0 - 65009
172.16.2.11/32 10.0.0.9 0 - 65009
172.16.2.12/32 10.0.0.9 0 - 65009
supervisor@rtbrick: op> show bgp rib-in ipv6 unicast
Flags: & - Imported, ! - Error, N - RPKI Unknown, I - RPKI Invalid, V - RPKI Valid
Instance: l3vpn-ce1, AFI: ipv6, SAFI: unicast
Hostname: ce1, Peer IP: 10.0.0.9
Source IP: 10.0.0.1, Total routes: 3
Flags Prefix Next Hop MED Lpref AS Path
172:16:2::10/128 10.0.0.9 0 - 65009
172:16:2::11/128 10.0.0.9 0 - 65009
172:16:2::12/128 10.0.0.9 0 - 65009
supervisor@S1-STD-1-1011>bm13-tst.fsn.rtbrick.net: op>
Example 2: Summary view of the BGP rib-in where you can find received information of L3VPN default instance of address-family IPv4/IPv6 vpn-unicast
supervisor@rtbrick: op> show bgp rib-in ipv4 vpn-unicast
Flags: & - Imported, ! - Error, N - RPKI Unknown, I - RPKI Invalid, V - RPKI Valid
Instance: default, AFI: ipv4, SAFI: vpn-unicast
Hostname: PE2, Peer IP: 192.168.0.30
Source IP: 192.168.0.20, Total routes: 4
Flags Prefix Next Hop MED Lpref AS Path
10.0.1.0/24 192.168.0.30 0 - 4200000002, 65029
172.16.2.20/32 192.168.0.30 0 - 4200000002, 65029
172.16.2.21/32 192.168.0.30 0 - 4200000002, 65029
172.16.2.22/32 192.168.0.30 0 - 4200000002, 65029
supervisor@rtbrick: op> show bgp rib-in ipv6 vpn-unicast
Flags: & - Imported, ! - Error, N - RPKI Unknown, I - RPKI Invalid, V - RPKI Valid
Instance: default, AFI: ipv6, SAFI: vpn-unicast
Hostname: PE2, Peer IP: 192.168.0.30
Source IP: 192.168.0.20, Total routes: 3
Flags Prefix Next Hop MED Lpref AS Path
172:16:2::20/128 192.168.0.30 0 - 4200000002, 65029
172:16:2::21/128 192.168.0.30 0 - 4200000002, 65029
172:16:2::22/128 192.168.0.30 0 - 4200000002, 65029
BGP FIB
The 'show bgp fib' commands display the BGP forwarding table.
Syntax:
show bgp fib <option>
| Option | Description |
|---|---|
- |
Without any option, the commands display the BGP forwarding table for all address families and all instances in a summary table format. |
<afi> |
BGP forwarding table summary for the given address family (AFI), all sub-address families and all instances. Supported AFI values are 'l2vpn', 'ipv4' and 'ipv6'. |
<afi> <safi> |
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'. |
<afi> <safi> detail |
Detailed list view of the BGP forwarding table for the given address family (AFI) and sub-address family (SAFI), and all instances. |
<afi> <safi> <prefix> |
BGP forwarding table entry for the given prefix and all instances. |
<afi> <safi> instance <instance-name> |
BGP forwarding table summary for the given AFI, SAFI, and instance. |
<afi> <safi> instance <instance-name> detail |
Detailed list view of BGP forwarding table for the given AFI, SAFI, and instance. |
<afi> <safi> instance <instance-name> <prefix> |
BGP forwarding table entry for the given prefix and instance. |
Example: Summary view of the BGP FIB
supervisor@rtbrick: op> show bgp fib Instance: l3vpn-ce1, AFI: ipv4, SAFI: unicast, Total Routes: 8 Prefix Preference Out Label Next Hop 10.0.0.0/24 20 - 10.0.0.9 10.0.1.0/24 20 20001,bos:1 192.168.0.30 172.16.2.10/32 20 - 10.0.0.9 172.16.2.11/32 20 - 10.0.0.9 172.16.2.12/32 20 - 10.0.0.9 172.16.2.20/32 20 20001,bos:1 192.168.0.30 172.16.2.21/32 20 20001,bos:1 192.168.0.30 172.16.2.22/32 20 20001,bos:1 192.168.0.30 Instance: default, AFI: ipv4, SAFI: vpn-unicast, Total Routes: 8 Prefix Preference Out Label Next Hop 10.0.0.0/24 20 20001,bos:1 10.0.0.9 10.0.1.0/24 20 20005,bos:1 192.168.0.30 172.16.2.10/32 20 20001,bos:1 10.0.0.9 172.16.2.11/32 20 20001,bos:1 10.0.0.9 172.16.2.12/32 20 20001,bos:1 10.0.0.9 172.16.2.20/32 20 20005,bos:1 192.168.0.30 172.16.2.21/32 20 20005,bos:1 192.168.0.30 172.16.2.22/32 20 20005,bos:1 192.168.0.30 Instance: l3vpn-ce1, AFI: ipv6, SAFI: unicast, Total Routes: 6 Prefix Preference Out Label Next Hop 172:16:2::10/128 20 - 10.0.0.9 172:16:2::11/128 20 - 10.0.0.9 172:16:2::12/128 20 - 10.0.0.9 172:16:2::20/128 20 20002,bos:1 192.168.0.30 172:16:2::21/128 20 20002,bos:1 192.168.0.30 172:16:2::22/128 20 20002,bos:1 192.168.0.30 Instance: default, AFI: ipv6, SAFI: vpn-unicast, Total Routes: 6 Prefix Preference Out Label Next Hop 172:16:2::10/128 20 20002,bos:1 10.0.0.9 172:16:2::11/128 20 20002,bos:1 10.0.0.9 172:16:2::12/128 20 20002,bos:1 10.0.0.9 172:16:2::20/128 20 20006,bos:1 192.168.0.30 172:16:2::21/128 20 20006,bos:1 192.168.0.30 172:16:2::22/128 20 20006,bos:1 192.168.0.30
BGP RIB-out
This command displays the routes that were advertised to peers.
Syntax:
show bgp rib-out <option>
| Option | Description |
|---|---|
- |
Without any option, the command displays advertised BGP routes for all instances. |
<afi> |
BGP routing table summary for the given address family (AFI), all sub-address families and all instances. Supported AFI values are 'l2vpn', 'ipv4' and 'ipv6'. |
<afi> <safi> |
BGP routing table summary for the given address family (AFI) and sub-address family (SAFI), and all instances. Supported SAFI values are 'evpn', 'unicast', 'labeled-unicast', 'multicast', 'vpn-unicast', and 'vpls'. |
<afi> <safi> detail |
Detailed list view of the BGP routing table for the given address family (AFI) and sub-address family (SAFI), and all instances. |
<afi> <safi> <prefix> |
BGP routing table entry for the given prefix and all instances. |
<afi> <safi> instance <instance-name> |
BGP routing table summary for the given AFI, SAFI, and instance. |
<afi> <safi> instance <instance-name> detail |
Detailed list view of BGP routing table for the given AFI, SAFI, and instance. |
<afi> <safi> instance <instance-name> <prefix> |
BGP routing table entry for the given prefix and instance. |
<afi> <safi> peer <name> / peer address <ip> |
Peer name or address |
Example 1: Summary view of the routes advertised to a L3VPN VRF instance peer of IPv4/IPv6
supervisor@rtbrick: op> show bgp rib-out ipv4 unicast
Instance: l3vpn-ce1, AFI: ipv4, SAFI: unicast
Peer-group: ce1, Sent routes: 8
Prefix MED Lpref Origin Next Hop
AS Path
10.0.0.0/24 0 - Incomplete -
[65001, 65009]
10.0.1.0/24 0 - Incomplete -
[65001, 4200000002, 65029]
172.16.2.10/32 0 - Incomplete -
[65001, 65009]
172.16.2.11/32 0 - Incomplete -
[65001, 65009]
172.16.2.12/32 0 - Incomplete -
[65001, 65009]
172.16.2.20/32 0 - Incomplete -
[65001, 4200000002, 65029]
172.16.2.21/32 0 - Incomplete -
[65001, 4200000002, 65029]
172.16.2.22/32 0 - Incomplete -
[65001, 4200000002, 65029]
supervisor@rtbrick: op> show bgp rib-out ipv6 unicast
Instance: l3vpn-ce1, AFI: ipv6, SAFI: unicast
Peer-group: ce1, Sent routes: 6
Prefix MED Lpref Origin Next Hop
AS Path
172:16:2::10/128 0 - Incomplete -
[65001, 65009]
172:16:2::11/128 0 - Incomplete -
[65001, 65009]
172:16:2::12/128 0 - Incomplete -
[65001, 65009]
172:16:2::20/128 0 - Incomplete -
[65001, 4200000002, 65029]
172:16:2::21/128 0 - Incomplete -
[65001, 4200000002, 65029]
172:16:2::22/128 0 - Incomplete -
[65001, 4200000002, 65029]
Example 2: Summary view of the routes advertised to L3VPN default instance of address-family IPv4/IPv6 vpn-unicast
supervisor@rtbrick: op> show bgp rib-out ipv4 vpn-unicast
Instance: default, AFI: ipv4, SAFI: vpn-unicast
Peer-group: PE2, Sent routes: 8
Prefix MED Lpref Origin Next Hop
AS Path
10.0.0.0/24 0 - Incomplete -
[4200000001, 65009]
10.0.1.0/24 0 - Incomplete -
[4200000001, 4200000002, 65029]
172.16.2.10/32 0 - Incomplete -
[4200000001, 65009]
172.16.2.11/32 0 - Incomplete -
[4200000001, 65009]
172.16.2.12/32 0 - Incomplete -
[4200000001, 65009]
172.16.2.20/32 0 - Incomplete -
[4200000001, 4200000002, 65029]
172.16.2.21/32 0 - Incomplete -
[4200000001, 4200000002, 65029]
172.16.2.22/32 0 - Incomplete -
[4200000001, 4200000002, 65029]
supervisor@rtbrick: op> show bgp rib-out ipv6 vpn-unicast
Instance: default, AFI: ipv6, SAFI: vpn-unicast
Peer-group: PE2, Sent routes: 6
Prefix MED Lpref Origin Next Hop
AS Path
172:16:2::10/128 0 - Incomplete -
[4200000001, 65009]
172:16:2::11/128 0 - Incomplete -
[4200000001, 65009]
172:16:2::12/128 0 - Incomplete -
[4200000001, 65009]
172:16:2::20/128 0 - Incomplete -
[4200000001, 4200000002, 65029]
172:16:2::21/128 0 - Incomplete -
[4200000001, 4200000002, 65029]
172:16:2::22/128 0 - Incomplete -
[4200000001, 4200000002, 65029]