HP 3PAR Citrix Implementation Guide

Modifying the /etc/multipath-enabled.conf File for Citrix 5.5
The /etc/multipath.conf file is used by device mapper where the multipathing parameters
have been set.
Do not modify /etc/multipath.conf. Citrix links it to either
/etc/multipath-enabled.conf or /etc/multipath-disabled.conf depending on
whether multipathing is enabled or disabled.
The default installed /etc/multipath-enabled.conf file must be edited to make the following
changes:
1. Verify devnode * in blacklist section is commented out or removed:
devnode *
}
2. Edit the devices structure to add entries for HP 3PAR StoreServ Storage array and remove
other product entries that are not needed.
After all of the edits are made, the relevant sections of /etc/multipath-enabled.conf
devices section should appear as follows:
# cat /etc/multipath-enabled.conf
defaults {
polling_interval 5
}
devices {
device {
vendor "3PARdata"
product "VV"
no_path_retry 12
features "0"
hardware_handler "0"
path_grouping_policy multibus
path_selector "round-robin 0"
rr_weight uniform
rr_min_io 100
path_checker tur
failback immediate
}
}
NOTE: The /etc/multipath-enabled.conf file is replaced when installing Citrix
updates to the Citrix. Reapply the multipath-enabled.conf changes to each host after
updates. HP recommends creating a backup copy of the /etc/multipatch-enabled.conf
file before upgrading to any MU on the Citrix.
If SCSI devices such as the internal boot disk need to be excluded from being seen by device
mapper, the devices should be added into in devnode blacklist structure.
Example: The system is booted through an internal SCSI boot disk and has a device instance
sda, which is excluded from being seen by the device mapper by adding the devnode
blacklist structure. The resulting /etc/multipath-enabled.conf file blacklist section
appears as follows:
# cat /etc/multipath-enabled.conf
blacklist {
wwid 26353900f02796769
22 Connecting a Host with Fibre Channel/FCoE