focal (8) lvmlockctl.8.gz

Provided by: lvm2-lockd_2.03.07-1ubuntu1_amd64 bug

NAME

       lvmlockctl — Control for lvmlockd

DESCRIPTION

       This command interacts with lvmlockd(8).

OPTIONS

       lvmlockctl [options]

       --help | -h
               Show this help information.

       --quit | -q
               Tell lvmlockd to quit.

       --info | -i
               Print lock state information from lvmlockd.

       --dump | -d
               Print log buffer from lvmlockd.

       --wait | -w 0|1
               Wait option for other commands.

       --force | -f 0|1
               Force option for other commands.

       --kill | -k vgname
               Kill access to the VG when sanlock cannot renew lease.

       --drop | -r vgname
               Clear locks for the VG when it is unused after kill (-k).

       --gl-enable | -E vgname
               Tell lvmlockd to enable the global lock in a sanlock VG.

       --gl-disable | -D vgname
               Tell lvmlockd to disable the global lock in a sanlock VG.

       --stop-lockspaces | -S
               Stop all lockspaces.

USAGE

   info
       This  collects  and  displays  lock  state  from lvmlockd.  The display is primitive, incomplete and will
       change in future version.  To print the raw lock state from lvmlockd, combine this option with --dump|-d.

   dump
       This collects the circular log buffer of debug statements from lvmlockd and prints it.

   kill
       This is run by sanlock when it loses access to the storage holding leases for a VG.  It currently emits a
       syslog  message  stating that the VG must be immediately deactivated.  In the future it may automatically
       attempt to forcibly deactivate the VG.  For more, see lvmlockd(8).

   drop
       This should only be run after a VG has been  successfully  deactivated  following  an  lvmlockctl  --kill
       command.   It  clears  the stale lockspace from lvmlockd.  In the future, this may become automatic along
       with an automatic handling of --kill.  For more, see lvmlockd(8).

   gl-enable
       This enables the global lock in a sanlock VG.  This is necessary if  the  VG  that  previously  held  the
       global lock is removed.  For more, see lvmlockd(8).

   gl-disable
       This  disables the global lock in a sanlock VG.  This is necessary if the global lock has mistakenly been
       enabled in more than one VG.  The global lock should be disabled in all but one sanlock  VG.   For  more,
       see lvmlockd(8).

   stop-lockspaces
       This  tells  lvmlockd  to  stop  all  lockspaces.   It  can be useful to stop lockspaces for VGs that the
       vgchange --lock-stop comand can no longer see, or to stop the dlm global lockspace which is not  directly
       stopped by the vgchange command.  The wait and force options can be used with this command.