1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
|
.TH DLM_TOOL 8 2012-04-05 dlm dlm
.SH NAME
dlm_tool \- a utility for the dlm and dlm_controld daemon
.SH SYNOPSIS
.B dlm_tool
[COMMAND] [OPTIONS]
[
.I name
]
.SH COMMANDS
.B ls
.br
Display dlm_controld internal lockspace state.
.B status
.br
Dump dlm_controld daemon state.
.B dump
.br
Dump dlm_controld debug buffer.
.B dump_config
.br
Dump dlm_controld config settings.
.B reload_config
.br
Reload dlm_controld config settings from dlm.conf.
.BI set_config " setting" = "value"
.br
Set dlm_controld config settings in the currently running daemon.
.BI fence_ack " nodeid"
.br
Cancel a waiting fencing operation and consider it successful.
.B log_plock
.br
Dump dlm_controld plock debug buffer.
.BI plocks " lockspace_name"
.br
Dump posix locks from dlm_controld for the lockspace.
.BI join " lockspace_name"
.br
Join a lockspace.
.BI leave " lockspace_name"
.br
Leave a lockspace.
.BI joinleave " lockspace_name"
.br
Join then immediately leave a lockspace (for testing only.)
.BI lockdebug " lockspace_name"
.br
Complete display of locks from the lockspace.
.BI lockdump " lockspace_name"
.br
Minimal display of locks from the lockspace (deprecated).
.BI run " command"
.br
Run command and check for result (for lvmlockd only.)
.BI run_start " command"
.br
Run command and don't check for result.
.BI run_check " uuid"
.br
Check status of a command that was run.
.BI run_cancel " uuid"
.br
Cancel a command that was run and is not yet done.
.BI run_list
.br
Dump a list of running commands.
.SH OPTIONS
.B \-n
Show all node information from dlm_tool ls.
.B \-d
0|1 Resource directory off/on in join, default 0
.B \-e
0|1 Exclusive create off/on in join, default 0
.B \-f
0|1 FS (filesystem) flag off/on in join, default 0
.BI \-i " sec"
Seconds to wait in run_check.
.BI \-m " mode"
Permission mode for lockspace device (octal), default 0600
.B \-s
Summary following lockdebug output (experiemental)
.B \-v
Verbose lockdebug or status output
.B \-w
Wide lockdebug output
.B \-M
Include MSTCPY locks in lockdump output
.B \-h
Print help, then exit
.B \-V
Print program version information, then exit
.SH USAGE
.SS fence_ack
See dlm_tool status for information about waiting fencing operations for
specific nodeid's.
.SS set_config
dlm_tool set_config can change certain config settings in the currently
running dlm_controld. Supported options:
.nf
daemon_debug
log_debug
debug_logfile
plock_debug
plock_rate_limit
drop_resources_time
drop_resources_count
drop_resources_age
post_join_delay
enable_quorum_fencing
enable_quorum_lockspace
repeat_failed_fencing
.fi
Special cases to revert a previous set_config and restore the previous
value (from default or dlm.conf):
\fBdlm_tool set_config\fP \fIsetting\fP=\fBrestore\fP
.br
restores a single setting.
\fBdlm_tool set_config restore_all\fP
.br
restores all settings.
.SS dump_config
A config setting may have been set from: the default, the dlm_controld
command line, dlm.conf at startup, dlm.conf from reload_config, dlm_tool
set_config. The dump_config output indicates how values were set:
.TP
setting=value
default value.
.TP
setting=value (cli option)
Set from a dlm_controld command line option.
.TP
setting=value (dlm.conf)
Set from dlm.conf (at startup or reload.)
.TP
setting=value (set_config)
Set from dlm_tool set_config.
.SH EXAMPLES
.SS dump_config
.nf
$ dlm_tool dump_config | head -n 5
daemon_debug=1 (set_config)
foreground=0
log_debug=1 (dlm.conf)
protocol=detect
.fi
In this case, daemon_debug is set by set_config, log_debug is set from
dlm.conf, foreground and protocol are using default values.
.SS set_config
.nf
$ dlm_tool dump_config | grep log_debug
log_debug=1 (dlm.conf)
$ dlm_tool set_config "log_debug=0"
set_config done
$ dlm_tool dump_config | grep log_debug
log_debug=0 (set_config)
$ dlm_tool set_config "log_debug=restore"
set_config done
$ dlm_tool dump_config | grep log_debug
log_debug=1 (dlm.conf)
.fi
log_debug is set by dlm.conf (value is 1), then run set_config to change
to 0, then use restore to restore to dlm.conf setting.
.SS set_config
.nf
$ dlm_tool dump_config | grep _debug
daemon_debug=0
log_debug=1 (dlm.conf)
plock_debug=0
$ dlm_tool set_config "daemon_debug=1 log_debug=1 plock_debug=1"
set_config done
$ dlm_tool dump_config | grep _debug
daemon_debug=1 (set_config)
log_debug=1 (set_config)
plock_debug=1 (set_config)
$ dlm_tool set_config "restore_all"
set_config done
$ dlm_tool dump_config | grep _debug
daemon_debug=0
log_debug=1 (dlm.conf)
plock_debug=0
.fi
.SH SEE ALSO
.BR dlm_controld (8),
.BR dlm.conf (5)
|
