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, eBGP Protocol preference: 20, iBGP Protocol preference: 200 Router ID: 198.51.100.102, Cluster ID: 198.51.100.102 Capabilities Route refresh: True, AS4: True, Graceful restart: False, L2VPN EVPN:True L2VPN VPLS:True 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
To access the Operational State API that corresponds to this CLI, click
here.
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. |
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. |
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.net: cfg> sh bgp peer detail Peer: S1_default, Peer IP: fe80::7860:6700:c0:2, Remote AS: 4200000002, Local: fe80::7852:4200:c0:0, Local AS: 4200000001, Any AS: False Type: ebgp, State: Established, Up/Down Time: Fri May 23 08:57:55 GMT +0000 2025, Reason: Cease, Sub-Code: Admin shutdown Discovered on interface: hostif-0/0/0/0 Last transition: Fri May 23 08:57:55 GMT +0000 2025, Flap count: 2 Peer ID : 192.168.0.20, Local ID: 192.168.0.10 Instance : default, Peer group: hostif-0/0/0_default_peer_group_0 6PE enabled : False TTL security : True, TTL limit: 1 Authentication: ID: BGP_AUTH_MD5_ipv6_ll_0, Algorithm: MD5 Timer values: Peer keepalive : 10s, Local keepalive: 15s Peer holddown : 30s, Local holddown : 30s Connect retry : 15s Timers: Connect retry timer : 0 Keepalive timer : expires in 1s 375594us Holddown timer : expires in 23s 848144us NLRIs: Sent : ['l2vpn-vpls', 'ipv6-labeled-unicast'] Received : ['l2vpn-vpls', 'ipv6-labeled-unicast'] Negotiated : ['l2vpn-vpls', 'ipv6-labeled-unicast'] Capabilities: Addpath sent : None Addpath received : None Addpath negotiated : None Extended nexthop sent : ['l2vpn-vpls'] Extended nexthop received : ['l2vpn-vpls'] Extended nexthop negotiated : ['l2vpn-vpls'] <...>
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
Example 4: BGP Peer history for a specified peer
supervisor@rtbrick.net: op> show bgp peer history peer address 192:168::40 Instance: vrf1 Peer Address Source Address Type Last Reset Reason 192:168::40 192:168:5::20 FSM Error FSM Error, Sub-Code: Unexpected message in OpenSent State
To access the Operational State API that corresponds to this CLI, click
here.
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 1: 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
Example 2: BGP peer group with TTL limit
supervisor@rtbrick.net: cfg> sh bgp peer-group Instance: default Peer group name: PE2 Any AS: True Local AS: 4200000001, No prepend: True, Replace AS: True TTL security: True, TTL limit: 1
Example 3: BGP peer group with EBGP multihop
supervisor@rtbrick.net: cfg> sh bgp peer-group Instance: default Peer group name: PE2 Remote AS: 4200000002, EBGP multihop: 255 Local AS: 4200000001, No prepend: True, Replace AS: True
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. |
instance |
Instance name. |
summary |
Displays summary information. |
<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: Summary information for the installed BGP routes in the FIB under a specific BGP instance.
supervisor@rtbrick.net: cfg> show bgp fib instance default summary Instance: default, Total Routes: 1230200 Address family Routes IPv4 unicast 1000100 IPv6 unicast 230100 Total Routes 1230200
Example : 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: 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 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'] Large community: None Cluster list: None IGP metric: None, Local preference: 100, Multi exit discriminator: 0 Preference: 200, External route: None, Readvertised route: None Route up: None Next hop: 12.0.0.2, Label: 20003,bos:1 Prefix: 2001:db8:0:6::/32 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'] Large community: None Cluster list: None IGP metric: None, Local preference: 100, Multi exit discriminator: None Preference: 200, External route: None, Readvertised route: None Route up: None Next hop: 12.0.0.2, Label: 20003,bos:1
Example: Summary information for the installed BGP routes in the FIB under a specific BGP instance.
supervisor@rtbrick.net: cfg> show bgp fib instance default summary Instance: default, Total Routes: 1230200 Address family Routes IPv4 unicast 1000100 IPv6 unicast 230100 Total Routes 1230200
Example: Summary information for the installed BGP routes in the FIB for a specified AFI and SAFI within a specific BGP instance.
supervisor@rtbrick.net: cfg> show bgp fib ipv6 unicast summary Instance: default, Total Routes: 230100 Address family Routes IPv6 unicast 230100 Total Routes 230100
Example: Summary information for the installed BGP routes in the FIB.
supervisor@rtbrick.net: cfg> show bgp fib summary Instance: default, Total Routes: 1230200 Address family Routes IPv4 unicast 1000100 IPv6 unicast 230100 Total Routes 1230200
BGP RIB-in
This command displays the total 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. |
summary |
Displays summary information. |
instance <instance-name> |
Name of the instance. |
import source <source-name> |
Displays the information for BGP routes received from a specified neighbor (source) before the import policy is applied. |
peer address <peer-ip> |
Displays routes learned from a specific BGP peer IP address. |
import source <source-name> detail |
Detailed information for BGP routes received from a specified neighbor (source) before the import policy is applied. |
filter source <source-name> |
Displays flowspec routes based on the source prefix (where the FlowSpec rule originated). |
peer address <peer-ip> source <source> |
Displays routes learned from a specific BGP peer IP address for the source prefix of the FlowSpec rule. |
peer address <peer_ip> source <source> detail |
Detailed view of routes learned from a specific BGP peer IP address for the source prefix of the FlowSpec rule. |
peer <peer-name> source <source> |
Displays routes learned from a specific BGP peer (name) for the source prefix of the FlowSpec rule. |
peer <peer-name> source <source> detail |
Detailed view of routes learned from a specific BGP peer (name) for the source prefix of the FlowSpec rule. |
policy-accept |
Shows only the routes that were accepted by the BGP import policy. |
policy-accept detail |
Detailed view of the routes that were accepted by the BGP import policy. |
policy-deny |
Shows only the routes that were denied by the BGP import policy. |
policy-deny detail |
Detailed view of the routes that were denied by the BGP import policy. |
<safi> source <source> |
Display BGP routing information that has been received from a specific BGP peer (source) for a specified SAFI. |
<safi> source <source> detail |
Detailed view of BGP routes which have been received from a specific BGP peer (source) for a specified SAFI. |
AFI source <source> |
Displays BGP routes received from a specific BGP neighbor (source) for a specified address family. |
AFI source <source> detail |
Detailed view of BGP routes received from a specific BGP neighbor (source) for a specified address family. |
source <source> |
Displays a summarized list of all BGP routes received from a peer (source). |
source <source> detail |
View detailed information about the BGP routes received from the specified neighbor. |
<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> 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 |
import |
Summary information for imported routes. |
Example: The summary of all routes received from a specific BGP instance.
supervisor@rtbrick.net: cfg> show bgp rib-in summary Instance: default, Total Routes: 1230206 Hostname: Local, Peer IP: 0.0.0.0, Source IP: 0.0.0.0 Address family Routes IPv4 unicast 101 Total Routes 101 Hostname: L1_default, Peer IP: 12.0.0.1, Source IP: 12.0.0.2 Address family Routes IPv4 unicast 2 IPv6 unicast 2 Total Routes 4 Peer IP: 90.156.101.2, Source IP: 90.156.101.1 Address family Routes IPv4 unicast 10000 IPv6 unicast 2300 Total Routes 12300 <...>
Example: Summary view of the BGP rib-in.
supervisor@rtbrick: op> show bgp rib-in Flags: & - Imported, ! - Error Instance: vrf1, AFI: ipv4, SAFI: unicast Hostname: Local, Peer IP: 0.0.0.0 Source IP: 0.0.0.0, Total routes: 10 Prefix Next Hop MED Lpref 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 Hostname: Local, Peer IP: 0.0.0.0 Source IP: 0.0.0.0, Total routes: 4 Prefix Next Hop MED Lpref 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: Summary view of the BGP rib-in for IPv4, with error flag.
supervisor@rtbrick>rtbrick.net: op> show bgp rib-in Flags: & - Imported, ! - Error Instance: default, AFI: ipv4, SAFI: unicast Hostname: Local, Peer IP: 0.0.0.0 Source IP: 0.0.0.0, Total routes: 4 Flags Prefix Next Hop MED Lpref AS Path 12.0.0.0/24 - 0 100 - 12.1.0.0/24 - 0 100 - 192.168.0.10/32 - 0 100 - 192.168.0.11/32 - 0 100 - Hostname: P1, Peer IP: 12.0.0.2 Source IP: 12.0.0.1, Total routes: 4 Flags Prefix Next Hop MED Lpref AS Path 12.0.0.0/24 12.0.0.2 0 - 4200000002 12.1.0.0/24 12.0.0.2 0 - 4200000002 192.168.0.20/32 12.0.0.2 0 - 4200000002 192.168.0.21/32 12.0.0.2 0 - 4200000002
Example: Summary view of the BGP rib-in for IPv4, all SAFIs and all instances
supervisor@rtbrick: op> show bgp rib-in ipv4 Flags: & - Imported, ! - Error Instance: vrf1, AFI: ipv4, SAFI: unicast Hostname: Local, Peer IP: 0.0.0.0 Source IP: 0.0.0.0, Total routes: 10 Prefix Next Hop MED Lpref 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.95/24 198.51.100.95 - 100 - 198.51.100.99/24 198.51.100.95 - 100 - Instance: default, AFI: ipv4, SAFI: vpn-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 198.51.100.14/24 2001:db8:0:13:: 0 - 4200000004 198.51.100.17/24 2001:db8:0:13:: 0 - 4200000004
Example: Summary view of the received routes
supervisor@rtbrick: op> show bgp rib-in ipv4 unicast instance default peer address 198.51.100.94 Flags: & - Imported, ! - Error Instance: vrf1, AFI: ipv4, SAFI: unicast Hostname: Local, Peer IP: 0.0.0.0 Source IP: 0.0.0.0, Total routes: 13 Prefix Next Hop MED Lpref 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
Example: Summary view of the received routes which were accepted by import policy
supervisor@rtbrick.net: op> show bgp rib-in instance default policy-accept Flags: & - Imported, ! - Error, N - RPKI Unknown, I - RPKI Invalid, V - RPKI Valid Instance: default, AFI: ipv4, SAFI: unicast Peer IP: 23.0.1.3 Source IP: 23.0.1.2, Total routes: 109 Flags Prefix Next Hop MED Lpref AS Path 0.0.0.0/8 23.0.1.3 - - 40000003 0.0.0.0/9 23.0.1.3 - - 40000003 0.0.0.0/10 23.0.1.3 - - 40000003 0.0.0.0/25 23.0.1.3 - - 40000003 0.0.0.0/26 23.0.1.3 - - 40000003 0.0.0.0/27 23.0.1.3 - - 40000003 0.0.0.0/28 23.0.1.3 - - 40000003 0.0.0.0/29 23.0.1.3 - - 40000003 <...>
Example: Detailed view of the received routes which were accepted by import policy
supervisor@rtbrick.net: op> show bgp rib-in instance default policy-accept detail Instance: default, AFI: ipv4, SAFI: unicast Peer IP: 23.0.1.3 Source IP: 23.0.1.2, Total routes: 109 Prefix: 0.0.0.0/8, Received path ID: 0, Next hop: 23.0.1.3 Status: Policy-Accept Protocol source: bgp Origin: IGP Send path ID: 3483057950 AS path: [40000003] Last update: 0d:00h:17m:51s Prefix: 0.0.0.0/9, Received path ID: 0, Next hop: 23.0.1.3 Status: Policy-Accept Protocol source: bgp Origin: IGP Send path ID: 3483057950 AS path: [40000003] Last update: 0d:00h:17m:51s Prefix: 0.0.0.0/10, Received path ID: 0, Next hop: 23.0.1.3 Status: Policy-Accept Protocol source: bgp Origin: IGP Send path ID: 3483057950 AS path: [40000003] Last update: 0d:00h:17m:51s Prefix: 0.0.0.0/25, Received path ID: 0, Next hop: 23.0.1.3 Status: Policy-Accept Protocol source: bgp Origin: IGP Send path ID: 3483057950 AS path: [40000003] Last update: 0d:00h:17m:51s Prefix: 0.0.0.0/26, Received path ID: 0, Next hop: 23.0.1.3
Example: Detailed view of the received routes
supervisor@rtbrick.net: cfg> show bgp rib-in ipv4 unicast detail Instance: default, AFI: ipv4, SAFI: unicast Hostname: Local, Peer IP: 0.0.0.0 Source IP: 0.0.0.0, Total routes: 8 Prefix: 12.0.0.0/24, Received path ID: 2 Status: Valid Protocol source: direct Origin: Incomplete Send path ID: 1453600679 MED: 0 Local preference: 100 Last update: 0d:00h:00m:33s Prefix: 12.1.0.0/24, Received path ID: 2 Status: Valid Protocol source: direct Origin: Incomplete Send path ID: 1453600679 MED: 0 Local preference: 100 Last update: 0d:00h:00m:33s Prefix: 192.168.0.10/32, Received path ID: 2 Status: Valid Protocol source: direct Origin: Incomplete Send path ID: 1453600679 MED: 0 Local preference: 100 Last update: 0d:00h:00m:33s Prefix: 192.168.2.10/32, Received path ID: 2 Status: Valid Protocol source: direct Origin: Incomplete Send path ID: 1453600679 MED: 0 Local preference: 100
Example: The summary of all routes received from a specific BGP instance.
supervisor@rtbrick.net: cfg> show bgp rib-in summary Instance: default, Total Routes: 1230206 Hostname: Local, Peer IP: 0.0.0.0, Source IP: 0.0.0.0 Address family Routes IPv4 unicast 101 Total Routes 101 Hostname: L1_default, Peer IP: 12.0.0.1, Source IP: 12.0.0.2 Address family Routes IPv4 unicast 2 IPv6 unicast 2 Total Routes 4 Peer IP: 90.156.101.2, Source IP: 90.156.101.1 Address family Routes IPv4 unicast 10000 IPv6 unicast 2300 Total Routes 12300 <...>
Example: Summary of routes for a specific AFI and SAFI.
supervisor@rtbrick.net: cfg> show bgp rib-in ipv6 unicast summary Instance: default, Total Routes: 230103 Hostname: L1_default, Peer IP: 12.0.0.1, Source IP: 12.0.0.2 Address family Routes IPv6 unicast 2 Total Routes 2 Peer IP: 90.156.101.2, Source IP: 90.156.101.1 Address family Routes IPv6 unicast 2300 Total Routes 2300 Peer IP: 90.156.102.2, Source IP: 90.156.102.1 Address family Routes IPv6 unicast 2300 Total Routes 2300 <...>
Example: Summary information for the (imported) routes for a specific peer within a specified instance.
supervisor@rtbrick.net: cfg> sh bgp rib-in instance default peer Local summary Instance: default, Total Routes: 202 Hostname: Local, Peer IP: 0.0.0.0, Source IP: 0.0.0.0 Address family Routes IPv4 unicast 101 Total Routes 101 Hostname: Local, Peer IP: ::, Source IP: :: Address family Routes IPv6 unicast 101 Total Routes 101
Example: Summary information for the (imported) routes for a specific peer address
supervisor@rtbrick.net: cfg> sh bgp rib-in instance default peer address 90.156.196.2 summary Instance: default, Total Routes: 12300 Peer IP: 90.156.196.2, Source IP: 90.156.196.1 Address family Routes IPv4 unicast 10000 IPv6 unicast 2300 Total Routes 12300
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 |
<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> peer address <peer-ip> |
View of BGP routing table for the given peer Ip address. |
<afi> <safi> peer address <peer-ip> detail |
Detailed list view of BGP routes for give peer IP address. |
<afi> <safi> peer <peer-name> |
Displays BGP routing table for the given peer. |
<afi> <safi> peer <peer-name> |
Detailed list view of BGP routes for give peer IP address. |
<afi> <safi> community <community-name> |
Displays BGP routing table for the given community. |
<afi> <safi> community <community-name> detail |
Detailed list view of BGP routing table for the given community. |
<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 Lpref 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 Lpref 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 Lpref 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
Example 3: Routes advertised to a peer
supervisor@rtbrick.net: cfg> show bgp fib ipv4 multicast Instance: vrf1-blue, AFI: ipv4, SAFI: multicast Group Source Preference Out Label Route Type Next Hop - - 20 20002,bos:1 Intra-AS_I-PMSI_AD 12.0.0.1 20002,bos:1 Intra-AS_I-PMSI_AD 12::1 232.1.1.1/32 10.1.1.1/32 20 20002,bos:1 Source_Tree_Join 12.0.0.1 20002,bos:1 Source_Tree_Join 12::1 232.1.2.1/32 10.1.1.1/32 20 20002,bos:1 Source_Tree_Join 12.0.0.1 20002,bos:1 Source_Tree_Join 12::1
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
To access the Operational State API that corresponds to this CLI, click
here.