1COROSYNC-CFGTOOL(8)                                        COROSYNC-CFGTOOL(8)
2
3
4

NAME

6       corosync-cfgtool - An administrative tool for corosync.
7

SYNOPSIS

9       corosync-cfgtool  [[-i  IP_address]  [-b] -s] [-R] [-L] [-k nodeid] [-a
10       nodeid] [-h] [-H]
11

DESCRIPTION

13       corosync-cfgtool A tool for displaying and configuring  active  parame‐
14       ters within corosync.
15

OPTIONS

17       -i     Finds  only information about the specified interface IP address
18              or link id with -s.
19
20       -s     Displays the status of  the  current  links  on  this  node  for
21              UDP/UDPU,  with  extended status for KNET.  After each link, the
22              nodes on that link are displayed in order with their status, for
23              example there are 3 nodes with KNET transportation:
24
25              LINK ID 0
26                      addr    = 192.168.100.80
27                      status:
28                              nodeid  1:      localhost
29                              nodeid  2:      connected
30                              nodeid  3:      connected
31
32       -b     Displays  the  brief  status  of  the current links on this node
33              (KNET only) when used with "-s". If any interfaces are faulty, 1
34              is  returned  by  the  binary. If all interfaces are active 0 is
35              returned to the shell.  After each link, the nodes on that  link
36              are  displayed  in order with their status encoded into a single
37              digit, or characters 'n', 'd'  and  '?'  with  special  meaning.
38              1=link  enabled,  2=link  connected,  So  a 3 in a node position
39              indicates that the link is both enabled  and  connected.  Status
40              represented by character 'n' is used for localhost link. Charac‐
41              ter '?' means that Crosync was unable to get status of link from
42              knet  (log  should  contain  more  information).  Character  'd'
43              shouldn't appear and it means that Corosync was unable  to  con‐
44              figure  a  link and it is result of some error which should have
45              been logged.
46
47              The output will be:
48
49              LINK ID 0
50                      addr    = 192.168.100.80
51                      status  = n33
52
53       -R     Tell all  instances  of  corosync  in  this  cluster  to  reload
54              corosync.conf.
55
56              Running  corosync-cfgtool  -R  where nodes are running different
57              versions of corosync (including minor versions)  is  unsupported
58              and may result in undefined behaviour.
59
60       -L     Tell  corosync to reopen all logging files. In contrast to other
61              subcommands, nothing is displayed on terminal if  call  is  suc‐
62              cessful.
63
64       -k     Kill a node identified by node id.
65
66       -a     Display the IP address(es) of a node.
67
68       -h     Print basic usage.
69
70       -H     Shutdown corosync cleanly on this node.
71

SEE ALSO

73       corosync_overview(7),
74

AUTHOR

76       Angus Salkeld
77
78                                  2020-02-10               COROSYNC-CFGTOOL(8)