1COROSYNC-QDEVICE-TOOL(8)    System Manager's Manual   COROSYNC-QDEVICE-TOOL(8)
2
3
4

NAME

6       corosync-qdevice-tool - corosync-qdevice control interface.
7

SYNOPSIS

9       corosync-qdevice-tool [-Hhsv] [-p qdevice_ipc_socket_path]
10

DESCRIPTION

12       corosync-qdevice-tool  is  a  frontend to the internal corosync-qdevice
13       IPC. Its main purpose is to show important information about  the  cur‐
14       rent internal state of corosync-qdevice.
15

OPTIONS

17       -H     Properly shutdown the corosync-qdevice process
18
19       -h     Display a short usage text
20
21       -s     Display  the  status of the corosync-qdevice process. The output
22              is described in its own section below.
23
24       -v     Display more verbose output for the -s option.
25
26       -p     Path to the corosync-qdevice communication socket.
27
28

STATUS COMMAND OUTPUT

30       Qdevice information
31       -------------------
32       Model:                  Net
33       Node ID:                1
34       HB interval:            10000ms
35       Sync HB interval:       30000ms
36       Configured node list:
37           0   Node ID = 1
38       Heuristics:             Enabled
39       Ring ID:                1.a00000000021b48
40       Membership node list:   1
41       Quorate:                Yes
42       Quorum node list:
43           0   Node ID = 1, State = member
44       Expected votes:         2
45       Last poll call:         2016-06-24T17:05:20 (cast vote)
46
47       Qdevice-net information
48       ----------------------
49       Cluster name:           Cluster
50       QNetd host:             localhost:5403
51       Connect timeout:        8000ms
52       HB interval:            8000ms
53       VQ vote timer interval: 5000ms
54       TLS:                    Supported
55       Algorithm:              Fifty-Fifty split
56       Tie-breaker:            Node with lowest node ID
57       KAP Tie-breaker:        Enabled
58       Poll timer running:     Yes (cast vote)
59       State:                  Connected
60       Heuristics result:      Pass (regular: Pass, membership: Fail, connect: Fail)
61       TLS active:             Yes (client certificate sent)
62       Connected since:        2016-06-24T17:02:35
63       Echo reply received:    2016-06-24T17:05:15
64
65       The output is split into a generic qdevice section and a model specific
66       section.   Most  of  the  items are just taken from corosync.conf file.
67       It's helpful to note that the Membership node list  is  the  membership
68       list  of  the current node and should match the quorum node list.  Last
69       poll call is the timestamp (in iso format) of  the  last  call  to  the
70       votequorum_qdevice_poll function.
71
72       For  model net, it's good to check the Poll timer running state. Inter‐
73       nally, model net supports 3 states. Not voting (when Poll timer running
74       is  No,  which  means corosync-qdevice is waiting for corosync-qnetd to
75       reply), voting (without cast vote, it  means  that  the  corosync-qnetd
76       algorithm  decides that the current node shouldn't get a vote) and vot‐
77       ing (with cast vote).
78

SEE ALSO

80       corosync-qnetd(8) corosync-qdevice(8)
81

AUTHOR

83       Jan Friesse
84
85                                  2020-10-27          COROSYNC-QDEVICE-TOOL(8)