Thursday, February 16, 2012

Public Hotfixes: Driver Disk for Emulex Be2net 4.0.359.0 and Lpfc 8.3.5.44.4p - For XenServer 6.0 with HotFix XS60E003 #citrix

Public Hotfixes: Driver Disk for Emulex Be2net 4.0.359.0 and Lpfc 8.3.5.44.4p - For XenServer 6.0 with HotFix XS60E003: Driver Disk for Emulex b2net 4.0.359.0 and Lpfc 8.3.5.44.4p for XenServer 6.0 with Hotfix XS60E003. Requires the 4.0.493.0 Emulex firmware version.

Driver Disk for Emulex Be2net 4.0.359.0 and Lpfc 8.3.5.44.4p - For XenServer 6.0 with HotFix XS60E003

Document ID: CTX132254 / Created On: Feb 15, 2012 / Updated On: Feb 15, 2012
Average Rating: not yet rated

Who Should Install This Driver Disk?

Customers running Citrix XenServer 6.0 with Hotfix XS60E003 - For XenServer 6.0 who wish to use Emulex OneCommand to manage their 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 versions of the related drivers.

Issues Resolved In This Driver Disk

This provides an Emulex built Driver Disk that includes versions of lpfc, be2net, and OneCommand Manager Corekit. The versions for these components are:

  • lpfc: 8.3.5.44.4p
  • be2net: 4.0.359.0
  • OneComand: 5.2.12.2-1

Users must ensure that they are running the 4.0.493.0 Emulex firmware version for your CNA to be supported by Citrix. The firmware is available from http://www.emulex.com/downloads/emulex/linux/xenserver-60/drivers.html

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 disk is re-issued for compatibility with this new kernel version.

The functionality of the drivers has not been modified since its first release with XenServer 6.0. Refer to CTX132253 - Driver Disk for Emulex Be2net 4.0.359.0 and Lpfc 8.3.5.44.4p - 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.

Also present in the zip file is an MD5 checksum. This will allow you to verify that your download has been successful. The 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 log on directly.
  3. 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
    mount /dev/ /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/ /mnt/tmp -o loop,ro
    cd /mnt/tmp/
    ./install.sh
    cd /
    umount /mnt/tmp
  4. To complete the installation, restart the host. This ensures that the driver loads correctly.

Vendor Notes: Unable to make permanent LPFC driver parameter changes with OneCommand Manager

Due to a bug, the One Command Manager (OCM) component included in this updated Driver Disk causes a failure when persistent commands are issued. Therefore customers will not be able to make permanent changes in the LPFC driver's parameters using the OCM CLI. Instead, customers should set the LFPC driver parameter to "T" (not persist on system reboot). See the example below:

hbacmd SetDriverParam T

The LPFC driver parameter change will need to be re-issued on any subsequent system reboots, .

Files

Driver Disk Files

File NameFile MD5 Checksum
emulex.iso84a674477aae69ec116639fee33b54c0

Drivers Updated

Module NameVersionRPM Name
be2net-modules-xen (Xen kernel)4.0.359be2net-modules-xen-2.6.32.12-0.7.1.xs6.0.0.531.170662-4.0.359.0-1.i386.rpm
be2net-modules-kdump (Kdump kernel)4.0.359be2net-modules-kdump-2.6.32.12-0.7.1.xs6.0.0.531.170662-4.0.359.0-1.i386.rpm
elxocmcore5.2.12.2-1elxocmcore-5.2.12.2-1.i386.rpm
elxocmlibhbaapi5.2.12.2-1elxocmlibhbaapi-5.2.12.2-1.i386.rpm
lpfc-modules-xen (Xen kernel)8.3.5.44lpfc-modules-xen-2.6.32.12-0.7.1.xs6.0.0.531.170662-8.3.5.44.4p-1.i386.rpm
lpfc-modules-modules-kdump (Kdump kernel)8.3.5.44lpfc-modules-kdump-2.6.32.12-0.7.1.xs6.0.0.531.170662-8.3.5.44.4p-1.i386.rpm


More Information

For information on Hotfix XS60E003, refer to CTX131745 - Hotfix XS60E003 - For XenServer 6.0.

For information on how to build driver disks, refer to CTX130425 - XenServer 6.0 Supplemental Pack & DDK Guide.


This document applies to:

No comments:

Post a Comment