2 ## This is a template multipath-tools configuration file
3 ## Uncomment the lines relevent to your environment
8 ## desc : multipath-tools default settings
13 # # desc : directory where udev creates its device nodes
19 # # name : polling_interval
20 # # scope : multipathd
21 # # desc : interval between two path checks in seconds
29 # # desc : the default path selector algorithm to use
30 # # these algorithms are offered by the kernel multipath target
31 # # values : "round-robin 0"
32 # # default : "round-robin 0"
34 # selector "round-robin 0"
37 # # name : path_grouping_policy
39 # # desc : the default path grouping policy to apply to unspecified
41 # # default : multibus
43 # path_grouping_policy multibus
46 # # name : getuid_callout
48 # # desc : the default program and args to callout to obtain a unique
49 # # path identifier. Absolute path required
50 # # default : /sbin/scsi_id -g -u -s
52 # getuid_callout "/sbin/scsi_id -g -u -s /block/%n"
55 # # name : prio_callout
57 # # desc : the default program and args to callout to obtain a path
58 # # priority value. The ALUA bits in SPC-3 provide an
59 # # exploitable prio value for example. "none" is a valid value
62 # #prio_callout "/bin/true"
65 # # name : path_checker
66 # # scope : multipath & multipathd
67 # # desc : the default method used to determine the paths' state
68 # # values : readsector0|tur|emc_clariion|hp_sw|directio
69 # # default : readsector0
71 # #path_checker readsector0
76 # # desc : the number of IO to route to a path before switching
77 # # to the next in the same path group
85 # # desc : if set to priorities the multipath configurator will assign
86 # # path weights as "path prio * rr_min_io"
87 # # values : priorities|uniform
90 # rr_weight priorities
94 # # scope : multipathd
95 # # desc : tell the daemon to manage path group failback, or not to.
96 # # 0 means immediate failback, values >0 means deffered failback
97 # # expressed in seconds.
98 # # values : manual|immediate|n > 0
99 # # default : immediate
104 # # name : no_path_retry
105 # # scope : multipath & multipathd
106 # # desc : tell the number of retries until disable queueing, or
107 # # "fail" means immediate failure (no queueing),
108 # # "queue" means never stop queueing
109 # # values : queue|fail|n (>0)
112 # #no_path_retry queue
115 # # name : user_friendly_names
116 # # scope : multipath
117 # # desc : If set to "yes", using the bindings file
118 # # /var/lib/multipath/bindings to assign a persistent and
119 # # unique alias to the multipath, in the form of mpath<n>.
120 # # If set to "no" use the WWID as the alias. In either case
121 # # this be will be overriden by any specific aliases in this
125 # user_friendly_names no
131 ## scope : multipath & multipathd
132 ## desc : list of device names to discard as not multipath candidates
133 ## default : cciss, fd, hd, md, dm, sr, scd, st, ram, raw, loop
136 # wwid 26353900f02796769
137 # devnode "^(ram|raw|loop|fd|md|dm-|sr|scd|st)[0-9]*"
138 # devnode "^hd[a-z][[0-9]*]"
139 # devnode "^cciss!c[0-9]d[0-9]*[p[0-9]*]"
148 ## scope : multipath & multipathd
149 ## desc : list of multipaths finest-grained settings
154 # # scope : multipath & multipathd
155 # # desc : container for settings that apply to one specific multipath
160 # # scope : multipath & multipathd
161 # # desc : index of the container
163 # wwid 3600508b4000156d700012000000b0000
167 # # scope : multipath
168 # # desc : symbolic name for the multipath
173 # # name : path_grouping_policy
174 # # scope : multipath
175 # # desc : path grouping policy to apply to this multipath
176 # # values : failover, multibus, group_by_serial
177 # # default : failover
179 # path_grouping_policy multibus
182 # # name : path_checker
183 # # scope : multipathd
184 # # desc : path checking alorithm to use to check path state
185 # # values : readsector0, tur
186 # # default : readsector0
188 # # path_checker readsector0
191 # # name : path_selector
192 # # desc : the path selector algorithm to use for this mpath
193 # # these algo are offered by the kernel mpath target
194 # # values : "round-robin 0"
195 # # default : "round-robin 0"
197 # path_selector "round-robin 0"
201 # # scope : multipathd
202 # # desc : tell the daemon to manage path group failback, or not to.
203 # # 0 means immediate failback, values >0 means deffered failback
204 # # expressed in seconds.
205 # # values : manual|immediate|n > 0
206 # # default : immediate
211 # # name : no_path_retry
212 # # scope : multipath & multipathd
213 # # desc : tell the number of retries until disable queueing, or
214 # # "fail" means immediate failure (no queueing),
215 # # "queue" means never stop queueing
216 # # values : queue|fail|n (>0)
219 # #no_path_retry queue
223 # # scope : multipath
224 # # desc : the number of IO to route to a path before switching
225 # # to the next in the same path group
231 # wwid 1DEC_____321816758474
233 # rr_weight priorities
239 ## scope : multipath & multipathd
240 ## desc : list of per storage controller settings
241 ## overrides default settings (device_maps block)
242 ## overriden by per multipath settings (multipaths block)
247 # # scope : multipath & multipathd
248 # # desc : settings for this specific storage controller
252 # # name : vendor, product
253 # # scope : multipath & multipathd
254 # # desc : index for the block
257 # product "HSV110 (C)COMPAQ"
260 # # name : path_grouping_policy
261 # # scope : multipath
262 # # desc : path grouping policy to apply to multipath hosted
263 # # by this storage controller
264 # # values : failover = 1 path per priority group
265 # # multibus = all valid paths in 1 priority
267 # # group_by_serial = 1 priority group per detected
269 # # default : failover
271 # path_grouping_policy multibus
274 # # name : getuid_callout
275 # # scope : multipath
276 # # desc : the program and args to callout to obtain a unique
277 # # path identifier. Absolute path required
278 # # default : /sbin/scsi_id -g -u -s
280 # getuid_callout "/sbin/scsi_id -g -u -s /block/%n"
283 # # name : prio_callout
284 # # scope : multipath
285 # # desc : the program and args to callout to obtain a path
286 # # weight. Weights are summed for each path group to
287 # # determine the next PG to use case of failure.
288 # # "none" is a valid value.
289 # # default : no callout, all paths equals
291 # prio_callout "/sbin/mpath_prio_balance_units %d"
294 # # name : path_checker
295 # # scope : multipathd
296 # # desc : path checking alorithm to use to check path state
297 # # values : readsector0, tur
298 # # default : readsector0
300 # path_checker readsector0
303 # # name : path_selector
304 # # desc : the path selector algorithm to use for this mpath
305 # # these algo are offered by the kernel mpath target
306 # # values : "round-robin 0"
307 # # default : "round-robin 0"
309 # path_selector "round-robin 0"
313 # # scope : multipathd
314 # # desc : tell the daemon to manage path group failback, or not to.
315 # # 0 means immediate failback, values >0 means deffered failback
316 # # expressed in seconds.
317 # # values : manual|immediate|n > 0
318 # # default : immediate
324 # # scope : multipath
325 # # desc : the number of IO to route to a path before switching
326 # # to the next in the same path group
332 # # name : product_blacklist
333 # # scope : multipath & multipathd
334 # # desc : product strings to blacklist for this vendor
337 # product_blacklist LUN_Z
342 # path_grouping_policy multibus
344 # rr_weight priorities