man/clvmd.8.in

   1 .TH CLVMD 8 "LVM TOOLS #VERSION#" "Red Hat Inc" \" -*- nroff -*-
   2 .SH NAME
   3 clvmd \- cluster LVM daemon
   4 .SH SYNOPSIS
   5 .B clvmd
   6 .RB [ \-d
   7 .RI [< value >]
   8 .RB [ \-C ]]
   9 .RB [ \-E
  10 .RI < "lock uuid" >]
  11 .RB [ \-f ]
  12 .RB [ \-h ]
  13 .RB [ \-I
  14 .IR "cluster_manager" ]
  15 .RB [ \-R ]
  16 .RB [ \-S ]
  17 .RB [ \-t
  18 .RI < timeout >]
  19 .RB [ \-T
  20 .RI < "start timeout" >]
  21 .RB [ \-V ]
  22 .SH DESCRIPTION
  23 clvmd is the daemon that distributes LVM metadata updates around a cluster.
  24 It must be running on all nodes in the cluster and will give an error
  25 if a node in the cluster does not have this daemon running.
  26 .SH OPTIONS
  27 .TP
  28 .BR \-d [< \fIvalue >]
  29 Enable debug logging. Value can be 0, 1 or 2.
  30 .br
  31 0 disables debug logging
  32 .br
  33 1 sends debug logs to stderr (implies \fB\-f\fP option)
  34 .br
  35 2 sends debug logs to syslog
  36 .br
  37 If
  38 .B \-d
  39 is specified without a value then 1 is assumed.
  40 .TP
  41 .B \-C
  42 Only valid if
  43 .B \-d
  44 is also specified. Tells all clvmds in a cluster to enable/disable debug logging.
  45 Without this switch, only the local clvmd will change its debug level to that
  46 given with
  47 .B \-d
  48 .
  49 .br
  50 This does not work correctly if specified on the command-line that starts clvmd.
  51 If you want to start clvmd
  52 .B and
  53 enable cluster-wide logging then the command needs to be issued twice, eg:
  54 .br
  55 .B clvmd
  56 .br
  57 .B clvmd -d2
  58 .br
  59 .TP
  60 .BR \-E < "\fIlock uuid" >
  61 Pass lock uuid to be reacquired exclusively when clvmd is restarted.
  62 .TP
  63 .B \-f
  64 Don't fork, run in the foreground.
  65 .TP
  66 .B \-h
  67 Show help information.
  68 .TP
  69 .B \-I \fIcluster manager
  70 Selects the cluster manager to use for locking and internal communications,
  71 the available managers will be listed as part of the \fBclvmd -h\fP output.
  72 clvmd will use the first cluster manager that succeeds, and it checks them
  73 in the order cman,corosync,openais. As it is quite possible to have
  74 (eg) corosync and cman available on the same system you might have to
  75 manually specify this option to override the search.
  76 .TP
  77 .B \-R
  78 Tells all the running clvmds in the cluster to reload their device cache and
  79 re-read the lvm configuration file. This command should be run whenever the
  80 devices on a cluster system are changed.
  81 .TP
  82 .B \-S
  83 Tells the running clvmd to exit and reexecute itself, for example at the
  84 end of a package upgrade.  The new instance is instructed to reacquire
  85 any locks in the same state as they were previously held.  (Alternative
  86 methods of restarting the daemon have the side effect of changing
  87 exclusive LV locks into shared locks.)
  88 .TP
  89 .BR \-t < \fItimeout >
  90 Specifies the timeout for commands to run around the cluster. This should not
  91 be so small that commands with many disk updates to do will fail, so you
  92 may need to increase this on systems with very large disk farms.
  93 The default is 30 seconds.
  94 .TP
  95 .BR \-T < "\fIstart timeout" >
  96 Specifies the timeout for clvmd daemon startup. If the daemon does not report
  97 that it has started up within this time then the parent command will exit with
  98 status of 5. This does NOT mean that clvmd has not started! What it means is
  99 that the startup of clvmd has been delayed for some reason; the most likely
 100 cause of this is an inquorate cluster though it could be due to locking
 101 latencies on a cluster with large numbers of logical volumes. If you get the
 102 return code of 5 it is usually not necessary to restart clvmd - it will start
 103 as soon as that blockage has cleared. This flag is to allow startup scripts
 104 to exit in a timely fashion even if the cluster is stalled for some reason.
 105 .br
 106 The default is 0 (no timeout) and the value is in seconds. Don't set this too
 107 small or you will experience spurious errors. 10 or 20 seconds might be
 108 sensible.
 109 .br
 110 This timeout will be ignored if you start clvmd with the -d switch.
 111 .TP
 112 .B \-V
 113 Display the version of the cluster LVM daemon.
 114
 115 .SH ENVIRONMENT VARIABLES
 116 .TP
 117 .B LVM_CLVMD_BINARY
 118 The CLVMD binary to use when clmvd restart is requested.
 119 Defaults to #CLVMD_PATH#.
 120 .TP
 121 .B LVM_BINARY
 122 The LVM2 binary to use. Defaults to #LVM_PATH#.
 123
 124 .SH SEE ALSO
 125 .BR lvm (8)