Chapter 1. Device Mapper Multipathing
Device mapper multipathing (DM-Multipath) allows you to configure multiple I/O paths between server nodes and storage arrays into a single device. These I/O paths are physical SAN connections that can include separate cables, switches, and controllers. Multipathing aggregates the I/O paths, creating a new device that consists of the aggregated paths.
This chapter provides a summary of the features of DM-Multipath that are new for the initial release of Red Hat Enterprise Linux 6. Following that, this chapter provides a high-level overview of DM Multipath and its components, as well as an overview of DM-Multipath setup.
1.1. New and Changed Features Copy linkLink copied to clipboard!
Copy linkLink copied to clipboard!
This section lists new and changed features of DM-Multipath that are included with the initial and subsequent releases of Red Hat Enterprise Linux 6.
1.1.1. New and Changed Features for Red Hat Enterprise Linux 6.0 Copy linkLink copied to clipboard!
Copy linkLink copied to clipboard!
Red Hat Enterprise Linux 6.0 includes the following documentation and feature updates and changes.
- For the Red Hat Enterprise Linux 6 release, the initial DM-Multipath setup procedure for a basic failover configuration has changed. You can now create the DM-Multipath configuration file and enable DM-Multipath with the
mpathconfconfiguration utility, which can also load thedevice-mapper-multipathmodule, start themultipathddaemon, and setchkconfigto start the daemon automatically on reboot.For information on the new setup procedure, see Section 3.1, “Setting Up DM-Multipath”. For more information on thempathconfcommand, see thempathconf(5) man page. - The Red Hat Enterprise Linux 6 release provides a new mode for setting up multipath devices, which you set with the
find_multipathsconfiguration file parameter. In previous releases of Red Hat Enterprise Linux, multipath always tried to create a multipath device for every path that was not explicitly blacklisted. In Red Hat Enterprise Linux 6, however, if thefind_multipathsconfiguration parameter is set toyes, then multipath will create a device only if one of three conditions are met:- There are at least two non-blacklisted paths with the same WWID.
- The user manually forces the device creation, by specifying a device with the
multipathcommand. - A path has the same WWID as a multipath device that was previously created (even if that multipath device does not currently exist). For instructions on the procedure to follow if you have previously created multipath devices when the
find_multipathsparameter was not set, see Section 4.2, “Configuration File Blacklist”.
This feature should allow most users to have multipath automatically choose the correct paths to make into multipath devices, without having to edit the blacklist.For information on thefind_multipathsconfiguration parameter, see Section 4.3, “Configuration File Defaults”. - The Red Hat Enterprise Linux 6 release provides two new path selector algorithms which determine which path to use for the next I/O operation:
queue-lengthandservice-time. Thequeue-lengthalgorithm looks at the amount of outstanding I/O to the paths to determine which path to use next. Theservice-timealgorithm looks at the amount of outstanding I/O and the relative throughput of the paths to determine which path to use next. For more information on the path selector parameters in the configuration file, see Chapter 4, The DM-Multipath Configuration File. - In the Red Hat Enterprise Linux 6 release, priority functions are no longer callout programs. Instead they are dynamic shared objects like the path checker functions. The
prio_calloutparameter has been replaced by theprioparameter. For descriptions of the supportedpriofunctions, see Chapter 4, The DM-Multipath Configuration File. - In Red Hat Enterprise Linux 6, the
multipathcommand output has changed format. For information on themultipathcommand output, see Section 5.7, “Multipath Command Output”. - In the Red Hat Enterprise Linux 6 release, the location of the multipath
bindingsfile is/etc/multipath/bindings. - The Red Hat Enterprise Linux 6 release provides three new
defaultsparameters in themultipath.conffile:checker_timeout,fast_io_fail_tmo, anddev_loss_tmo. For information on these parameters, see Chapter 4, The DM-Multipath Configuration File. - When the
user_friendly_namesoption in the multipath configuration file is set toyes, the name of a multipath device is of the formmpathn. For the Red Hat Enterprise Linux 6 release, n is an alphabetic character, so that the name of a multipath device might bempathaormpathb. In previous releases, n was an integer.
1.1.2. New and Changed Features for Red Hat Enterprise Linux 6.1 Copy linkLink copied to clipboard!
Copy linkLink copied to clipboard!
Red Hat Enterprise Linux 6.1 includes the following documentation and feature updates and changes.
- This document now contains a new chapter, Section 5.3, “Moving root File Systems from a Single Path Device to a Multipath Device”.
- This document now contains a new chapter, Section 5.4, “Moving swap File Systems from a Single Path Device to a Multipath Device”.
1.1.3. New and Changed Features for Red Hat Enterprise Linux 6.2 Copy linkLink copied to clipboard!
Copy linkLink copied to clipboard!
Red Hat Enterprise Linux 6.2 includes the following documentation and feature updates and changes.
- The Red Hat Enterprise Linux 6.2 release provides a new
multipath.confparameter,rr_min_io_rq, in thedefaults,devices, andmultipathssections of themultipath.conffile. Therr_min_ioparameter no longer has an effect in Red Hat Enterprise Linux 6.2. For information on therr_min_io_rqparameter, see Chapter 4, The DM-Multipath Configuration File. - The
dev_loss_tmoconfiguration file parameter can now be set to infinity, which sets the actualsysfsvariable to 2147483647 seconds, or 68 years. For information on this parameter, see Chapter 4, The DM-Multipath Configuration File. - The procedure described in Section 5.3, “Moving root File Systems from a Single Path Device to a Multipath Device” has been updated.
1.1.4. New and Changed Features for Red Hat Enterprise Linux 6.3 Copy linkLink copied to clipboard!
Copy linkLink copied to clipboard!
Red Hat Enterprise Linux 6.3 includes the following documentation and feature updates and changes.
- The default value of the
queue_without_daemonconfiguration file parameter is now set tonoby default. - The default value of the
max_fdsconfiguration file parameter is now set tomaxby default. - The
user_friendly_namesconfiguration file parameter is now configurable in thedefaults,multipaths, anddevicessections of themultipath.confconfiguration file. - The
defaultssection of themultipath.confconfiguration file supports a newhwtable_regex_matchparameter.
For information on the configuration file parameters, see Chapter 4, The DM-Multipath Configuration File.
1.1.5. New and Changed Features for Red Hat Enterprise Linux 6.4 Copy linkLink copied to clipboard!
Copy linkLink copied to clipboard!
Red Hat Enterprise Linux 6.4 includes the following documentation and feature updates and changes.
- The
defaultssection and thedevicessection of themultipath.confconfiguration file support a newretain_attached_hardware_handlerparameter and a newdetect_prioparameter. For information on the configuration file parameters, see Chapter 4, The DM-Multipath Configuration File. - This document contains a new section, Section 3.4, “Setting Up Multipathing in the initramfs File System”.
1.1.6. New and Changed Features for Red Hat Enterprise Linux 6.5 Copy linkLink copied to clipboard!
Copy linkLink copied to clipboard!
Red Hat Enterprise Linux 6.5 includes the following documentation and feature updates and changes.
- The
defaultssection of themultipath.confconfiguration file supports a newreplace_wwid_whitespaceand a newreload_readwriteparameter. Thedefaultssection of themultipath.conffile is documented in Table 4.1, “Multipath Configuration Defaults”.
1.1.7. New and Changed Features for Red Hat Enterprise Linux 6.6 Copy linkLink copied to clipboard!
Copy linkLink copied to clipboard!
Red Hat Enterprise Linux 6.6 includes the following documentation and feature updates and changes.
- The
defaultssection of themultipath.confconfiguration file supports a newforce_syncparameter. Thedefaultssection of themultipath.conffile is documented in Table 4.1, “Multipath Configuration Defaults”. - The
multipathsupports a-wand a-W, as described in Table 4.1, “Multipath Configuration Defaults”.
1.1.8. New and Changed Features for Red Hat Enterprise Linux 6.7 Copy linkLink copied to clipboard!
Copy linkLink copied to clipboard!
Red Hat Enterprise Linux 6.7 includes the following documentation and feature updates and changes.
- This document includes a new section, Section 5.1, “Automatic Configuration File Generation with Multipath Helper”. The Multipath Helper application gives you options to create multipath configurations with custom aliases, device blacklists, and settings for the characteristics of individual multipath devices.
- The
defaultssection of themultipath.confconfiguration file supports a newconfig_dirparameter. Thedefaultssection of themultipath.conffile is documented in Table 4.1, “Multipath Configuration Defaults”. - The
defaults,devices, andmultipathssections of themultipath.confconfiguration file now support thedelay_watch_checksanddelay_wait_checksconfiguration parameters. For information on the configuration parameters, see Chapter 4, The DM-Multipath Configuration File.
1.1.9. New and Changed Features for Red Hat Enterprise Linux 6.8 Copy linkLink copied to clipboard!
Copy linkLink copied to clipboard!
Red Hat Enterprise Linux 6.8 includes the following documentation and feature updates and changes.
- The
prioconfiguration parameter now supports theprio "alua exclusive_pref_bit"setting, which will cause multipath to create a path group that contains only the path with theprefbit set and will give that path group the highest priority. For information on the configuration parameters, see Chapter 4, The DM-Multipath Configuration File. - As of Red Hat Enterprise Linux release 6.8, the
multipathdcommand supports new format commands that show the status of multipath devices and paths in "raw" format versions. For information on themultipathdcommand, see Section 5.12, “The multipathd Interactive Console and the multipathd Command”.
1.1.10. New and Changed Features for Red Hat Enterprise Linux 6.9 Copy linkLink copied to clipboard!
Copy linkLink copied to clipboard!
Red Hat Enterprise Linux 6.9 includes the following documentation and feature updates and changes.
- The
defaults,devices, andmultipathssections of themultipath.confconfiguration file now support theskip_kpartxandmax_sectors_kbconfiguration parameters. For information on the configuration parameters, see Chapter 4, The DM-Multipath Configuration File.