Use VTY shell commands to troubleshoot BGP

You can use the shell for Virtual Terminal Interface (VTY shell) to interact with the Free Range Routing (FRRouting, or FRR) daemons. In Red Hat OpenStack Platform, FRR daemons such as bgpd run inside a container. Using the VTY shell can help you troubleshoot BGP routing issues.

Before you begin

  • You must have sudo privileges on the host where you want to run VTY shell commands.

Procedure

  1. Log in to the host where you want to troubleshoot the BGP daemon, bgpd. Typically, bgpd runs on all of the overcloud nodes.
  2. Enter the FRR container. 
    $ sudo podman exec -it frr bash
  3. You have two options for running VTY shell commands:
    • Interactive mode

      Type sudo vtysh once to enter interactive mode to run multiple VTY shell commands.

      Example
      $ sudo vtysh
> show bgp summary
    • Direct mode

      Preface each VTY shell command with sudo vtysh -c.

      Example
      $ sudo vtysh -c 'show bgp summary'
  4. Here are several VTY shell BGP daemon troubleshooting commands:
    Tip

    Omit the ip argument when you are using IPv6.
    Display a particular routing table or all routing tables
    > show ip bgp <IPv4_address> | all
> show bgp <IPv6_address> | all
    Output routes advertised to a BGP peer
    > show ip bgp neighbors <router-ID> <advertised-routes>
    Output routes received from a BGP peer
    > show ip bgp neighbors <router-ID> <received-routes>