Ubuntu Server Guide

Device Mapper Multipathing - Configuration
Device Mapper Multipath will be referred here as multipath only.
Before moving on with this session it is recommended that you read: 1. Device Mapper Multi-
pathing - Introduction
Multipath is usually able to work out-of-the-box with most common storages. This doesn’t mean the default
configuration variables should be used in production: they don’t treat important parameters your storage
might need.
Consult your storage manufacturer’s install guide for the Linux Multipath configuration
options. It is very common that storage vendors provide the most adequate options for Linux,
including minimal kernel and multipath-tools versions required.
Default configuration values for DM-Multipath can be overridden by editing the /etc/multipath.conf file and
restarting the multipathd service.
This chapter provides information on parsing and modifying the multipath.conf file and it is split into the
following configuration file sections:
• Configuration File Overview
• Configuration File Defaults
• Configuration File Blacklist & Exceptions
• Configuration File Multipath Section
• Configuration File Devices Section
Configuration File Overview
The configuration file contains entries of the form:
 {
 
. . .
 {
 
. . .
}
}
The following keywords are recognized:
• defaults - This section defines default values for attributes which are used whenever no values are
given in the appropriate device or multipath sections.
• blacklist - This section defines which devices should be excluded from the multipath topology discov-
ery.
29

---

• blacklist_exceptions - This section defines which devices should be included in the multipath topol-
ogy discovery, despite being listed in the blacklist section.
• multipaths - This section defines the multipath topologies. They are indexed by a World Wide
Identifier(WWID).Attributes set in this section take precedence over all others.
• devices - This section defines the device-specific settings. Devices are identified by vendor, product,
and revision.
• overrides - This section defines values for attributes that should override the device-specific settings
for all devices.