Chapter 1. Device Mapper Multipathing

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 mpathconf configuration utility, which can also load the device-mapper-multipath module, start the multipathd daemon, and set chkconfig to 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 the mpathconf command, see the mpathconf(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_multipaths configuration 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 the find_multipaths configuration parameter is set to yes, then multipath will create a device only if one of three conditions are met:

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 the find_multipaths configuration 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-length and service-time. The queue-length algorithm looks at the amount of outstanding I/O to the paths to determine which path to use next. The service-time algorithm 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_callout parameter has been replaced by the prio parameter. For descriptions of the supported prio functions, see Chapter 4, The DM-Multipath Configuration File.

In Red Hat Enterprise Linux 6, the multipath command output has changed format. For information on the multipath command output, see Section 5.7, “Multipath Command Output”.

In the Red Hat Enterprise Linux 6 release, the location of the multipath bindings file is /etc/multipath/bindings.

The Red Hat Enterprise Linux 6 release provides three new defaults parameters in the multipath.conf file: checker_timeout, fast_io_fail_tmo, and dev_loss_tmo. For information on these parameters, see Chapter 4, The DM-Multipath Configuration File.

When the user_friendly_names option in the multipath configuration file is set to yes, the name of a multipath device is of the form mpathn. For the Red Hat Enterprise Linux 6 release, n is an alphabetic character, so that the name of a multipath device might be mpatha or mpathb. In previous releases, n was an integer.

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”.

The Red Hat Enterprise Linux 6.2 release provides a new multipath.conf parameter, rr_min_io_rq, in the defaults, devices, and multipaths sections of the multipath.conf file. The rr_min_io parameter no longer has an effect in Red Hat Enterprise Linux 6.2. For information on the rr_min_io_rq parameter, see Chapter 4, The DM-Multipath Configuration File.

The dev_loss_tmo configuration file parameter can now be set to infinity, which sets the actual sysfs variable 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.

The default value of the queue_without_daemon configuration file parameter is now set to no by default.

The default value of the max_fds configuration file parameter is now set to max by default.

The user_friendly_names configuration file parameter is now configurable in the defaults, multipaths, and devices sections of the multipath.conf configuration file.

The defaults section of the multipath.conf configuration file supports a new hwtable_regex_match parameter.

The defaults section and the devices section of the multipath.conf configuration file support a new retain_attached_hardware_handler parameter and a new detect_prio parameter. 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”.

The defaults section of the multipath.conf configuration file supports a new replace_wwid_whitespace and a new reload_readwrite parameter. The defaults section of the multipath.conf file is documented in Table 4.1, “Multipath Configuration Defaults”.

The defaults section of the multipath.conf configuration file supports a new force_sync parameter. The defaults section of the multipath.conf file is documented in Table 4.1, “Multipath Configuration Defaults”.

The multipath supports a -w and a -W, as described in Table 4.1, “Multipath Configuration Defaults”.

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 defaults section of the multipath.conf configuration file supports a new config_dir parameter. The defaults section of the multipath.conf file is documented in Table 4.1, “Multipath Configuration Defaults”.

The defaults, devices, and multipaths sections of the multipath.conf configuration file now support the delay_watch_checks and delay_wait_checks configuration parameters. For information on the configuration parameters, see Chapter 4, The DM-Multipath Configuration File.

The prio configuration parameter now supports the prio "alua exclusive_pref_bit" setting, which will cause multipath to create a path group that contains only the path with the pref bit 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 multipathd command supports new format commands that show the status of multipath devices and paths in "raw" format versions. For information on the multipathd command, see Section 5.12, “The multipathd Interactive Console and the multipathd Command”.

The defaults, devices, and multipaths sections of the multipath.conf configuration file now support the skip_kpartx and max_sectors_kb configuration parameters. For information on the configuration parameters, see Chapter 4, The DM-Multipath Configuration File.