Tip

This is the documentation for the 20.08 version. Looking for the documentation of the latest version? Have a look here.

BGP Status¶

TNSR supports several commands to display information about the BGP daemon configuration and its status.

Configuration Information¶

To view the BGP configuration:

tnsr# show route dynamic bgp config [<as-number>]

To view other individual sections of the configuration:

tnsr# show route dynamic bgp as-path [<as-path-name>]
tnsr# show route dynamic bgp community-list [<community-list-name>]

Status Information¶

The general form of the command to view BGP non-configuration state information is show route dynamic bgp <options>. Output includes all VRFs by default, but may be restricted to a single VRF by using show route dynamic bgp vrf <vrf-name> <options> instead. The list of options is the same in both cases.

For a brief summary of BGP status information:

tnsr# show route dynamic bgp [vrf <vrf-name>] (ipv4|ipv6) summary

For a list of configured BGP Neighbors and their status details:

tnsr# show route dynamic bgp [vrf <vrf-name>] (ipv4|ipv6) neighbors [[<peer>]
        [advertised-routes|dampened-routes|flap-statistics|prefix-counts|
        received|received-routes|routes]]

For information about a specific BGP peer group:

tnsr# show route dynamic bgp [vrf <vrf-name>] peer-group <peer-group-name>

For a list of valid BGP next hops:

tnsr# show route dynamic bgp [vrf <vrf-name>] nexthop [detail]

For details about an address or prefix in the BGP routing table:

tnsr# show route dynamic bgp [vrf <vrf-name>] (ipv4|ipv6) network <prefix>

BGP Active Session Control¶

The session clear command can be used to reset active BGP sessions. This command is available from within config-frr-bgp mode. The general form of the command is:

tnsr(config)# route dynamic bgp
tnsr(config-frr-bgp)# session clear [vrf <vrf-name>] (*|<peer>|<asn>) [soft]

The first parameter after the optional VRF name controls what will be cleared, and values may be completed automatically with tab:

*:: Clears all open BGP sessions
<peer>:: Clears all sessions to a specific peer IP address or peer group name
<asn>:: Clears all sessions to a specific AS number

The second parameter, soft is optional and controls whether or not the command will trigger a soft reconfiguration.

Additional Information¶

Additional BGP status information can be obtained by using the vtysh program outside of TNSR.

The vtysh program must be run as root:

sudo vtysh

The vtysh interface offers numerous commands. Of particular interest for BGP status are the following:

show bgp summary:: A brief summary of BGP status information.
show bgp neighbors:: Lists configured BGP Neighbors and their status details.
show ip bgp:: A list of routes and paths for networks involved in BGP.
show ip route:: The IP routing table managed by the FRR Zebra daemon, which marks the origin of routes to see which entries were obtained via BGP.