raft list v5.6

Lists BDR Raft (consensus protocol) details

Synopsis

Lists 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 raft list [flags]

Examples

Viewing Raft details

In this example, we have a multi-group cluster with a subgroup Raft and a witness, logical standby, and subscriber-only nodes.

Note: Unlike data or witness node, logical standby and subscriber-only nodes don't have Raft voting rights (see the Voting Nodes column).

$ pgd raft list
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