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:

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

To limit the neighbor status output to a specific area, use the address family form of the command:

tnsr# show route dynamic bgp [vrf <vrf-name>] (ipv4|ipv6) neighbors [<peer>
        [advertised-routes|dampened-routes|flap-statistics|graceful-restart|
        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 the root user and it requires a parameter specifying the namespace in which the routing daemons run (dataplane):

sudo vtysh -N dataplane

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.