IBM DS4000/DS5000 support for the Linux 2.6 kernel device driver version 1.1.0.6 of the Brocade FC 8Gbps single and dual port Fibre Channel Host Bus Adapter (FC HBA) for IBM System X in Linux environments where the Brocade FC HBAs are IO attached to the DS4000/DS5000 storage subsystems. NOTE TO SERVICE – Reference RETAIN # N/A (C) Copyright International Business Machines Corporation 1999, 2009. 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 6.0 "Trademarks and Notices" in this document. Also read the section 1.2 Limitations before installing this device driver. Last Update: 08/02/2009 Products supported: -------------------------------------------------------------- | System-x Adapter | Brocade Adapter | IBM Option P/N | -------------------------------------------------------------- |Brocade 8Gb Single port | 815 | 46M6049 | |PCI-E HBA | | | |Brocade 8Gb Dual port | 825 | 46M6050 | |PCI-E HBA | | | -------------------------------------------------------------- -------------------------------------------------------------------- | DS4000/DS5000 | Controller Firmware | DS4000 Storage Manager | | Storage Subsystem | Version Required | Version Required | -------------------------------------------------------------------- | DS4100 | 06.12.56.00 or later| 10.60.xx.05 or later | | DS4200 | 07.50.12.00 or later| 10.60.xx.05 or later | | DS4300 (dual | | | | controller)| 06.60.08.xx or later| 10.60.xx.05 or later | | DS4400 | 06.12.56.00 or later| 10.60.xx.05 or later | | DS4500 | 06.60.08.xx or later| 10.60.xx.05 or later | | DS4700 | 07.50.12.00 or later| 10.60.xx.05 or later | | DS4800 | 07.50.12.00 or later| 10.60.xx.05 or later | | DS5020 | 07.60.13.00 or later| 10.60.xx.05 or later | | DS5100 | 07.50.12.00 or later| 10.60.xx.05 or later | | DS5300 | 07.50.12.00 or later| 10.60.xx.05 or later | -------------------------------------------------------------------- ======================================================================= Contents -------- 1.0 OS Support 2.0 Supported Features 3.0 Change History 4.0 Host Adapter configuration 5.0 Download and Install the Brocade Host Bus Adapter device driver 6.0 Building a Driver from the Sources Code 7.0 Loading the driver 8.0 Limitations 9.0 Driver file Contents 10.0 WEB Sites and Support Phone Number 11.0 Trademarks and Notices 12.0 Disclaimer ======================================================================= 1.0 OS Support -------------- IBM DS4000/DS5000 has tested and supported the v1.1.0.6 device driver for Linux 2.6 kernel in the following Linux distributions. ----------------------------------------------------------------- | Supported Operating System | Kernel Version | ----------------------------------------------------------------- | RedHat 4 Update 7 | 2.6.9-78.EL UP SMP | | (x86 and x86_64 versions) | | |-----------------------------------------------------------------| | RedHat 5 Update 3 | 2.6.18-128.el5 UP SMP | | (x86 and x86_64 versions | | |-----------------------------------------------------------------| | SuSe SLES 9 SP4 | 2.6.5-7.308 UP SMP | | (x86 and x86_64 versions) | | ----------------------------------------------------------------- | SuSe SLES 10 SP2 | 2.6.16.60_0.21 UP SMP | | (x86 and x86_64 versions) | | ----------------------------------------------------------------- | SuSe SLES 11 | 2.6.27.19-5 UP SMP | | (x86 and x86_64 versions) | | ----------------------------------------------------------------- IMPORTANT: - The 1.1.0.6 version of the Linux device driver does not support Itanium IA-64 servers. The latest Linux device driver version that supports the Itanium IA-64 servers is 1.1.0.1. - Earlier or later versions of the vendor kernels or generic kernels have not been tested with this device driver version and may not be supported with this release. The Brocade device driver in the Linux vendor packages have not been tested and are not supported by IBM. ======================================================================= 2.0 Supported Features ---------------------- · Quality of Service (QoS) - Three priority levels for end-to-end QoS which are enforced in hardware. · Target Rate Limiting (TRL) - Maximizes throughput across the entire fabric. · BIOS – Boot code support for x86 servers. · EFI – Boot code support for IA64 servers. · Fabric Based Boot LUN Discovery - Automatically configure boot parameters from the fabric. · N_Port ID Virtualization (NPIV) and HCM management integration with virtualization applications from Microsoft and Novell. ======================================================================= 3.0 Change History ------------------- Please refer to the attached change history file brocade_ibm_dd_ds4kds5khba_v1.1.0.6_linux-2.6-kernel_32-64.chg. ======================================================================= 4.0 Host Adapter configuration ------------------------------ Please refer to Brocade FC HBA Installation and Reference Manual and other publications under the Documentation section of the following URL. http://www.brocade.com/sites/dotcom/services-support/drivers-downloads/HBA/HBA_IBM.page ======================================================================= 5.0 Download and Install the Brocade Host Bus Adapter device driver ------------------------------------------------------------------------ Please refer to the Brocade FC HBA Installation and Reference Manual and other publications under the Documentation section of the following URL for the instructions to install the device driver and the Brocade Host Connectivity Manager (HCM) in your operating system environment. http://www.brocade.com/sites/dotcom/services-support/drivers-downloads/HBA/HBA_IBM.page The Web link to download the Linux device driver code is http://www.brocade.com/sites/dotcom/services-support/drivers-downloads/HBA/Linux.page Note: This is not the same as the Brocade IBM OEM web page as identified in the previous paragraph. You can use either individual precompiled device driver binaries installation program (RPMs) for various versions of Linux operating systems or the Brocade HBA Integrated Software Installer for Linux operating system. This installer is a one-step installer that allows you to install all Brocade FC HBA software and drivers. It allows the option to install only Host Connectivity Manager (HCM, GUI Management Application), only the supported Driver Packages, or both. Included with the Driver Packages are the Brocade Command line Utility (BCU), HCM Agent, and APIs. If there is not a precompiled device driver binary for your Linux kernel version, see section 6.0 for compiling the device driver from source code. The name of the Brocade HBA Integrated Software Installer for Linux operating system is bfa_setup_linux_v1-1-0-6.bin. The file names of various precompiled device driver binaries RPMs are as listed below. The RPMs are compiled for a specific version of your Linux kernel (Redhat 4 u7, Redhat 5, SLES 9 SP4, SLES 10 SP2, SLES 11 ...). Please select the appropriate device driver binary RPM for your version of Linux operating system. Note: After installing the precompiled device driver binaries RPM, you also need to install the Linux Driver Utility. For SLES 10 SP2 brocade-bfa-kmp-bigsmp-1.1.0.6_2.6.16.60_0.21-0.i586.rpm (for bigSMP 32-bit x86 edition) brocade-bfa-kmp-debug-1.1.0.6_2.6.16.60_0.21-0.i586.rpm (Debug version of 32-bit x86 device driver) brocade-bfa-kmp-debug-1.1.0.6_2.6.16.60_0.21-0.x86_64.rpm (Debug version of 64-bit x86_64 edition) brocade-bfa-kmp-default-1.1.0.6_2.6.16.60_0.21-0.i586.rpm (for 32-bit x86 edition) brocade-bfa-kmp-default-1.1.0.6_2.6.16.60_0.21-0.x86_64.rpm (for 64-bit x86_64 edition) brocade-bfa-kmp-smp-1.1.0.6_2.6.16.60_0.21-0.i586.rpm (for SMP 32-bit x86 edition) brocade-bfa-kmp-smp-1.1.0.6_2.6.16.60_0.21-0.x86_64.rpm (for SMP 64-bit x86_64 edition) brocade-bfa-kmp-vmi-1.1.0.6_2.6.16.60_0.21-0.i586.rpm (for VMI 32-bit x86 edition) brocade-bfa-kmp-vmipae-1.1.0.6_2.6.16.60_0.21-0.i586.rpm (for VMIPAE 32-bit x86 edition) For SLES11 brocade-bfa-kmp-debug-1.1.0.6_2.6.27.19_5-0.i586.rpm (Debug version of 32-bit x86 device driver) brocade-bfa-kmp-debug-1.1.0.6_2.6.27.19_5-0.x86_64.rpm (Debug version of 64-bit x86_64 edition) brocade-bfa-kmp-default-1.1.0.6_2.6.27.19_5-0.i586.rpm (for 32-bit x86 edition) brocade-bfa-kmp-default-1.1.0.6_2.6.27.19_5-0.x86_64.rpm (for 64-bit x86_64 edition) brocade-bfa-kmp-pae-1.1.0.6_2.6.27.19_5-0.i586.rpm (for PAE 32-bit x86 edition) brocade-bfa-kmp-trace-1.1.0.6_2.6.27.19_5-0.i586.rpm (for 64-bit x86_64 edition, trace FC driver) brocade-bfa-kmp-trace-1.1.0.6_2.6.27.19_5-0.x86_64.rpm (for 32-bit x86 edition, trace FC driver) brocade-bfa-kmp-vmi-1.1.0.6_2.6.27.19_5-0.i586.rpm (for VMI 32-bit x86 edition) For Redhat 5 kmod-bfa-1.1.0.6-0.i686.rpm (for 32-bit x86 edition) kmod-bfa-1.1.0.6-0.ia64.rpm (for 64-bit Itanium edition) kmod-bfa-1.1.0.6-0.x86_64.rpm (for 64-bit x86_64 edition) kmod-bfa-PAE-1.1.0.6-0.i686.rpm (for PAE 32-bit x86 edition) For Redhat 4 u7 brocade-bfa-default-1.1.0.6_2.6.9_78.EL-0.i386.rpm (for 32-bit x86 edition) brocade-bfa-default-1.1.0.6_2.6.9_78.EL-0.x86_64.rpm (for 64-bit x86_64 edition) brocade-bfa-hugemem-1.1.0.6_2.6.9_78.EL-0.i386.rpm (for HUGEMEM 32-bit x86 edition) brocade-bfa-largesmp-1.1.0.6_2.6.9_78.EL-0.x86_64.rpm (for LargeSMP 64-bit x86_64 edition) brocade-bfa-smp-1.1.0.6_2.6.9_78.EL-0.i386.rpm (for SMP 32-bit x86 edition) brocade-bfa-smp-1.1.0.6_2.6.9_78.EL-0.x86_64.rpm (for SMP 64-bit x86_64 edition) Linux Utility package (for all Linux distributions) bfa_util_linux-1.1.0.1-0.noarch.rpm Device Driver source bfa_driver_linux-1.1.0.6-0.noarch.rpm ======================================================================= 6.0 Building a Driver from the Source Code ------------------------------------------ Please refer to the Brocade FC HBA Installation and Reference Manual and other publications under the Documentation section of the following URL. http://www.brocade.com/sites/dotcom/services-support/drivers-downloads/HBA/Linux.page The name of the file to download is bfa_driver_linux-1.1.0.6-0.noarch.rpm. ======================================================================= 7.0 Load and configure the driver --------------------------------- Please refer to the Brocade FC HBA Installation and Reference Manual, the Brocade FC HBA Troubleshooting Guide and other publications under the Documentation section of the following URL for the instructions to install the device driver and the Brocade Host Connectivity Manager (HCM) and troubleshoot configuration problems. http://www.brocade.com/sites/dotcom/services-support/drivers-downloads/HBA/HBA_IBM.page ======================================================================= 8.0 Limitations --------------- 1. The Brocade FC HBA can not be directly attached to the DS4000/DS5000 host ports. Connectivity from the Brocade FC HBA ports and the DS4000/DS5000 host ports must be through the FC switches. 2. In RHEL 5.x systems, when serial console redirection is used, the system might report “soft lockups” with the following message in the /var/log/messages: “May 11 19:59:10 sysname kernel: BUG: soft lockup - CPU#0 stuck for 10s! [multipathd:15307]” It is recommended to remove serial console redirection to workaround this issue. 3. In SLES11 systems with multipath enabled, dev_loss_tmo may reset (by the SLES 11 OS) to 10secs when an rport (target) is offline for greater than dev_loss_tmo. 4. When using Linux's Device Mapper, MPIO timeout value may not be applied consistently to all devices. The first device goes offline from the Device Mapper within the first 10 seconds, whereas the rest of the devices go offline at the expiry of MPIO timeout Value. 5. RHEL 5.3 Boot-from-SAN installation may suspend when multiple LUNs are presented during the installation. It is recommended to present only one LUN from the boot target and install the OS on that LUN. Once the installation and subsequent OS boot complete, additional LUNs can be presented to the OS. 6. For RHEL 5.3, there may be instances where the boot process takes longer than expected. This issue can be fixed by increasing the system’s memory. 7. On SLES9 SP3, traffic may suspend after multiple target offline events. To resolve this issue, a manual rescan of the targets, driver reload, or host reboot may be required In addition, please refer to the Brocade Release Notes for Software Release v1.1.0.6 publication under the Documentation section of the following URL for additional limitations. http://www.brocade.com/sites/dotcom/services-support/drivers-downloads/HBA/Linux.page ======================================================================= 9.0 Driver file Contents ------------------------ N/A ======================================================================= 10.0 WEB Sites and Support Phone Number ---------------------------------------- 10.1 IBM System Storage™ Disk Storage Systems Technical Support web site: http://www.ibm.com/servers/storage/support/disk/ 10.2 IBM System Storage™ Marketing Web Site: http://www.ibm.com/servers/storage/disk 10.3 Brocade Device Driver Matrix for Supported IBM Products: http://www.brocade.com/sites/dotcom/services-support/drivers-downloads/HBA/HBA_IBM.page 10.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-Sir7378). IMPORTANT: You should download the latest version of the DS Storage Manager host software, the DS4000/DS5000 storage subsystem controller firmware, the DS4000/DS5000 drive expansion enclosure ESM firmware and the drive firmware at the time of the initial installation and when product updates become available. For more information about how to register for support notifications, see the following IBM Support Web page: www.ibm.com/systems/support/storage/subscribe/moreinfo.html You can also check the Stay Informed section of the IBM Disk Support Web site, at the following address: www.ibm.com/systems/support/storage/disk ======================================================================= 11.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. ======================================================================= 12.0 Disclaimer -------------- 12.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. 12.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.