show-raft#

Shows BDR Raft (consensus protocol) details.

Synopsis#

Shows BDR Raft (consensus protocol) details such as Raft instance id, Raft state (leader, follower), and Raft term. If Raft is enabled at subgroup level, then that subgroup’s Raft instance is also shown.

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

pgd show-raft [flags]

Options#

No specific command options. See Global Options for global options.

Examples#

Show Raft details#

In this example, there is a multi-group cluster with subgroup Raft and with witness, logical standby, subscriber-only nodes. Note that logical standby and subscriber-only nodes don’t have Raft voting rights, unlike data or witness nodes.

$ pgd show-raft
__OUTPUT__
Instance Group    Node               Raft State    Raft Term Commit Index Nodes Voting Nodes Protocol Version
- ------- -----    ----               ----------    --------- ------------ ----- ------------ ----------------
1        bdrgroup bdr-b1             RAFT_LEADER   0         383          10    7            5000
1        bdrgroup bdr-a1             RAFT_FOLLOWER 0         383          10    7            5000
1        bdrgroup bdr-a2             RAFT_FOLLOWER 0         383          10    7            5000
1        bdrgroup bdr-b2             RAFT_FOLLOWER 0         383          10    7            5000
1        bdrgroup logical-standby-a1 RAFT_FOLLOWER 0         383          10    7            5000
1        bdrgroup logical-standby-b1 RAFT_FOLLOWER 0         383          10    7            5000
1        bdrgroup subscriber-only-c1 RAFT_FOLLOWER 0         383          10    7            5000
1        bdrgroup witness-a          RAFT_FOLLOWER 0         383          10    7            5000
1        bdrgroup witness-b          RAFT_FOLLOWER 0         383          10    7            5000
1        bdrgroup witness-c          RAFT_FOLLOWER 0         383          10    7            5000
2        group_a  witness-a          RAFT_LEADER   1         2            4     3            0
2        group_a  bdr-a1             RAFT_FOLLOWER 1         2            4     3            0
2        group_a  bdr-a2             RAFT_FOLLOWER 1         2            4     3            0
2        group_a  logical-standby-a1 RAFT_FOLLOWER 1         2            4     3            0
3        group_b  witness-b          RAFT_LEADER   1         2            4     3            0
3        group_b  bdr-b1             RAFT_FOLLOWER 1         2            4     3            0
3        group_b  bdr-b2             RAFT_FOLLOWER 1         2            4     3            0
3        group_b  logical-standby-b1 RAFT_FOLLOWER 1         2            4     3            0