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
117 ## scope : multipath & multipathd
118 ## desc : list of device names to discard as not multipath candidates
119 ## default : cciss, fd, hd, md, dm, sr, scd, st, ram, raw, loop
122 # wwid 26353900f02796769
123 # devnode "^(ram|raw|loop|fd|md|dm-|sr|scd|st)[0-9]*"
124 # devnode "^hd[a-z][[0-9]*]"
125 # devnode "^cciss!c[0-9]d[0-9]*[p[0-9]*]"
130 ## scope : multipath & multipathd
131 ## desc : list of multipaths finest-grained settings
136 # # scope : multipath & multipathd
137 # # desc : container for settings that apply to one specific multipath
142 # # scope : multipath & multipathd
143 # # desc : index of the container
145 # wwid 3600508b4000156d700012000000b0000
149 # # scope : multipath
150 # # desc : symbolic name for the multipath
155 # # name : path_grouping_policy
156 # # scope : multipath
157 # # desc : path grouping policy to apply to this multipath
158 # # values : failover, multibus, group_by_serial
159 # # default : failover
161 # path_grouping_policy multibus
164 # # name : path_checker
165 # # scope : multipathd
166 # # desc : path checking alorithm to use to check path state
167 # # values : readsector0, tur
168 # # default : readsector0
170 # # path_checker readsector0
173 # # name : path_selector
174 # # desc : the path selector algorithm to use for this mpath
175 # # these algo are offered by the kernel mpath target
176 # # values : "round-robin 0"
177 # # default : "round-robin 0"
179 # path_selector "round-robin 0"
183 # # scope : multipathd
184 # # desc : tell the daemon to manage path group failback, or not to.
185 # # 0 means immediate failback, values >0 means deffered failback
186 # # expressed in seconds.
187 # # values : manual|immediate|n > 0
188 # # default : immediate
193 # # name : no_path_retry
194 # # scope : multipath & multipathd
195 # # desc : tell the number of retries until disable queueing, or
196 # # "fail" means immediate failure (no queueing),
197 # # "queue" means never stop queueing
198 # # values : queue|fail|n (>0)
201 # #no_path_retry queue
204 # wwid 1DEC_____321816758474
206 # rr_weight priorities
212 ## scope : multipath & multipathd
213 ## desc : list of per storage controler settings
214 ## overrides default settings (device_maps block)
215 ## overriden by per multipath settings (multipaths block)
220 # # scope : multipath & multipathd
221 # # desc : settings for this specific storage controler
225 # # name : vendor, product
226 # # scope : multipath & multipathd
227 # # desc : index for the block
230 # product "HSV110 (C)COMPAQ"
233 # # name : path_grouping_policy
234 # # scope : multipath
235 # # desc : path grouping policy to apply to multipath hosted
236 # # by this storage controler
237 # # values : failover = 1 path per priority group
238 # # multibus = all valid paths in 1 priority
240 # # group_by_serial = 1 priority group per detected
242 # # default : failover
244 # path_grouping_policy multibus
247 # # name : getuid_callout
248 # # scope : multipath
249 # # desc : the program and args to callout to obtain a unique
250 # # path identifier. Absolute path required
251 # # default : /sbin/scsi_id -g -u -s
253 # getuid_callout "/sbin/scsi_id -g -u -s /block/%n"
256 # # name : prio_callout
257 # # scope : multipath
258 # # desc : the program and args to callout to obtain a path
259 # # weight. Weights are summed for each path group to
260 # # determine the next PG to use case of failure.
261 # # "none" is a valid value.
262 # # default : no callout, all paths equals
264 # prio_callout "/sbin/mpath_prio_balance_units %d"
267 # # name : path_checker
268 # # scope : multipathd
269 # # desc : path checking alorithm to use to check path state
270 # # values : readsector0, tur
271 # # default : readsector0
273 # path_checker readsector0
276 # # name : path_selector
277 # # desc : the path selector algorithm to use for this mpath
278 # # these algo are offered by the kernel mpath target
279 # # values : "round-robin 0"
280 # # default : "round-robin 0"
282 # path_selector "round-robin 0"
286 # # scope : multipathd
287 # # desc : tell the daemon to manage path group failback, or not to.
288 # # 0 means immediate failback, values >0 means deffered failback
289 # # expressed in seconds.
290 # # values : manual|immediate|n > 0
291 # # default : immediate
298 # path_grouping_policy multibus
300 # rr_weight priorities