Who Should Install This Driver Disk?
Customers running Citrix XenServer 6.0 with CTX131745 – Hotfix XS60E003 - For XenServer 6.0 on a server with Emulex Fibre Channel (FC) Host Bus Adapters (HBA), Fibre Channel over Ethernet (FCoE) Converged Network Adapters (CNA), and Ethernet Network Adapters, and wish to upgrade to the latest supported version of the this driver (lpfc v8.3.5.86, be2net v4.2.389.0, ocm v6.1.34.2).
Note: If your Emulex card has been branded by your OEM, please ensure that you consult them regarding the currently supported firmware version.
If you are using an Emulex branded card, you must ensure that you obtain the firmware version listed below which corresponds to the chipset type of your device. Customers can obtain the firmware directly from Emulex: http://www.emulex.com/downloads/emulex.html.
| Chipset | Firmware Version |
|---|---|
| Saturn | 2.01a4 |
| BE | 4.2.401.6 |
| Lancer | 1.1.21.6 |
Issues Resolved in this Driver Disk
Hotfix XS60E003 updated the XenServer 6.0 dom0 kernel version to 2.6.32.12-0.7.1.xs6.0.0.531.170662.i686.
This driver is re-issued for compatibility with this new kernel version. The functionality of this driver has not been modified since its first release with XenServer 6.0. Refer to CTX136362 – Driver Disk for Emulex be2net 4.2.389.0 & lpfc 8.3.5.86 - For XenServer 6.0 for details.
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.
The file with filename ending metadata.md5 contains 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 emulex.iso. 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
- 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.
- Use XenCenter to access the XenServer host's console, or log in directly using SSH.
- Mount the driver disk image. The directory being mounted varies depending on whether the driver disk is still in ISO form, or was burnt to CD. For a CD-ROM, use:
mkdir -p /mnt/tmp
If instead, the ISO file is used, the steps are:
mount /dev/<path to cd-rom>/mnt/tmp
cd /mnt/tmp/
./install.sh
cd /
umount /mnt/tmp
mkdir -p /mnt/tmp
mount /tmp/<path to ISO>/mnt/tmp -o loop,ro
cd /mnt/tmp/
./install.sh
cd /
umount /mnt/tmp - To complete the installation, restart the host. This ensures that the driver loads correctly.
Files
Driver Disk Files
| File Name | MD5 Checksum |
|---|---|
| emulex.iso | 8651a45281d4f47faa2b6d3f5f7b0da9 |
| Metadata | 992dae344792e6e5236ed0cab97b65cb |
Drivers Provided
| Module/File Name | Version | RPM Name |
|---|---|---|
| be2net (Xen kernel) | 4.2.389 | be2net-modules-xen-2.6.32.12-0.7.1.xs6.0.0.531.170662-4.2.389.0-1.i386.rpm |
| be2net (Kdump kernel) | 4.2.389 | be2net-modules-xen-2.6.32.12-0.7.1.xs6.0.0.531.170662-4.2.389.0-1.i386.rpm |
| elxocmcore | 6.1.34.2 | elxocmcore-6.1.34.2-1.i386.rpm |
| elxocmlibhbaapi | 6.1.34.2 | elxocmlibhbaapi-6.1.34.2-1.i386.rpm |
| lpfc (Xen kernel) | 8.3.5.86 | lpfc-modules-xen-2.6.32.12-0.7.1.xs6.0.0.531.170662-8.3.5.86-1.i386.rpm |
| lpfc (Kdump kernel) | 8.3.5.86 | lpfc-modules-kdump-2.6.32.12-0.7.1.xs6.0.0.531.170662-8.3.5.86-1.i386.rpm |
| rubah-libemsdm | 10.0-1 | rubah-libemsdm-10.0-1.i386.rpm |
More Information
For information on how to build driver disks, refer to CTX130425 – XenServer 6.0 Supplemental Pack & DDK Guide .