NAME

       corosync-vqsim - The votequorum simulator

SYNOPSIS

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

DESCRIPTION

       corosync-vqsim  simulates  the  quorum  functions  of corosync in a single program. it can
       simulate multiple nodes, network splits and a basic quorum device.

       By default vqsim will build a virtual cluster of all the nodes in the corosync.conf  file,
       each  'node'  running in a forked subprocess (and thus asynchronously). It then provides a
       command-line interface to add (up) or remove (down) nodes, and cause  network  splits  and
       rejoins. After each event it shows the new quorum status for all nodes.

       Nodes  in vqsim are always referred to by their nodeid (the IP address is meaningless) and
       optionally by a 'partition' which precedes the nodeid with a colon. By default  all  nodes
       are  in  partition  0.  Nodes  can  be  moved  between partitions using the split and join
       commands.  Multiple nodes can be split and joined at the same time.

       To script vqsim you must send input to it via a pipe rather than just  redirecting  STDIN.
       This is because it runs asynchronously to enable the virtual 'nodes' to report status when
       needed.  (eg if you kill a subprocess using the 'kill(1)' command it gets removed from the
       cluster).

       By default vqsim will wait for all nodes in all partitions to reach the same ring sequence
       number before returning a prompt, there is a timeout associated with this  in  case  of  a
       'node'  failure and exceeding this timeout can (optionally) quit the program signalling an
       error.

       You can disable waiting using the 'sync off' command or the -n command-line  option.  This
       can easily cause unexpected behaviour so use it with care.

       The  number  of  votes per node is read from corosync.conf. New nodes added using the 'up'
       command will copy their number of votes from the first node in corosync.conf. This may not
       be  what  you  expect  and I might fix it in future. As most clusters have only 1 vote per
       node (and this is strongly recommended) then this should rarely be a problem.

       Once you have the 'vqsim> ' prompt you can type 'help' and get a list of sub-commands.

OPTIONS

       -c     This specifies the fully qualified path to the corosync configuration file.

              The default is /etc/corosync/corosync.conf.

       -o     Specifies the output destination. STDOUT by default.

       -n     Don't pause after each command, come straight back to a prompt. Use with care!

       -h     Display a brief help message

SEE ALSO

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

AUTHOR

       Christine Caulfield

                                            2019-05-10                          COROSYNC-VQSIM(8)