dlm_tool(8)

1DLM_TOOL(8)                           dlm                          DLM_TOOL(8)
2
3
4

NAME

6       dlm_tool - a utility for the dlm and dlm_controld daemon
7
8

SYNOPSIS

10       dlm_tool [COMMAND] [OPTIONS] [ name ]
11
12

COMMANDS

14       ls
15            Display dlm_controld internal lockspace state.
16
17       status
18            Dump dlm_controld daemon state.
19
20       dump
21            Dump dlm_controld debug buffer.
22
23       dump_config
24            Dump dlm_controld config settings.
25
26       reload_config
27            Reload dlm_controld config settings from dlm.conf.
28
29       set_config setting=value
30            Set dlm_controld config settings in the currently running daemon.
31
32       fence_ack nodeid
33            Cancel a waiting fencing operation and consider it successful.
34
35       log_plock
36            Dump dlm_controld plock debug buffer.
37
38       plocks lockspace_name
39            Dump posix locks from dlm_controld for the lockspace.
40
41       join lockspace_name
42            Join a lockspace.
43
44       leave lockspace_name
45            Leave a lockspace.
46
47       joinleave lockspace_name
48            Join then immediately leave a lockspace (for testing only.)
49
50       lockdebug lockspace_name
51            Complete display of locks from the lockspace.
52
53       lockdump lockspace_name
54            Minimal display of locks from the lockspace (deprecated).
55
56       run command
57            Run command and check for result (for lvmlockd only.)
58
59       run_start command
60            Run command and don't check for result.
61
62       run_check uuid
63            Check status of a command that was run.
64
65       run_cancel uuid
66            Cancel a command that was run and is not yet done.
67
68       run_list
69            Dump a list of running commands.
70
71
72

OPTIONS

74       -n Show all node information from dlm_tool ls.
75
76       -d 0|1 Resource directory off/on in join, default 0
77
78       -e 0|1 Exclusive create off/on in join, default 0
79
80       -f 0|1 FS (filesystem) flag off/on in join, default 0
81
82       -i sec Seconds to wait in run_check.
83
84       -m mode Permission mode for lockspace device (octal), default 0600
85
86       -s Summary following lockdebug output (experiemental)
87
88       -v Verbose lockdebug or status output
89
90       -w Wide lockdebug output
91
92       -M Include MSTCPY locks in lockdump output
93
94       -h Print help, then exit
95
96       -V Print program version information, then exit
97
98
99

USAGE

101   fence_ack
102       See  dlm_tool  status  for information about waiting fencing operations
103       for specific nodeid's.
104
105
106   set_config
107       dlm_tool set_config can change certain config settings in the currently
108       running dlm_controld.  Supported options:
109
110       daemon_debug
111       log_debug
112       debug_logfile
113       plock_debug
114       plock_rate_limit
115       drop_resources_time
116       drop_resources_count
117       drop_resources_age
118       post_join_delay
119       enable_quorum_fencing
120       enable_quorum_lockspace
121       repeat_failed_fencing
122
123       Special  cases to revert a previous set_config and restore the previous
124       value (from default or dlm.conf):
125
126       dlm_tool set_config setting=restore
127       restores a single setting.
128
129       dlm_tool set_config restore_all
130       restores all settings.
131
132
133   dump_config
134       A config setting may have been set from: the default, the  dlm_controld
135       command   line,  dlm.conf  at  startup,  dlm.conf  from  reload_config,
136       dlm_tool set_config.  The dump_config output indicates how values  were
137       set:
138
139
140       setting=value
141              default value.
142
143
144       setting=value (cli option)
145              Set from a dlm_controld command line option.
146
147
148       setting=value (dlm.conf)
149              Set from dlm.conf (at startup or reload.)
150
151
152       setting=value (set_config)
153              Set from dlm_tool set_config.
154
155
156

EXAMPLES

158   dump_config
159       $ dlm_tool dump_config | head -n 5
160       daemon_debug=1 (set_config)
161       foreground=0
162       log_debug=1 (dlm.conf)
163       protocol=detect
164
165       In  this case, daemon_debug is set by set_config, log_debug is set from
166       dlm.conf, foreground and protocol are using default values.
167
168
169   set_config
170       $ dlm_tool dump_config | grep log_debug
171       log_debug=1 (dlm.conf)
172
173       $ dlm_tool set_config "log_debug=0"
174       set_config done
175
176       $ dlm_tool dump_config | grep log_debug
177       log_debug=0 (set_config)
178
179       $ dlm_tool set_config "log_debug=restore"
180       set_config done
181
182       $ dlm_tool dump_config | grep log_debug
183       log_debug=1 (dlm.conf)
184
185       log_debug is set by dlm.conf (value  is  1),  then  run  set_config  to
186       change to 0, then use restore to restore to dlm.conf setting.
187
188
189
190   set_config
191       $ dlm_tool dump_config | grep _debug
192       daemon_debug=0
193       log_debug=1 (dlm.conf)
194       plock_debug=0
195
196       $ dlm_tool set_config "daemon_debug=1 log_debug=1 plock_debug=1"
197       set_config done
198
199       $ dlm_tool dump_config | grep _debug
200       daemon_debug=1 (set_config)
201       log_debug=1 (set_config)
202       plock_debug=1 (set_config)
203
204       $ dlm_tool set_config "restore_all"
205       set_config done
206
207       $ dlm_tool dump_config | grep _debug
208       daemon_debug=0
209       log_debug=1 (dlm.conf)
210       plock_debug=0
211
212
213

NAME

SYNOPSIS

COMMANDS

OPTIONS

USAGE

EXAMPLES

SEE ALSO