mirror of
git://sourceware.org/git/lvm2.git
synced 2024-12-22 17:35:59 +03:00
3f0434057b
'lvm dumpconfig' now does a lot more than just dumping configuration information and is no longer only a support tool. Users now need to run it to find out about configuration information that has been removed from the lvm.conf man page so we need to promote this to full command line status as 'lvmconfig'. Also accept 'lvm config' and mention it in the usage information of lvmconf (which should also get merged in eventually).
132 lines
4.1 KiB
Groff
132 lines
4.1 KiB
Groff
.TH CLVMD 8 "LVM TOOLS #VERSION#" "Red Hat Inc" \" -*- nroff -*-
|
|
.SH NAME
|
|
clvmd \(em cluster LVM daemon
|
|
.SH SYNOPSIS
|
|
.B clvmd
|
|
.RB [ \-C ]
|
|
.RB [ \-d [< \fIvalue\fP >]]
|
|
.RB [ \-E
|
|
.RI < "lock uuid" >]
|
|
.RB [ \-f ]
|
|
.RB [ \-h ]
|
|
.RB [ \-I
|
|
.IR "cluster_manager" ]
|
|
.RB [ \-R ]
|
|
.RB [ \-S ]
|
|
.RB [ \-t
|
|
.RI < timeout >]
|
|
.RB [ \-T
|
|
.RI < "start timeout" >]
|
|
.RB [ \-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
|
|
.BR \-d [< \fIvalue >]
|
|
Set debug logging level.If \fB\-d\fP is specified without a \fIvalue\fP
|
|
then 1 is assumed. \fIValue\fP can be:
|
|
.RS
|
|
.IP \fI0\fP
|
|
Disabled
|
|
.IP \fI1\fP
|
|
Sends debug logs to stderr (implies \fB\-f\fP)
|
|
.IP \fI2\fP
|
|
Sends debug logs to \fBsyslog\fP(3)
|
|
.RE
|
|
.TP
|
|
.B \-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
|
|
.B clvmd
|
|
.br
|
|
.B clvmd \-d2
|
|
.br
|
|
.TP
|
|
.BR \-E < "\fIlock uuid" >
|
|
Pass lock uuid to be reacquired exclusively when clvmd is restarted.
|
|
.TP
|
|
.B \-f
|
|
Don't fork, run in the foreground.
|
|
.TP
|
|
.B \-h
|
|
Show help information.
|
|
.TP
|
|
.BR \-I " \fIcluster_manager\fP"
|
|
Selects the \fIcluster manager\fP 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 \fB-I\fP is equivalent to \fB\-I\fP\fIauto\fP. \fBClvmd\fP
|
|
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
|
|
\fBclvmd \-h\fP output.
|
|
.TP
|
|
.B \-R
|
|
Tells all the running instance of \fBclvmd\fP in the cluster to reload their device cache and
|
|
re-read the lvm configuration file \fBlvm.conf\fP(5). This command should be run whenever the
|
|
devices on a cluster system are changed.
|
|
.TP
|
|
.B \-S
|
|
Tells the running \fBclvmd\fP 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
|
|
.BR \-t < \fItimeout >
|
|
Specifies the \fItimeout\fP 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.
|
|
.TP
|
|
.BR \-T < "\fIstart timeout" >
|
|
Specifies the \fIstart timeout\fP for \fBclvmd\fP 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 \fBclvmd\fP 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 \fBclvmd\fP — 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 \fBclvmd\fP with the \fB\-d\fP.
|
|
.TP
|
|
.B \-V
|
|
Display the version of the cluster LVM daemon.
|
|
|
|
.SH ENVIRONMENT VARIABLES
|
|
.TP
|
|
.B LVM_CLVMD_BINARY
|
|
The CLVMD binary to use when \fBclvmd\fP restart is requested.
|
|
Defaults to #CLVMD_PATH#.
|
|
.TP
|
|
.B LVM_BINARY
|
|
The LVM2 binary to use.
|
|
Defaults to #LVM_PATH#.
|
|
|
|
.SH SEE ALSO
|
|
.BR syslog (3),
|
|
.BR lvm.conf (5),
|
|
.BR lvm (8)
|