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.conf
configuration file, load the multipath module, and setchkconfig
for themultipathd
toon
:#
mpathconf --enable
For further information on using thempathconf
command to set up multipathing, see Section 3.1, “Setting Up DM-Multipath”. - Edit the
blacklist
andblacklist_exceptions
sections of the/etc/multipath.conf
file, as described in Section 4.2, “Configuration File Blacklist”. - To confirm that your configuration file is set up correctly, you can run the
/sbin/multipath
command with the-v3
option 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 onsda
or 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
initramfs
file system withmultipath
, execute thedracut
command 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
fstab
file 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/multipath
command with the-v3
to determine the WWID of the root device. - Set up an alias for the root device in the
/etc/multipath.conf
file:multipaths { multipath { wwid WWID_of_root_device alias rootdev } }
- Edit the
/etc/fstab
and replace the old device path to the root device with the multipath device.For example, if you had the following entry in the/etc/fstab
file:/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/fstab
file, you will also need to edit the/etc/grub.conf
file and change the root parameter fromroot=/dev/sda1
toroot=/dev/mapper/rootdev
.The following example shows what thisgrub.conf
file 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.img
The following example shows what thegrub.conf
file 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.