NAME

       clvmd - cluster LVM daemon

SYNOPSIS

       clvmd  [-d  [<value>]  [-C]] [-E <lock uuid>] [-f] [-h] [-I cluster_manager] [-R] [-S] [-t
       <timeout>] [-T <start timeout>] [-V]

DESCRIPTION

       clvmd is the daemon that distributes LVM metadata updates around a cluster.   It  must  be
       running  on  all nodes in the cluster and will give an error if a node in the cluster does
       not have this daemon running.

OPTIONS

       -d[<value>]
              Enable debug logging. Value can be 0, 1 or 2.
              0 disables debug logging
              1 sends debug logs to stderr (implies -f option)
              2 sends debug logs to syslog
              If -d is specified without a value then 1 is assumed.

       -C     Only valid if -d is also specified. Tells all clvmds in a cluster to enable/disable
              debug  logging.   Without  this  switch, only the local clvmd will change its debug
              level to that given with -d
              This does not work correctly if specified on the command-line  that  starts  clvmd.
              If  you  want to start clvmd and enable cluster-wide logging then the command needs
              to be issued twice, eg:
              clvmd
              clvmd -d2

       -E<lock uuid>
              Pass lock uuid to be reacquired exclusively when clvmd is restarted.

       -f     Don't fork, run in the foreground.

       -h     Show help information.

       -I cluster manager
              Selects the cluster manager to use for locking  and  internal  communications,  the
              available  managers  will be listed as part of the clvmd -h output.  clvmd will use
              the first  cluster  manager  that  succeeds,  and  it  checks  them  in  the  order
              cman,corosync,openais.  As  it  is  quite  possible  to have (eg) corosync and cman
              available on the same system you might have to  manually  specify  this  option  to
              override the search.

       -R     Tells  all  the  running clvmds in the cluster to reload their device cache and re-
              read the lvm configuration file. This command should be run whenever the devices on
              a cluster system are changed.

       -S     Tells  the  running clvmd to exit and reexecute itself, for example at the end of a
              package upgrade.  The new instance is instructed to reacquire any locks in the same
              state  as they were previously held.  (Alternative methods of restarting the daemon
              have the side effect of changing exclusive LV locks into shared locks.)

       -t<timeout>
              Specifies the timeout for commands to run around the cluster. This should not be so
              small  that  commands  with  many  disk updates to do will fail, so you may need to
              increase this on systems with very large disk farms.  The default is 30 seconds.

       -T<start timeout>
              Specifies the timeout for clvmd daemon startup. If the daemon does not report  that
              it has started up within this time then the parent command will exit with status of
              5. This does NOT mean that clvmd has not started! What it means is that the startup
              of  clvmd  has  been  delayed  for some reason; the most likely cause of this is an
              inquorate cluster though it could be due to locking latencies  on  a  cluster  with
              large numbers of logical volumes. If you get the return code of 5 it is usually not
              necessary to restart clvmd - it will start as soon as that  blockage  has  cleared.
              This  flag  is  to  allow  startup  scripts to exit in a timely fashion even if the
              cluster is stalled for some reason.
              The default is 0 (no timeout) and the value is in seconds. Don't set this too small
              or you will experience spurious errors. 10 or 20 seconds might be sensible.
              This timeout will be ignored if you start clvmd with the -d switch.

       -V     Display the version of the cluster LVM daemon.

ENVIRONMENT VARIABLES

       LVM_CLVMD_BINARY
              The   CLVMD   binary   to  use  when  clmvd  restart  is  requested.   Defaults  to
              /usr/sbin/clvmd.

       LVM_BINARY
              The LVM2 binary to use. Defaults to /sbin/lvm.

SEE ALSO

       lvm(8)