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)