BGP Operational Commands
BGP Show Commands
The BGP show commands provide detailed information about the BGP protocol operation and BGP routes.
BGP Summary
This command displays BGP protocol parameters like attributes or timers that are generic to the BGP instance.
Syntax:
show bgp summary <option>
| Option | Description |
|---|---|
- |
Without any option, the commands displays the information for all instances. |
instance <instance-name> |
BGP summary information for the given instance. |
Example: BGP summary for the default instance
supervisor@rtbrick: op> show bgp summary instance default
Instance: default
General information
Hostname: PE1, Domain name:
Local AS: 1000, Version: 4
Local preference: 100, Protocol preference: 200
Router ID: 198.51.100.102, Cluster ID: 198.51.100.102
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. |
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. |
| Although 6PE routes are labeled, they are handled as unicast routes, and therefore will be shown as IPv6 unicast in the BGP peer statistics. |
Example 1: BGP Peer Summary View
supervisor@rtbrick: op> show bgp peer Instance: default Peer Remote AS State Up/Down Time PfxRcvd PfxSent PE2 2000 Established 11d:22h:18m:30s 12 20 Instance: default Peer Remote AS State Up/Down Time PfxRcvd PfxSent CE1 65535 Established 6d:02h:28m:02s 2 2 CE1 65535 Established 6d:02h:27m:45s 2 2
Example 2: BGP Peer Detail View
supervisor@rtbrick: op> show bgp peer detail
Peer: PE2, Peer IP: 198.51.100.39, Remote AS: 2000, Local: 198.51.100.29, Local AS: 1000, Any AS: False
Type: ebgp, State: Established, Uptime: 11d:22h:18m:48s, Reason: Cease, Sub-Code: Admin shutdown
Discovered on interface: -
Last transition: Thu Nov 19 05:33:28 GMT +0000 2020, Flap count: 1
Peer ID : 198.51.100.106, Local ID : 198.51.100.102
Instance : default, Peer group: to_pe2
6PE enabled : False
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 1s 488011us
Holddown timer : expires in 1m 15s 85437us
NLRIs:
Sent : ['ipv6-unicast', 'ipv4-vpn-unicast', 'ipv6-vpn-unicast', 'ipv6-labeled-unicast']
Received : ['ipv6-unicast', 'ipv6-labeled-unicast', 'ipv4-vpn-unicast', 'ipv6-vpn-unicast']
Negotiated : ['ipv6-unicast', 'ipv6-labeled-unicast', 'ipv4-vpn-unicast', 'ipv6-vpn-unicast']
Capabilities:
Addpath sent : None
Addpath received : None
Addpath negotiated : None
Extended nexthop sent : ['ipv4-vpn-unicast']
Extended nexthop received : ['ipv4-vpn-unicast']
Extended nexthop negotiated : ['ipv4-vpn-unicast']
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
End of RIB:
Address family Sent Received
IPv4 unicast never never
IPv4 labeled-unicast never never
IPv6 unicast Thu Nov 19 05:33:30 GMT +0000 2020 Thu Nov 19 05:33:30 GMT +0000 2020
IPv6 labeled-unicast Thu Nov 19 05:33:30 GMT +0000 2020 Thu Nov 19 05:33:30 GMT +0000 2020
IPv4 VPN-unicast Thu Nov 19 05:33:30 GMT +0000 2020 Thu Nov 19 05:33:30 GMT +0000 2020
IPv6 VPN-unicast Thu Nov 19 05:33:30 GMT +0000 2020 Thu Nov 19 05:33:30 GMT +0000 2020
IPv4 VPN-multicast never never
Message stats:
Session stats:
Direction Open Update Keepalive Notify Route refresh
Input 1 38 41196 0 0
Output 1 22 41207 0 0
Total stats:
Input 2 48 44618 1 0
Output 3 32 44624 0 0
Route stats:
Address family Received Sent
IPv4 unicast 0 0
IPv4 labeled-unicast 0 0
IPv6 unicast 2 3
IPv6 labeled-unicast 2 3
IPv4 VPN-unicast 4 7
IPv6 VPN-unicast 4 7
IPv4 multicast 0 0
IPv4 VPN-multicast 0 0
<...>
Example 3: BGP Peer Statistics
supervisor@rtbrick: op> show bgp peer statistics instance default peer PE2
Instance: default
Peer AFI SAFI PfxRcvd PfxSent
PE2 ipv4 unicast 0 0
ipv4 labeled-unicast 0 0
ipv6 unicast 2 3
ipv6 labeled-unicast 2 3
ipv4 vpn-unicast 4 7
ipv6 vpn-unicast 4 7
ipv4 multicast 0 0
ipv4 vpn-multicast 0 0
BGP Peer Group
The 'show bgp peer-group' commands display parameters like BGP attributes that are specific to the respective peer groups.
Syntax:
show bgp peer-group <option> …
| Option | Description |
|---|---|
- |
Without any option, the commands display information on all peer groups in all instances. |
<peer-group-name> |
Information on the peer group with the given name. |
instance <instance-name> |
All peer groups in the given instance. |
instance <instance-name> <peer-group-name> |
Information on the peer group with the given name in the given instance. |
Example: BGP Peer Group
supervisor@rtbrick: op> show bgp peer-group to_pe2
Instance: default
Peer group name : to_pe2
Remote AS : 2000
Import rule : None
Export rule : None
Remove AS : None
Nexthop self : None
Multipath iBGP : None
Multipath eBGP : None
Client-to-Client : None
Add path : None
eBGP multihop : None
Hop (TTL) : None
Any AS : None
Update VPNv4 NH : None
Update MVPN NH : None
BGP FIB
The 'show bgp fib' commands display the BGP forwarding table. In contrast to the 'show bgp rib' commands, the output of the 'show bgp fib' commands includes only the selected routes. The BGP route selection occurs between the RIB and the FIB.
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 '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', and 'vpn-unicast'. |
<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 1: Summary view of the BGP FIB for IPv6, all SAFIs and all instances
supervisor@rtbrick: op> show bgp fib ipv6 Instance: default, AFI: ipv6, SAFI: unicast Prefix Preference Out Label Next Hop 2001:db8:0:2::/32 20 - 198.51.100.39 2001:db8:0:2::/32 20 - 198.51.100.39 Instance: services, AFI: ipv6, SAFI: unicast Prefix Preference Out Label Next Hop 2001:db8:0:6::/32 200 - 2001:db8:0:4:: Instance: default, AFI: ipv6, SAFI: labeled-unicast Prefix Preference Out Label Next Hop 2001:db8:0:2::/32 20 2003 198.51.100.39 2001:db8:0:2::/32 20 2003 198.51.100.39 Instance: default, AFI: ipv6, SAFI: vpn-unicast Prefix Preference Out Label Next Hop 2001:db8:0:5::/32 200 20003,bos:1 2001:db8:0:6::/32 200 20003,bos:1 2001:db8:0:8::/32 200 20003,bos:1 2001:db8:0:9::/32 20 20006,bos:1 2001:db8:0:7:: 2001:db8:0:10::/32 20 20006,bos:1 2001:db8:0:7:: 2001:db8:0:11::/32 20 20006,bos:1 2001:db8:0:7:: 2001:db8:0:12::/32 20 20006,bos:1 2001:db8:0:7::
Example 2: Detailed view of the BGP FIB for IPv6 VPN unicast routes in the default instances
supervisor@rtbrick: op> show bgp fib ipv6 vpn-unicast instance default detail
Instance: default, AFI: ipv6, SAFI: vpn-unicast
Prefix: 2001:db8:0:5::/32
Next hop key: 2b38f6f1d2ae56178666d1edcffd18a85fd4509bcac9a21f
Peer: None, Peer domain: None
Route source: bgp-local, Send path ID: 405188370, Received path ID: None, Path hash: None
As path: None, Originator ID: None, Origin: Incomplete
Community: None
Extended community: ['target:198.51.100.93:2']
Cluster list: None
IGP metric: None, Local preference: 100, Multi exit discriminator: 0
Preference: 200, External route: None, Readvertised route: None
Label: 20003,bos:1, Route up: None
Prefix: 2001:db8:0:6::/32
Next hop key: 62b6c375c2ee2cb053bd5482ec1b7df18e271b6e0d37a4b0
Peer: None, Peer domain: None
Route source: bgp-local, Send path ID: 2400017309, Received path ID: None, Path hash: None
As path: None, Originator ID: None, Origin: Incomplete
Community: None
Extended community: ['target:198.51.100.93:2']
Cluster list: None
IGP metric: None, Local preference: 100, Multi exit discriminator: None
Preference: 200, External route: None, Readvertised route: None
Label: 20003,bos:1, Route up: None
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' 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 'labeled-unicast', 'unicast', 'vpn-multicast', and 'vpn-unicast'. |
<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 BGP rib-in.
supervisor@rtbrick: op> show bgp rib-in
Instance: ip2vrf, AFI: ipv4, SAFI: unicast
Peer: None, Received routes: 10
Prefix Next Hop MED Local Preference AS Path
198.51.100.75/24 198.51.100.93 - 100 -
198.51.100.76/24 198.51.100.94 - 100 -
198.51.100.77/24 198.51.100.99 - 100 -
198.51.100.78/24 198.51.100.94 - 100 -
198.51.100.79/24 198.51.100.99 - 100 -
198.51.100.82/24 198.51.100.94 - 100 -
198.51.100.93/24 198.51.100.93 - 100 -
198.51.100.94/24 198.51.100.94 - 100 -
198.51.100.99/24 198.51.100.99 - 100 -
198.51.100.99/24 198.51.100.99 - 100 -
Instance: default, AFI: ipv4, SAFI: vpn-unicast
Peer: None, Received routes: 4
Prefix Next Hop MED Local Preference AS Path
198.51.100.14/24 2001:db8:0:1::/32 0 - 4200000004
198.51.100.17/24 2001:db8:0:1::/32 0 - 4200000004
198.51.100.16/24 2001:db8:0:1::/32 0 - 4200000004
Example 2: Summary view of the BGP rib-in for IPv4, all SAFIs and all instances
supervisor@rtbrick: op> show bgp rib-in ipv4
Instance: ip2vrf, AFI: ipv4, SAFI: unicast
Peer: None, Received routes: 10
Prefix Next Hop MED Local Preference AS Path
198.51.100.75/24 198.51.100.93 - 100 -
198.51.100.76/24 198.51.100.94 - 100 -
198.51.100.77/24 198.51.100.95 - 100 -
198.51.100.78/24 198.51.100.94 - 100 -
198.51.100.79/24 198.51.100.95 - 100 -
198.51.100.82/24 198.51.100.94 - 100 -
198.51.100.93/24 198.51.100.93 - 100 -
198.51.100.94/24 198.51.100.94 - 100 -
198.51.100.95/24 198.51.100.95 - 100 -
198.51.100.99/24 198.51.100.95 - 100 -
Instance: default, AFI: ipv4, SAFI: vpn-unicast
Peer: None, Received routes: 4
Prefix Next Hop MED Local Preference AS Path
198.51.100.14/24 2001:db8:0:13:: 0 - 4200000004
198.51.100.17/24 2001:db8:0:13:: 0 - 4200000004
Example 3: Summary view of the received routes
supervisor@rtbrick: op> show bgp rib-in ipv4 unicast peer address 198.51.100.94
Instance: ip2vrf, AFI: ipv4, SAFI: unicast
Peer: None, Received routes: 13
Prefix Next Hop MED Local Preference AS Path
198.51.100.75/24 198.51.100.93 - 100 -
198.51.100.76/24 198.51.100.94 - 100 -
198.51.100.77/24 198.51.100.95 - 100 -
198.51.100.78/24 198.51.100.94 - 100 -
198.51.100.79/24 198.51.100.95 - 100 -
198.51.100.82/24 198.51.100.94 - 100 -
198.51.100.93/24 198.51.100.93 - 100 -
198.51.100.113/24 198.51.100.93 - 100 4200000003
198.51.100.114/24 198.51.100.93 - 100 4200000004
198.51.100.94/24 198.51.100.94 - 100 -
198.51.100.95/24 198.51.100.95 - 100 -
198.51.100.99/24 198.51.100.95 - 100 -
BGP RIB-out
This command displays the send routes.
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 '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 'unicast', 'labeled-unicast', 'multicast', and 'vpn-unicast'. |
<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 peer
supervisor@rtbrick: op> show bgp rib-out ipv4 unicast peer CE1-Vrf1
Instance: vrf1, AFI: ipv4, SAFI: unicast
Peer: CE1-Vrf1, Sent routes: 4
Prefix MED Local Preference Origin Next Hop AS Path
198.51.100.104/24 0 - Incomplete - 65001
198.51.100.113/24 0 - Incomplete - 65001
198.51.100.117/24 0 - Incomplete - 65001
198.51.100.106/24 0 - Incomplete - 65001
Example 2: Detailed view of the routes advertised to a peer
supervisor@rtbrick: op> show bgp rib-out
Instance: vrf1, AFI: ipv4, SAFI: unicast
Peer-group: pe1_ce1, Sent routes: 4
Prefix MED Local Preference Origin Next Hop AS Path
198.51.100.104/24 0 - Incomplete - 65001
198.51.100.113/24 0 - Incomplete - 65001
198.51.100.105/24 0 - Incomplete - 65001
198.51.100.106/24 0 - Incomplete - 65001
Instance: vrf1, AFI: ipv6, SAFI: unicast
Peer-group: pe1_ce1, Sent routes: 3
Prefix MED Local Preference Origin Next Hop AS Path
2001:db8:0:14::/24 0 - Incomplete - 65001
2001:db8:0:15::/24 0 - Incomplete - 65001
2001:db8:0:16::/24 0 - Incomplete - 65001
TCP Connections
This command displays information of the TCP connections used by BGP.
Syntax:
show bgp tcp bgp.iod.1 connection <option> …
| Option | Description |
|---|---|
- |
Without any option, the command displays the TCP connections used by BGP for all instances. |
detail |
Detailed list view of the the TCP connections for the given address family (AFI) and sub-address family (SAFI), and all instances. |
prefix |
TCP connections for the given prefix and all instances. |
instance <instance-name> |
TCP connections summary for the given instance. |
Example 1: Summary view of the BGP TCP connections
supervisor@leaf1: cfg> show bgp tcp bgp.iod.1 connection Instance Local IP Address Remote IP Address Local Port Remote Port State default 2001:db8:0:189:: 2001:db8:0:38:: 179 49568 Established default 2001:db8:0:61:: 2001:db8:0:237:: 50529 179 Established
Example 2: Detailed information of the BGP TCP connections
supervisor@leaf1: cfg> show bgp tcp bgp.iod.1 connection detail
Instance: default
Local IPv6 address : 2001:db8:0:189::
Remote IPv6 address : 2001:db8:0:38::
Local port : 179
Remote port : 49568
State : Established
Internal
Options : -- | Keepalive | --
TOS : 0
TTL : 1
Priority : 1
Flags : -|-|-|-|-|Nagle Disabled|-|Wnd Scale|-|-|-
Last trigger : 27
Timer : 37624
Timers
Poll : 0s
Poll interval : 0s
Retransmission : 65535s
Receiver
Expected sequence : 32965979
Available window : 96816
Announced window : 95562
Announced wnd RT edge : 33061541
MSS : 1440
RTT estimate : 0
Timeout
Sequence : 17683639s
Retransmission : 3s
Retransmissions : 0s
Duplicate acks : 0s
Highest ack'd sequence : 17683658s
Congestion
Window : 162834
Persist count : 0
Send scale : 5
Receive scale : 5
Sender
Next seq to send : 17683658
Last wnd update seq : 32965979
Last wnd update ack : 17683658
Window : 96192
Max window announced : 96800
Acknowledged : None
Send buf : 56476
Send queue length : 0
Unsent oversize : 0
TS last ack sent : 818020352
Keepalive
Next keepalive idle : 7200000
Keepalive interval : 75000
Keepalive count : 9
Keep sent count : 0
Authentication
Auth type : HMAC-SHA-256-128
key1-id : 255
key2-id : 0
Algorithm mismatch : 0
Secret mismatch : 43
Latest sent digest : 850fea02c98912ce4497ec2b101a4f7c
Latest received digest : a718fb88e0d7fd4a00843e6aec03c864
TCP Statistics
This command displays TCP statistics information of the TCP connections used by BGP.
Syntax:
show bgp tcp bgp.iod.1 statistics <option> …
| Option | Description |
|---|---|
- |
Without any option, the command displays the TCP statistics information of the TCP connections used by BGP for all instances. |
instance <instance-name> |
TCP connections summary for the given instance. |
Example: TCP statistics information of the TCP connections used by BGP for the default instance
supervisor@rtbrick: op> show bgp tcp bgp.iod.1 statistics instance default
Instance: default
IP statistics
Transmitted packets : 3103242412
Received packets : 47351
Forwarded packets : 0
Dropped packets : 0
Checksum error : 0
Invalid length error : 0
Out of memory error : 0
Routing error : 0
Protocol error : 0
Error in options : 0
Misc error : 0
Cachehit : 0
TCP statistics
Transmitted packets : 365499779
Received packets : 5577
Forwarded packets : 3014656
Dropped packets : 46
Checksum error : 0
Invalid length error : 0
Out of memory error : 0
Routing error : 3014656
Protocol error : 46
Error in options : 0
Misc error : 2097152
Cachehit : 1557594144
BGP Clear Commands
Clear commands allow to reset operational states.
BGP Peer
This commands resets BGP peerings.
Syntax:
clear bgp peer <option> …
| Option | Description |
|---|---|
all |
Clears all the BGP peers. |
all soft-in <afi> <safi> |
Sends route refresh to all neighbors. |
all soft-out <afi> <safi> |
Re-advertises all the routes previously sent to the peer. |
all stats |
Clears the statistics of all the BGP peers. |
instance <instance> <peer-ip> |
Clears the peer for the given instance and peer IP address. |
instance <instance> <peer-ip> source <src-ip> |
Clears a specific peer for the given peer IP address and source IP address in the specified instance. |
instance <instance> all |
Clears all peers in the given instance. |
instance <instance> <peer-ip> source <src-ip> soft-in <afi> <safi> |
Sends route refresh to specific peer for the given instance, peer-ip, source-ip and address-family. |
instance <instance> <peer-ip> soft-in <afi> <safi> |
Sends route refresh to peer for the given instance, peer-ip and address-family. |
instance <instance> all soft-in <afi> <safi> |
Sends route refresh to all peers for the given instance and address family. |
instance <instance> <peer-ip> source <src-ip> soft-out <afi> <safi> |
Re-advertises all the routes previously sent to the specific peer for the given instance, peer-ip, source-ip and address-family. |
instance <instance> <peer-ip> soft-out <afi> <safi> |
Sends route refresh to peer for a given instance, peer-ip and address-family. |
instance <instance> all soft-out <afi> <safi> |
Sends route update to all peers for given instance and address family. |
instance <instance> <peer-ip> source <src-ip> stats |
Clears the statistics of a specific peer for a given instance, peer-ip and source-IP. |
instance <instance> <peer-ip> stats |
Clears the statistics of the peer for a given instance and peer-IP. |
instance <instance> all stats |
Clears the statistics of all peers for a given instance. |
Example: The example below shows how to clear all the BGP peers.
supervisor@rtbrick: op> clear bgp peer all