show ip bgp summary

Displays summarized information about the status of all BGP connections.
Syntax
show ip bgp summary
Modes

User EXEC mode

Usage Guidelines

If a BGP4 peer is not configured for an address-family, the peer information is not displayed. If a BGP4 peer is configured for an address-family but not negotiated for an address-family after the BGP4 peer is in the established state, the show ip bgp summary command output shows (NoNeg ) at the end of the line for this peer.

The show ip bgp summary command displays the following information:

This field

Displays

Router ID

The device ID.

Local AS Number

The BGP4 AS number for the device.

Confederation Identifier

The AS number of the confederation in which the device resides.

Confederation Peers

The numbers of the local autonomous systems contained in the confederation. This list matches the confederation peer list you configure on the device.

Maximum Number of Paths Supported for Load Sharing

The maximum number of route paths across which the device can balance traffic to the same destination. The feature is enabled by default but the default number of paths is 1. You can increase the number from 2 through 8 paths.

Number of Neighbors Configured

The number of BGP4 neighbors configured on this device, and currently in established state.

Number of Routes Installed

The number of BGP4 routes in the device BGP4 route table and the route or path memory usage.

Number of Routes Advertising to All Neighbors

The total of the RtSent and RtToSend columns for all neighbors, the total number of unique ribout group entries, and the amount of memory used by these groups.

Number of Attribute Entries Installed

The number of BGP4 route-attribute entries in the device route-attributes table and the amount of memory used by these entries.

Neighbor Address

The IP addresses of the BGP4 neighbors for this device.

AS#

The AS number.

State

The state of device sessions with each neighbor. The states are from this perspective of the device, not the neighbor. State values are based on the BGP4 state machine values described in RFC 1771 and can be one of the following for each device:

  • IDLE - The BGP4 process is waiting to be started. Usually, enabling BGP4 or establishing a neighbor session starts the BGP4 process. A minus sign (-) indicates that the session has gone down and the software is clearing or removing routes.
  • ADMND - The neighbor has been administratively shut down.
  • CONNECT - BGP4 is waiting for the connection process for the TCP neighbor session to be completed.
  • ACTIVE - BGP4 is waiting for a TCP connection from the neighbor. Note : If the state frequently changes between CONNECT and ACTIVE, there may be a problem with the TCP connection.
  • OPEN SENT - BGP4 is waiting for an Open message from the neighbor.
  • OPEN CONFIRM - BGP4 has received an Open message from the neighbor and is now waiting for either a KEEPALIVE or NOTIFICATION message. If the device receives a KEEPALIVE message from the neighbor, the state changes to Established. If the message is a NOTIFICATION, the state changes to Idle.
  • ESTABLISHED - BGP4 is ready to exchange UPDATE packets with the neighbor.

Operational States:

Additional information regarding the operational states of BGP described previously may be added as described in the following:

  • (+) - is displayed if there is more BGP data in the TCP receiver queue. Note : If you display information for the neighbor using the show ip bgp neighborip-addr command, the TCP receiver queue value will be greater than 0.
  • (>) - indicates that there is more BGP data in the outgoing queue.
  • (-) - indicates that the session has gone down and the software is clearing or removing routes.
  • (*) - indicates that the inbound or outbound policy is being updated for the peer.
  • (c) - indicates that the table entry is clearing.
  • (p) - indicates that the neighbor ribout group membership change is pending or in progress
  • (s) - indicates that the peer has negotiated restart, and the session is in a stale state.
  • (r) - indicates that the peer is restarting the BGP4 connection, through restart.
  • (^) - on the standby MP indicates that the peer is in the ESTABLISHED state and has received restart capability (in the primary MP).
  • (<) - indicates that the device is waiting to receive the "End of RIB" message the peer.

Time

The time that has passed since the state last changed.

Accepted

The number of routes received from the neighbor that this device installed in the BGP4 route table. Usually, this number is lower than the RoutesRcvd number. The difference indicates that this device filtered out some of the routes received in the UPDATE messages.

Filtered

The routes or prefixes that have been filtered out:

  • If soft reconfiguration is enabled, this field shows how many routes were filtered out (not placed in the BGP4 route table) but retained in memory.
  • If soft reconfiguration is not enabled, this field shows the number of BGP4 routes that have been filtered out.

Sent

The number of BGP4 routes the device has sent to the neighbor.

ToSend

The number of routes the device has queued to advertise and withdraw to a neighbor.

Examples

The following example displays sample output from the show ip bgp summary command.

device> show ip bgp summary
   BGP4 Summary 
  Router ID: 7.7.7.7   Local AS Number: 100
  Confederation Identifier: not configured
  Confederation Peers: 
  Maximum Number of IP ECMP Paths Supported for Load Sharing: 1
  Number of Neighbors Configured: 1, UP: 1
  Number of Routes Installed: 0
  Number of Routes Advertising to All Neighbors: 0 (0 entries)
  Number of Attribute Entries Installed: 0
  '+': Data in InQueue '>': Data in OutQueue '-': Clearing
  '*': Update Policy 'c': Group change 'p': Group change Pending
  'r': Restarting 's': Stale '^': Up before Restart '<': EOR waiting
  Neighbor Address  AS#         State   Time          Rt:Accepted Filtered Sent     ToSend
  10.1.1.8          100         ESTAB   0h 9m16s      0           0        0        0