3.1. Setting Up DM-Multipath

3.1. Setting Up DM-Multipath

Before setting up DM-Multipath on your system, ensure that your system has been updated and includes the device-mapper-multipath package.

Use the following procedure to set up DM-Multipath for a basic failover configuration.

  1. Edit the /etc/multipath.conf file by commenting out the following lines at the top of the file. This section of the configuration file, in its initial state, blacklists all devices. You must comment it out to enable multipathing.

    blacklist {
            devnode "*"
    }
    

    After commenting out those lines, this section appears as follows.

    # blacklist {
    #        devnode "*"
    # }
    
  2. The default settings for DM-Multipath are compiled in to the system and do not need to be explicitly set in the /etc/multipath.conf file.

    The default value of path_grouping_policy is set to failover, so in this example you do not need to change the default value. For information on changing the values in the configuration file to something other than the defaults, see Chapter 4, The DM-Multipath Configuration File.

    The initial defaults section of the configuration file configures your system that the names of the multipath devices are are of the form mpathn; without this setting, the names of the multipath devices would be aliased to the WWID of the device.

  3. Save the configuration file and exit the editor.

  4. Execute the following commands:

    modprobe dm-multipath
    service multipathd start
    multipath -v2
    

    The multipath -v2 command prints out multipathed paths that show which devices are multipathed. If the command does not print anything out, ensure that all SAN connections are set up properly and the system is multipathed.

    For further information on the multipath command output, see Section 5.1, “Multipath Command Output”.

  5. Execute the following command to ensure sure that the multipath daemon starts on bootup:

    chkconfig multipathd on
    

Since the value of user_friendly_name is set to yes in the configuration filea the multipath devices will be created as /dev/mapper/mpathn. For information on setting the name of the device to an alias of your choosing, see Chapter 4, The DM-Multipath Configuration File.


Note: This documentation is provided {and copyrighted} by Red Hat®, Inc. and is released via the Open Publication License. The copyright holder has added the further requirement that Distribution of substantively modified versions of this document is prohibited without the explicit permission of the copyright holder. The CentOS project redistributes these original works (in their unmodified form) as a reference for CentOS-5 because CentOS-5 is built from publicly available, open source SRPMS. The documentation is unmodified to be compliant with upstream distribution policy. Neither CentOS-5 nor the CentOS Project are in any way affiliated with or sponsored by Red Hat®, Inc.