Sample Configuration for Citrix XenServer
All versions of Citrix XenServer use a DM-Multipath configuration file, but there might be slight variations in the file based on which Citrix update you have installed. You can replace your current file with sample file and change the values to the ones that are appropriate for your system.
Citrix XenServer, SAN boot LUNs, and user_friendly_names parameter
You can use the sample Citrix XenServer configuration files shown here to create your own multipath.conf file.
When you create your file, keep the following in mind:
Citrix XenServer 6 series | Parameter notes |
---|---|
Blacklist section | You must provide information of 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 /sbin/scsi_id -g -u -s /block/%n command on the SCSI drive to be blacklisted. |
SAN boot support | SAN booting is supported only with Citrix XenServer 6 series and the FC/FCoE protocol. |
SAN boot LUNs and the user_friendly_names parameter | NetApp recommends that you set the user_friendly_names parameter to no. There have been reports of problems when this parameter is set to yes. |
The recommended value for the user_friendly_names parameter is no. There have been reports of problems when this parameter is set to yes.
If you create a SAN boot LUN and the installer sets the user_friendly_names parameter to yes, you must perform the following steps.
Change the user_friendly_names parameter to no.
Make a backup of initrd-p_w_picpath.
Place the above multipath.conf file in the /etc directory.
Run the following command:
service multipathd reload
multipath -v3.
Note: multipath -llshould reflect the changes on the SAN Boot LUN as per the changed multipath.conf file.
Re-create the initrd-p_w_picpath using the command mkinitrd.
You could use the following command line:
mkinitrd -f /boot/initrd-"`uname -r`".img `uname -r`
Reboot the host.
Note: Currently SAN Boot LUN does not reflect queue_if_no_path feature. To overcome this limitation, perform the step mentioned below:
Run multipath command after boot.
Note: To avoid running multipath command on every boot, add /sbin/multipath to /etc/rc.d/rc.local file.
Running multipath forces the unused LUNs (on which there is no Storage Repository) to get added to the XAPI Layer.
To remove the scsi_device ID of those unused LUNs from mpathutil use the following command: # /opt/xensource/sm/mpathutil.py remove <scsi_device-id>.
Skip this step if you have no unused LUNs (where no SR is created).