Emulex Fibre Channel Expansion Card for IBM eServer BladeCenter Linux Device Driver for 2.6 version kernels (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 "Notices and trademarks" in this document. Driver Installation Notes ---------------------------------------------------------------------- 1. System Requirements 2. Driver Installation 3. Driver Uninstallation 4. Notes 5. Web Sites 6. Notices 7. Disclaimer ---------------------------------------------------------------------- 1. System Requirements The Emulex LPFC driver and LPFC DFC driver RPMs require gcc compiler tools and the kernel sources for the running kernel be installed on the system in order for the RPM installation to succeed. The following distributions of Linux are supported by the Emulex drivers: Red Hat Enterprise Linux 4 (Update 3 or higher) SuSE Linux Enterprise Server 9 (SP2 or higher) 1.1 Red Hat Enterprise Linux 'kernel-devel' Package Requirement For Red Hat Enterprise Linux installations, the kernel development package with the same version as the currently running kernel must be installed for the LPFC 8.0 driver build to succeed. For example, a system with the 2.6.9-22.EL kernel would need the kernel-devel-2.6.9-22.EL package, and a system with the 2.6.9-22.ELsmp kernel would need the kernel-smp-devel-2.6.9-22.EL package. 1.2 SuSE Linux Enterprise Server 'kernel-source' Package Requirement For SuSE Linux Enterprise Server installations, the kernel-source package with the same version as the currently running kernel must be installed for the LPFC 8.0 driver build to succeed. For example, a system with the 2.6.5-7.139-bigsmp kernel would need the kernel-source-2.6.5-7.139 package. The lpfc-install script installs both the LPFC driver and the LPFC DFC driver RPMs. These RPMs install their driver sources to the /usr/src/lpfc directory, build their drivers for the currently running kernel, and then install the drivers to the proper directory for the currently running kernel. Once the RPMs are installed, the lpfc-install script creates a new ramdisk for the currently running kernel so that the 'lpfc' driver is loaded when the kernel is initialized during system startup. 2. Driver Installation Refer to the LPFC Linux 8.0.16 documentation on the Emulex website at http://www.emulex.com for an installation manual that includes a complete set of options for the lpfc-install program IBM strongly recommends uninstalling any old driver kits before installing the new driver kit. Please refer to the "Driver Uninstallation" section to uninstall previous versions of the Emulex LPFC 8.x or older driver. Create a download directory. Change to that directory and download the updated driver from the Emulex website. Untar the driver kit archive: # tar xvzf {download_directory_path}/{driver_kit_name}.tar.gz Log in as the user 'root' to a terminal, Change directory to {download_directory_path}/{driver_kit_name} and execute the 'lpfc-install' script with no options to install the driver: ./lpfc-install Once the 'lpfc-install' script has completed successfully, the Emulex LPFC and LPFC DFC drivers will be loaded, and fibre channel disks that are properly connected to the system should be accessible. However, a reboot of the system is recommended to load the 'lpfc' driver through the ramdisk. For FAilover support: Go to http://www-307.ibm.com/pc/support/site.wss/document.do?lndocid=MIGR-63243 the latest RDAC driver for Linux 2.6 kernels Minimum driver version to support the Emulex 4Gb daughtercard is 09.01.b5.30 3. Driver Uninstallation To completely remove the Emulex LPFC and LPFC DFC drivers from a system, first exit out of all applications that use Fibre Channel-attached drives, then unmount the drives. Execute system command: swapon -s to be sure that the OS is not using any swap space on Fibre Channel-attached drives Log in as the user 'root' to a terminal. To uninstall the failover driver, follow the instructions in the readme for the RDAC driver. Copy the 'lpfc-install' script to a temporary directory, such as '/tmp': cp /usr/src/lpfc/lpfc-install /tmp Next, execute the lpfc-install script in the temporary directory with the '--uninstall' option. /tmp/lpfc-install --uninstall 4. Notes 4.1 Packaging Change Involving The Application Helper Module 4.1.1 Background Prior versions of the LPFC driver kit included both the LPFC driver and the Application Helper Module (LPFCDFC). As of driver version 8.0.16.26 the Application Helper Module is included in the HBAnyware Applications 3.0 kit and is not a part of the LPFC driver kit. 4.1.2 Observed Behavior On LPFC driver kits prior to 8.0.16.26 version, the 'lpfc-install' script that ships with the LPFC driver kit could be used to install/uninstall both the LPFC driver and Application Helper Module. Starting with the 8.0.16.26 driver version though, this 'lpfc-install' script can be used to install/uninstall only the LPFC driver. The Application Helper Module is installed and uninstalled as part of the HBAnyware Application kit's installation procedure. As a result of this packaging change, the 'lpfc-install' script that ships with the LPFC driver kit cannot be used to uninstall the Application Helper Module component of older driver kits. To do that you should use the 'lpfc-install' script of the older kit. For more information on the new packaging please refer to the User Manual. 4.2 If you are planning to upgrade the kernel, please consult the section "Upgrading the Kernel" in the Installation manual and follow the steps required for proper driver operation before you perform the upgrade. ________________________________________ 5.0 WEB Sites and Support Phone Number ________________________________________ You can download new and updated files for BladeCenter Fibre Channel products from http://www.ibm.com/support/. For a list of supported operating systems on legacy (non-shipping) controllers, see http://www.ibm.com/servers/eserver/serverproven/compat/us/. 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). In the U.S. and Canada, hardware service and support is available 24 hours a day, 7 days a week. In the U.K., these services are available Monday through Friday, from 9 a.m. to 6 p.m. ____________________________ 6.0 Notices and Trademarks ____________________________ The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both: IBM BladeCenter eServer 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. Adaptec and HostRAID are trademarks of Adaptec, Inc. Other company, product, or service names may be trademarks or service marks of others. ________________ 7.0 Disclaimer ________________ 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.LIED 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.