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.
See also
For more general dynamic routing status information, see Dynamic Routing Manager 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.