Using /etc/multipath.conf File
The first step of configuring HPDM Multipath involves editing the /etc/multipath.conf configuration file, which is distributed as part of the HPDM Multipath tools user space package. This file also enables you to customize HPDM Multipath for a variety of SAN storage subsystems .
The
multipath.conf file provides the following options to configure the attributes of a
multipath device:
- I/O grouping policy
- Polling interval for subsequent path status verification
- Path selector algorithm
- Program used by multipath to obtain a unique path identifier
The HPDM Multipath package comes with a template file with the recommended configuration for HP supported arrays. To use this template file:
For RHEL systems:
- Copy the /usr/share/doc/HPDMmultipath-tools-4.0.0/multipath.conf.HPTemplate file as /etc/multipath.conf
For SLES systems:
- Copy the /usr/share/doc/packages/HPDMmultipath-tools-4.0.0/ multipath.conf.HPTemplate file as /etc/multipath.conf
The
/etc/multipath.conf file consists of the following sections, to configure the attributes of a multipath device:
- System defaults (defaults )
- Black-listed devices (devnode_blacklist/blacklist )
- Storage array model settings (devices )
- Multipath device settings (multipaths )
- Blacklist exceptions (blacklist_exceptions )
The defaults section defines default values for attributes which are used whenever required setting is unavailable. The blacklist section defines which devices should be excluded from the multipath topology discovery. The blacklist_exceptions section defines which devices should be included in the multipath topology discovery, despite being listed in the blacklist section. The multipaths section defines the multipath topologies. They are indexed by a World Wide Identifier (wwid). The devices section defines the device-specific settings based on vendor and product values.
Recommended Values for HP Arrays
The product string of the storage controller contains 16 characters (including spaces) and the vendor string contains 8 characters (including spaces) in the /etc/multipath.conf file. To ease the task of manually editing the devices section of the multipath.conf file, the wild card, regular expression support for the product and vendor string is provided. For example, in /etc/multipath.conf file, the product string for the HSV101 arrays is given the value of HSV101* , instead of HSV101 \(C\)COMPAQ .
Starting HPDM Multipath
Whenever an attribute for the LUNs of any of the HP supported storage arrays changes, the multipathd daemon must be restarted and the configuration must be reloaded by executing the following commands:
# /etc/init.d/multipathd restart
# /sbin/multipath
These steps are required only if the attributes are modified.
To view the status of the multipath devices, complete the following steps:
- Run multipath utility.
- Use the # /sbin/multipath -ll option.
-