contrib/lvm2/dist/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 [\-d [<value>]] [\-C] [\-h]
   7 [\-R]
   8 [\-t <timeout>]
   9 [\-T <start timeout>]
  10 [\-V]
  11 .SH DESCRIPTION
  12 clvmd is the daemon that distributes LVM metadata updates around a cluster.
  13 It must be running on all nodes in the cluster and will give an error
  14 if a node in the cluster does not have this daemon running.
  15 .SH OPTIONS
  16 .TP
  17 .I \-d [<value>]
  18 Enable debug logging. Value can be 0, 1 or 2.
  19 .br
  20 0 disables debug logging in a running clvmd
  21 .br
  22 1 sends debug logs to stderr (clvmd will not fork in this case)
  23 .br
  24 2 sends debug logs to syslog
  25 .br
  26 If
  27 .B -d
  28 is specified without a value then 1 is assumed if you are starting a
  29 new clvmd, 2 if you are enabling debug in a running clvmd.
  30 .TP
  31 .I \-C
  32 Only valid if
  33 .B -d
  34 is also specified. Tells all clvmds in a cluster to enable/disable debug logging.
  35 Without this switch, only the local clvmd will change its debug level to that
  36 given with
  37 .B -d.
  38 .br
  39 This does not work correctly if specified on the command-line that starts clvmd.
  40 If you want to start clvmd
  41 .B and
  42 enable cluster-wide logging then the command needs to be issued twice, eg:
  43 .br
  44 clvmd
  45 .br
  46 clvmd -d2
  47 .br
  48 .TP
  49 .I \-t <timeout>
  50 Specifies the timeout for commands to run around the cluster. This should not
  51 be so small that commands with many disk updates to do will fail, so you
  52 may need to increase this on systems with very large disk farms.
  53 The default is 30 seconds.
  54 .TP
  55 .I \-T <start timeout>
  56 Specifies the timeout for clvmd daemon startup. If the daemon does not report
  57 that it has started up within this time then the parent command will exit with
  58 status of 5. This does NOT mean that clvmd has not started! What it means is
  59 that the startup of clvmd has been delayed for some reason; the most likely
  60 cause of this is an inquorate cluster though it could be due to locking
  61 latencies on a cluster with large numbers of logical volumes. If you get the
  62 return code of 5 it is usually not necessary to restart clvmd - it will start
  63 as soon as that blockage has cleared. This flag is to allow startup scripts
  64 to exit in a timely fashion even if the cluster is stalled for some reason.
  65 .br
  66 The default is 0 (no timeout) and the value is in seconds. Don't set this too
  67 small or you will experience spurious errors. 10 or 20 seconds might be
  68 sensible.
  69 .br
  70 This timeout will be ignored if you start clvmd with the -d switch.
  71 .TP
  72 .I \-R
  73 Tells all the running clvmds in the cluster to reload their device cache and
  74 re-read the lvm configuration file. This command should be run whenever the
  75 devices on a cluster system are changed.
  76 .TP
  77 .I \-I
  78 Selects the cluster manager to use for locking and internal communications,
  79 the available managers will be listed as part of the 'clvmd -h' output.
  80 clvmd will use the first cluster manager that succeeds, and it checks them
  81 in the order cman,gulm,corosync,openais. As it is quite possible to have
  82 (eg) corosync and cman available on the same system you might have to
  83 manually specify this option to override the search.
  84 .TP
  85 .I \-V
  86 Display the version of the cluster LVM daemon.
  87 .SH SEE ALSO
  88 .BR lvm (8)