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 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 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 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 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: 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 multipath command. 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_multipaths parameter 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 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 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 . 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 . 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 mpath n . 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 releases, n was an integer. 1.1.2. New and Changed Features for Red Hat Enterprise Linux 6.1 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 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.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. 1.1.4. New and Changed Features for Red Hat Enterprise Linux 6.3 Red Hat Enterprise Linux 6.3 includes the following documentation and feature updates and changes. 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. 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 Red Hat Enterprise Linux 6.4 includes the following documentation and feature updates and changes. 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" . 1.1.6. New and Changed Features for Red Hat Enterprise Linux 6.5 Red Hat Enterprise Linux 6.5 includes the following documentation and feature updates and changes. 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" . 1.1.7. New and Changed Features for Red Hat Enterprise Linux 6.6 Red Hat Enterprise Linux 6.6 includes the following documentation and feature updates and changes. 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" . 1.1.8. New and Changed Features for Red Hat Enterprise Linux 6.7 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 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 . 1.1.9. New and Changed Features for Red Hat Enterprise Linux 6.8 Red Hat Enterprise Linux 6.8 includes the following documentation and feature updates and changes. 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" . 1.1.10. New and Changed Features for Red Hat Enterprise Linux 6.9 Red Hat Enterprise Linux 6.9 includes the following documentation and feature updates and changes. 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 .

Commands: