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

NAME

6       corosync-vqsim - The votequorum simulator
7

SYNOPSIS

9       corosync-vqsim [-c config_file] [-o output file] [-n] [-h]
10

DESCRIPTION

12       corosync-vqsim  simulates  the quorum functions of corosync in a single
13       program. it can simulate multiple nodes, network  splits  and  a  basic
14       quorum device.
15
16       By  default  vqsim will build a virtual cluster of all the nodes in the
17       corosync.conf file, each 'node' running in  a  forked  subprocess  (and
18       thus  asynchronously). It then provides a command-line interface to add
19       (up) or remove (down) nodes, and  cause  network  splits  and  rejoins.
20       After each event it shows the new quorum status for all nodes.
21
22       Nodes  in  vqsim are always referred to by their nodeid (the IP address
23       is meaningless) and optionally by  a  'partition'  which  precedes  the
24       nodeid with a colon. By default all nodes are in partition 0. Nodes can
25       be moved between partitions using the split and join commands.   Multi‐
26       ple nodes can be split and joined at the same time.
27
28       To  script  vqsim you must send input to it via a pipe rather than just
29       redirecting STDIN. This is because it runs asynchronously to enable the
30       virtual  'nodes'  to report status when needed.  (eg if you kill a sub‐
31       process using the 'kill(1)' command it gets removed from the cluster).
32
33       By default vqsim will wait for all nodes in all partitions to reach the
34       same ring sequence number before returning a prompt, there is a timeout
35       associated with this in case of a 'node'  failure  and  exceeding  this
36       timeout can (optionally) quit the program signalling an error.
37
38       You can disable waiting using the 'sync off' command or the -n command-
39       line option. This can easily cause unexpected behaviour so use it  with
40       care.
41
42       The  number  of  votes  per  node is read from corosync.conf. New nodes
43       added using the 'up' command will copy their number of votes  from  the
44       first  node  in  corosync.conf.  This  may not be what you expect and I
45       might fix it in future. As most clusters have only 1 vote per node (and
46       this is strongly recommended) then this should rarely be a problem.
47
48       Once  you  have the 'vqsim> ' prompt you can type 'help' and get a list
49       of sub-commands.
50
51

OPTIONS

53       -c     This specifies the fully qualified path to the corosync configu‐
54              ration file.
55
56              The default is /etc/corosync/corosync.conf.
57
58       -o     Specifies the output destination. STDOUT by default.
59
60       -n     Don't  pause after each command, come straight back to a prompt.
61              Use with care!
62
63
64       -h     Display a brief help message
65

SEE ALSO

67       corosync(9), corosync.conf(5),
68

AUTHOR

70       Christine Caulfield
71
72                                  2019-05-10                 COROSYNC-VQSIM(8)
Impressum