1LVMLOCKCTL(8)                                                    LVMLOCKCTL(8)
2
3
4

NAME

6       lvmlockctl — Control for lvmlockd
7
8

DESCRIPTION

10       This command interacts with lvmlockd(8).
11
12

OPTIONS

14       lvmlockctl [options]
15
16       --help | -h
17               Show this help information.
18
19       --quit | -q
20               Tell lvmlockd to quit.
21
22       --info | -i
23               Print lock state information from lvmlockd.
24
25       --dump | -d
26               Print log buffer from lvmlockd.
27
28       --wait | -w 0|1
29               Wait option for other commands.
30
31       --force | -f 0|1
32               Force option for other commands.
33
34       --kill | -k vgname
35               Kill access to the VG when sanlock cannot renew lease.
36
37       --drop | -r vgname
38               Clear locks for the VG when it is unused after kill (-k).
39
40       --gl-enable | -E vgname
41               Tell lvmlockd to enable the global lock in a sanlock VG.
42
43       --gl-disable | -D vgname
44               Tell lvmlockd to disable the global lock in a sanlock VG.
45
46       --stop-lockspaces | -S
47               Stop all lockspaces.
48
49
50

USAGE

52   info
53       This  collects  and  displays lock state from lvmlockd.  The display is
54       primitive, incomplete and will change in future version.  To print  the
55       raw lock state from lvmlockd, combine this option with --dump|-d.
56
57
58   dump
59       This collects the circular log buffer of debug statements from lvmlockd
60       and prints it.
61
62
63   kill
64       This is run by sanlock when it loses  access  to  the  storage  holding
65       leases  for a VG.  It currently emits a syslog message stating that the
66       VG must be immediately deactivated.  In the future it may automatically
67       attempt to forcibly deactivate the VG.  For more, see lvmlockd(8).
68
69
70   drop
71       This  should  only  be run after a VG has been successfully deactivated
72       following an lvmlockctl --kill command.  It clears the stale  lockspace
73       from  lvmlockd.  In the future, this may become automatic along with an
74       automatic handling of --kill.  For more, see lvmlockd(8).
75
76
77   gl-enable
78       This enables the global lock in a sanlock VG.  This is necessary if the
79       VG that previously held the global lock is removed.  For more, see lvm‐
80       lockd(8).
81
82
83   gl-disable
84       This disables the global lock in a sanlock VG.  This  is  necessary  if
85       the  global  lock has mistakenly been enabled in more than one VG.  The
86       global lock should be disabled in all but one sanlock  VG.   For  more,
87       see lvmlockd(8).
88
89
90   stop-lockspaces
91       This  tells  lvmlockd to stop all lockspaces.  It can be useful to stop
92       lockspaces for VGs that the vgchange --lock-stop comand can  no  longer
93       see,  or to stop the dlm global lockspace which is not directly stopped
94       by the vgchange command.  The wait and force options can be  used  with
95       this command.
96
97
98
99
100
101Red Hat, Inc        LVM TOOLS 2.03.02(2)-RHEL8 (2019-01-04)      LVMLOCKCTL(8)
Impressum