IBM DS4000/DS5000 support of Emulex FC 4Gb/8Gb single and dual port Fibre Channel Host Bus Adapter (FC HBA) for IBM System X, and Emulex LP1100x, LPe1100x, and LPe1200x Fibre Channel Host Bus Adapter device drivers for Linux 2.6 kernel operating system platforms. IMPORTANT: IBM DS4000/DS5000 supports only those device drivers that have meet and passed IBM DS4000/DS5000 test criteria. OEM Linux distribtion developers have been testing OEM Fibre Channel (FC) Host Bus Adapter (HBA) device drivers for the purpose of bundling these device drivers within a specific Linux release build. The terms used to describe these bundled device drivers are "in-distribution", "in-distro", or "in-box" device drivers. IBM DS4000/DS5000 refers to them as "in-distro" device drivers. IBM DS4000/DS5000 has tested the Linux distribution OS platforms and their associated device drivers for the purpose of supporting that Linux distribution build and it's associated in-distro device driver for our IBM DS4000/DS5000 customer. These device drivers differ from those available from the OEM FC HBA vendors website, and may not be supported, unless otherwise specified by IBM DS4000/DS5000 Development. OEM FC HBA device drivers that are available through their websites are referred to as "standard" device drivers. In The Event That An "In-Distro" Device Driver Is Not Available, Or Some Gating Defect Was Found, A "Standard" (aka. non-distro) Device Driver Can And Will Be Tested To Support That Linux Distribution. IBM DS4000/DS5000 Will Indicate Support Of The Standard Device Driver And It Version. Please refer to section 1.0 OS/Device Driver Support for the listed Linux 2.6 kernel OS distributions that IBM DS4000/DS5000 has tested. Refer to the IBM Support Web site or Emulex's IBM OEM Web site, for the latest information and updated readme file. NOTE TO SERVICE – Reference RETAIN # N/A (C) Copyright International Business Machines Corporation 1999, 2005. All rights reserved. US Government Users Restricted Rights - Use, duplication, or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Note: Before using this information and the product it supports, read the general information in section 8.0 "Trademarks and Notices" in this document. Also read the section 5.0 "Limitations" before installing this device driver. Last Update: 05/22/2009 Products tested with this release: ----------------------------------------------------------- | System X Adapter | Emulex Adapter | IBM Option P/N| |-----------------------------------------------------------| |Emulex 4Gb Single port | LP11000 | 42D0405 | |PCIx HBA | | | |-----------------------|-------------------|---------------| |Emulex 4Gb Dual port | LP11002 | 42D0407 | |PCIx HBA | | | |-----------------------|-------------------|---------------| |Emulex 4Gb Single port | LPe11000 | 42C2069 | |PCIe HBA | | | |-----------------------|-------------------|---------------| |Emulex 4Gb-Dual port | LPe11002 | 42C2071 | |PCIe HBA | | | |-----------------------|-------------------|---------------| |Emulex 8Gb-Single port | LPe12000 | 42D0485 | |PCIe HBA | | | |-----------------------|-------------------|---------------| |Emulex 8Gb-Dual port | LPe12002 | 42D0494 | |PCIe HBA | | | ----------------------------------------------------------- -------------------------------------------------------------------- | DS4000/DS5000 | Controller Firmware | DS4000 Storage Manager | | Storage Subsystem | Version Required | Version Required | -------------------------------------------------------------------- | DS4100 | 06.12.56.00 or later| 10.50.xx.19 or later | | DS4200 | 07.50.12.00 or later| 10.50.xx.19 or later | | DS4300 (dual | | | | controller)| 06.60.08.xx or later| 10.50.xx.19 or later | | DS4400 | 06.12.56.00 or later| 10.50.xx.19 or later | | DS4500 | 06.60.08.xx or later| 10.50.xx.19 or later | | DS4700 | 07.50.12.00 or later| 10.50.xx.19 or later | | DS4800 | 07.50.12.00 or later| 10.50.xx.19 or later | | DS5100 | 07.50.12.00 or later| 10.50.xx.19 or later | | DS5300 | 07.50.12.00 or later| 10.50.xx.19 or later | -------------------------------------------------------------------- ======================================================================= Contents -------- 1.0 OS/Device driver Support 2.0 New This Release 3.0 Change History 4.0 Host Adapter configuration 4.1 Update Emulex Adapter BIOS 5.0 Limitations 6.0 Driver file Contents 7.0 WEB Sites and Support Phone Number 8.0 Trademarks and Notices 9.0 Disclaimer ======================================================================= 1.0 OS/Device driver Support -------------- Installation of the Emulex lpfc driver kit is not required with Linux 2.6 OS distributions who IBM DS4000/DS5000 has tested and supports the "in-distro" version of the device driver that OEM Linux vendor included. Conversely, those Linux distributions that IBM DS4000/DS5000 tested and supports the "standard" version of the device driver will require the end user to download and Install the Emulex lpfc driver kit. Table below provides a list of the tested and supported Emulex device drivers for the following Linux 2.6 kernel OS distributions: ---------------------------------------------------------------------------- | Linux OS | Kernel | Standard/In-distro | Device driver | | Platform | version | | Version | ---------------------------------------------------------------------------- | RHEL 4.6 | 2.6.9-67.elsmp | in-distro | 8.0.16.34 | | (x86, IA64 and | UP SMP | | | | x86_64 distros)| | | | |----------------------------------------------------------------------------| | RHEL 4.7 | 2.6.9-78.EL | in-distro | 8.0.16.40 | | (x86, IA64 and | UP SMP | | | | x86_64 distros)| | | | |----------------------------------------------------------------------------| | RHEL 5.2 | 2.6.18-92.el5 | in-distro | 8.2.0.22 | | (x86, IA64 and | UP SMP | | | | x86_64 distros)| | | | |----------------------------------------------------------------------------| | RHEL 5.3 | 2.6.18.128 | in-distro | 8.2.0.33.3p | | (x86, IA64 and | UP SMP | | | | x86_64 distros)| | | | |----------------------------------------------------------------------------| | SLES 9 SP4 | 2.6.5-7.305-smp | in-distro | 8.0.16.34 | | (x86, IA64 and | UP SMP | | | | x86_64 distros)| | | | |----------------------------------------------------------------------------| | SLES 10 SP1 | 2.6.16.46-0.12-smp | standard | 8.1.10.9 | | (x86, IA64 and | UP SMP | | | | x86_64 distros)| | | | |----------------------------------------------------------------------------| | SLES 10 SP2 | 2.6.16.60-0.23-smp | in-distro | 8.2.0.22 | | (x86, IA64 and | UP SMP | | | | x86_64 distros)| | | | ---------------------------------------------------------------------------- IMPORTANT NOTE: Please note which Emulex device drivers are "standard" (aka. "non-distro") or "in-distro". Device drivers that are indicated as "standard" will require the end user to download the appropriate Emulex lpfc device driver kit to install in the associate Linux 2.6 kernel OS distribution. The Emulex lpfc device driver kit is available at the Emulex support web site for IBM customers - http://www.emulex.com/downloads/ibm/drivers.html. Then, select the appropriate link in this web site to get to the device driver web page with the links for the appropriate Emulex lpfc device driver kit and its associated User Manuals. ======================================================================= 2.0 New this release ---------------------- - Red Hat Enterprise Linux 5.3 support - For further information regarding this device driver go to the following web site http://www.emulex.com/downloads/ibm/drivers.html. ======================================================================= 3.0 Change History ------------------- Please refer to change history file emulex_ibm_dd_ds4kds5khba_linux2.6_32-64.chg ======================================================================= 4.0 Host Adapter configuration ------------------------------ 4.1 Update Emulex 4Gb/8Gb single and dual port PCIx/PCIe Fibre Channel Host Bus Adapter for IBM System x firmware. --------------------------------------------------------------------- It is recommended, but not required, that the Emulex Fibre Channel Host Bus Adapter firmware should be at the level IBM DS4000/DS5000 tested with this release. Currently, the latest IBM DS4000/DS5000 supported firmware tested for this release provided below: ----------------------------------------------------------- | System X Adapter | Emulex Adapter | Firmware level| |-----------------------------------------------------------| |Emulex 4Gb Single port | LP11000 | 2.80a4 | |PCIx HBA | | | |-----------------------|-------------------|---------------| |Emulex 4Gb Dual port | LP11002 | 2.80a4 | |PCIx HBA | | | |-----------------------|-------------------|---------------| |Emulex 4Gb Single port | LPe11000 | 2.80a4 | |PCIe HBA | | | |-----------------------|-------------------|---------------| |Emulex 4Gb-Dual port | LPe11002 | 2.80a4 | |PCIe HBA | | | |-----------------------|-------------------|---------------| |Emulex 8Gb-Single port | LPe12000 | 1.00a12 | |PCIe HBA | | | |-----------------------|-------------------|---------------| |Emulex 8Gb-Dual port | LPe12002 | 1.00a12 | |PCIe HBA | | | ----------------------------------------------------------- Tested BIOS and firmware for the above list Emulex HBAs is available at the following URL: http://www.emulex.com/downloads/ibm/fw-and-bootcode.html Please refer to readme file in the BIOS package of your Fibre Channel HBA for the information on how to update the BIOS of your Fibre Channel HBA. Emulex makes available the HBAnywhere Emulex HBA management software which you will use to update the HBA's BIOS and firmware. HBAnywhere utility can be down loaded from the Emulex website and is part of the Application Utility package that can downloaded from the each device driver webpage. IBM DS4000/DS5000 supported Emulex device drivers are available through the following URL: http://www.emulex.com/downloads/ibm/drivers.html 4.2 Installation and Configuration --------------------------------------------------------------------- Please refer to the User manual web links that are in the Emulex Linux device driver web page for information on installation and configuration. To get to this page, go to the IBM Matrices for supported DS4000/DS5000 Emulex device drivers information web page at the following URL - http://www.emulex.com/downloads/ibm/drivers.html. Then, select the appropriate link in this web site to get to the device driver web page with the links for the User Manuals, the Anywhere utility and the Emulex lpfc device driver (if this is a "standard"/"non-distro" version of the device driver.) ======================================================================= 5.0 Limitations --------------------------------------------------------------------- * RHEL 5.2 and (in-distro) device driver 8.2.0.22 - RHEL 5.2 Linux MPP does not find an online path, resulting in IO error in an open SAN environment. In a heterogeneous fabric with open SAN that includes a RHEL 5.2 host with Emulex HBAs, when rebooting the primary controller, the host never logged back into it after it came back online. When the alternate controller rebooted afterwards, the host lost connection to both paths resulting in an IO error. Issue appears in an open SAN configuration where different OS types like Linux, Solaris and Windows are in the same zone. It is IBM DS4000/DS5000 recommends, and is best practice, that IBM DS4000/DS5000 end customer use a single initiator to single target zone for each HBA port to a controller host port connection. This is the best zoning methodology as a rule. It also mitigates the types of problems that can occur in a Open SAN environment. IBM DS4000/DS5000 customer who already observe IBM zoning best practices recommendation will be unaffected by this limitation since you are already using the required mitigation method. Other IBM DS4000/DS5000 customers using RHEL5.2 and using the in- distro device driver 8.2.0.22 will be required to implement our IBM DS4000/DS5000 zoning best practices for access of their RHEL5.2 host to avoid encountering this problem. ======================================================================= 6.0 Driver file Contents ------------------------ n/a ======================================================================= 7.0 WEB Sites and Support Phone Number ---------------------------------------- 7.1 IBM System Storage™ Disk Storage Systems Technical Support web site: http://www.ibm.com/servers/storage/support/disk/ 7.2 IBM System Storage™ Marketing Web Site: http://www.ibm.com/servers/storage/disk 7.3 Emulex Device Driver Matrix for Supported IBM Products: http://www.emulex.com/ibm/support/index.jsp 7.4 You can receive hardware service through IBM Services or through your IBM reseller, if your reseller is authorized by IBM to provide warranty service. See http://www.ibm.com/planetwide/ for support telephone numbers, or in the U.S. and Canada, call 1-800-IBM-SERV (1- 800-426-7378). ======================================================================= 8.0 Trademarks and Notices -------------------------- The following terms are trademarks of the IBM Corporation in the United States or other countries or both: IBM System Storage the e-business logo xSeries, pSeries HelpCenter UNIX is a registered of The Open Group in the United States and other countries. Microsoft, Windows, and Windows NT are of Microsoft Corporation in the United States, other countries, or both. Linux is a trademark of Linus Torvalds in the United States, other countries, or both. Java and all Java-based trademarks and logos are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. Emulex and HBAnyware are trademarks of Emulex Corporation. Other company, product, or service names may be trademarks or service marks of others. ======================================================================= 9.0 Disclaimer -------------- 9.1 THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS. 9.2 Note to U.S. Government Users -- Documentation related to restricted rights -- Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corporation.