Show Table of Contents
5.3. Moving root File Systems from a Single Path Device to a Multipath Device
If you have installed your system on a single-path device and later add another path to the root file system, you will need to move your root file system to a multipathed device. This section documents the procedure for moving from a single-path to a multipathed device.
After ensuring that you have installed the
device-mapper-multipath package, perform the following procedure:
- Execute the following command to create the
/etc/multipath.confconfiguration file, load the multipath module, and setchkconfigfor themultipathdtoon:#
mpathconf --enableFor further information on using thempathconfcommand to set up multipathing, see Section 3.1, “Setting Up DM-Multipath”. - Edit the
blacklistandblacklist_exceptionssections of the/etc/multipath.conffile, as described in Section 4.2, “Configuration File Blacklist”. - To confirm that your configuration file is set up correctly, you can run the
/sbin/multipathcommand with the-v3option to check whether the multipath daemon tried to create a multipath device over your root device. The command will fail since the root the device is in use, but the output from the command should show the root device in the paths list.You should look in the command output for a line of the following format:WWID H:B:T:L devname MAJOR:MINOR
For example, if your root file system is set up onsdaor one of its partitions, you would see a line in the output such as the following:===== paths list ===== ... 1ATA WDC WD800JD-75MSA3 WD-WMAM9F 1:0:0:0 sda 8:0 ...
Later in the output, you should see the root device assigned to a multipath device:time | devname: ownership set to mpathdev
For example, the output may appear as follows:Jun 14 06:48:21 | sda: ownership set to mpatha
You will also see an indication that the command failed to create the multipath device with a line of the following format:time | mpathdev: domap (0) failure for create/reload map
In the example noted above, you would see the following line in the command output:Jun 14 06:48:21 | mpatha: domap (0) failure for create/reload map
- To rebuild the
initramfsfile system withmultipath, execute thedracutcommand with the following options:#
dracut --force --add multipath --include /etc/multipath /etc/multipath - If your root device is not an LVM volume and it is mounted by device name, you may need to edit the
fstabfile to switch to the appropriate multipath device name. If your root device is an LVM device or is mounted by UUID or something else, this step is not necessary.- Use the procedure described in Step 3 of running the
/sbin/multipathcommand with the-v3to determine the WWID of the root device. - Set up an alias for the root device in the
/etc/multipath.conffile:multipaths { multipath { wwid WWID_of_root_device alias rootdev } } - Edit the
/etc/fstaband replace the old device path to the root device with the multipath device.For example, if you had the following entry in the/etc/fstabfile:/dev/sda1 / ext4 defaults 1 1
You would change the entry to the following:/dev/mapper/rootdev / ext4 defaults 1 1
If you need to edit the/etc/fstabfile, you will also need to edit the/etc/grub.conffile and change the root parameter fromroot=/dev/sda1toroot=/dev/mapper/rootdev.The following example shows what thisgrub.conffile entry would look like before you edit it.title Red Hat Enterprise Linux FoundationServer (2.6.32-71.24.1.el6.x86_64) root (hd0,0) kernel /vmlinuz-2.6.32-71.24.1.el6.x86_64 ro root=/dev/sda1 rd_NO_LUKS rd_NO_MD rd_NO_DM LANG=en_US.UTF-8 SYSFONT=latarcyrheb-sun16 KEYTABLE=us console=ttyS0,115200n8 crashkernel=auto initrd /initramfs-2.6.32-71.24.1.el6.x86_64.imgThe following example shows what thegrub.conffile entry would look like after you edit it.title Red Hat Enterprise Linux FoundationServer (2.6.32-71.24.1.el6.x86_64) root (hd0,0) kernel /vmlinuz-2.6.32-71.24.1.el6.x86_64 ro root=/dev/mapper/rootdev rd_NO_LUKS rd_NO_MD rd_NO_DM LANG=en_US.UTF-8 SYSFONT=latarcyrheb-sun16 KEYTABLE=us console=ttyS0,115200n8 crashkernel=auto initrd /initramfs-2.6.32-71.24.1.el6.x86_64.img - Shut the machine down.
- Configure the FC switch so that other paths are visible to the machine.
- Boot the machine.
- Check whether the root file system ('/') is on the multipathed device.

Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.