oracular (8) lvmlockctl.8.gz

Provided by: lvm2-lockd_2.03.22-1ubuntu2_amd64 bug

NAME

       lvmlockctl — Control for lvmlockd

SYNOPSIS

       lvmlockctl [options]

DESCRIPTION

       This command interacts with lvmlockd(8).

OPTIONS

       -h|--help
              Show this help information.

       -q|--quit
              Tell lvmlockd to quit.

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

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

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

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

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

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

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

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

       -S|--stop-lockspaces
              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 runs the
              command specified in lvm.conf lvmlockctl_kill_command  to  deactivate  LVs  in  the  VG.   If  the
              specified  command  is successful, locks will be dropped for the VG in lvmlockd (the equivalent of
              lvmlockctl --drop will be run.)  If no command is specified, or the command fails, then  the  user
              must  intervene  to forcefully deactivate LVs in the VG, and if successful, run lvmlockctl --drop.
              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.  When lvmlockctl_kill_command is
              used, the --kill command may run drop automatically.  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 command 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.

SEE ALSO

       lvm(8), lvmlockd(8)