The multipath.conf
file is the configuration file for the multipath daemon, multipathd. The multipath.conf
file overrides the built-in configuration table for multipathd. Any line in the file whose first non-white-space character is # is considered a comment line. Empty lines are ignored.
Note: For SANtricity operating system 8.30, NetApp recommends using the default settings as provided.
Example multipath.conf
are available in the following locations:
- For SLES, /usr/share/doc/packages/multipath-tools/multipath.conf.synthetic
- For RHEL, /usr/share/doc/device-mapper-multipath-0.4.9/multipath.conf
All the lines in the sample
multipath.conf
file are commented out. The file is divided into five sections:
- defaults
– Specifies all default values.
- blacklist
– All devices are blacklisted for new installations. The default blacklist is listed in the commented-out section of the /etc/multipath.conf
file. Blacklist the device mapper multipath by WWID if you do not want to use this functionality.
- blacklist_exceptions
– Specifies any exceptions to the items specified in the section blacklist.
- devices
– Lists all multipath devices with their matching vendor and product values.
- multipaths
– Lists the multipath device with their matching WWID values.
The DM-MP multipath driver has built-in default values, as well as built-in settings for different vendor and product ID combinations. When defining sections in multipath.conf, it has the following effects:
- Parameter values defined in the defaults section merge with the built-in defaults, replacing those values.
- Parameter values defined in a device section merge with the built-in defaults for that vendor and product ID if the device already exists in the built-in configuration. To ensure this merging occurs, the vendor and product strings must match the built-in configuration exactly.
- For each parameter, the value is determined in the following sequence:
- If defined, the multipath section for each device.
- If defined, the device section for the device's vendor and product ID.
- The internal default value.
In the following tasks, you modify the default, blacklist and devices sections of the multipath.conf
file. Remove the initial # character from the start of each line you modify.