Configuration file devices section

The devices section defines configuration settings for specific storage controller types, identified by vendor, product, and revision patterns to optimize multipath behavior per device.

Use the devices section of the multipath.conf configuration file to define settings for individual storage controller types. Values set in this section overwrite specified values in the defaults section.

The system identifies the storage controller types by the vendor, product, and revision keywords. These keywords are regular expressions and must match the sysfs information about the specific device.

The devices section recognizes only the device subsection as an attribute. If there are multiple keyword matches for a device, the attributes of all matching entries apply to it. If an attribute is specified in several matching device subsections, later versions of entries have priority over any previous entries. For more information, see the multipath.conf(5) man page on your system

Important

Configuration attributes in the latest version of the device subsections override attributes in any previous devices subsections and from the defaults section.

The following table shows the attributes that you can set in the device subsection.

Table 1. Devices section attributes
Attribute Description

vendor

Specifies the regular expression to match the device vendor name. This is a mandatory attribute.

product

Specifies the regular expression to match the device product name. This is a mandatory attribute.

revision

Specifies the regular expression to match the device product revision. If the revision attribute is missing, all device revisions match.

product_blacklist

Multipath uses this attribute to create a device blacklist entry that has a vendor attribute that matches the vendor attribute of this device entry, and a product attribute that matches this product_blacklist attribute.

vpd_vendor

Shows the vendor specific Vital Product Data (VPD) page information, using the VPD page abbreviation.

The multipathd daemon uses this information to gather device specific information. Currently only the hp3par VPD page is supported.

hardware_handler

Specifies the hardware handler to use for a particular device type. All possible values are hardware dependent and include:

emc: Hardware handler for DGC class arrays, as CLARiiON CX/AX and EMC VNX and Unity families.

rdac: Hardware handler for LSI/Engenio/NetApp RDAC class, as NetApp SANtricity E/EF Series, and OEM arrays from IBM DELL SGI STK and SUN.

hp_sw: Hardware handler for HP/COMPAQ/DEC HSG80 and MSA/HSV arrays with Active/Standby mode exclusively.

alua: Hardware handler for Small Computer System Interface-3 (SCSI-3) Asymmetric Logical Unit Access (ALUA) compatible arrays.

ana: Hardware handler for Non-Volatile Memory Express (NVMe) Asymmetric Namespace Access (ANA) compatible arrays.

The default value is unset.

Important

​​Linux kernels, versions 4.3 and newer, automatically attach a device handler to known devices. This includes all devices supporting SCSI-3 ALUA). The kernel does not enable changing the handler later on. Setting the hardware_handler attribute for such devices on these kernels takes no effect.