Ubuntu Manpage: clvmd — cluster LVM daemon

Provided by: clvm_2.02.133-1ubuntu10_amd64

NAME

       clvmd — cluster LVM daemon

SYNOPSIS

       clvmd [-C] [-d [value]] [-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

-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

-d [value]
Set debug logging level. If -d is specified without a value then 1 is assumed.
Value can be:
0 — Disabled
1 — Sends debug logs to stderr (implies -f)
2 — Sends debug logs to syslog(3)

-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. As it
is quite possible to have multiple managers available on the same system you might
have to manually specify this option to override the search.

By default, omit -I is equivalent to -Iauto. Clvmd will use the first cluster
manager that succeeds, and it checks them in a predefined order cman, corosync,
openais. The available managers will be listed by order as part of the clvmd -h
output.

-R
Tells all the running instance of clvmd in the cluster to reload their device cache
and re-read the lvm configuration file lvm.conf(5). 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 60 seconds.

-T start_timeout
Specifies the start 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 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.

-V
Display the version of the cluster LVM daemon.

ENVIRONMENT VARIABLES

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

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

FILES