1CLVMD(8)                    System Manager's Manual                   CLVMD(8)
2
3
4

NAME

6       clvmd - cluster LVM daemon
7

SYNOPSIS

9       clvmd [-d[<value>]] [-C] [-h] [-R] [-S] [-t <timeout>] [-T <start time‐
10       out>] [-V]
11

DESCRIPTION

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

OPTIONS

18       -d[<value>]
19              Enable debug logging. Value can be 0, 1 or 2.
20              0 disables debug logging
21              1 sends debug logs to stderr (implies -f option)
22              2 sends debug logs to syslog
23              If -d is specified without a value then 1 is assumed.
24
25       -C     Only valid if -d is also specified. Tells all clvmds in a  clus‐
26              ter  to enable/disable debug logging.  Without this switch, only
27              the local clvmd will change its debug level to that  given  with
28              -d.
29              This  does  not  work correctly if specified on the command-line
30              that starts clvmd.  If you want to start clvmd and enable  clus‐
31              ter-wide logging then the command needs to be issued twice, eg:
32              clvmd
33              clvmd -d2
34
35       -t <timeout>
36              Specifies  the  timeout  for commands to run around the cluster.
37              This should not be so small that commands with many disk updates
38              to  do  will  fail,  so you may need to increase this on systems
39              with very large disk farms.  The default is 30 seconds.
40
41       -T <start timeout>
42              Specifies the timeout for clvmd daemon startup.  If  the  daemon
43              does not report that it has started up within this time then the
44              parent command will exit with status of 5. This  does  NOT  mean
45              that clvmd has not started! What it means is that the startup of
46              clvmd has been delayed for some reason; the most likely cause of
47              this  is  an inquorate cluster though it could be due to locking
48              latencies on a cluster with large numbers of logical volumes. If
49              you  get  the  return  code  of 5 it is usually not necessary to
50              restart clvmd - it will start  as  soon  as  that  blockage  has
51              cleared.  This  flag  is  to  allow startup scripts to exit in a
52              timely fashion even if the cluster is stalled for some reason.
53              The default is 0 (no timeout) and the value is in seconds. Don't
54              set this too small or you will experience spurious errors. 10 or
55              20 seconds might be sensible.
56              This timeout will be ignored if you  start  clvmd  with  the  -d
57              switch.
58
59       -R     Tells  all  the  running  clvmds  in the cluster to reload their
60              device cache and re-read the lvm configuration file.  This  com‐
61              mand  should be run whenever the devices on a cluster system are
62              changed.
63
64       -S     Tells the running clvmd to exit and reexecute itself, for  exam‐
65              ple  at  the  end  of  a  package  upgrade.  The new instance is
66              instructed to reacquire any locks in the same state as they were
67              previously  held.  (Alternative methods of restarting the daemon
68              have the side effect of changing exclusive LV locks into  shared
69              locks.)
70
71       -I     Selects the cluster manager to use for locking and internal com‐
72              munications, the available managers will be listed  as  part  of
73              the 'clvmd -h' output.  clvmd will use the first cluster manager
74              that   succeeds,   and   it   checks   them   in    the    order
75              cman,gulm,corosync,openais. As it is quite possible to have (eg)
76              corosync and cman available on the same system you might have to
77              manually specify this option to override the search.
78
79       -V     Display the version of the cluster LVM daemon.
80

SEE ALSO

82       lvm(8)
83
84
85
86Red Hat Inc            LVM TOOLS 2.02.84(2) (2011-02-09)              CLVMD(8)
Impressum