1MULTIPATHD(8) System Manager's Manual MULTIPATHD(8)
2
6 multipathd - multipath daemon
7
10 multipathd [options]
11
14 The multipathd daemon is in charge of checking for failed paths. When
15 this happens, it will reconfigure the multipath map the path belongs
16 to, so that this map regains its maximum performance and redundancy.
17 This daemon executes the external multipath config tool when events
19 occur. In turn, the multipath tool signals the multipathd daemon when
20 it is done with devmap reconfiguration, so that it can refresh its
21 failed path list.
22
25 -d Forground Mode. Don't daemonize, and print all messages to std‐
26 out and stderr.
27 -v level
29 Verbosity level. Print additional information while running mul‐
30 tipathd. A level of 0 means only print errors. A level of 3 or
31 greater prints debugging information as well.
32 -k multipathd will enter interactive mode. From this mode, the
34 available commands can be viewed by entering "help". When you
35 are finished entering commands, press CTRL-D to quit.
36
39 The following commands can be used in interactive mode:
40 list|show paths
42 Show the paths that multipathd is monitoring, and their state.
43 list|show paths format $format
45 Show the paths that multipathd is monitoring, using a format
46 string with path format wildcards.
47 list|show maps|multipaths
49 Show the multipath devices that the multipathd is monitoring.
50 list|show daemon
52 Show the current state of the multipathd daemon
53 list|show maps|multipaths format $format
55 Show the status of all multipath devices that the multipathd is
56 monitoring, using a format string with multipath format wild‐
57 cards.
58 list|show maps|multipaths status
60 Show the status of all multipath devices that the multipathd is
61 monitoring.
62 list|show maps|multipaths stats
64 Show some statistics of all multipath devices that multipathd is
65 monitoring.
66 list|show maps|multipaths topology
68 Show the current multipath topology. Same as "multipath -ll".
69 list|show maps|multipaths json
71 Show the multipath devices that multipathd is monitoring, using
72 JSON formatted output.
73 list|show topology
75 Show the current multipath topology. Same as "multipath -ll".
76 list|show map|multipath $map topology
78 Show topology of a single multipath device specified by $map,
79 e.g. 36005076303ffc56200000000000010aa. This map could be
80 obtained from "list maps".
81 list|show map|multipath $map json
83 Show a single multipath device specified by $map, using JSON
84 formatted output.
85 list|show wildcards
87 Show the format wildcards used in interactive commands taking
88 $format
89 list|show config
91 Show the currently used configuration, derived from default val‐
92 ues and values specified within the configuration file /etc/mul‐
93 tipath.conf.
94 list|show blacklist
96 Show the currently used blacklist rules, derived from default
97 values and values specified within the configuration file
98 /etc/multipath.conf.
99 list|show devices
101 Show all available block devices by name including the informa‐
102 tion if they are blacklisted or not.
103 list|show status
105 Show the number of path checkers in each possible state, the
106 number of monitored paths, and whether multipathd is currently
107 handling a uevent.
108 reset maps|multipaths stats
110 Reset the stat counters for all multipath devices.
111 reset map|multipath $map stats
113 Reset the stat counters for a specific multipath device.
114 add path $path
116 Add a path to the list of monitored paths. $path is as listed in
117 /sys/block (e.g. sda).
118 remove|del path $path
120 Stop monitoring a path. $path is as listed in /sys/block (e.g.
121 sda).
122 add map|multipath $map
124 Add a multipath device to the list of monitored devices. $map
125 can either be a device-mapper device as listed in /sys/block
126 (e.g. dm-0) or it can be the alias for the multipath device
127 (e.g. mpath1) or the uid of the multipath device (e.g.
128 36005076303ffc56200000000000010aa).
129 remove|del map|multipath $map
131 Stop monitoring a multipath device.
132 resize map|multipath $map
134 Resizes map $map to the given size
135 switch|switchgroup map|multipath $map group $group
137 Force a multipath device to switch to a specific path group.
138 $group is the path group index, starting with 1.
139 reconfigure
141 Reconfigures the multipaths. This should be triggered automati‐
142 cally after any hotplug event.
143 suspend map|multipath $map
145 Sets map $map into suspend state.
146 resume map|multipath $map
148 Resumes map $map from suspend state.
149 reset map|multipath $map
151 Reassign existing device-mapper table(s) use use the multipath
152 device, instead of its path devices.
153 reload map|multipath $map
155 Reload a multipath device.
156 fail path $path
158 Sets path $path into failed state.
159 reinstate path $path
161 Resumes path $path from failed state.
162 disablequeueing maps|multipaths
164 Disable queueing on all multipath devices.
165 restorequeueing maps|multipaths
167 Restore queueing on all multipath devices.
168 disablequeueing map|multipath $map
170 Disable queuing on multipathed map $map
171 restorequeueing map|multipath $map
173 Restore queuing on multipathed map $map
174 forcequeueing daemon
176 Forces multipathd into queue_without_daemon mode, so that
177 no_path_retry queueing will not be disabled when the daemon
178 stops
179 restorequeueing daemon
181 Restores configured queue_without_daemon mode
182 map|multipath $map setprstatus
184 Enable persistent reservation management on $map
185 map|multipath $map unsetprstatus
187 Disable persistent reservation management on $map
188 map|multipath $map getprstatus
190 Get the current persistent reservation management status of $map
191 map|multipath $map getprkey
193 Get the current persistent reservation key associated with $map.
194 map|multipath $map setprkey key $key
196 Set the persistent reservation key associated with $map to $key
197 in the prkeys_file. This key will only be used by multipathd if
198 reservation_key is set to file in /etc/multipath.conf.
199 map|multipath $map unsetprkey
201 Remove the persistent reservation key associated with $map from
202 the prkeys_file. This will only unset the key used by multipathd
203 if reservation_key is set to file in /etc/multipath.conf.
204 quit|exit
206 End interactive session.
207 shutdown
209 Stop multipathd.
210
213 multipath(8) kpartx(8) hotplug(8)
214
216 multipathd was developed by Christophe Varoqui, <christophe.varo‐
217 qui@opensvc.com> and others.
218Linux Administrator's Manual November 2009 MULTIPATHD(8)