Skip to main content
emisar

FRRouting (FRR)

v0.1.4

Query the local FRRouting daemons via vtysh — BGP summary + neighbors, BFD peers, IP route summary, and interface state — plus one gated mutation: shut a BGP neighbor to drain a node from an anycast VIP. Reads are `show` commands; the drain is policy-gated (risk: high).

5 allowed by default 1 need approval by default
Pack ID
frr
Vendor
emisar
OS
linux
Actions
6
Required binaries. Install these on the host before relying on the pack — an action that calls a missing one fails at run time.
vtysh

Install

emisar pack install fetches this pack, re-validates it, and verifies its content hash against the --hash below — the exact bytes this page was rendered against, so a tampered copy is rejected — before copying it into the runner's packs dir. The command reloads a running daemon itself; no manual restart.

on the runner host 
sudo emisar pack install frr --hash sha256:e918df8551e73607dec0f6304c0166da4dd8b307396a9f4acea70cb0916763c6

Actions 6 total

View on GitHub
  • frr.bfd_peers exec low

    vtysh -c "show bfd peers"

    List BFD peer sessions — local/remote state (Up/Down), last diagnostic, and timers.

    View source on GitHub
  • frr.bgp_neighbor_shutdown exec high

    vtysh -c "router bgp <asn>" -c "neighbor <peer> shutdown"

    Administratively shut a BGP neighbor session via vtysh, withdrawing every prefix this node advertises to that peer — the governed way to drain a node from an anycast VIP so the upstream ECMP routes around it within a BFD interval. Reversible: re-advertise with `no neighbor <peer> shutdown` once the node is healthy. The change is to the running config only (not persisted), so a daemon restart re-advertises. Pair with frr.bgp_summary to confirm PfxSnt drops to 0 after the drain.

    View source on GitHub
  • frr.bgp_neighbors exec low

    vtysh -c "show bgp neighbors"

    Show detailed BGP neighbor state — capabilities, timers, and message + prefix counters per peer.

    View source on GitHub
  • frr.bgp_summary exec low

    vtysh -c "show bgp summary"

    Show BGP neighbor summary — per-peer state/uptime and prefix counts (PfxRcd / PfxSnt). The quick "are my BGP sessions established and exchanging routes?" check.

    View source on GitHub
  • frr.interfaces exec low

    vtysh -c "show interface brief"

    Show interface brief — admin/protocol status, addresses, and VRF per interface as FRR sees them.

    View source on GitHub
  • frr.route_summary exec low

    vtysh -c "show ip route summary"

    Show IP route table summary — route and FIB counts grouped by source protocol.

    View source on GitHub
← Back to registry
Pack reference Publish your own →