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]*]"
144 ## scope : multipath & multipathd
145 ## desc : list of multipaths finest-grained settings
150 # # scope : multipath & multipathd
151 # # desc : container for settings that apply to one specific multipath
156 # # scope : multipath & multipathd
157 # # desc : index of the container
159 # wwid 3600508b4000156d700012000000b0000
163 # # scope : multipath
164 # # desc : symbolic name for the multipath
169 # # name : path_grouping_policy
170 # # scope : multipath
171 # # desc : path grouping policy to apply to this multipath
172 # # values : failover, multibus, group_by_serial
173 # # default : failover
175 # path_grouping_policy multibus
178 # # name : path_checker
179 # # scope : multipathd
180 # # desc : path checking alorithm to use to check path state
181 # # values : readsector0, tur
182 # # default : readsector0
184 # # path_checker readsector0
187 # # name : path_selector
188 # # desc : the path selector algorithm to use for this mpath
189 # # these algo are offered by the kernel mpath target
190 # # values : "round-robin 0"
191 # # default : "round-robin 0"
193 # path_selector "round-robin 0"
197 # # scope : multipathd
198 # # desc : tell the daemon to manage path group failback, or not to.
199 # # 0 means immediate failback, values >0 means deffered failback
200 # # expressed in seconds.
201 # # values : manual|immediate|n > 0
202 # # default : immediate
207 # # name : no_path_retry
208 # # scope : multipath & multipathd
209 # # desc : tell the number of retries until disable queueing, or
210 # # "fail" means immediate failure (no queueing),
211 # # "queue" means never stop queueing
212 # # values : queue|fail|n (>0)
215 # #no_path_retry queue
219 # # scope : multipath
220 # # desc : the number of IO to route to a path before switching
221 # # to the next in the same path group
227 # wwid 1DEC_____321816758474
229 # rr_weight priorities
235 ## scope : multipath & multipathd
236 ## desc : list of per storage controler settings
237 ## overrides default settings (device_maps block)
238 ## overriden by per multipath settings (multipaths block)
243 # # scope : multipath & multipathd
244 # # desc : settings for this specific storage controler
248 # # name : vendor, product
249 # # scope : multipath & multipathd
250 # # desc : index for the block
253 # product "HSV110 (C)COMPAQ"
256 # # name : path_grouping_policy
257 # # scope : multipath
258 # # desc : path grouping policy to apply to multipath hosted
259 # # by this storage controler
260 # # values : failover = 1 path per priority group
261 # # multibus = all valid paths in 1 priority
263 # # group_by_serial = 1 priority group per detected
265 # # default : failover
267 # path_grouping_policy multibus
270 # # name : getuid_callout
271 # # scope : multipath
272 # # desc : the program and args to callout to obtain a unique
273 # # path identifier. Absolute path required
274 # # default : /sbin/scsi_id -g -u -s
276 # getuid_callout "/sbin/scsi_id -g -u -s /block/%n"
279 # # name : prio_callout
280 # # scope : multipath
281 # # desc : the program and args to callout to obtain a path
282 # # weight. Weights are summed for each path group to
283 # # determine the next PG to use case of failure.
284 # # "none" is a valid value.
285 # # default : no callout, all paths equals
287 # prio_callout "/sbin/mpath_prio_balance_units %d"
290 # # name : path_checker
291 # # scope : multipathd
292 # # desc : path checking alorithm to use to check path state
293 # # values : readsector0, tur
294 # # default : readsector0
296 # path_checker readsector0
299 # # name : path_selector
300 # # desc : the path selector algorithm to use for this mpath
301 # # these algo are offered by the kernel mpath target
302 # # values : "round-robin 0"
303 # # default : "round-robin 0"
305 # path_selector "round-robin 0"
309 # # scope : multipathd
310 # # desc : tell the daemon to manage path group failback, or not to.
311 # # 0 means immediate failback, values >0 means deffered failback
312 # # expressed in seconds.
313 # # values : manual|immediate|n > 0
314 # # default : immediate
320 # # scope : multipath
321 # # desc : the number of IO to route to a path before switching
322 # # to the next in the same path group
330 # path_grouping_policy multibus
332 # rr_weight priorities