Who Should Install This Driver Disk?

Customers running Citrix XenServer 5.6 with HotFix XS56E002 installed and who wish to update the QLogic qla2xxx from the version shipped with XenServer (qla2xxx version 8.02.01.05.5.6), to the latest supported version (qla2xxx version 8.03.01.11.5.6). This driver disk fixes an issue in a previous driver disk that caused a crash during scans for LUNs when using iSCSI HBAs. Customers who previously installed the old driver disk should also install the driver disk attached to this article.

Issues Resolved In This Driver Disk

• Failure to scan for LUNs when using iSCSI HBAs in some cases.

Installing the Driver Disk

Customers should use the XenServer CLI to install this driver disk. Once the driver has been installed, the server must be restarted, in order for the driver to be loaded. As with any software update, Citrix advises customers to back up their data before applying this driver disk.

Please note that the attachment to this article is a zip file. It contains both the drive disk ISO mentioned below, and the source code for the driver. The zip file should be unzipped (to produce the driver disk ISO image), before carrying out the steps below. The source code file is not necessary for driver disk installation: it is provided to fulfill licensing obligations.

Also present in the zip file are two MD5 checksums.

The checksumn named vxge.metadata.md5 is the checksum of the driver disk's metadata. If, when you install the driver disk, you elect to verify the driver disk when prompted, you should check that the checksum presented by the installer is the same as that in the metadata MD5 checksum file included in this download.

Also present in the zip file is an MD5 checksum for the ISO image named qla2xxx.iso.md5. This will allow you to verify that your download has been successful. This checksum is of the ISO only, and can be verified by following the instructions at CTX116166: How to verify downloaded ISO images.

Installing onto a Running XenServer System

1. Download the driver disk directly to the XenServer host to be updated (Citrix recommends storing it in the /tmp/ directory), or first download the file to an Internet-connected computer, and burn the ISO image to a CD.
2. Use XenCenter to access the XenServer host's console, or use secure shell (ssh) to login directly.
3. Mount the driver disk image. Depending on whether the driver disk is still in ISO form, or has been burnt to CD, the directory to be mounted will vary. For a CD-ROM, use:
   

   mkdir -p /mnt/tmp
   mount /dev/<path to cd-rom> /mnt/tmp
   cd /mnt/tmp/
   ./install.sh
   cd /
   umount /mnt/tmp

   If instead the ISO file is used, the steps are:
   

   mkdir -p /mnt/tmp
   mount /tmp/<path to ISO> /mnt/tmp -o loop,ro
   cd /mnt/tmp/
   ./install.sh
   cd /
   umount /mnt/tmp

4. Restart the host to complete the installation. This ensures that the driver will be loaded correctly.

Files

Driver Disk Files

File Name	File MD5 Checksum
qla2xxx.iso	ad13f4a8e2b1df738639ee325dd32c64
Metadata	7c542fea85b397521abbe5c5258ae543

Drivers Updated

Module Name	Version	RPM Name
qla2xxx (Xen kernel)	8.03.01.11.5.6	qla2xxx-modules-xen-2.6.27.42-0.1.1.xs5.6.0.50.111162-8.03.01.11.5.6.k4-1.i386.rpm
qla2xxx (Kdump kernel)	8.03.01.11.5.6	qla2xxx-modules-kdump-2.6.27.42-0.1.1.xs5.6.0.50.111162-8.03.01.11.5.6.k4-1.i386.rpm

More Information

For information on how to build driver disks, consult the XenServer Supplemental Packs & the DDK guide.