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. For
22 # # properly functioning paths, the interval between checks
23 # # will gradually increase to (4 * polling_interval).
30 # # name : path_selector
31 # # scope : multipath & multipathd
32 # # desc : the default path selector algorithm to use
33 # # these algorithms are offered by the kernel multipath target
34 # # values : "round-robin 0"
35 # # default : "round-robin 0"
37 # path_selector "round-robin 0"
40 # # name : path_grouping_policy
41 # # scope : multipath & multipathd
42 # # desc : the default path grouping policy to apply to unspecified
44 # # values : failover = 1 path per priority group
45 # # multibus = all valid paths in 1 priority group
46 # # group_by_serial = 1 priority group per detected serial
48 # # group_by_prio = 1 priority group per path priority
50 # # group_by_node_name = 1 priority group per target node name
51 # # default : failover
53 # path_grouping_policy multibus
56 # # name : getuid_callout
57 # # scope : multipath & multipathd
58 # # desc : the default program and args to callout to obtain a unique
59 # # path identifier. Absolute path required
60 # # default : /lib/udev/scsi_id --whitelisted --device=/dev/%n
62 # getuid_callout "/lib/udev/scsi_id --whitelisted --device=/dev/%n"
66 # # scope : multipath & multipathd
67 # # desc : the default function to call to obtain a path
68 # # priority value. The ALUA bits in SPC-3 provide an
69 # # exploitable prio value for example.
76 # # scope : multipath & multipathd
77 # # desc : The arguments string passed to the prio function
78 # # Most prio functions do not need arguments. The
79 # # datacore prioritizer need one.
82 # prio_args "timeout=1000 preferredsds=foo"
86 # # scope : multipath & multipathd
87 # # desc : The default extra features of multipath devices. The
88 # # only existing feature currently is queue_if_no_path, which
89 # # is the same as setting no_path_retry to queue.
90 # # values : "1 queue_if_no_path"
93 # features "1 queue_if_no_path"
96 # # name : path_checker, checker
97 # # scope : multipath & multipathd
98 # # desc : the default method used to determine the paths' state
99 # # values : readsector0|tur|emc_clariion|hp_sw|directio|rdac|cciss_tur
100 # # default : directio
102 # path_checker directio
106 # # scope : multipath & multipathd
107 # # desc : the number of IO to route to a path before switching
108 # # to the next in the same path group
114 # # name : flush_on_last_del
115 # # scope : multipathd
116 # # desc : If set to "yes", multipathd will disable queueing when the
117 # # last path to a device has been deleted.
121 # flush_on_last_del yes
125 # # scope : multipathd
126 # # desc : Sets the maximum number of open file descriptors for the
127 # # multipathd process.
128 # # values : max|n > 0
135 # # scope : multipath & multipathd
136 # # desc : if set to priorities the multipath configurator will assign
137 # # path weights as "path prio * rr_min_io"
138 # # values : priorities|uniform
139 # # default : uniform
141 # rr_weight priorities
145 # # scope : multipathd
146 # # desc : tell the daemon to manage path group failback, or not to.
147 # # 0 means immediate failback, values >0 means deffered
148 # # failback expressed in seconds.
149 # # values : manual|immediate|n > 0
155 # # name : no_path_retry
156 # # scope : multipath & multipathd
157 # # desc : tell the number of retries until disable queueing, or
158 # # "fail" means immediate failure (no queueing),
159 # # "queue" means never stop queueing
160 # # values : queue|fail|n (>0)
163 # no_path_retry queue
166 # # name : queue_without_daemon
167 # # scope : multipathd
168 # # desc : If set to "no", multipathd will disable queueing for all
169 # # devices when it is shut down.
172 # queue_without_daemon no
175 # # name : user_friendly_names
176 # # scope : multipath & multipathd
177 # # desc : If set to "yes", using the bindings file
178 # # /etc/multipath/bindings to assign a persistent and
179 # # unique alias to the multipath, in the form of mpath<n>.
180 # # If set to "no" use the WWID as the alias. In either case
181 # # this be will be overriden by any specific aliases in this
185 # user_friendly_names no
189 # # scope : multipath & multipathd
190 # # desc : The mode to use for the multipath device nodes, in octal.
191 # # values : 0000 - 0777
192 # # default : determined by the process
197 # # scope : multipath & multipathd
198 # # desc : The user id to use for the multipath device nodes. You
199 # # may use either the numeric or symbolic uid
200 # # values : <user_id>
201 # # default : determined by the process
206 # # scope : multipath & multipathd
207 # # desc : The group id to user for the multipath device nodes. You
208 # # may use either the numeric or symbolic gid
209 # # values : <group_id>
210 # # default : determined by the process
214 # # name : checker_timeout
215 # # scope : multipath & multipathd
216 # # desc : The timeout to use for path checkers that issue scsi
217 # # commands with an explicit timeout, in seconds.
219 # # default : taken from /sys/block/sd<x>/device/timeout
223 # # name : fast_io_fail_tmo
224 # # scope : multipath & multipathd
225 # # desc : The number of seconds the scsi layer will wait after a
226 # # problem has been detected on a FC remote port before failing
227 # # IO to devices on that remote port.
228 # # values : off | n >= 0 (smaller than dev_loss_tmo)
229 # # default : determined by the OS
233 # # name : dev_loss_tmo
234 # # scope : multipath & multipathd
235 # # desc : The number of seconds the scsi layer will wait after a
236 # # problem has been detected on a FC remote port before
237 # # removing it from the system.
239 # # default : determined by the OS
241 # # name : bindings_file
242 # # scope : multipath
243 # # desc : The location of the bindings file that is used with
244 # # the user_friendly_names option.
245 # # values : <full_pathname>
246 # # default : "/var/lib/multipath/bindings"
247 # bindings_file "/etc/multipath_bindings"
253 ## scope : multipath & multipathd
254 ## desc : list of device names to discard as not multipath candidates
255 ## Devices can be identified by their device node name "devnode",
256 ## their WWID "wwid", or their vender and product strings
258 ## default : fd, hd, md, dm, sr, scd, st, ram, raw, loop, dcssblk
261 # wwid 26353900f02796769
262 # devnode "^(ram|raw|loop|fd|md|dm-|sr|scd|st)[0-9]*"
264 # devnode "^dcssblk[0-9]*"
271 ## name : blacklist_exceptions
272 ## scope : multipath & multipathd
273 ## desc : list of device names to be treated as multipath candidates
274 ## even if they are on the blacklist.
275 ## Note: blacklist exceptions are only valid in the same class.
276 ## It is not possible to blacklist devices using the devnode keyword
277 ## and to exclude some devices of them using the wwid keyword.
280 #blacklist_exceptions {
281 # devnode "^dasd[c-d]+[0-9]*"
282 # wwid "IBM.75000000092461.4d00.34"
283 # wwid "IBM.75000000092461.4d00.35"
284 # wwid "IBM.75000000092461.4d00.36"
289 ## scope : multipath & multipathd
290 ## desc : list of multipaths finest-grained settings
295 # # scope : multipath & multipathd
296 # # desc : container for settings that apply to one specific multipath
301 # # scope : multipath & multipathd
302 # # desc : index of the container
304 # wwid 3600508b4000156d700012000000b0000
308 # # scope : multipath & multipathd
309 # # desc : symbolic name for the multipath. If you are using
310 # # user_friendly_names, do not set the alias to
311 # # mpath<n>. This may conflict with an automatically
312 # # assigned user friendly name, and give you
313 # # incorrect device node names.
318 # # name : path_grouping_policy
319 # # scope : multipath & multipathd
320 # # desc : path grouping policy to apply to this multipath
321 # # values : failover, multibus, group_by_serial
322 # # values : failover = 1 path per priority group
323 # # multibus = all valid paths in 1 priority
325 # # group_by_serial = 1 priority group per detected
327 # # group_by_prio = 1 priority group per path
329 # # group_by_node_name = 1 priority group per target
332 # path_grouping_policy failover
335 # # name : path_selector
336 # # scope : multipath & multipathd
337 # # desc : the path selector algorithm to use for this mpath
338 # # these algo are offered by the kernel mpath target
339 # # values : "round-robin 0"
341 # path_selector "round-robin 0"
345 # # scope : multipathd
346 # # desc : tell the daemon to manage path group failback, or
347 # # not to. 0 means immediate failback, values >0 means
348 # # deffered failback expressed in seconds.
349 # # values : manual|immediate|n > 0
355 # # scope : multipath & multipathd
356 # # desc : if set to priorities the multipath configurator will
357 # # assign path weights as "path prio * rr_min_io"
358 # # values : priorities|uniform
360 # rr_weight priorities
363 # # name : no_path_retry
364 # # scope : multipath & multipathd
365 # # desc : tell the number of retries until disable queueing,
366 # # or "fail" means immediate failure (no queueing),
367 # # "queue" means never stop queueing
368 # # values : queue|fail|n (>0)
370 # no_path_retry queue
374 # # scope : multipath & multipathd
375 # # desc : the number of IO to route to a path before switching
376 # # to the next in the same path group
381 # # name : flush_on_last_del
382 # # scope : multipathd
383 # # desc : If set to "yes", multipathd will disable queueing
384 # # when the last path to a device has been deleted.
388 # flush_on_last_del yes
392 # # scope : multipath & multipathd
393 # # desc : The mode to use for the multipath device nodes, in
395 # # values : 0000 - 0777
396 # # default : determined by the process
401 # # scope : multipath & multipathd
402 # # desc : The user id to use for the multipath device nodes.
403 # # You may use either the numeric or symbolic uid
404 # # values : <user_id>
405 # # default : determined by the process
410 # # scope : multipath & multipathd
411 # # desc : The group id to user for the multipath device nodes.
412 # # You may use either the numeric or symbolic gid
413 # # values : <group_id>
414 # # default : determined by the process
419 # wwid 1DEC_____321816758474
421 # rr_weight priorities
427 ## scope : multipath & multipathd
428 ## desc : list of per storage controller settings
429 ## overrides default settings (device_maps block)
430 ## overriden by per multipath settings (multipaths block)
435 # # scope : multipath & multipathd
436 # # desc : settings for this specific storage controller
440 # # name : vendor, product
441 # # scope : multipath & multipathd
442 # # desc : index for the block
445 # product "HSV110 (C)COMPAQ"
448 # # name : path_grouping_policy
449 # # scope : multipath & multipathd
450 # # desc : path grouping policy to apply to this multipath
451 # # values : failover, multibus, group_by_serial
452 # # values : failover = 1 path per priority group
453 # # multibus = all valid paths in 1 priority
455 # # group_by_serial = 1 priority group per detected
457 # # group_by_prio = 1 priority group per path
459 # # group_by_node_name = 1 priority group per target
462 # path_grouping_policy failover
465 # # name : getuid_callout
466 # # scope : multipath & multipathd
467 # # desc : the program and args to callout to obtain a unique
468 # # path identifier. Absolute path required
470 # getuid_callout "/lib/udev/scsi_id --whitelisted --device=/dev/%n"
474 # # scope : multipath & multipathd
475 # # desc : the function to call to obtain a path
476 # # weight. Weights are summed for each path group to
477 # # determine the next PG to use case of failure.
478 # # default : no callout, all paths equals
484 # # scope : multipath & multipathd
485 # # desc : The arguments string passed to the prio function
486 # # Most prio functions do not need arguments. The
487 # # datacore prioritizer need one.
490 # prio_args "timeout=1000 preferredsds=foo"
492 # # name : path_checker, checker
493 # # scope : multipathd & multipathd
494 # # desc : path checking alorithm to use to check path state
495 # # values : readsector0|tur|emc_clariion|hp_sw|directio|rdac|
498 # path_checker directio
501 # # name : path_selector
502 # # scope : multipathd & multipathd
503 # # desc : the path selector algorithm to use for this mpath
504 # # these algo are offered by the kernel mpath target
505 # # values : "round-robin 0"
507 # path_selector "round-robin 0"
511 # # scope : multipath & multipathd
512 # # desc : The extra features of multipath devices. The only
513 # # existing feature currently is queue_if_no_path,
514 # # which is the same as setting no_path_retry to queue.
515 # # values : "1 queue_if_no_path"
517 # features "1 queue_if_no_path"
520 # # name : hardware_handler
521 # # scope : multipath & multipathd
522 # # desc : If set, it specifies a module that will be used to
523 # # perform hardware specific actions when switching
524 # # path groups or handling IO errors
525 # # values : "0"|"1 emc"
528 # hardware_handler "1 emc"
532 # # scope : multipathd
533 # # desc : tell the daemon to manage path group failback, or
534 # # not to. 0 means immediate failback, values >0 means
535 # # deffered failback expressed in seconds.
536 # # values : manual|immediate|n > 0
542 # # scope : multipath & multipathd
543 # # desc : if set to priorities the multipath configurator will
544 # # assign path weights as "path prio * rr_min_io"
545 # # values : priorities|uniform
547 # rr_weight priorities
550 # # name : no_path_retry
551 # # scope : multipath & multipathd
552 # # desc : tell the number of retries until disable queueing,
553 # # or "fail" means immediate failure (no queueing),
554 # # "queue" means never stop queueing
555 # # values : queue|fail|n (>0)
557 # no_path_retry queue
561 # # scope : multipath & multipathd
562 # # desc : the number of IO to route to a path before switching
563 # # to the next in the same path group
568 # # name : flush_on_last_del
569 # # scope : multipathd
570 # # desc : If set to "yes", multipathd will disable queueing
571 # # when the last path to a device has been deleted.
574 # flush_on_last_del yes
577 # # name : product_blacklist
578 # # scope : multipath & multipathd
579 # # desc : product strings to blacklist for this vendor
581 # product_blacklist LUN_Z
584 # # name : fast_io_fail_tmo
585 # # scope : multipath & multipathd
586 # # desc : The number of seconds the scsi layer will wait after
587 # # a problem has been detected on a FC remote port
588 # # before failing IO to devices on that remote port.
589 # # values : off | n >= 0 (smaller than dev_loss_tmo)
593 # # name : dev_loss_tmo
594 # # scope : multipath & multipathd
595 # # desc : The number of seconds the scsi layer will wait after
596 # # a problem has been detected on a FC remote port
597 # # before removing it from the system.
604 # path_grouping_policy multibus
606 # rr_weight priorities