show-raft v4

Shows BDR Raft (consensus protocol) details.

Synopsis

Shows BDR Raft (consensus protocol) details such as Raft state (leader, follower), Raft election id, and number of voting nodes.

Note: In some cases such as network partition, output may vary based on the node to which the CLI is connected.

pgd show-raft [flags]

Examples

  Example 1 (3 node cluster, bdr-a1 and bdr-c1 are up, bdr-b1 is down)

  $ pgd show-raft

  Node   Raft State    Raft Term Commit Index Nodes Voting Nodes Protocol Version
  ----   ----------    --------- ------------ ----- ------------ ----------------
  bdr-c1 RAFT_FOLLOWER 29        6081272      3     3            4002
  bdr-a1 RAFT_LEADER   29        6081272      3     3            4002
  bdr-b1


  Example 2 (3 node cluster, all nodes are up)

  $ pgd show-raft

  Node   Raft State    Raft Term Commit Index Nodes Voting Nodes Protocol Version
  ----   ----------    --------- ------------ ----- ------------ ----------------
  bdr-c1 RAFT_FOLLOWER 38        6132327      3     3            4002
  bdr-a1 RAFT_LEADER   38        6132331      3     3            4002
  bdr-b1 RAFT_FOLLOWER 38        6132336      3     3            4002


  Example 3 (3 node cluster, all nodes are up but bdr-a1 is not able to connect
  to other nodes; following is the output when cli is connected to bdr-a1)

  $ pgd show-raft

  Node   Raft State    Raft Term Commit Index Nodes Voting Nodes Protocol Version
  ----   ----------    --------- ------------ ----- ------------ ----------------
  bdr-c1
  bdr-a1 RAFT_FOLLOWER 40        6176769      3     3            4002
  bdr-b1


  Example 4 (cluster with witness, logical standby and subscriber-only nodes)
  Note: Unlike full-bdr (or witness node), logical standby and subscriber-only
  nodes don't have raft voting rights.

  $ pgd show-raft

  Node               Raft State    Raft Term Commit Index Nodes Voting Nodes Protocol Version
  ----               ----------    --------- ------------ ----- ------------ ----------------
  bdr-a1             RAFT_LEADER   0         10268        6     3            4003
  bdr-b1             RAFT_FOLLOWER 0         10279        6     3            4003
  witness-c1         RAFT_FOLLOWER 0         10281        6     3            4003
  logical-standby-a1 RAFT_FOLLOWER 0         10281        6     3            4003
  logical-standby-b1 RAFT_FOLLOWER 0         10281        6     3            4003
  subscriber-only-c1 RAFT_FOLLOWER 0         10281        6     3            4003

Options

  -h, --help   help for show-raft

Options inherited from parent commands

  -f, --config-file string   config file; ignored if 
                             --dsn flag is present (default "/etc/edb/pgd-config.yml")
      --dsn string           database connection string
                             e.g."host=bdr-a1 port=5432 dbname=bdrdb user=postgres "
  -L, --log-level string     logging level: debug, info, warn, error (default "error")
  -o, --output string        output format: json, yaml

← Prev

show-nodes

show-replslots