mirror of
git://sourceware.org/git/lvm2.git
synced 2024-12-25 01:34:38 +03:00
97 lines
3.4 KiB
Groff
97 lines
3.4 KiB
Groff
.TH CLVMD 8 "LVM TOOLS #VERSION#" "Red Hat Inc" \" -*- nroff -*-
|
|
.SH NAME
|
|
clvmd \- cluster LVM daemon
|
|
.SH SYNOPSIS
|
|
.B clvmd
|
|
[\-d [<value>]] [\-C] [\-h]
|
|
[\-R]
|
|
[\-S]
|
|
[\-t <timeout>]
|
|
[\-T <start timeout>]
|
|
[\-V]
|
|
.SH 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.
|
|
.SH OPTIONS
|
|
.TP
|
|
.I \-d [<value>]
|
|
Enable debug logging. Value can be 0, 1 or 2.
|
|
.br
|
|
0 disables debug logging in a running clvmd
|
|
.br
|
|
1 sends debug logs to stderr (clvmd will not fork in this case)
|
|
.br
|
|
2 sends debug logs to syslog
|
|
.br
|
|
If
|
|
.B -d
|
|
is specified without a value then 1 is assumed if you are starting a
|
|
new clvmd, 2 if you are enabling debug in a running clvmd.
|
|
.TP
|
|
.I \-C
|
|
Only valid if
|
|
.B -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
|
|
.B -d.
|
|
.br
|
|
This does not work correctly if specified on the command-line that starts clvmd.
|
|
If you want to start clvmd
|
|
.B and
|
|
enable cluster-wide logging then the command needs to be issued twice, eg:
|
|
.br
|
|
clvmd
|
|
.br
|
|
clvmd -d2
|
|
.br
|
|
.TP
|
|
.I \-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.
|
|
.TP
|
|
.I \-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.
|
|
.br
|
|
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.
|
|
.br
|
|
This timeout will be ignored if you start clvmd with the -d switch.
|
|
.TP
|
|
.I \-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.
|
|
.TP
|
|
.I \-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.)
|
|
.TP
|
|
.I \-I
|
|
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,gulm,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.
|
|
.TP
|
|
.I \-V
|
|
Display the version of the cluster LVM daemon.
|
|
.SH SEE ALSO
|
|
.BR lvm (8)
|