All versions of Red Hat Enterprise Virtualization Hypervisor (RHEV) use a DM-Multipath configuration file, but there might be slight variations in the file. You can replace your current file with this sample file and change the values to ones that are appropriate for your system.
You can use the sample Red Hat Enterprise Virtualization Hypervisor configuration files to create your own multipath.conf file. When you create your file, keep the following in mind:
| Red Hat Enterprise Virtualization Hypervisor | Explanation |
|---|---|
| Blacklist section | You must provide information that is specific to your system in the blacklist section. Any names shown in the sample files are examples and will not work with your system. |
| wwid <Dev ID> | Use the actual device ID. Run the /lib/udev/scsi_id -g -u -d /dev/<sd_device> command on the SCSI drive to be blacklisted. |
| Revision and private tags | The first and second lines of the file should be the revision and private tags:# RHEV REVISION # RHEV PRIVATE These tags tell the VDSM not to overwrite the configuration file. If there is no tag, then the configuration file will be overwritten with the defaults after server reboot/update. |
| multipath.conf file and persistence | You must set the multipath.conf file to persist across reboots by entering the following command persist /etc/multipath.conf |
The following file provides an example of the values you need to supply when your host is running Red Hat Enterprise Virtualization Hypervisor 6.2 with ALUA enabled:
Remember: If you use the blacklist section, you must replace the sample information with information for your system.
# RHEV REVISION 0.7
# RHEV PRIVATE
defaults {
user_friendly_names no
max_fds max
flush_on_last_del yes
queue_without_daemon no
dev_loss_tmo infinity
fast_io_fail_tmo 5
}
# All data under blacklist must be specific to your system.
blacklist {
devnode "^hd[a-z]"
wwid "<wwid_of_the_local_disk>"
devnode "^(ram|raw|loop|fd|md|dm-|sr|scd|st)[0-9]*"
devnode "^cciss.*"
}
devices {
device {
vendor "NETAPP"
product "LUN"
path_grouping_policy group_by_prio
features "3 queue_if_no_path pg_init_retries 50"
prio "alua"
path_checker tur
failback immediate
path_selector "round-robin 0"
hardware_handler "1 alua"
rr_weight uniform
rr_min_io 128
getuid_callout "/lib/udev/scsi_id -g -u -d /dev/%n"
}
}
The following file provides an example of the values you need to supply when your host is running Red Hat Enterprise Virtualization Hypervisor 6.2 and does not have ALUA enabled:
Remember: If you use the blacklist section, you must replace the sample information with information for your system.
# RHEV REVISION 0.7
# RHEV PRIVATE
defaults {
user_friendly_names no
max_fds max
flush_on_last_del yes
queue_without_daemon no
dev_loss_tmo infinity
fast_io_fail_tmo 5
}
# All data under blacklist must be specific to your system.
blacklist {
devnode "^hd[a-z]"
wwid <wwid_of_the_local_disk>"
devnode "^(ram|raw|loop|fd|md|dm-|sr|scd|st)[0-9]*"
devnode "^cciss.*"
}
devices {
device {
vendor "NETAPP"
product "LUN"
path_grouping_policy group_by_prio
features "3 queue_if_no_path pg_init_retries 50"
prio "ontap"
path_checker tur
failback immediate
path_selector "round-robin 0"
hardware_handler "0"
rr_weight uniform
rr_min_io 128
getuid_callout "/lib/udev/scsi_id -g -u -d /dev/%n"
}
}
The following file provides an example of the values you need to supply when your host is running Red Hat Enterprise Virtualization Hypervisor 6.3 with ALUA enabled:
Remember: If you use the blacklist section, you must replace the sample information with information for your system.
# RHEV REVISION 0.8
# RHEV PRIVATE
defaults {
user_friendly_names no
max_fds max
flush_on_last_del yes
queue_without_daemon no
dev_loss_tmo infinity
fast_io_fail_tmo 5
}
# All data under blacklist must be specific to your system.
blacklist {
wwid <wwid_of_the_local_disk>
}
devices {
device {
vendor "NETAPP"
product "LUN.*"
prio "alua"
hardware_handler "1 alua"
}
}
The following file provides an example of the values you need to supply when your host is running Red Hat Enterprise Virtualization Hypervisor 6.3 without ALUA enabled:
Remember: If you use the blacklist section, you must replace the sample information with information for your system.
# RHEV REVISION 0.8
# RHEV PRIVATE
defaults {
user_friendly_names no
max_fds max
flush_on_last_del yes
queue_without_daemon no
dev_loss_tmo infinity
fast_io_fail_tmo 5
}
# All data under blacklist must be specific to your system.
blacklist {
wwid <wwid_of_the_local_disk>
}
devices {
device {
vendor "NETAPP"
product "LUN.*"
prio "ontap"
hardware_handler "0"
}
}
In Red Hat Enterprise Virtualization Hypervisor 6.4, dm-multipath can automatically apply ALUA and non-ALUA settings after you run multipath.conf; you must specify rdloaddriver=scsi_dh_alua in the kernel command line as described below.
Remember: If you use the blacklist section, you must replace the sample information with information for your system.
# RHEV REVISION 0.9
# RHEV PRIVATE
# All data under blacklist must be specific to your system.
blacklist {
wwid < wwid_of_the_local_disk>
}
mount -o remount,rw /dev/initramfs/live
kernel /vmlinuz0 root=live:LABEL=Root ro rootfstype=auto
rootflags=ro crashkernel=128M elevator=deadline quiet rd_NO_LVM
max_loop=256 rhgb rd_NO_LUKS rd_NO_MD rd_NO_DM rdloaddriver=scsi_dh_alua
mount –o remount,ro /dev/.initramfs/live
In Red Hat Enterprise Virtualization Hypervisor 6.5, dm-multipath can automatically apply ALUA and non-ALUA settings with the multipath.conf; you must specify rdloaddriver=scsi_dh_alua in the kernel command line as described below.
Remember: If you use the blacklist section, you must replace the sample information with information from your system.
# RHEV REVISION 1.0
# RHEV PRIVATE
# All data under blacklist must be specific to your system.
blacklist {
wwid < wwid_of_the_local_disk>
}
mount -o remount,rw /dev/initramfs/live
nel /vmlinuz0 root=live:LABEL=Root ro rootfstype=auto
rootflags=ro crashkernel=128M elevator=deadline quiet rd_NO_LVM
max_loop=256 rhgb rd_NO_LUKS rd_NO_MD rd_NO_DM rdloaddriver=scsi_dh_alua
mount –o remount,ro /dev/.initramfs/live
