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.

Referenced By

lvchange(8), lvconvert(8), lvcreate(8), lvdisplay(8), lvextend(8), lvm(8), lvmconfig(8), lvmdiskscan(8), lvm-fullreport(8), lvm-lvpoll(8), lvreduce(8), lvremove(8), lvrename(8), lvresize(8), lvs(8), lvscan(8), pvchange(8), pvck(8), pvcreate(8), pvdisplay(8), pvmove(8), pvremove(8), pvresize(8), pvs(8), pvscan(8), vgcfgbackup(8), vgcfgrestore(8), vgchange(8), vgck(8), vgconvert(8), vgcreate(8), vgdisplay(8), vgexport(8), vgextend(8), vgimport(8), vgimportclone(8), vgmerge(8), vgmknodes(8), vgreduce(8), vgremove(8), vgrename(8), vgs(8), vgscan(8), vgsplit(8).

LVM TOOLS 2.03.06(2) (2019-10-23) Red Hat, Inc