Troubleshooting BGP in Red Hat OpenStack Platform¶
Diagnosing problems in a Red Hat OpenStack Platform environment that uses BGP begins with examining logs and querying FRR components with VTY shell.
Log Locations¶
The key log files for troubleshooting BGP issues are:
OVN BGP Agent logs: Located on Compute and Networker nodes
/var/log/containers/stdouts/ovn_bgp_agent.log
FRR component logs: Located on all nodes where FRR is running
/var/log/containers/frr/frr.log
Using VTY Shell for Troubleshooting¶
VTY shell allows interaction with FRR daemons to diagnose BGP routing issues.
Accessing VTY Shell
Log in to the node where you need to troubleshoot BGP
Enter the FRR container:
$ sudo podman exec -it frr bash
You can use VTY shell in two different modes:
Interactive mode:
$ sudo vtysh > show bgp summary
Direct mode:
$ sudo vtysh -c 'show bgp summary'
Useful Troubleshooting Commands
The following commands help diagnose common BGP issues:
Display BGP routing tables:
# For IPv4 > show ip bgp <IPv4_address> | all # For IPv6 (omit the 'ip' argument) > show bgp <IPv6_address> | all
Show routes advertised to a peer:
> show ip bgp neighbors <router-ID> advertised-routes
Show routes received from a peer:
> show ip bgp neighbors <router-ID> received-routes
Check BGP peer status:
> show bgp summary
Verify BGP configuration:
> show running-config
Common BGP Issues¶
Here are some common issues you might encounter and how to address them:
BGP Peers Not Establishing Connection
Check IP connectivity between peers
Verify ASN configuration matches on both sides
Check for firewall rules blocking BGP port (TCP 179)
Examine logs for capability negotiation issues
Routes Not Being Advertised
Verify the OVN BGP agent is running
Check if IP addresses are added to the bgp-nic interface
Inspect FRR configuration for proper route redistribution
Check for route filtering that might prevent advertisement
Traffic Not Reaching VMs
Verify OVS flow rules are correctly installed
Check IP rules and routing table entries
Ensure ARP/NDP proxy is enabled on the provider bridge
Confirm VRF configuration is correct
Slow Convergence After Failures
Check if BFD is enabled and configured correctly
Verify timers are set appropriately
Inspect BGP graceful restart configuration
Check for any route dampening that might delay reconvergence