Emulex LP1050DC-E Download Drivers, Utilities, Manual, Firmware and BIOS

Fibre Channel Host Bus Adapter for Symmetrix and CLARiiON
BootBIOS for x86 platforms and x64 platforms that support legacy BIOS. The adapter boot BIOS provides x86 boot capability through the use of INT13
system BIOS calls. The adapter Boot BIOS supports:

(1) Multi-topology: Fabric Point to Point; FC-AL: Private loop and Public loop
topologies.
(2) Multi-initiators: The adapter BIOS supports up to 32 Emulex LightPulse
adapters in a system.
(3) Multi-LUNs: The adapter BIOS supports up to 256 LUNs.
(4) Multi-boot: The adapter BIOS complies with the BIOS Boot Specification
(BBS).
(5) EDD (Enhanced Disk Drive Services): The adapter BIOS supports both the
EDD 3.0 and EDD 2.1 specifications depending on the selection in the
adapter BIOS configuration utility.
(6) Boot fail over feature: There are eight boot entries that can be
configured in the adapter BIOS configuration utility. If the first boot
entry fails the system is still able to boot from the second configured
boot entry and so on.
\211a0.txt this file you are reading

\TB211a0.PRG Lp10000 adapter boot BIOS version 2.11a0
\BB211a0.PRG Lp11000 adapter boot BIOS version 2.11a0
\MB211a0.PRG Lp1050 adapter boot BIOS version 2.11a0
\JB211a0.PRG Lp1150 adapter boot BIOS version 2.11a0
\EB211a0.PRG Lp101 adapter boot BIOS version 2.11a0
\YB211a0.PRG LPe111 adapter boot BIOS version 2.11a0
\AB211a0.PRG Lp21000 adapter boot BIOS version 2.11a0
\WB211a0.PRG LPe1150 adapter boot BIOS version 2.11a0
\ZB211a0.PRG LPe11000 adapter boot BIOS version 2.11a0
\UB211a0.PRG LPe12000 adapter boot BIOS version 2.11a0
\OB211a0.PRG LPe1250 adapter boot BIOS version 2.11a0


***** Important Note ******

(1) BIOS downloading

The adapter boot BIOS image has increased in size to 50K. As a result, it might
fail during the downloading of the BIOS .prg file. One way to correct the
problem is to download the firmware .AWC file WITHOUT the BIOS image
(for example: dd390a7.awc) and then download the adapter boot BIOS .prg file.
(2) BIOS was not activated (Enabled)

If the adapter boot BIOS is not enabled by LP6DUTIL or an Emulex O.S.
configuration utility, the adapter and the drives connected to the adapter
cannot not be configured to be used to boot the system. In addition if there is
a "No BIOS support" message displayed next to this adapter in the adapter BIOS
configuration utility the user must use LP6DUTIL or other Emulex O.S.
configuration utility to enable the adapter boot BIOS in order to allow this adapter
to be used a bootable controller by the host system.

Fibre Channel Host Bus Adapter for Symmetrix and CLARiiON
EFIBoot for IA64 platforms and
x64 platforms that support EFIBoot. The current EFI (Extensible Firmware Interface) Boot provides 64-bit system
boot capability through the use of the EFI Shell. EFIBoot supports EFI
Specification 1.10 and EFI Source Code version 1.10.14.61 and 1.10.14.62.

EFIBoot supports:

(1) Multi-Topology : Fabric Point-to-Point; FC-AL: Private Loop and Public
Loop.

(2) EFI Protocols : Configuration, Component Name, Firmware Update, VPD,
LunCtrlAttrs and Diagnostics are supported.

(3) Operating System : Windows Server 2003 and Red-Hat Linux

(4) Multi-Device path : Fibre/SCSI device path selectable through the Driver
Configuration Protocol.

(5) Multi-Initiators : Up to 128 adapters in a system.

(6) Multi-Boot : Eight targets/controller selectable through the Driver
configuration Protocol.

(7) Multi-LUNs : Up to 4096 LUNs/target for a volume set device.
Up to 256 LUNs/target for a peripheral device.

(8) Multi-Mode : Peripheral and Volume Set devices are supported.

(9) Multi-Utility : Setup and firmware update are supported.
Files included in this release:

EFI Byte Code Driver Images:

\rel_notes.txt this file you are reading
\HE400A5.PRG Lp9802 EFIBoot version 4.00A5
\LE400A5.PRG Lp982 EFIBoot version 4.00A5
\TE400A5.PRG Lp10000 EFIBoot version 4.00A5
\ME400A5.PRG Lp1050 EFIBoot version 4.00A5
\EE400A5.PRG Lp101 EFIBoot version 4.00A5
\BE400A5.PRG Lp11000 EFIBoot version 4.00A5
\JE400A5.PRG Lp1150 EFIBoot version 4.00A5
\ZE400A5.PRG Lpe11000 EFIBoot version 4.00A5
\WE400A5.PRG Lpe1150 EFIBoot version 4.00A5
\YE400A5.PRG Lpe111 EFIBoot version 4.00A5
\UE400A5.PRG Lpe12000 EFIBoot version 4.00A5
\OE400A5.PRG Lpe1250 EFIBoot version 4.00A5
\AE400A5.PRG Lp21000 EFIBoot version 4.00A5
\ElxCli400A5.efi

***** Important Note ******

(1) EFIBoot was not enabled from loading to system memory:

If the adapter EFIBoot is not enabled from loading to system, this adapter
will not be configured. User must use LP6dutil or some other OS Utility to
enable the EFIBoot in order to make this card bootable.

(2) EFIBoot Bios was enabled to configure the adapter and No Link:

EFIBoot will wait for 15 seconds/adapter to confirm a link.

(3) If two or more adapters have same EFIBoot driver version, EFIBoot will
load only one driver.

(4) If there are adapters with different EFIBoot driver versions, EFIBoot
will load the highest version of the EFIBoot driver.

(5) In order to display Linkup speed, use the latest version of the firmware.

Fibre Channel Host Bus Adapter for Symmetrix and CLARiiON
Contains: x86 BootBIOS 2.11a0 and EFIBoot 4.00a5 This Pair Boot version 5.03a7 contains:

(1) x86 BootBIOS version 2.11a0
(2) EFIBoot version 4.00a5

For detailed information about x86 BootBIOS, please refer to section II below and
for EFIBoot, section III. This Pair Boot can boot on either Intel x86 Platform or
EFI environment. In other words, the platform is transparent and the user should
not be concerned with any differences with regard to x86 BootBIOS or EFIBoot.

Pair Boot is a complete image, Whenever it is enabled by any Emulex OS utility,
the whole image (x86 BootBIOS and EFIBoot) is enabled. This is also true for
disable.
Files included in this release:

\503a7.txt this file you are reading
\LP503a7.PRG LP982 Pair Boot
\MP503a7.PRG LP1050 Pair Boot
\EP503a7.PRG LP101 Pair Boot
\JP503a7.PRG LP1150 Pair Boot
\WP503a7.PRG LPe1150 Pair Boot
\OP503a7.PRG LPe1250 Pair Boot
\PP503a7.PRG LPe121 Pair Boot
\elxcli400a5.efi EFI 4.00a5 Driver
Pair Boot Load Procedure

The Light Pulse Universal Boot is distributed as a .PRG file. This file may be
downloaded to the Adapter using the firmware upgrade procedure with the following
Utility in Various systems.

1. "Drvcfg" : EFI based Systems.

Please refer to section 4 in EFIBoot for user interface how to download
Universal Boot in EFI based systems.

2. DosLpCfg.EXE : DOS based utility.

Please refer to the utility user manual for details on using the above tool.

3. LPUTILNT : Windows Miniport Driver.

Please refer to the utility user manual for details on using the above tool.

4. Emulex Configuration Tool : Windows Port Driver.

Please refer to the elxcfg user manual for details on using the above tool.

Fibre Channel Host Bus Adapter for Symmetrix and CLARiiON Compatibility:

This kit supports the LP1050, LP1050DC and LP1050Ex
PCI host adapters.

This kit includes the following files:

README.TXT The file you are reading

MF192A1.ALL All firmware components, no boot code

LP6DUTIL.EXE DOS-based diagnostic utility 9.3a6
LP6DUTIL.DOC LP6DUTIL diagnostic utility document
SAMPLESCRIPT.TXT An example script for LP6DUTIL 9.3a6
Changes and Corrections:

-- Changes and corrections between 1.92a1 and 1.91a5:

Implemeted beaconing feature for Pegasus and Thor. (CR 16592, 21846)

The R_A_TOV field is now properly expressed in milliseconds. (CR 22640)

Improved target mode "fast" POST so that power up no longer causes HBA
to hang. (CR 22594)

A timeout is prevented by allowing the firmware to process fatal DMA
engine errors even if the DMA is not complete, such as during a PCI
master abort. (CR 22641)

Various concurrent FLASH programming issues were resolved by improving
the FLASH interlocking/unlocking algorithm, implementing Intel errata,
and implementing erase failure recovery code.
(CR 21885, 21888, 21889, 21890)

We now default to allowing the PCI bridge to reorder data frames as
necessary, which may result in a system performance increase for some
systems. (CR 21867)

Improved FCP2 recovery to avoid the dropping of frames
(and the resulting delays) during REC ELS command. (CR 21865)

Fixed a recovery issue where a corrupted REC frame with a mismatching
offset would cause the HBA to loop, continually requesting recovery.
(CR 21864)

To avoid dropped receive frames in the case where an OXID is reused
for a new exchange during the ABTS/RRQ processing window, we now skip
any matching "new" exchanges which are in the RRQ state. (CR 21855)

Improved management of unavailable memory by limiting the number of
retries. The HBA now reports an error attention after retries have
been exhausted. (CR 21854)

Improved DMA error handling of split errors where host memory has been
made unavailable. (CR 21853)

Commands are now timed out properly when in FCP-2 mode. (CR 21852)

Protocol testing with invalid conditions revealed protocol response
errors which have had no reported instances of failure in the field.
(CR 21850, 21851, 21863)

An I/O timeout during tape operation was eliminated by delaying
processing of any FCP2 errors during discovery. (CR 17363)

Thor no longer deadlocks during processing of RRQ when RESET_RING is
issued with no available exchange resources. (CR 20064)

Please note: EMC qualifies operation of the hardware, drivers, firmware and Boot Bios for the products referenced, as documented in the current EMC ESM (EMC Support Matrix). Utility software, including HBAnyware and various stand alone utilities used to manage or maintain Emulex products, are not tested by EMC. Utility software is provided for the convenience of EMC customers. Emulex is responsible for the integrity, functionality and support.
WARNING: You are about to download the EMC Approved HBA driver. This driver is optimized for use with EMC "-E" HBAs. It is being made available to you to update your approved EMC HBAs to support your EMC and non-EMC hardware environments. Downloading this EMC approved driver for use with an unqualified or unsupported HBA may be inconsistent with applicable terms and conditions. If you have any questions about the suitability of downloading this driver, contact your Emulex or EMC sales team.

Please note: EMC qualifies operation of the hardware, drivers, firmware and Boot Bios for the products referenced, as documented in the current EMC ESM (EMC Support Matrix). Utility software, including HBAnyware and various stand alone utilities used to manage or maintain Emulex products, are not tested by EMC. Utility software is provided for the convenience of EMC customers. Emulex is responsible for the integrity, functionality and support.
WARNING: You are about to download the EMC Approved HBA driver. This driver is optimized for use with EMC "-E" HBAs. It is being made available to you to update your approved EMC HBAs to support your EMC and non-EMC hardware environments. Downloading this EMC approved driver for use with an unqualified or unsupported HBA may be inconsistent with applicable terms and conditions. If you have any questions about the suitability of downloading this driver, contact your Emulex or EMC sales team.

Red Hat Enterprise Linux 5.4 and SUSE SLES 10 SP3 (x86 Intel,x86-64 AMD & Intel architectures)
Base driver and install script

1. System Requirements
1.1 Red Hat Enterprise Linux 'kernel-devel' Package Requirement
1.2 SuSE Linux Enterprise Server 'kernel-source' Package Requirement
2. Description of Install Procedure
3. Known Issues
3.1 PCI Hot Plug Support for applications
3.1.1 Observed problem
3.1.2 Workaround
3.2 Deletion of Vports/PCI Hot Unplug
3.2.1 Observed Problem
3.2.2 Background
3.3 lspci utility displays "Unknown Device" for LPe12000 HBAs
3.3.1 Observed Problem
3.3.2 Background
3.4 Speed of LPe12000 HBA (8Gb) is incorrectly displayed by HBAnyware
3.4.1 Observed Problem
3.4.2 Background
3.5 Port disabled on system boot or HBA reset with authentication enabled
3.5.1 Observed Problem
3.5.2 Workaround
3.6 LILO Boot Loader is not supported - i386 and x86_64 architectures
3.6.1 Observed Problem
3.6.2 Background
3.7 Order of lpfc module in initrd module list
3.7.1 Observed Problem
3.7.2 Workaround
3.8 Devloss timeout after swapping ports
3.8.1 Observed Problem
3.8.2 Workaround
3.9 Suspend to disk and Resume support
3.9.1 Observed Problem
3.9.2 Background
3.10 Deleting vports while devices are in use
3.10.1 Observed Problem
3.10.2 Workaround
3.11 Support of 4Gb/s HBAs in Direct I/O virtualized environments
3.11.1 Observed Problem
3.11.2 Workaround
3.12 Potential error messages during driver kit removal process
3.12.1 Observer Problem
3.12.2 Resolution

----------------------------------------------------------------------

1. System Requirements

The following distributions of Linux are supported by the Emulex
LPFC driver:

Red Hat Enterprise Linux 5
SuSE Linux Enterprise Server 10 (SP1 or higher)

Red Hat Enterprise Linux 5.4 and SUSE SLES 10 SP3 (x86 Intel,x86-64 AMD & Intel architectures)
HBAnyware utility 4.1a36

HBAnyware 4.1a36 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 4.1a36
SSC version 4.1a36
DFC Library version 3.0.35-1-1
HBAAPI version 2.1.g
FCAUTHD version 1.20-1-1
Multipulse version 3.0.30-1
Dependencies:

lpfc driver version 8.2.0.48.2p or later

HBAnyware requires that the lpfc driver module be installed.

HBAnyware requires a minimum screen resolution of 1024 x 768.
Installing HBAnyware:

1. Copy the applications kit tar file to a directory on the install machine
2. cd to the directory which you copied the tar file
3. Untar the file: tar -xvf tarfilename
4. cd (change directory) to the "ElxLinuxApps.." directory created by step 3
5. su to root
6. If earlier HBAnyware version currently installed, type : ./uninstall
7. Run the install script: ./install
8. When prompted, answer the following question:

Select desired mode of operation for HBAnyware

1 Local Mode : HBA's on this Platform can be managed by HBAnyware
clients on this platform only.
2 Managed Mode : HBA's on this Platform can be managed by local or
remote HBAnyware clients
3 Remote Mode : Same as '2' plus HBAnyware clients on this Platform
can manage local and remote clients.

Enter the number '1' or '2' or '3'
9. When prompted, answer the following question:

Do you want to allow user to make subsequent management mode changes
using 'set_operating_mode' script
Enter the letter 'Y' for yes or 'N' for no

10. Installation Complete: type /usr/sbin/hbanyware/hbanyware
to start GUI or type /usr/sbin/hbanyware/hbacmd list
to run script utility

Red Hat Enterprise Linux 5.4 and SUSE SLES 10 SP3 (x86 Intel,x86-64 AMD & Intel architectures)
Driver for Linux User Manual (1.53 MB pdf file) Chapter 1 Introduction
Purpose of this document................................................................ 12
Host connectivity .............................................................................. 12
Fibre Channel ..............................................................................12
Fibre Channel over Ethernet .....................................................12
EMC storage array-specific settings............................................... 13
Boot device support.......................................................................... 13
Zoning ................................................................................................ 14
Useful Linux utilities and functions............................................... 14
Chapter 2 Installation Steps
Prerequisites for first-time installation .......................................... 16
Summary of installation steps......................................................... 18
Installing the adapter ....................................................................... 20
Matching the adapter with the correct PCI slot .....................22
Chapter 3 Installing and Configuring the BIOS Settings
Verifying and updating the Emulex boot BIOS............................ 28
Verifying the correct BIOS version...........................................28
Updating the boot BIOS.............................................................29
Method One — Updating the adapter boot BIOS with
hbacmd............................................................................................... 30
Method Two – Booting from a DOS bootable diskette and
using the lp6dutil utility .................................................................. 33
Chapter 4 Installing and Configuring the Driver
Installation instructions for the Emulex v8.x-series driver......... 36
Downloading the Emulex v8.x-series adapter driver for
the v2.6.x kernel .......................................................................... 37
Installing the Emulex CNA v8.x-series driver on RHEL
5.2 and SLES 10 SP2 hosts ......................................................... 38
Installing the Emulex v8.x-series driver on SLES 9 SP1
hosts.............................................................................................. 39
Installing the Emulex v8.x-series driver on RHEL 4
hosts.............................................................................................. 42
Included Emulex driver on RHEL 4, RHEL 5, OEL 4,
OEL 5, Asianux 2.0, Asianux 3.0, SLES 9, and SLES 10 ........ 45
Uninstalling the Emulex v8.x-series driver................................... 47
Installing the Emulex HBAnywhere applications kit.................. 48
Editing the configuration files ........................................................ 51
Description of the Emulex lpfc driver parameters ................ 51
Descriptions of the Emulex parameters .................................. 52
Editing the Emulex driver parameters on hosts with
SLES 9 and SLES 10 .................................................................... 54
Editing the Emulex driver parameters on hosts with
RHEL 4 and RHEL 5 .................................................................. 55
Editing the Emulex driver parameters on hosts with
Asianux 2.0 and Asianux 3.0..................................................... 56
Editing the Emulex driver parameters on hosts with
OEL 4 and OEL 5 ........................................................................ 57
Exercising the Emulex v8.x-series device driver.......................... 58
Loading and unloading the Emulex v8.x-series driver......... 58
Target information exported to the /proc filesystem ........... 59
Dynamically modifying the driver and device
information exported to the /sys filesystem.......................... 59

Red Hat Enterprise Linux 5.4 and SUSE SLES 10 SP3 (x86 Intel,x86-64 AMD & Intel architectures)
HBAnyware Utility Version 4.1 Introduction.............................................................................................................. 1
Known Issues .................................................................................................... 1
Installing HBAnyware Components.......................................................................... 2
Installing the HBAnyware Utility......................................................................... 2
Installing the HBAnyware Utility with Web Launch............................................. 4
Installing the HBAnyware Utility Security Configurator ...................................... 5
Uninstalling the HBAnyware Security Configurator............................................ 6
Uninstalling HBAnyware Web Launch Only ....................................................... 7
Uninstalling the Utility Package ......................................................................... 7
Using the HBAnyware Components......................................................................... 8
Starting the HBAnyware Utility........................................................................... 8
Starting HBAnyware with Web Launch .............................................................. 8
Starting the HBAnyware Security Configurator .................................................. 8
Starting HBAnyware from the Command Line ................................................... 9
Examples of Modifications .................................................................... 9
The HBAnyware Utility Window Element Definitions ....................................... 10
The Menu Bar ........................................................................................... 11
The Toolbar ............................................................................................... 11
The Toolbar Buttons .................................................................................. 11
Sort Toolbar Buttons ........................................................................... 11
The Discovery-Tree................................................................................... 12
Discovery-Tree Icons .......................................................................... 12
Property Tabs............................................................................................ 13
Status Bar ................................................................................................. 13
Changing Management Mode ......................................................................... 13
Resetting HBAs ............................................................................................... 14
Discovering HBAs ........................................................................................... 14
Automatic Fibre Channel Discovery .......................................................... 14
Remote SAN Management Using TCP/IP Access Protocol....................... 15
Adding a Single Host .......................................................................... 15
Adding a Range of Hosts .................................................................... 16
Removing Hosts.................................................................................. 17
Configuring Discovery Settings ................................................................. 18
Sorting HBA Information.................................................................................. 19
Viewing Remote and Local HBAs.............................................................. 19
Viewing HBA Information................................................................................. 20
Viewing Discovery Information .................................................................. 20
Viewing Host Information .......................................................................... 21
The Host Information Tab.................................................................... 21
The Driver Parameters Tab................................................................. 22
Viewing General HBA Attributes ............................................................... 23
Viewing Detailed HBA Information ............................................................ 24
Viewing Fabric Information........................................................................ 26
Viewing Target Information........................................................................ 27
Viewing LUN Information........................................................................... 28
Masking and Unmasking LUNs (Windows, Solaris LPFC and
Solaris SFS)........................................................................................ 29
Viewing Port Statistics............................................................................... 31
Viewing Firmware Information ................................................................... 33
Viewing Target Mapping (Windows, Solaris LPFC and Solaris SFS)......... 34
Viewing Target Mapping (Linux) ................................................................ 35

SLES 11 (x86 Intel,x86-64 AMD & Intel)
Base driver and install script (333 KB gz file)

1. System Requirements
1.1 SuSE Linux Enterprise Server 'kernel-source' Package Requirement
2. Description of Install Procedure
3. Known Issues
3.1 PCI Hot Plug Support for applications
3.1.1 Observed problem
3.1.2 Workaround
3.2 Deletion of Vports/PCI Hot Unplug
3.2.1 Observed Problem
3.2.2 Background
3.3 Port disabled on system boot or HBA reset with authentication enabled
3.3.1 Observed Problem
3.3.2 Workaround
3.4 LILO Boot Loader is not supported - i386 and x86_64 architectures
3.4.1 Observed Problem
3.4.2 Background
3.5 Order of lpfc module in initrd module list
3.5.1 Observed Problem
3.5.2 Workaround
3.6 Devloss timeout after swapping ports
3.6.1 Observed Problem
3.6.2 Workaround
3.7 Deleting vports while devices are in use
3.7.1 Observed Problem
3.7.2 Workaround
3.8 Support of 4Gb/s HBAs in Direct I/O virtualized environments
3.8.1 Observed Problem
3.8.2 Workaround
----------------------------------------------------------------------

1. System Requirements

The following distributions of Linux are supported by the Emulex
LPFC driver:

SuSE Linux Enterprise Server 11

1.1 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 driver build to succeed. For example, a
system with the 2.6.27-rc7-12-default kernel would need the
kernel-source-2.6.27-12.1 package.

SUSE Linux Enterprise Server 11 (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures)
New features, fixed issues and known issues in the driver (31 KB)

Release Notes
Date: March 2009 Product: Driver for Linux Version: 8.2.8.14 This document describes the new features, resolved known issues and current known issues associated with this driver build release. For the latest product documentation, go to www.Emulex.com. If you have any questions or require additional information, contact an authorized Emulex Corporation technical support representative.
New Features Driver for Linux 8.2.8.14
1. Supports the LP21000 and LP21002 FCoE adapters. (10 Gb/s capable) 2. Supports the LPe1250, LPe1252, LPe12000 and LPe12002 adapters. (2, 4 and 8 Gb/s capable) 3. Supports the latest HBAnyware utility version 4.1 as part of the master kit. Refer to the HBAnyware Utility User Manual for more information. 4. Supports SuSE Linux Enterprise Server 11. (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and PowerPC 64-bit architectures) 5. Adds interfaces via the sysfs file system to update speed and topology parameters without requiring link bounce. 6. Supports Power Management Suspend/Resume operations. 7.
Resolved Issues in Driver for Linux 8.2.8.14
Supports MSI-X interrupt handling.
Known Issues in Driver for Linux 8.2.8.14
There are no resolved issues in this driver version.
1. PCI Hot Plug may cause applications to malfunction Performing a PCI Hot Plug may cause the HBAnyware utilities or third party applications that use the Emulex libraries (i.e. HBAAPI) to behave unpredictably or malfunction. Workaround: 1. Stop all applications that are accessing LPFC's HBAAPI interface (HBAnyware utilities or third party applications) before performing PCI Hot Plug of an LPFC HBA. Use the following command to stop the HBAnyware application: #/usr/sbin/hbanyware/stop_hbanyware 2. Perform the PCI Hot Plug of the HBA. 3. Restart the application.

SLES 11 (x86 Intel,x86-64 AMD & Intel)
HBAnyware utility 4.1a26 (170 MB tar file)

HBAnyware 4.1a36 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 4.1a36
SSC version 4.1a36
DFC Library version 3.1.12-1-1
HBAAPI version 2.1.g
FCAUTHD version 2.5-1-1

Dependencies:

lpfc driver version 8.2.8.14 or later

HBAnyware requires that the lpfc driver module be installed.

HBAnyware requires a minimum screen resolution of 1024 x 768.
Installing HBAnyware:

1. Copy the applications kit tar file to a directory on the install machine
2. cd to the directory which you copied the tar file
3. Untar the file: tar -xvf tarfilename
4. cd (change directory) to the "ElxLinuxApps.." directory created by step 3
5. su to root
6. If earlier HBAnyware version currently installed, type : ./uninstall
7. Run the install script: ./install
8. When prompted, answer the following question:

Select desired mode of operation for HBAnyware

1 Local Mode : HBA's on this Platform can be managed by HBAnyware
clients on this platform only.
2 Managed Mode : HBA's on this Platform can be managed by local or
remote HBAnyware clients
3 Remote Mode : Same as '2' plus HBAnyware clients on this Platform
can manage local and remote clients.

Enter the number '1' or '2' or '3'
9. When prompted, answer the following question:

Do you want to allow user to make subsequent management mode changes
using 'set_operating_mode' script
Enter the letter 'Y' for yes or 'N' for no

10. Installation Complete: type /usr/sbin/hbanyware/hbanyware
to start GUI or type /usr/sbin/hbanyware/hbacmd list
to run script utility

SLES 11 (x86 Intel,x86-64 AMD & Intel)
New features, fixed issues and known issues in the HBAnyware utility

Release Notes
Date: January 2010
Product: Driver for Linux
Version: FC and FCoE version 8.2.0.63
NIC version 2.101.374.0
iSCSI version 2.101.374.0

New Features in the Driver for Linux
1. Supports the OCe1010x OneConnect Universal Converged Network Adapters (CNAs).
2. Supports the OneCommand Manager application version 5.0. Refer to the OneCommand Manager
application User Manual for more information.
3. Adds PCI ID support for the LPSe12002-ML1-E EmulexSecure Fibre Channel Adapter.
4. Adds support for Advanced Error Reporting (AER) for PCIe HBAs.
Resolved Issues in the Driver for Linux
1. Multipath Package Issues Fixed
Corrected issues with the multipath package functions with the OneConnect UCNA.
2. FCF Failures Addressed
Resolved various FCF failures.
3. Corrected Adapter Reset
Corrected adapter reset and offline/online stress test failing with I/O errors.
4. Multiple Spurious Interrupts Corrected
Required OneConnect UCNA to set up and use single FCP EQ only under INTx interrupt mode. Changed
lpfc_use_msi module parameter to use INTx mode (not MSI) by default. This prevents multiple spurious
interrupts from the firmware.
5. Extended Error Handling Issue Resolved
Blocked all SCSI I/O requests from the midlayer until target rediscovery during Extended Error Handling
EEH.
6. VPort Log Out Issue Corrected
Corrected an issue that prevented a VPort to log out if deleted.
7. mbox sysfs Attribute Corrected
Corrected an issue that resulted in the mbox sysfs attribute smaller than the mailbox extension size.
8. LUN Panic Fixed
Fixed a potential panic if LUNs were unmapped.
9. CPU Lockup Fixed
Resolved an issue that caused the CPU to lock up or hang during boot when authentication is
enabled (fcauthd process is started).
10. Hot Plug Issue Resolved
Fixed a potential system panic issue during PCI Hot Plug.
11. List Corruption Fixed
Corrected an issue that caused a list corruption while unloading the driver.
12. Fabric Login Issue Fixed
Resolved an issue that caused the frame to be zeroed on the wire after a fabric login FLOGI .
13. Advanced Error Reporting Issue Resolved
Added logic to stop and abort all I/Os on an HBA for an advanced error reporting (AER) uncorrectable
non-fatal error handling.
14. AER sysfs entry Point Changed
Made the AER sysfs entry point return "Operation not permitted" for OneConnect UCNAs.
15. Unsolicited CT Exchange Sequences Fixed
Fixed handling of unsolicited CT exchange sequences.
16. Clear Virtual Link Support Added
Added support for Clear Virtual Link command.
17. devloss Timeout Issue Fixed
Corrected a devloss timeout issue when multiple initiators were in the same zone.

SUSE Linux Enterprise Server 11 (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures)
Driver for Linux User Manual (1.64 MB pdf file)

Installation ...............................................................................................1
Driver Information .................................................................................................... 1
Supported Features........................................................................................... 1
New Features in this Release............................................................................ 1
Prerequisites ..................................................................................................... 2
For the lpfc Driver Kit .................................................................................. 2
Compatibility...................................................................................................... 2
Things to Know Before You Download .............................................................. 3
Known Issues .................................................................................................... 3
Installing the Driver Kit ............................................................................................ 3
Driver Kit Install Script Options.......................................................................... 4
Driver Kit Directory Structure ............................................................................. 4
Installing the Driver on Unsupported Linux Distributions.......................................... 5
Upgrading the Kernel or Applying a Distribution Service Pack or Update ................ 5
Installing the Driver Kit into an Upgraded Kernel ............................................... 5
Booting From a Non-Zero LUN Attached to an Emulex Adapter .............................. 6
Installing the HBAnyware Utility ............................................................................... 6
Uninstalling the Driver Kit .................................................................................. 7
Configuration ..........................................................................................8
Driver Configuration Methods Using modprobe and
/etc/modprobe.conf............................................................................................ 8
Temporary Configuration Method ................................................................ 8
Persistent Configuration Method ................................................................. 8
Temporary Driver Configuration by Read/Write to sysfs .................................... 9
Creating a New Ramdisk Image ...................................................................... 10
For Installed lpfc Driver Kits ...................................................................... 10
For Distribution In-Box lpfc Drivers............................................................ 10
Dynamically Adding LUNs and Targets............................................................ 10
Driver Parameters Reference Table ................................................................ 11
Using udev for Persistent Naming ................................................................... 15
Using udev to Discover Logical to Physical Mappings for sd Devices ....... 15
Configuring the System to Boot From SAN Using Persistent Names ........ 15
Using udev with st Devices ....................................................................... 16
Further Information About Persistent Names ............................................ 17
Working with Virtual Ports (vports)......................................................................... 18
Creating, Deleting and Displaying vports......................................................... 18
The mkvport.sh Script ............................................................................... 18
The rmvport.sh Script................................................................................ 19
The lsvport.sh Script ................................................................................. 19
The vport Sysfs Tree ....................................................................................... 19
Driver Version 8.2.8.14 sysfs Structure............................................................ 20
Vport sysfs Entries .................................................................................... 21
Vport Configuration Limits ............................................................................... 23
DHCHAP Authentication and Configuration ........................................................... 24
Authentication Configuration Parameters ........................................................ 25
Setting Remote and Local Passwords ............................................................. 25

SLES 11 (x86 Intel,x86-64 AMD & Intel)
HBAnyware Utility Version 4.1

Introduction.............................................................................................................. 1
Known Issues .................................................................................................... 1
Installing HBAnyware Components.......................................................................... 2
Installing the HBAnyware Utility......................................................................... 2
Installing the HBAnyware Utility with Web Launch............................................. 4
Installing the HBAnyware Utility Security Configurator ...................................... 5
Uninstalling the HBAnyware Security Configurator............................................ 6
Uninstalling HBAnyware Web Launch Only ....................................................... 7
Uninstalling the Utility Package ......................................................................... 7
Using the HBAnyware Components......................................................................... 8
Starting the HBAnyware Utility........................................................................... 8
Starting HBAnyware with Web Launch .............................................................. 8
Starting the HBAnyware Security Configurator .................................................. 8
Starting HBAnyware from the Command Line ................................................... 9
Examples of Modifications .................................................................... 9
The HBAnyware Utility Window Element Definitions ....................................... 10
The Menu Bar ........................................................................................... 11
The Toolbar ............................................................................................... 11
The Toolbar Buttons .................................................................................. 11
Sort Toolbar Buttons ........................................................................... 11
The Discovery-Tree................................................................................... 12
Discovery-Tree Icons .......................................................................... 12
Property Tabs............................................................................................ 13
Status Bar ................................................................................................. 13
Changing Management Mode ......................................................................... 13
Resetting HBAs ............................................................................................... 14
Discovering HBAs ........................................................................................... 14
Automatic Fibre Channel Discovery .......................................................... 14
Remote SAN Management Using TCP/IP Access Protocol....................... 15
Adding a Single Host .......................................................................... 15
Adding a Range of Hosts .................................................................... 16
Removing Hosts.................................................................................. 17
Configuring Discovery Settings ................................................................. 18
Sorting HBA Information.................................................................................. 19
Viewing Remote and Local HBAs.............................................................. 19
Viewing HBA Information................................................................................. 20
Viewing Discovery Information .................................................................. 20
Viewing Host Information .......................................................................... 21
The Host Information Tab.................................................................... 21
The Driver Parameters Tab................................................................. 22
Viewing General HBA Attributes ............................................................... 23
Viewing Detailed HBA Information ............................................................ 24
Viewing Fabric Information........................................................................ 26
Viewing Target Information........................................................................ 27
Viewing LUN Information........................................................................... 28
Masking and Unmasking LUNs (Windows, Solaris LPFC and
Solaris SFS)........................................................................................ 29
Viewing Port Statistics............................................................................... 31
Viewing Firmware Information ................................................................... 33
Viewing Target Mapping (Windows, Solaris LPFC and Solaris SFS)......... 34
Viewing Target Mapping (Linux) ................................................................ 35

RHEL 4.8 (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and 64-bit architectures)
HBAnyware utility 4.0a38, Application helper module 2.0.38-1

HBAnyware 4.0a38 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 4.0a38
SSC version 4.0a38
DFC Library version 80.206-1
HBAAPI version 2.1.g
Multipulse version 3.0.30-1
IOCTL Module version 2.0.36-1
Dependencies:

lpfc driver version 8.0.16.46 or later

HBAnyware requires that the lpfc driver module be installed.

HBAnyware requires a minimum screen resolution of 1024 x 768.
Installing HBAnyware:

1. Copy the applications kit tar file to a directory on the install machine
2. cd to the directory which you copied the tar file
3. Untar the file: tar -xvf tarfilename
4. cd (change directory) to the "ElxLinuxApps.." directory created by step 3
5. su to root
6. If earlier HBAnyware version currently installed, type : ./uninstall
7. Run the install script: ./install
8. When prompted, answer the following question:

Select desired mode of operation for HBAnyware

1 Local Mode : HBA's on this Platform can be managed by HBAnyware
clients on this platform only.
2 Managed Mode : HBA's on this Platform can be managed by local or
remote HBAnyware clients
3 Remote Mode : Same as '2' plus HBAnyware clients on this Platform
can manage local and remote clients.

Enter the number '1' or '2' or '3'
9. When prompted, answer the following question:

Do you want to allow user to make subsequent management mode changes
using 'set_operating_mode' script
Enter the letter 'Y' for yes or 'N' for no

10. Installation Complete: type /usr/sbin/hbanyware/hbanyware
to start GUI or type /usr/sbin/hbanyware/hbacmd list
to run script utility

RHEL 4.8 (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and 64-bit architectures)
Driver for Linux User Manual (1.53 MB pdf file) Chapter 1 Introduction
Purpose of this document................................................................ 12
Host connectivity .............................................................................. 12
Fibre Channel ..............................................................................12
Fibre Channel over Ethernet .....................................................12
EMC storage array-specific settings............................................... 13
Boot device support.......................................................................... 13
Zoning ................................................................................................ 14
Useful Linux utilities and functions............................................... 14
Chapter 2 Installation Steps
Prerequisites for first-time installation .......................................... 16
Summary of installation steps......................................................... 18
Installing the adapter ....................................................................... 20
Matching the adapter with the correct PCI slot .....................22
Chapter 3 Installing and Configuring the BIOS Settings
Verifying and updating the Emulex boot BIOS............................ 28
Verifying the correct BIOS version...........................................28
Updating the boot BIOS.............................................................29
Method One — Updating the adapter boot BIOS with
hbacmd............................................................................................... 30
Method Two – Booting from a DOS bootable diskette and
using the lp6dutil utility .................................................................. 33
Chapter 4 Installing and Configuring the Driver
Installation instructions for the Emulex v8.x-series driver......... 36
Downloading the Emulex v8.x-series adapter driver for
the v2.6.x kernel .......................................................................... 37
Installing the Emulex CNA v8.x-series driver on RHEL
5.2 and SLES 10 SP2 hosts ......................................................... 38
Installing the Emulex v8.x-series driver on SLES 9 SP1
hosts.............................................................................................. 39
Installing the Emulex v8.x-series driver on RHEL 4
hosts.............................................................................................. 42
Included Emulex driver on RHEL 4, RHEL 5, OEL 4,
OEL 5, Asianux 2.0, Asianux 3.0, SLES 9, and SLES 10 ........ 45
Uninstalling the Emulex v8.x-series driver................................... 47
Installing the Emulex HBAnywhere applications kit.................. 48
Editing the configuration files ........................................................ 51
Description of the Emulex lpfc driver parameters ................ 51
Descriptions of the Emulex parameters .................................. 52
Editing the Emulex driver parameters on hosts with
SLES 9 and SLES 10 .................................................................... 54
Editing the Emulex driver parameters on hosts with
RHEL 4 and RHEL 5 .................................................................. 55
Editing the Emulex driver parameters on hosts with
Asianux 2.0 and Asianux 3.0..................................................... 56
Editing the Emulex driver parameters on hosts with
OEL 4 and OEL 5 ........................................................................ 57
Exercising the Emulex v8.x-series device driver.......................... 58
Loading and unloading the Emulex v8.x-series driver......... 58
Target information exported to the /proc filesystem ........... 59
Dynamically modifying the driver and device
information exported to the /sys filesystem.......................... 59

RHEL 4.8 (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and 64-bit architectures)
HBAnyware Utility Version 4.0 Introduction.............................................................................................................. 1
Known Issues .................................................................................................... 1
Installing HBAnyware Components.......................................................................... 2
Installing the HBAnyware Utility......................................................................... 2
Installing the HBAnyware Utility with Web Launch............................................. 4
Installing the HBAnyware Utility Security Configurator ...................................... 5
Uninstalling the HBAnyware Security Configurator............................................ 6
Uninstalling HBAnyware Web Launch Only ....................................................... 7
Uninstalling the Utility Package ......................................................................... 7
Using the HBAnyware Components......................................................................... 8
Starting the HBAnyware Utility........................................................................... 8
Starting HBAnyware with Web Launch .............................................................. 8
Starting the HBAnyware Security Configurator .................................................. 8
Starting HBAnyware from the Command Line ................................................... 9
Examples of Modifications .................................................................... 9
The HBAnyware Utility Window Element Definitions ....................................... 10
The Menu Bar ........................................................................................... 11
The Toolbar ............................................................................................... 11
The Toolbar Buttons .................................................................................. 11
Sort Toolbar Buttons ........................................................................... 11
The Discovery-Tree................................................................................... 12
Discovery-Tree Icons .......................................................................... 12
Property Tabs............................................................................................ 13
Status Bar ................................................................................................. 13
Changing Management Mode ......................................................................... 13
Resetting HBAs ............................................................................................... 14
Discovering HBAs ........................................................................................... 14
Automatic Fibre Channel Discovery .......................................................... 14
Remote SAN Management Using TCP/IP Access Protocol....................... 15
Adding a Single Host .......................................................................... 15
Adding a Range of Hosts .................................................................... 16
Removing Hosts.................................................................................. 17
Configuring Discovery Settings ................................................................. 18
Sorting HBA Information.................................................................................. 19
Viewing Remote and Local HBAs.............................................................. 19
Viewing HBA Information................................................................................. 20
Viewing Discovery Information .................................................................. 20
Viewing Host Information .......................................................................... 21
The Host Information Tab.................................................................... 21
The Driver Parameters Tab................................................................. 22
Viewing General HBA Attributes ............................................................... 23
Viewing Detailed HBA Information ............................................................ 24
Viewing Fabric Information........................................................................ 26
Viewing Target Information........................................................................ 27
Viewing LUN Information........................................................................... 28
Masking and Unmasking LUNs (Windows, Solaris LPFC and
Solaris SFS)........................................................................................ 29
Viewing Port Statistics............................................................................... 31
Viewing Firmware Information ................................................................... 33
Viewing Target Mapping (Windows, Solaris LPFC and Solaris SFS)......... 34
Viewing Target Mapping (Linux) ................................................................ 35

Asianux 2.0 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures)
HBAnyware utility 4.0a38, Application helper module 2.0.39-1 (176 MB tar file)
Note: This kit does not support Intel Itanium2 architecture. For Intel Itanium2 architecture support, download the corresponding core (CLI) applications kit.

HBAnyware 4.0a38 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 4.0a38
SSC version 4.0a38
DFC Library version 80.206-1
HBAAPI version 2.1.g
Multipulse version 3.0.30-1
IOCTL Module version 2.0.39-1
Dependencies:

lpfc driver version 8.0.16.47 or later

HBAnyware requires that the lpfc driver module be installed.

HBAnyware requires a minimum screen resolution of 1024 x 768.
Installing HBAnyware:

1. Copy the applications kit tar file to a directory on the install machine
2. cd to the directory which you copied the tar file
3. Untar the file: tar -xvf tarfilename
4. cd (change directory) to the "ElxLinuxApps.." directory created by step 3
5. su to root
6. If earlier HBAnyware version currently installed, type : ./uninstall
7. Run the install script: ./install
8. When prompted, answer the following question:

Select desired mode of operation for HBAnyware

1 Local Mode : HBA's on this Platform can be managed by HBAnyware
clients on this platform only.
2 Managed Mode : HBA's on this Platform can be managed by local or
remote HBAnyware clients
3 Remote Mode : Same as '2' plus HBAnyware clients on this Platform
can manage local and remote clients.

Enter the number '1' or '2' or '3'
9. When prompted, answer the following question:

Do you want to allow user to make subsequent management mode changes
using 'set_operating_mode' script
Enter the letter 'Y' for yes or 'N' for no

10. Installation Complete: type /usr/sbin/hbanyware/hbanyware
to start GUI or type /usr/sbin/hbanyware/hbacmd list
to run script utility

Asianux 2.0 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures)
Driver for Linux User Manual

Installation ...............................................................................................1
Driver Information .................................................................................................... 1
Supported Features........................................................................................... 1
New Features in this Release............................................................................ 1
Prerequisites ..................................................................................................... 1
For the LPFC Driver Kit............................................................................... 1
Compatibility...................................................................................................... 2
Things to Know Before You Download .............................................................. 2
Known Issues.................................................................................................... 2
Installing the Driver Kit ............................................................................................ 2
Driver Kit Install Script Options.......................................................................... 3
Driver Kit Directory Structure ............................................................................. 3
Installing the Driver on Unsupported Linux Distributions.......................................... 3
Upgrading the Kernel or Applying a Distribution Service Pack or Update ................ 4
Installing the Driver Kit into an Upgraded Kernel ............................................... 4
Installing the Utilities and the Application Helper Module......................................... 4
Prerequisites ............................................................................................... 4
Procedure ................................................................................................... 5
Utilities Directory Structure.......................................................................... 5
Installing the HBAnyware Utility with Web Launch............................................. 6
Prerequisites ............................................................................................... 6
Procedure ................................................................................................... 6
Installing the HBAnyware Security Configurator ................................................ 7
Prerequisites ............................................................................................... 7
Procedure ................................................................................................... 7
Installing the HBAnyware Utility and the Application Helper Module
using the Upgrade Kernel Option ..................................................................... 7
Prerequisites ............................................................................................... 7
Procedure ................................................................................................... 7
Uninstalling the Driver Kit .................................................................................. 8
Uninstalling a Previous Application Helper Module
(Stand Alone Kit) ............................................................................................... 9
Uninstalling the Utilities ........................................................................................... 9
Uninstalling the HBAnyware Security Configurator............................................ 9
Uninstalling HBAnyware Web Launch only...................................................... 10
Uninstalling the HBAnyware Utility and the Application Helper Module ........... 10
Configuration ........................................................................................11
Driver Configuration Methods using modprobe and
/etc/modprobe.conf.......................................................................................... 11
Temporary Configuration Method .............................................................. 11
Persistent Configuration Method ............................................................... 11
Creating a New Ramdisk Image ...................................................................... 12
For Installed LPFC Driver Kits................................................................... 12
For Distribution In-Box LPFC Drivers ........................................................ 13
Temporary Driver Configuration by Read/Write to sysfs .................................. 13
Dynamically Adding LUNs and Targets............................................................ 14
Driver Parameters Reference Table ................................................................ 14
Using udev for Persistent Naming ................................................................... 17

Asianux 2.0 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures)
HBAnyware Utility Version 4.0 Introduction.............................................................................................................. 1
Known Issues .................................................................................................... 1
Installing HBAnyware Components.......................................................................... 2
Installing the HBAnyware Utility......................................................................... 2
Installing the HBAnyware Utility with Web Launch............................................. 4
Installing the HBAnyware Utility Security Configurator ...................................... 5
Uninstalling the HBAnyware Security Configurator............................................ 6
Uninstalling HBAnyware Web Launch Only ....................................................... 7
Uninstalling the Utility Package ......................................................................... 7
Using the HBAnyware Components......................................................................... 8
Starting the HBAnyware Utility........................................................................... 8
Starting HBAnyware with Web Launch .............................................................. 8
Starting the HBAnyware Security Configurator .................................................. 8
Starting HBAnyware from the Command Line ................................................... 9
Examples of Modifications .................................................................... 9
The HBAnyware Utility Window Element Definitions ....................................... 10
The Menu Bar ........................................................................................... 11
The Toolbar ............................................................................................... 11
The Toolbar Buttons .................................................................................. 11
Sort Toolbar Buttons ........................................................................... 11
The Discovery-Tree................................................................................... 12
Discovery-Tree Icons .......................................................................... 12
Property Tabs............................................................................................ 13
Status Bar ................................................................................................. 13
Changing Management Mode ......................................................................... 13
Resetting HBAs ............................................................................................... 14
Discovering HBAs ........................................................................................... 14
Automatic Fibre Channel Discovery .......................................................... 14
Remote SAN Management Using TCP/IP Access Protocol....................... 15
Adding a Single Host .......................................................................... 15
Adding a Range of Hosts .................................................................... 16
Removing Hosts.................................................................................. 17
Configuring Discovery Settings ................................................................. 18
Sorting HBA Information.................................................................................. 19
Viewing Remote and Local HBAs.............................................................. 19
Viewing HBA Information................................................................................. 20
Viewing Discovery Information .................................................................. 20
Viewing Host Information .......................................................................... 21
The Host Information Tab.................................................................... 21
The Driver Parameters Tab................................................................. 22
Viewing General HBA Attributes ............................................................... 23
Viewing Detailed HBA Information ............................................................ 24
Viewing Fabric Information........................................................................ 26
Viewing Target Information........................................................................ 27
Viewing LUN Information........................................................................... 28
Masking and Unmasking LUNs (Windows, Solaris LPFC and
Solaris SFS)........................................................................................ 29
Viewing Port Statistics............................................................................... 31
Viewing Firmware Information ................................................................... 33
Viewing Target Mapping (Windows, Solaris LPFC and Solaris SFS)......... 34
Viewing Target Mapping (Linux) ................................................................ 35

Red Hat Enterprise Linux 5.3, SUSE SLES 11 (x86 Intel,x86-64 AMD & Intel architectures)
Base driver and install script

1. System Requirements
1.1 Red Hat Enterprise Linux 'kernel-devel' Package Requirement
1.2 SuSE Linux Enterprise Server 'kernel-source' Package Requirement
2. Description of Install Procedure
3. Known Issues
3.1 PCI Hot Plug Support for applications
3.1.1 Observed problem
3.1.2 Workaround
3.2 Deletion of Vports/PCI Hot Unplug
3.2.1 Observed Problem
3.2.2 Background
3.3 lspci utility displays "Unknown Device" for LPe12000 HBAs
3.3.1 Observed Problem
3.3.2 Background
3.4 Speed of LPe12000 HBA (8Gb) is incorrectly displayed by HBAnyware
3.4.1 Observed Problem
3.4.2 Background
3.5 Port disabled on system boot or HBA reset with authentication enabled
3.5.1 Observed Problem
3.5.2 Workaround
3.6 LILO Boot Loader is not supported - i386 and x86_64 architectures
3.6.1 Observed Problem
3.6.2 Background
3.7 Order of lpfc module in initrd module list
3.7.1 Observed Problem
3.7.2 Workaround
3.8 Devloss timeout after swapping ports
3.8.1 Observed Problem
3.8.2 Workaround
3.9 Suspend to disk and Resume support
3.9.1 Observed Problem
3.9.2 Background
3.10 Deleting vports while devices are in use
3.10.1 Observed Problem
3.10.2 Workaround

----------------------------------------------------------------------

1. System Requirements

The following distributions of Linux are supported by the Emulex
LPFC driver:

Red Hat Enterprise Linux 5
SuSE Linux Enterprise Server 10 (SP1 or higher)

1.1 Red Hat Enterprise Linux 'kernel-devel' Package Requirement

For Red Hat Enterprise Linux installations, the -devel package
which matches the kernel package with the same version as the
currently running kernel must be installed for the LPFC driver
build to succeed. For example, a system with the 2.6.18-7 kernel
would need the kernel-devel-2.6.18-7 package.

Red Hat Enterprise Linux 5.3, SUSE SLES 11 (x86 Intel,x86-64 AMD & Intel architectures)
HBAnyware utility 4.1a36

HBAnyware 4.1a36 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 4.1a36
SSC version 4.1a36
DFC Library version 3.0.35-1-1
HBAAPI version 2.1.g
FCAUTHD version 1.19-1-1
Multipulse version 3.0.30-1
Dependencies:

lpfc driver version 8.2.0.33.3p or later

HBAnyware requires that the lpfc driver module be installed.

HBAnyware requires a minimum screen resolution of 1024 x 768.
Installing HBAnyware:

1. Copy the applications kit tar file to a directory on the install machine
2. cd to the directory which you copied the tar file
3. Untar the file: tar -xvf tarfilename
4. cd (change directory) to the "ElxLinuxApps.." directory created by step 3
5. su to root
6. If earlier HBAnyware version currently installed, type : ./uninstall
7. Run the install script: ./install
8. When prompted, answer the following question:

Select desired mode of operation for HBAnyware

1 Local Mode : HBA's on this Platform can be managed by HBAnyware
clients on this platform only.
2 Managed Mode : HBA's on this Platform can be managed by local or
remote HBAnyware clients
3 Remote Mode : Same as '2' plus HBAnyware clients on this Platform
can manage local and remote clients.

Enter the number '1' or '2' or '3'
9. When prompted, answer the following question:

Do you want to allow user to make subsequent management mode changes
using 'set_operating_mode' script
Enter the letter 'Y' for yes or 'N' for no

10. Installation Complete: type /usr/sbin/hbanyware/hbanyware
to start GUI or type /usr/sbin/hbanyware/hbacmd list
to run script utility

Red Hat Enterprise Linux 5.3, SUSE SLES 11 (x86 Intel,x86-64 AMD & Intel architectures)
Driver for Linux User Manual (1.53 MB pdf file) Chapter 1 Introduction
Purpose of this document................................................................ 12
Host connectivity .............................................................................. 12
Fibre Channel ..............................................................................12
Fibre Channel over Ethernet .....................................................12
EMC storage array-specific settings............................................... 13
Boot device support.......................................................................... 13
Zoning ................................................................................................ 14
Useful Linux utilities and functions............................................... 14
Chapter 2 Installation Steps
Prerequisites for first-time installation .......................................... 16
Summary of installation steps......................................................... 18
Installing the adapter ....................................................................... 20
Matching the adapter with the correct PCI slot .....................22
Chapter 3 Installing and Configuring the BIOS Settings
Verifying and updating the Emulex boot BIOS............................ 28
Verifying the correct BIOS version...........................................28
Updating the boot BIOS.............................................................29
Method One — Updating the adapter boot BIOS with
hbacmd............................................................................................... 30
Method Two – Booting from a DOS bootable diskette and
using the lp6dutil utility .................................................................. 33
Chapter 4 Installing and Configuring the Driver
Installation instructions for the Emulex v8.x-series driver......... 36
Downloading the Emulex v8.x-series adapter driver for
the v2.6.x kernel .......................................................................... 37
Installing the Emulex CNA v8.x-series driver on RHEL
5.2 and SLES 10 SP2 hosts ......................................................... 38
Installing the Emulex v8.x-series driver on SLES 9 SP1
hosts.............................................................................................. 39
Installing the Emulex v8.x-series driver on RHEL 4
hosts.............................................................................................. 42
Included Emulex driver on RHEL 4, RHEL 5, OEL 4,
OEL 5, Asianux 2.0, Asianux 3.0, SLES 9, and SLES 10 ........ 45
Uninstalling the Emulex v8.x-series driver................................... 47
Installing the Emulex HBAnywhere applications kit.................. 48
Editing the configuration files ........................................................ 51
Description of the Emulex lpfc driver parameters ................ 51
Descriptions of the Emulex parameters .................................. 52
Editing the Emulex driver parameters on hosts with
SLES 9 and SLES 10 .................................................................... 54
Editing the Emulex driver parameters on hosts with
RHEL 4 and RHEL 5 .................................................................. 55
Editing the Emulex driver parameters on hosts with
Asianux 2.0 and Asianux 3.0..................................................... 56
Editing the Emulex driver parameters on hosts with
OEL 4 and OEL 5 ........................................................................ 57
Exercising the Emulex v8.x-series device driver.......................... 58
Loading and unloading the Emulex v8.x-series driver......... 58
Target information exported to the /proc filesystem ........... 59
Dynamically modifying the driver and device
information exported to the /sys filesystem.......................... 59

Red Hat Enterprise Linux 5.3, SUSE SLES 11 (x86 Intel,x86-64 AMD & Intel architectures)
HBAnyware Utility Version 4.1 Introduction.............................................................................................................. 1
Known Issues .................................................................................................... 1
Installing HBAnyware Components.......................................................................... 2
Installing the HBAnyware Utility......................................................................... 2
Installing the HBAnyware Utility with Web Launch............................................. 4
Installing the HBAnyware Utility Security Configurator ...................................... 5
Uninstalling the HBAnyware Security Configurator............................................ 6
Uninstalling HBAnyware Web Launch Only ....................................................... 7
Uninstalling the Utility Package ......................................................................... 7
Using the HBAnyware Components......................................................................... 8
Starting the HBAnyware Utility........................................................................... 8
Starting HBAnyware with Web Launch .............................................................. 8
Starting the HBAnyware Security Configurator .................................................. 8
Starting HBAnyware from the Command Line ................................................... 9
Examples of Modifications .................................................................... 9
The HBAnyware Utility Window Element Definitions ....................................... 10
The Menu Bar ........................................................................................... 11
The Toolbar ............................................................................................... 11
The Toolbar Buttons .................................................................................. 11
Sort Toolbar Buttons ........................................................................... 11
The Discovery-Tree................................................................................... 12
Discovery-Tree Icons .......................................................................... 12
Property Tabs............................................................................................ 13
Status Bar ................................................................................................. 13
Changing Management Mode ......................................................................... 13
Resetting HBAs ............................................................................................... 14
Discovering HBAs ........................................................................................... 14
Automatic Fibre Channel Discovery .......................................................... 14
Remote SAN Management Using TCP/IP Access Protocol....................... 15
Adding a Single Host .......................................................................... 15
Adding a Range of Hosts .................................................................... 16
Removing Hosts.................................................................................. 17
Configuring Discovery Settings ................................................................. 18
Sorting HBA Information.................................................................................. 19
Viewing Remote and Local HBAs.............................................................. 19
Viewing HBA Information................................................................................. 20
Viewing Discovery Information .................................................................. 20
Viewing Host Information .......................................................................... 21
The Host Information Tab.................................................................... 21
The Driver Parameters Tab................................................................. 22
Viewing General HBA Attributes ............................................................... 23
Viewing Detailed HBA Information ............................................................ 24
Viewing Fabric Information........................................................................ 26
Viewing Target Information........................................................................ 27
Viewing LUN Information........................................................................... 28
Masking and Unmasking LUNs (Windows, Solaris LPFC and
Solaris SFS)........................................................................................ 29
Viewing Port Statistics............................................................................... 31
Viewing Firmware Information ................................................................... 33
Viewing Target Mapping (Windows, Solaris LPFC and Solaris SFS)......... 34
Viewing Target Mapping (Linux) ................................................................ 35

SLES 11 (x86 Intel,x86-64 AMD & Intel)
Base driver and install script (333 KB gz file)

1. System Requirements
1.1 SuSE Linux Enterprise Server 'kernel-source' Package Requirement
2. Description of Install Procedure
3. Known Issues
3.1 PCI Hot Plug Support for applications
3.1.1 Observed problem
3.1.2 Workaround
3.2 Deletion of Vports/PCI Hot Unplug
3.2.1 Observed Problem
3.2.2 Background
3.3 Port disabled on system boot or HBA reset with authentication enabled
3.3.1 Observed Problem
3.3.2 Workaround
3.4 LILO Boot Loader is not supported - i386 and x86_64 architectures
3.4.1 Observed Problem
3.4.2 Background
3.5 Order of lpfc module in initrd module list
3.5.1 Observed Problem
3.5.2 Workaround
3.6 Devloss timeout after swapping ports
3.6.1 Observed Problem
3.6.2 Workaround
3.7 Deleting vports while devices are in use
3.7.1 Observed Problem
3.7.2 Workaround
3.8 Support of 4Gb/s HBAs in Direct I/O virtualized environments
3.8.1 Observed Problem
3.8.2 Workaround
----------------------------------------------------------------------

1. System Requirements

The following distributions of Linux are supported by the Emulex
LPFC driver:

SuSE Linux Enterprise Server 11

1.1 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 driver build to succeed. For example, a
system with the 2.6.27-rc7-12-default kernel would need the
kernel-source-2.6.27-12.1 package.

SUSE Linux Enterprise Server 11 (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures)
New features, fixed issues and known issues in the driver (31 KB)

Release Notes
Date: March 2009 Product: Driver for Linux Version: 8.2.8.14 This document describes the new features, resolved known issues and current known issues associated with this driver build release. For the latest product documentation, go to www.Emulex.com. If you have any questions or require additional information, contact an authorized Emulex Corporation technical support representative.
New Features Driver for Linux 8.2.8.14
1. Supports the LP21000 and LP21002 FCoE adapters. (10 Gb/s capable) 2. Supports the LPe1250, LPe1252, LPe12000 and LPe12002 adapters. (2, 4 and 8 Gb/s capable) 3. Supports the latest HBAnyware utility version 4.1 as part of the master kit. Refer to the HBAnyware Utility User Manual for more information. 4. Supports SuSE Linux Enterprise Server 11. (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and PowerPC 64-bit architectures) 5. Adds interfaces via the sysfs file system to update speed and topology parameters without requiring link bounce. 6. Supports Power Management Suspend/Resume operations. 7.
Resolved Issues in Driver for Linux 8.2.8.14
Supports MSI-X interrupt handling.
Known Issues in Driver for Linux 8.2.8.14
There are no resolved issues in this driver version.
1. PCI Hot Plug may cause applications to malfunction Performing a PCI Hot Plug may cause the HBAnyware utilities or third party applications that use the Emulex libraries (i.e. HBAAPI) to behave unpredictably or malfunction. Workaround: 1. Stop all applications that are accessing LPFC's HBAAPI interface (HBAnyware utilities or third party applications) before performing PCI Hot Plug of an LPFC HBA. Use the following command to stop the HBAnyware application: #/usr/sbin/hbanyware/stop_hbanyware 2. Perform the PCI Hot Plug of the HBA. 3. Restart the application.

SLES 11 (x86 Intel,x86-64 AMD & Intel)
HBAnyware utility 4.1a26 (170 MB tar file)

HBAnyware 4.1a36 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 4.1a36
SSC version 4.1a36
DFC Library version 3.1.12-1-1
HBAAPI version 2.1.g
FCAUTHD version 2.5-1-1

Dependencies:

lpfc driver version 8.2.8.14 or later

HBAnyware requires that the lpfc driver module be installed.

HBAnyware requires a minimum screen resolution of 1024 x 768.
Installing HBAnyware:

1. Copy the applications kit tar file to a directory on the install machine
2. cd to the directory which you copied the tar file
3. Untar the file: tar -xvf tarfilename
4. cd (change directory) to the "ElxLinuxApps.." directory created by step 3
5. su to root
6. If earlier HBAnyware version currently installed, type : ./uninstall
7. Run the install script: ./install
8. When prompted, answer the following question:

Select desired mode of operation for HBAnyware

1 Local Mode : HBA's on this Platform can be managed by HBAnyware
clients on this platform only.
2 Managed Mode : HBA's on this Platform can be managed by local or
remote HBAnyware clients
3 Remote Mode : Same as '2' plus HBAnyware clients on this Platform
can manage local and remote clients.

Enter the number '1' or '2' or '3'
9. When prompted, answer the following question:

Do you want to allow user to make subsequent management mode changes
using 'set_operating_mode' script
Enter the letter 'Y' for yes or 'N' for no

10. Installation Complete: type /usr/sbin/hbanyware/hbanyware
to start GUI or type /usr/sbin/hbanyware/hbacmd list
to run script utility

SLES 11 (x86 Intel,x86-64 AMD & Intel)
New features, fixed issues and known issues in the HBAnyware utility

Release Notes
Date: January 2010
Product: Driver for Linux
Version: FC and FCoE version 8.2.0.63
NIC version 2.101.374.0
iSCSI version 2.101.374.0

New Features in the Driver for Linux
1. Supports the OCe1010x OneConnect Universal Converged Network Adapters (CNAs).
2. Supports the OneCommand Manager application version 5.0. Refer to the OneCommand Manager
application User Manual for more information.
3. Adds PCI ID support for the LPSe12002-ML1-E EmulexSecure Fibre Channel Adapter.
4. Adds support for Advanced Error Reporting (AER) for PCIe HBAs.
Resolved Issues in the Driver for Linux
1. Multipath Package Issues Fixed
Corrected issues with the multipath package functions with the OneConnect UCNA.
2. FCF Failures Addressed
Resolved various FCF failures.
3. Corrected Adapter Reset
Corrected adapter reset and offline/online stress test failing with I/O errors.
4. Multiple Spurious Interrupts Corrected
Required OneConnect UCNA to set up and use single FCP EQ only under INTx interrupt mode. Changed
lpfc_use_msi module parameter to use INTx mode (not MSI) by default. This prevents multiple spurious
interrupts from the firmware.
5. Extended Error Handling Issue Resolved
Blocked all SCSI I/O requests from the midlayer until target rediscovery during Extended Error Handling
EEH.
6. VPort Log Out Issue Corrected
Corrected an issue that prevented a VPort to log out if deleted.
7. mbox sysfs Attribute Corrected
Corrected an issue that resulted in the mbox sysfs attribute smaller than the mailbox extension size.
8. LUN Panic Fixed
Fixed a potential panic if LUNs were unmapped.
9. CPU Lockup Fixed
Resolved an issue that caused the CPU to lock up or hang during boot when authentication is
enabled (fcauthd process is started).
10. Hot Plug Issue Resolved
Fixed a potential system panic issue during PCI Hot Plug.
11. List Corruption Fixed
Corrected an issue that caused a list corruption while unloading the driver.
12. Fabric Login Issue Fixed
Resolved an issue that caused the frame to be zeroed on the wire after a fabric login FLOGI .
13. Advanced Error Reporting Issue Resolved
Added logic to stop and abort all I/Os on an HBA for an advanced error reporting (AER) uncorrectable
non-fatal error handling.
14. AER sysfs entry Point Changed
Made the AER sysfs entry point return "Operation not permitted" for OneConnect UCNAs.
15. Unsolicited CT Exchange Sequences Fixed
Fixed handling of unsolicited CT exchange sequences.
16. Clear Virtual Link Support Added
Added support for Clear Virtual Link command.
17. devloss Timeout Issue Fixed
Corrected a devloss timeout issue when multiple initiators were in the same zone.

SUSE Linux Enterprise Server 11 (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures)
Driver for Linux User Manual (1.64 MB pdf file)

Installation ...............................................................................................1
Driver Information .................................................................................................... 1
Supported Features........................................................................................... 1
New Features in this Release............................................................................ 1
Prerequisites ..................................................................................................... 2
For the lpfc Driver Kit .................................................................................. 2
Compatibility...................................................................................................... 2
Things to Know Before You Download .............................................................. 3
Known Issues .................................................................................................... 3
Installing the Driver Kit ............................................................................................ 3
Driver Kit Install Script Options.......................................................................... 4
Driver Kit Directory Structure ............................................................................. 4
Installing the Driver on Unsupported Linux Distributions.......................................... 5
Upgrading the Kernel or Applying a Distribution Service Pack or Update ................ 5
Installing the Driver Kit into an Upgraded Kernel ............................................... 5
Booting From a Non-Zero LUN Attached to an Emulex Adapter .............................. 6
Installing the HBAnyware Utility ............................................................................... 6
Uninstalling the Driver Kit .................................................................................. 7
Configuration ..........................................................................................8
Driver Configuration Methods Using modprobe and
/etc/modprobe.conf............................................................................................ 8
Temporary Configuration Method ................................................................ 8
Persistent Configuration Method ................................................................. 8
Temporary Driver Configuration by Read/Write to sysfs .................................... 9
Creating a New Ramdisk Image ...................................................................... 10
For Installed lpfc Driver Kits ...................................................................... 10
For Distribution In-Box lpfc Drivers............................................................ 10
Dynamically Adding LUNs and Targets............................................................ 10
Driver Parameters Reference Table ................................................................ 11
Using udev for Persistent Naming ................................................................... 15
Using udev to Discover Logical to Physical Mappings for sd Devices ....... 15
Configuring the System to Boot From SAN Using Persistent Names ........ 15
Using udev with st Devices ....................................................................... 16
Further Information About Persistent Names ............................................ 17
Working with Virtual Ports (vports)......................................................................... 18
Creating, Deleting and Displaying vports......................................................... 18
The mkvport.sh Script ............................................................................... 18
The rmvport.sh Script................................................................................ 19
The lsvport.sh Script ................................................................................. 19
The vport Sysfs Tree ....................................................................................... 19
Driver Version 8.2.8.14 sysfs Structure............................................................ 20
Vport sysfs Entries .................................................................................... 21
Vport Configuration Limits ............................................................................... 23
DHCHAP Authentication and Configuration ........................................................... 24
Authentication Configuration Parameters ........................................................ 25
Setting Remote and Local Passwords ............................................................. 25

SLES 11 (x86 Intel,x86-64 AMD & Intel)
HBAnyware Utility Version 4.1

Introduction.............................................................................................................. 1
Known Issues .................................................................................................... 1
Installing HBAnyware Components.......................................................................... 2
Installing the HBAnyware Utility......................................................................... 2
Installing the HBAnyware Utility with Web Launch............................................. 4
Installing the HBAnyware Utility Security Configurator ...................................... 5
Uninstalling the HBAnyware Security Configurator............................................ 6
Uninstalling HBAnyware Web Launch Only ....................................................... 7
Uninstalling the Utility Package ......................................................................... 7
Using the HBAnyware Components......................................................................... 8
Starting the HBAnyware Utility........................................................................... 8
Starting HBAnyware with Web Launch .............................................................. 8
Starting the HBAnyware Security Configurator .................................................. 8
Starting HBAnyware from the Command Line ................................................... 9
Examples of Modifications .................................................................... 9
The HBAnyware Utility Window Element Definitions ....................................... 10
The Menu Bar ........................................................................................... 11
The Toolbar ............................................................................................... 11
The Toolbar Buttons .................................................................................. 11
Sort Toolbar Buttons ........................................................................... 11
The Discovery-Tree................................................................................... 12
Discovery-Tree Icons .......................................................................... 12
Property Tabs............................................................................................ 13
Status Bar ................................................................................................. 13
Changing Management Mode ......................................................................... 13
Resetting HBAs ............................................................................................... 14
Discovering HBAs ........................................................................................... 14
Automatic Fibre Channel Discovery .......................................................... 14
Remote SAN Management Using TCP/IP Access Protocol....................... 15
Adding a Single Host .......................................................................... 15
Adding a Range of Hosts .................................................................... 16
Removing Hosts.................................................................................. 17
Configuring Discovery Settings ................................................................. 18
Sorting HBA Information.................................................................................. 19
Viewing Remote and Local HBAs.............................................................. 19
Viewing HBA Information................................................................................. 20
Viewing Discovery Information .................................................................. 20
Viewing Host Information .......................................................................... 21
The Host Information Tab.................................................................... 21
The Driver Parameters Tab................................................................. 22
Viewing General HBA Attributes ............................................................... 23
Viewing Detailed HBA Information ............................................................ 24
Viewing Fabric Information........................................................................ 26
Viewing Target Information........................................................................ 27
Viewing LUN Information........................................................................... 28
Masking and Unmasking LUNs (Windows, Solaris LPFC and
Solaris SFS)........................................................................................ 29
Viewing Port Statistics............................................................................... 31
Viewing Firmware Information ................................................................... 33
Viewing Target Mapping (Windows, Solaris LPFC and Solaris SFS)......... 34
Viewing Target Mapping (Linux) ................................................................ 35

RHEL 4.8 (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and 64-bit architectures)
HBAnyware utility 4.0a38, Application helper module 2.0.38-1

HBAnyware 4.0a38 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 4.0a38
SSC version 4.0a38
DFC Library version 80.206-1
HBAAPI version 2.1.g
Multipulse version 3.0.30-1
IOCTL Module version 2.0.36-1
Dependencies:

lpfc driver version 8.0.16.46 or later

HBAnyware requires that the lpfc driver module be installed.

HBAnyware requires a minimum screen resolution of 1024 x 768.
Installing HBAnyware:

1. Copy the applications kit tar file to a directory on the install machine
2. cd to the directory which you copied the tar file
3. Untar the file: tar -xvf tarfilename
4. cd (change directory) to the "ElxLinuxApps.." directory created by step 3
5. su to root
6. If earlier HBAnyware version currently installed, type : ./uninstall
7. Run the install script: ./install
8. When prompted, answer the following question:

Select desired mode of operation for HBAnyware

1 Local Mode : HBA's on this Platform can be managed by HBAnyware
clients on this platform only.
2 Managed Mode : HBA's on this Platform can be managed by local or
remote HBAnyware clients
3 Remote Mode : Same as '2' plus HBAnyware clients on this Platform
can manage local and remote clients.

Enter the number '1' or '2' or '3'
9. When prompted, answer the following question:

Do you want to allow user to make subsequent management mode changes
using 'set_operating_mode' script
Enter the letter 'Y' for yes or 'N' for no

10. Installation Complete: type /usr/sbin/hbanyware/hbanyware
to start GUI or type /usr/sbin/hbanyware/hbacmd list
to run script utility

RHEL 4.8 (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and 64-bit architectures)
Driver for Linux User Manual (1.53 MB pdf file) Chapter 1 Introduction
Purpose of this document................................................................ 12
Host connectivity .............................................................................. 12
Fibre Channel ..............................................................................12
Fibre Channel over Ethernet .....................................................12
EMC storage array-specific settings............................................... 13
Boot device support.......................................................................... 13
Zoning ................................................................................................ 14
Useful Linux utilities and functions............................................... 14
Chapter 2 Installation Steps
Prerequisites for first-time installation .......................................... 16
Summary of installation steps......................................................... 18
Installing the adapter ....................................................................... 20
Matching the adapter with the correct PCI slot .....................22
Chapter 3 Installing and Configuring the BIOS Settings
Verifying and updating the Emulex boot BIOS............................ 28
Verifying the correct BIOS version...........................................28
Updating the boot BIOS.............................................................29
Method One — Updating the adapter boot BIOS with
hbacmd............................................................................................... 30
Method Two – Booting from a DOS bootable diskette and
using the lp6dutil utility .................................................................. 33
Chapter 4 Installing and Configuring the Driver
Installation instructions for the Emulex v8.x-series driver......... 36
Downloading the Emulex v8.x-series adapter driver for
the v2.6.x kernel .......................................................................... 37
Installing the Emulex CNA v8.x-series driver on RHEL
5.2 and SLES 10 SP2 hosts ......................................................... 38
Installing the Emulex v8.x-series driver on SLES 9 SP1
hosts.............................................................................................. 39
Installing the Emulex v8.x-series driver on RHEL 4
hosts.............................................................................................. 42
Included Emulex driver on RHEL 4, RHEL 5, OEL 4,
OEL 5, Asianux 2.0, Asianux 3.0, SLES 9, and SLES 10 ........ 45
Uninstalling the Emulex v8.x-series driver................................... 47
Installing the Emulex HBAnywhere applications kit.................. 48
Editing the configuration files ........................................................ 51
Description of the Emulex lpfc driver parameters ................ 51
Descriptions of the Emulex parameters .................................. 52
Editing the Emulex driver parameters on hosts with
SLES 9 and SLES 10 .................................................................... 54
Editing the Emulex driver parameters on hosts with
RHEL 4 and RHEL 5 .................................................................. 55
Editing the Emulex driver parameters on hosts with
Asianux 2.0 and Asianux 3.0..................................................... 56
Editing the Emulex driver parameters on hosts with
OEL 4 and OEL 5 ........................................................................ 57
Exercising the Emulex v8.x-series device driver.......................... 58
Loading and unloading the Emulex v8.x-series driver......... 58
Target information exported to the /proc filesystem ........... 59
Dynamically modifying the driver and device
information exported to the /sys filesystem.......................... 59

RHEL 4.8 (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and 64-bit architectures)
HBAnyware Utility Version 4.0 Introduction.............................................................................................................. 1
Known Issues .................................................................................................... 1
Installing HBAnyware Components.......................................................................... 2
Installing the HBAnyware Utility......................................................................... 2
Installing the HBAnyware Utility with Web Launch............................................. 4
Installing the HBAnyware Utility Security Configurator ...................................... 5
Uninstalling the HBAnyware Security Configurator............................................ 6
Uninstalling HBAnyware Web Launch Only ....................................................... 7
Uninstalling the Utility Package ......................................................................... 7
Using the HBAnyware Components......................................................................... 8
Starting the HBAnyware Utility........................................................................... 8
Starting HBAnyware with Web Launch .............................................................. 8
Starting the HBAnyware Security Configurator .................................................. 8
Starting HBAnyware from the Command Line ................................................... 9
Examples of Modifications .................................................................... 9
The HBAnyware Utility Window Element Definitions ....................................... 10
The Menu Bar ........................................................................................... 11
The Toolbar ............................................................................................... 11
The Toolbar Buttons .................................................................................. 11
Sort Toolbar Buttons ........................................................................... 11
The Discovery-Tree................................................................................... 12
Discovery-Tree Icons .......................................................................... 12
Property Tabs............................................................................................ 13
Status Bar ................................................................................................. 13
Changing Management Mode ......................................................................... 13
Resetting HBAs ............................................................................................... 14
Discovering HBAs ........................................................................................... 14
Automatic Fibre Channel Discovery .......................................................... 14
Remote SAN Management Using TCP/IP Access Protocol....................... 15
Adding a Single Host .......................................................................... 15
Adding a Range of Hosts .................................................................... 16
Removing Hosts.................................................................................. 17
Configuring Discovery Settings ................................................................. 18
Sorting HBA Information.................................................................................. 19
Viewing Remote and Local HBAs.............................................................. 19
Viewing HBA Information................................................................................. 20
Viewing Discovery Information .................................................................. 20
Viewing Host Information .......................................................................... 21
The Host Information Tab.................................................................... 21
The Driver Parameters Tab................................................................. 22
Viewing General HBA Attributes ............................................................... 23
Viewing Detailed HBA Information ............................................................ 24
Viewing Fabric Information........................................................................ 26
Viewing Target Information........................................................................ 27
Viewing LUN Information........................................................................... 28
Masking and Unmasking LUNs (Windows, Solaris LPFC and
Solaris SFS)........................................................................................ 29
Viewing Port Statistics............................................................................... 31
Viewing Firmware Information ................................................................... 33
Viewing Target Mapping (Windows, Solaris LPFC and Solaris SFS)......... 34
Viewing Target Mapping (Linux) ................................................................ 35

Red Hat Enterprise Linux 5.2 and Novell SUSE SLES 10 SP2 (x86 Intel,x86-64 AMD & Intel architectures)
Base driver and install script for RHEL 5.2 (288 KB gz file)

1. System Requirements
1.1 Red Hat Enterprise Linux 'kernel-devel' Package Requirement
1.2 SuSE Linux Enterprise Server 'kernel-source' Package Requirement
2. Description of Install Procedure
3. Known Issues
3.1 PCI Hot Plug Support for applications
3.1.1 Observed problem
3.1.2 Workaround
3.2 Deletion of Vports/PCI Hot Unplug
3.2.1 Observed Problem
3.2.2 Background
3.3 lspci utility displays "Unknown Device" for LPe12000 HBAs
3.3.1 Observed Problem
3.3.2 Background
3.4 Speed of LPe12000 HBA (8Gb) is incorrectly displayed by HBAnyware
3.4.1 Observed Problem
3.4.2 Background
3.5 Port disabled on system boot or HBA reset with authentication enabled
3.5.1 Observed Problem
3.5.2 Workaround
3.6 LILO Boot Loader is not supported - i386 and x86_64 architectures
3.6.1 Observed Problem
3.6.2 Background
3.7 Order of lpfc module in initrd module list
3.7.1 Observed Problem
3.7.2 Workaround
3.8 Devloss timeout after swapping ports
3.8.1 Observed Problem
3.8.2 Workaround
3.9 Suspend to disk and Resume support
3.9.1 Observed Problem
3.9.2 Background
3.10 Deleting vports while devices are in use
3.10.1 Observed Problem
3.10.2 Workaround

----------------------------------------------------------------------

1. System Requirements

The following distributions of Linux are supported by the Emulex
LPFC driver:

Red Hat Enterprise Linux 5
SuSE Linux Enterprise Server 10 (SP1 or higher)

1.1 Red Hat Enterprise Linux 'kernel-devel' Package Requirement

For Red Hat Enterprise Linux installations, the -devel package
which matches the kernel package with the same version as the
currently running kernel must be installed for the LPFC driver
build to succeed. For example, a system with the 2.6.18-7 kernel
would need the kernel-devel-2.6.18-7 package.

Red Hat Enterprise Linux 5.0 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP1 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5 or later (x86 and x64 architectures)
HBAnyware utility 4.0a31 (179 MB tar file)

HBAnyware 4.0a31 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 4.0a31
SSC version 4.0a31
DFC Library version 3.0.25-1-1
HBAAPI version 2.1.g
Multipulse version 3.0.30-1
FCAUTHD version 1.17-1-1
Dependencies:

lpfc driver version 8.2.0.29 or later

HBAnyware requires that the lpfc driver module be installed.

HBAnyware requires a minimum screen resolution of 1024 x 768.
Installing HBAnyware:

1. Copy the applications kit tar file to a directory on the install machine
2. cd to the directory which you copied the tar file
3. Untar the file: tar -xvf tarfilename
4. cd (change directory) to the "ElxLinuxApps.." directory created by step 3
5. su to root
6. If earlier HBAnyware version currently installed, type : ./uninstall
7. Run the install script: ./install
8. When prompted, answer the following question:

Select desired mode of operation for HBAnyware

1 Local Mode : HBA's on this Platform can be managed by HBAnyware
clients on this platform only.
2 Managed Mode : HBA's on this Platform can be managed by local or
remote HBAnyware clients
3 Remote Mode : Same as '2' plus HBAnyware clients on this Platform
can manage local and remote clients.

Enter the number '1' or '2' or '3'
9. When prompted, answer the following question:

Do you want to allow user to make subsequent management mode changes
using 'set_operating_mode' script
Enter the letter 'Y' for yes or 'N' for no

10. Installation Complete: type /usr/sbin/hbanyware/hbanyware
to start GUI or type /usr/sbin/hbanyware/hbacmd list
to run script utility

Red Hat Enterprise Linux 5.2 and Novell SUSE SLES 10 SP2 (x86 Intel,x86-64 AMD & Intel architectures)
Driver for Linux User Manual (1.53 MB) Chapter 1 Introduction
Purpose of this document................................................................ 12
Host connectivity .............................................................................. 12
Fibre Channel ..............................................................................12
Fibre Channel over Ethernet .....................................................12
EMC storage array-specific settings............................................... 13
Boot device support.......................................................................... 13
Zoning ................................................................................................ 14
Useful Linux utilities and functions............................................... 14
Chapter 2 Installation Steps
Prerequisites for first-time installation .......................................... 16
Summary of installation steps......................................................... 18
Installing the adapter ....................................................................... 20
Matching the adapter with the correct PCI slot .....................22
Chapter 3 Installing and Configuring the BIOS Settings
Verifying and updating the Emulex boot BIOS............................ 28
Verifying the correct BIOS version...........................................28
Updating the boot BIOS.............................................................29
Method One — Updating the adapter boot BIOS with
hbacmd............................................................................................... 30
Method Two – Booting from a DOS bootable diskette and
using the lp6dutil utility .................................................................. 33
Chapter 4 Installing and Configuring the Driver
Installation instructions for the Emulex v8.x-series driver......... 36
Downloading the Emulex v8.x-series adapter driver for
the v2.6.x kernel .......................................................................... 37
Installing the Emulex CNA v8.x-series driver on RHEL
5.2 and SLES 10 SP2 hosts ......................................................... 38
Installing the Emulex v8.x-series driver on SLES 9 SP1
hosts.............................................................................................. 39
Installing the Emulex v8.x-series driver on RHEL 4
hosts.............................................................................................. 42
Included Emulex driver on RHEL 4, RHEL 5, OEL 4,
OEL 5, Asianux 2.0, Asianux 3.0, SLES 9, and SLES 10 ........ 45
Uninstalling the Emulex v8.x-series driver................................... 47
Installing the Emulex HBAnywhere applications kit.................. 48
Editing the configuration files ........................................................ 51
Description of the Emulex lpfc driver parameters ................ 51
Descriptions of the Emulex parameters .................................. 52
Editing the Emulex driver parameters on hosts with
SLES 9 and SLES 10 .................................................................... 54
Editing the Emulex driver parameters on hosts with
RHEL 4 and RHEL 5 .................................................................. 55
Editing the Emulex driver parameters on hosts with
Asianux 2.0 and Asianux 3.0..................................................... 56
Editing the Emulex driver parameters on hosts with
OEL 4 and OEL 5 ........................................................................ 57
Exercising the Emulex v8.x-series device driver.......................... 58
Loading and unloading the Emulex v8.x-series driver......... 58
Target information exported to the /proc filesystem ........... 59
Dynamically modifying the driver and device
information exported to the /sys filesystem.......................... 59

Red Hat Enterprise Linux 5.2 and Novell SUSE SLES 10 SP2 (x86 Intel,x86-64 AMD & Intel architectures)
HBAnyware Utility Version 4.0 Introduction.............................................................................................................. 1
Known Issues .................................................................................................... 1
Installing HBAnyware Components.......................................................................... 2
Installing the HBAnyware Utility......................................................................... 2
Installing the HBAnyware Utility with Web Launch............................................. 4
Installing the HBAnyware Utility Security Configurator ...................................... 5
Uninstalling the HBAnyware Security Configurator............................................ 6
Uninstalling HBAnyware Web Launch Only ....................................................... 7
Uninstalling the Utility Package ......................................................................... 7
Using the HBAnyware Components......................................................................... 8
Starting the HBAnyware Utility........................................................................... 8
Starting HBAnyware with Web Launch .............................................................. 8
Starting the HBAnyware Security Configurator .................................................. 8
Starting HBAnyware from the Command Line ................................................... 9
Examples of Modifications .................................................................... 9
The HBAnyware Utility Window Element Definitions ....................................... 10
The Menu Bar ........................................................................................... 11
The Toolbar ............................................................................................... 11
The Toolbar Buttons .................................................................................. 11
Sort Toolbar Buttons ........................................................................... 11
The Discovery-Tree................................................................................... 12
Discovery-Tree Icons .......................................................................... 12
Property Tabs............................................................................................ 13
Status Bar ................................................................................................. 13
Changing Management Mode ......................................................................... 13
Resetting HBAs ............................................................................................... 14
Discovering HBAs ........................................................................................... 14
Automatic Fibre Channel Discovery .......................................................... 14
Remote SAN Management Using TCP/IP Access Protocol....................... 15
Adding a Single Host .......................................................................... 15
Adding a Range of Hosts .................................................................... 16
Removing Hosts.................................................................................. 17
Configuring Discovery Settings ................................................................. 18
Sorting HBA Information.................................................................................. 19
Viewing Remote and Local HBAs.............................................................. 19
Viewing HBA Information................................................................................. 20
Viewing Discovery Information .................................................................. 20
Viewing Host Information .......................................................................... 21
The Host Information Tab.................................................................... 21
The Driver Parameters Tab................................................................. 22
Viewing General HBA Attributes ............................................................... 23
Viewing Detailed HBA Information ............................................................ 24
Viewing Fabric Information........................................................................ 26
Viewing Target Information........................................................................ 27
Viewing LUN Information........................................................................... 28
Masking and Unmasking LUNs (Windows, Solaris LPFC and
Solaris SFS)........................................................................................ 29
Viewing Port Statistics............................................................................... 31
Viewing Firmware Information ................................................................... 33
Viewing Target Mapping (Windows, Solaris LPFC and Solaris SFS)......... 34
Viewing Target Mapping (Linux) ................................................................ 35

Red Hat Enterprise Linux 5.2 and SUSE SLES 10 SP2 (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and PowerPC 64-bit architectures)
HBAnyware utility 3.4a14 (198 MB tar file)

HBAnyware 3.4a14 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 3.4a14
SSC version 3.4a14
DFC Library version 3.0.13-1
Lputil version
HBAAPI version 2.1.g

Dependencies:

lpfc driver version 8.2.0.22 or later

HBAnyware requires that the lpfc driver module be installed.

HBAnyware requires a minimum screen resolution of 1024 x 768.
Installing HBAnyware:

1. Copy the applications kit tar file to a directory on the install machine
2. cd to the directory which you copied the tar file
3. Untar the file: tar -xvf tarfilename
4. cd (change directory) to the "ElxLinuxApps.." directory created by step 3
5. su to root
6. If earlier HBAnyware version currently installed, type : ./uninstall
7. Run the install script: ./install
8. When prompted, answer the following question:

Select desired mode of operation for HBAnyware

1 Local Mode : HBA's on this Platform can be managed by HBAnyware
clients on this platform only.
2 Managed Mode : HBA's on this Platform can be managed by local or
remote HBAnyware clients
3 Remote Mode : Same as '2' plus HBAnyware clients on this Platform
can manage local and remote clients.

Enter the number '1' or '2' or '3'
9. When prompted, answer the following question:

Do you want to allow user to make subsequent management mode changes
using 'set_operating_mode' script
Enter the letter 'Y' for yes or 'N' for no

10. Installation Complete: type /usr/sbin/hbanyware/hbanyware
to start GUI or type /usr/sbin/hbanyware/hbacmd list
to run script utility

Red Hat Enterprise Linux 5.2 and SUSE SLES 10 SP2 (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and PowerPC 64-bit architectures)
Driver for Linux User Manual (1.53 MB) Chapter 1 Introduction
Purpose of this document................................................................ 12
Host connectivity .............................................................................. 12
Fibre Channel ..............................................................................12
Fibre Channel over Ethernet .....................................................12
EMC storage array-specific settings............................................... 13
Boot device support.......................................................................... 13
Zoning ................................................................................................ 14
Useful Linux utilities and functions............................................... 14
Chapter 2 Installation Steps
Prerequisites for first-time installation .......................................... 16
Summary of installation steps......................................................... 18
Installing the adapter ....................................................................... 20
Matching the adapter with the correct PCI slot .....................22
Chapter 3 Installing and Configuring the BIOS Settings
Verifying and updating the Emulex boot BIOS............................ 28
Verifying the correct BIOS version...........................................28
Updating the boot BIOS.............................................................29
Method One — Updating the adapter boot BIOS with
hbacmd............................................................................................... 30
Method Two – Booting from a DOS bootable diskette and
using the lp6dutil utility .................................................................. 33
Chapter 4 Installing and Configuring the Driver
Installation instructions for the Emulex v8.x-series driver......... 36
Downloading the Emulex v8.x-series adapter driver for
the v2.6.x kernel .......................................................................... 37
Installing the Emulex CNA v8.x-series driver on RHEL
5.2 and SLES 10 SP2 hosts ......................................................... 38
Installing the Emulex v8.x-series driver on SLES 9 SP1
hosts.............................................................................................. 39
Installing the Emulex v8.x-series driver on RHEL 4
hosts.............................................................................................. 42
Included Emulex driver on RHEL 4, RHEL 5, OEL 4,
OEL 5, Asianux 2.0, Asianux 3.0, SLES 9, and SLES 10 ........ 45
Uninstalling the Emulex v8.x-series driver................................... 47
Installing the Emulex HBAnywhere applications kit.................. 48
Editing the configuration files ........................................................ 51
Description of the Emulex lpfc driver parameters ................ 51
Descriptions of the Emulex parameters .................................. 52
Editing the Emulex driver parameters on hosts with
SLES 9 and SLES 10 .................................................................... 54
Editing the Emulex driver parameters on hosts with
RHEL 4 and RHEL 5 .................................................................. 55
Editing the Emulex driver parameters on hosts with
Asianux 2.0 and Asianux 3.0..................................................... 56
Editing the Emulex driver parameters on hosts with
OEL 4 and OEL 5 ........................................................................ 57
Exercising the Emulex v8.x-series device driver.......................... 58
Loading and unloading the Emulex v8.x-series driver......... 58
Target information exported to the /proc filesystem ........... 59
Dynamically modifying the driver and device
information exported to the /sys filesystem.......................... 59

Red Hat Enterprise Linux 5.2 and SUSE SLES 10 SP2 (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and PowerPC 64-bit architectures)
HBAnyware Utility Version 3.4

Introduction.............................................................................................................. 1
Known Issues .................................................................................................... 1
Installing HBAnyware Components.......................................................................... 2
Installing the HBAnyware Utility......................................................................... 2
Installing the HBAnyware Utility with Web Launch............................................. 4
Installing the HBAnyware Utility Security Configurator ...................................... 5
Uninstalling the HBAnyware Security Configurator............................................ 6
Uninstalling HBAnyware Web Launch Only ....................................................... 7
Uninstalling the Utility Package ......................................................................... 7
Using the HBAnyware Components......................................................................... 8
Starting the HBAnyware Utility........................................................................... 8
Starting HBAnyware with Web Launch .............................................................. 8
Starting the HBAnyware Security Configurator .................................................. 8
Starting HBAnyware from the Command Line ................................................... 9
Examples of Modifications .................................................................... 9
The HBAnyware Utility Window Element Definitions ....................................... 10
The Menu Bar ........................................................................................... 11
The Toolbar ............................................................................................... 11
The Toolbar Buttons .................................................................................. 11
Sort Toolbar Buttons ........................................................................... 11
The Discovery-Tree................................................................................... 12
Discovery-Tree Icons .......................................................................... 12
Property Tabs............................................................................................ 13
Status Bar ................................................................................................. 13
Changing Management Mode ......................................................................... 13
Resetting HBAs ............................................................................................... 14
Discovering HBAs ........................................................................................... 14
Automatic Fibre Channel Discovery .......................................................... 14
Remote SAN Management Using TCP/IP Access Protocol....................... 15
Adding a Single Host .......................................................................... 15
Adding a Range of Hosts .................................................................... 16
Removing Hosts.................................................................................. 17
Configuring Discovery Settings ................................................................. 18
Sorting HBA Information.................................................................................. 19
Viewing Remote and Local HBAs.............................................................. 19
Viewing HBA Information................................................................................. 20
Viewing Discovery Information .................................................................. 20
Viewing Host Information .......................................................................... 21
The Host Information Tab.................................................................... 21
The Driver Parameters Tab................................................................. 22
Viewing General HBA Attributes ............................................................... 23
Viewing Detailed HBA Information ............................................................ 24
Viewing Fabric Information........................................................................ 26
Viewing Target Information........................................................................ 27
Viewing LUN Information........................................................................... 28
Masking and Unmasking LUNs (Windows, Solaris LPFC and
Solaris SFS)........................................................................................ 29
Viewing Port Statistics............................................................................... 31
Viewing Firmware Information ................................................................... 33
Viewing Target Mapping (Windows, Solaris LPFC and Solaris SFS)......... 34
Viewing Target Mapping (Linux) ................................................................ 35

RHEL5.1 x86 (Intel), x86-64 (AMD and Intel), IA64
SLES 10 SP1 (x86 Intel, x86-64 AMD and Intel), IA64
HBAnyware utility 3.2a5, lputil 2.0a14 (169 MB tar file)

HBAnyware 3.2a14 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 3.2a14
SSC version 3.2a14
DFC Library version 2-15-1005
Lputil version 2.0a14
HBAAPI version 2.1.e

Dependencies:

HBAnyware requires that the lpfc driver module be installed.
The lpfc driver version 8.1.10.9 and all 8.1.10.x based driver releases are
supported with this version of HBAnyware.
This support includes the RHEL5 and SLES10-SP1 in-distro 8.1.10.3 lpfc driver.

HBAnyware requires a minimum screen resolution of 1024 x 768.
Installing HBAnyware:

1. Copy the applications kit tar file to a directory on the install machine
2. cd to the directory which you copied the tar file
3. Untar the file: tar -xvf tarfilename
4. cd (change directory) to the "ElxLinuxApps.." directory created by step 3
5. su to root
6. If earlier HBAnyware version currently installed, type : ./uninstall
7. Run the install script: ./install
8. When prompted, answer the following question:

Select desired mode of operation for HBAnyware

1 Local Mode : HBA's on this Platform can be managed by HBAnyware
clients on this platform only.
2 Managed Mode : HBA's on this Platform can be managed by local or
remote HBAnyware clients
3 Remote Mode : Same as '2' plus HBAnyware clients on this Platform
can manage local and remote clients.

Enter the number '1' or '2' or '3'
9. When prompted, answer the following question:

Do you want to allow user to make subsequent management mode changes
using 'set_operating_mode' script
Enter the letter 'Y' for yes or 'N' for no

10. Installation Complete: type /usr/sbin/hbanyware/hbanyware
to start GUI or type /usr/sbin/hbanyware/hbacmd list
to run script utility

RHEL5.1 x86 (Intel), x86-64 (AMD and Intel), IA64
SLES 10 SP1 (x86 Intel, x86-64 AMD and Intel), IA64
Installation, Configuration and Troubleshooting (500 KB pdf file) Chapter 1 Introduction
Purpose of this document................................................................ 12
Host connectivity .............................................................................. 12
Fibre Channel ..............................................................................12
Fibre Channel over Ethernet .....................................................12
EMC storage array-specific settings............................................... 13
Boot device support.......................................................................... 13
Zoning ................................................................................................ 14
Useful Linux utilities and functions............................................... 14
Chapter 2 Installation Steps
Prerequisites for first-time installation .......................................... 16
Summary of installation steps......................................................... 18
Installing the adapter ....................................................................... 20
Matching the adapter with the correct PCI slot .....................22
Chapter 3 Installing and Configuring the BIOS Settings
Verifying and updating the Emulex boot BIOS............................ 28
Verifying the correct BIOS version...........................................28
Updating the boot BIOS.............................................................29
Method One — Updating the adapter boot BIOS with
hbacmd............................................................................................... 30
Method Two – Booting from a DOS bootable diskette and
using the lp6dutil utility .................................................................. 33
Chapter 4 Installing and Configuring the Driver
Installation instructions for the Emulex v8.x-series driver......... 36
Downloading the Emulex v8.x-series adapter driver for
the v2.6.x kernel .......................................................................... 37
Installing the Emulex CNA v8.x-series driver on RHEL
5.2 and SLES 10 SP2 hosts ......................................................... 38
Installing the Emulex v8.x-series driver on SLES 9 SP1
hosts.............................................................................................. 39
Installing the Emulex v8.x-series driver on RHEL 4
hosts.............................................................................................. 42
Included Emulex driver on RHEL 4, RHEL 5, OEL 4,
OEL 5, Asianux 2.0, Asianux 3.0, SLES 9, and SLES 10 ........ 45
Uninstalling the Emulex v8.x-series driver................................... 47
Installing the Emulex HBAnywhere applications kit.................. 48
Editing the configuration files ........................................................ 51
Description of the Emulex lpfc driver parameters ................ 51
Descriptions of the Emulex parameters .................................. 52
Editing the Emulex driver parameters on hosts with
SLES 9 and SLES 10 .................................................................... 54
Editing the Emulex driver parameters on hosts with
RHEL 4 and RHEL 5 .................................................................. 55
Editing the Emulex driver parameters on hosts with
Asianux 2.0 and Asianux 3.0..................................................... 56
Editing the Emulex driver parameters on hosts with
OEL 4 and OEL 5 ........................................................................ 57
Exercising the Emulex v8.x-series device driver.......................... 58
Loading and unloading the Emulex v8.x-series driver......... 58
Target information exported to the /proc filesystem ........... 59
Dynamically modifying the driver and device
information exported to the /sys filesystem.......................... 59

RHEL4 Update 4 x86 (Intel), x86-64 (AMD and Intel), IA64
AutoPilot Manager 2.0a3
(72.6 MB tar file)

RHEL 4.7 and SLES 9 SP4 (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and PowerPC 64-bit architectures)
HBAnyware utility 3.4a14, Application helper module 2.0.30

HBAnyware 3.4a14 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 3.4a14
SSC version 3.4a14
DFC Library version 80.164-8
Lputil version
HBAAPI version 2.1.g

Dependencies:

lpfc driver version 8.0.16.40 or later

HBAnyware requires that the lpfc driver module be installed.

HBAnyware requires a minimum screen resolution of 1024 x 768.
Installing HBAnyware:

1. Copy the applications kit tar file to a directory on the install machine
2. cd to the directory which you copied the tar file
3. Untar the file: tar -xvf tarfilename
4. cd (change directory) to the "ElxLinuxApps.." directory created by step 3
5. su to root
6. If earlier HBAnyware version currently installed, type : ./uninstall
7. Run the install script: ./install
8. When prompted, answer the following question:

Select desired mode of operation for HBAnyware

1 Local Mode : HBA's on this Platform can be managed by HBAnyware
clients on this platform only.
2 Managed Mode : HBA's on this Platform can be managed by local or
remote HBAnyware clients
3 Remote Mode : Same as '2' plus HBAnyware clients on this Platform
can manage local and remote clients.

Enter the number '1' or '2' or '3'
9. When prompted, answer the following question:

Do you want to allow user to make subsequent management mode changes
using 'set_operating_mode' script
Enter the letter 'Y' for yes or 'N' for no

10. Installation Complete: type /usr/sbin/hbanyware/hbanyware
to start GUI or type /usr/sbin/hbanyware/hbacmd list
to run script utility

RHEL 4.7 and SLES 9 SP4 (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and PowerPC 64-bit architectures)
Driver for Linux User Manual (1.53 MB pdf file) Chapter 1 Introduction
Purpose of this document................................................................ 12
Host connectivity .............................................................................. 12
Fibre Channel ..............................................................................12
Fibre Channel over Ethernet .....................................................12
EMC storage array-specific settings............................................... 13
Boot device support.......................................................................... 13
Zoning ................................................................................................ 14
Useful Linux utilities and functions............................................... 14
Chapter 2 Installation Steps
Prerequisites for first-time installation .......................................... 16
Summary of installation steps......................................................... 18
Installing the adapter ....................................................................... 20
Matching the adapter with the correct PCI slot .....................22
Chapter 3 Installing and Configuring the BIOS Settings
Verifying and updating the Emulex boot BIOS............................ 28
Verifying the correct BIOS version...........................................28
Updating the boot BIOS.............................................................29
Method One — Updating the adapter boot BIOS with
hbacmd............................................................................................... 30
Method Two – Booting from a DOS bootable diskette and
using the lp6dutil utility .................................................................. 33
Chapter 4 Installing and Configuring the Driver
Installation instructions for the Emulex v8.x-series driver......... 36
Downloading the Emulex v8.x-series adapter driver for
the v2.6.x kernel .......................................................................... 37
Installing the Emulex CNA v8.x-series driver on RHEL
5.2 and SLES 10 SP2 hosts ......................................................... 38
Installing the Emulex v8.x-series driver on SLES 9 SP1
hosts.............................................................................................. 39
Installing the Emulex v8.x-series driver on RHEL 4
hosts.............................................................................................. 42
Included Emulex driver on RHEL 4, RHEL 5, OEL 4,
OEL 5, Asianux 2.0, Asianux 3.0, SLES 9, and SLES 10 ........ 45
Uninstalling the Emulex v8.x-series driver................................... 47
Installing the Emulex HBAnywhere applications kit.................. 48
Editing the configuration files ........................................................ 51
Description of the Emulex lpfc driver parameters ................ 51
Descriptions of the Emulex parameters .................................. 52
Editing the Emulex driver parameters on hosts with
SLES 9 and SLES 10 .................................................................... 54
Editing the Emulex driver parameters on hosts with
RHEL 4 and RHEL 5 .................................................................. 55
Editing the Emulex driver parameters on hosts with
Asianux 2.0 and Asianux 3.0..................................................... 56
Editing the Emulex driver parameters on hosts with
OEL 4 and OEL 5 ........................................................................ 57
Exercising the Emulex v8.x-series device driver.......................... 58
Loading and unloading the Emulex v8.x-series driver......... 58
Target information exported to the /proc filesystem ........... 59
Dynamically modifying the driver and device
information exported to the /sys filesystem.......................... 59

RHEL 4.7 and SLES 9 SP4 (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and PowerPC 64-bit architectures)
HBAnyware Utility Version 4.0 Introduction.............................................................................................................. 1
Known Issues .................................................................................................... 1
Installing HBAnyware Components.......................................................................... 2
Installing the HBAnyware Utility......................................................................... 2
Installing the HBAnyware Utility with Web Launch............................................. 4
Installing the HBAnyware Utility Security Configurator ...................................... 5
Uninstalling the HBAnyware Security Configurator............................................ 6
Uninstalling HBAnyware Web Launch Only ....................................................... 7
Uninstalling the Utility Package ......................................................................... 7
Using the HBAnyware Components......................................................................... 8
Starting the HBAnyware Utility........................................................................... 8
Starting HBAnyware with Web Launch .............................................................. 8
Starting the HBAnyware Security Configurator .................................................. 8
Starting HBAnyware from the Command Line ................................................... 9
Examples of Modifications .................................................................... 9
The HBAnyware Utility Window Element Definitions ....................................... 10
The Menu Bar ........................................................................................... 11
The Toolbar ............................................................................................... 11
The Toolbar Buttons .................................................................................. 11
Sort Toolbar Buttons ........................................................................... 11
The Discovery-Tree................................................................................... 12
Discovery-Tree Icons .......................................................................... 12
Property Tabs............................................................................................ 13
Status Bar ................................................................................................. 13
Changing Management Mode ......................................................................... 13
Resetting HBAs ............................................................................................... 14
Discovering HBAs ........................................................................................... 14
Automatic Fibre Channel Discovery .......................................................... 14
Remote SAN Management Using TCP/IP Access Protocol....................... 15
Adding a Single Host .......................................................................... 15
Adding a Range of Hosts .................................................................... 16
Removing Hosts.................................................................................. 17
Configuring Discovery Settings ................................................................. 18
Sorting HBA Information.................................................................................. 19
Viewing Remote and Local HBAs.............................................................. 19
Viewing HBA Information................................................................................. 20
Viewing Discovery Information .................................................................. 20
Viewing Host Information .......................................................................... 21
The Host Information Tab.................................................................... 21
The Driver Parameters Tab................................................................. 22
Viewing General HBA Attributes ............................................................... 23
Viewing Detailed HBA Information ............................................................ 24
Viewing Fabric Information........................................................................ 26
Viewing Target Information........................................................................ 27
Viewing LUN Information........................................................................... 28
Masking and Unmasking LUNs (Windows, Solaris LPFC and
Solaris SFS)........................................................................................ 29
Viewing Port Statistics............................................................................... 31
Viewing Firmware Information ................................................................... 33
Viewing Target Mapping (Windows, Solaris LPFC and Solaris SFS)......... 34
Viewing Target Mapping (Linux) ................................................................ 35

RHEL 4.6 and SLES 9 SP4 (x86 Intel,x86-64 AMD & Intel, IA64)
HBAnyware 3.03a20 lputil 2.0a14

HBAnyware 3.3a20 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 3.3a20
SSC version 3.3a20
DFC Library version 80.164-2
Lputil version 2.0a14
HBAAPI version 2.1.d_1

Dependencies:

lpfc driver version 8.0.16.34 or later

HBAnyware requires that the lpfc driver module be installed.

HBAnyware requires a minimum screen resolution of 1024 x 768.
Installing HBAnyware:

1. Copy the applications kit tar file to a directory on the install machine
2. cd to the directory which you copied the tar file
3. Untar the file: tar -xvf tarfilename
4. cd (change directory) to the "ElxLinuxApps.." directory created by step 3
5. su to root
6. If earlier HBAnyware version currently installed, type : ./uninstall
7. Run the install script: ./install
8. When prompted, answer the following question:

Select desired mode of operation for HBAnyware

1 Local Mode : HBA's on this Platform can be managed by HBAnyware
clients on this platform only.
2 Managed Mode : HBA's on this Platform can be managed by local or
remote HBAnyware clients
3 Remote Mode : Same as '2' plus HBAnyware clients on this Platform
can manage local and remote clients.

Enter the number '1' or '2' or '3'
9. When prompted, answer the following question:

Do you want to allow user to make subsequent management mode changes
using 'set_operating_mode' script
Enter the letter 'Y' for yes or 'N' for no

10. Installation Complete: type /usr/sbin/hbanyware/hbanyware
to start GUI or type /usr/sbin/hbanyware/hbacmd list
to run script utility

RHEL 4.6 and SLES 9 SP4 (x86 Intel,x86-64 AMD & Intel, IA64)
Installation, Configuration and Troubleshooting (500 KB pdf file) Chapter 1 Introduction
Purpose of this document................................................................ 12
Host connectivity .............................................................................. 12
Fibre Channel ..............................................................................12
Fibre Channel over Ethernet .....................................................12
EMC storage array-specific settings............................................... 13
Boot device support.......................................................................... 13
Zoning ................................................................................................ 14
Useful Linux utilities and functions............................................... 14
Chapter 2 Installation Steps
Prerequisites for first-time installation .......................................... 16
Summary of installation steps......................................................... 18
Installing the adapter ....................................................................... 20
Matching the adapter with the correct PCI slot .....................22
Chapter 3 Installing and Configuring the BIOS Settings
Verifying and updating the Emulex boot BIOS............................ 28
Verifying the correct BIOS version...........................................28
Updating the boot BIOS.............................................................29
Method One — Updating the adapter boot BIOS with
hbacmd............................................................................................... 30
Method Two – Booting from a DOS bootable diskette and
using the lp6dutil utility .................................................................. 33
Chapter 4 Installing and Configuring the Driver
Installation instructions for the Emulex v8.x-series driver......... 36
Downloading the Emulex v8.x-series adapter driver for
the v2.6.x kernel .......................................................................... 37
Installing the Emulex CNA v8.x-series driver on RHEL
5.2 and SLES 10 SP2 hosts ......................................................... 38
Installing the Emulex v8.x-series driver on SLES 9 SP1
hosts.............................................................................................. 39
Installing the Emulex v8.x-series driver on RHEL 4
hosts.............................................................................................. 42
Included Emulex driver on RHEL 4, RHEL 5, OEL 4,
OEL 5, Asianux 2.0, Asianux 3.0, SLES 9, and SLES 10 ........ 45
Uninstalling the Emulex v8.x-series driver................................... 47
Installing the Emulex HBAnywhere applications kit.................. 48
Editing the configuration files ........................................................ 51
Description of the Emulex lpfc driver parameters ................ 51
Descriptions of the Emulex parameters .................................. 52
Editing the Emulex driver parameters on hosts with
SLES 9 and SLES 10 .................................................................... 54
Editing the Emulex driver parameters on hosts with
RHEL 4 and RHEL 5 .................................................................. 55
Editing the Emulex driver parameters on hosts with
Asianux 2.0 and Asianux 3.0..................................................... 56
Editing the Emulex driver parameters on hosts with
OEL 4 and OEL 5 ........................................................................ 57
Exercising the Emulex v8.x-series device driver.......................... 58
Loading and unloading the Emulex v8.x-series driver......... 58
Target information exported to the /proc filesystem ........... 59
Dynamically modifying the driver and device
information exported to the /sys filesystem.......................... 59

RHEL4 Update 4 x86 (Intel), x86-64 (AMD and Intel), IA64
AutoPilot Manager 2.0a3
(72.6 MB tar file)

RHEL4 Update 3 x86 (Intel), x86-64 (AMD and Intel) and IA64
HBAnyware utility 2.1a29, lputil 2.0a12

HBAnyware 2.1a29 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 2.1a29
SSC version 2.1a29
DFC Library version 80.161-5
Lputil version 2.0a12
HBAAPI version 2.1.a

Dependencies:

lpfc driver version 8.0.16.18 or later
HBAnyware is dependant on lpfc being installed, so install lpfc first if it is not already installed.

HBAnyware requires a minimum screen resolution of 1024 x 768.

Installing HBAnyware

1. Copy the applications kit tar file to a directory on the install machine
2. cd to the directory which you copied the tar file
3. Untar the file: tar -xvf tarfilename
4. su to root
5. Run the install script: ./install
Uninstalling HBAnyware

1. Complete steps 1 through 4 from "Installing HBAnyware" above.
2. Run the uninstall script: ./uninstall
Running the HBAnyware GUI

1. su to root
2. Run the script /usr/sbin/hbanyware/hbanyware
ppc64/sles8 NOTE:
If you want to use the 64bit HBAAPI libraries you must replace the following line in /etc/hba.conf:
com.emulex.emulexapilibrary /usr/lib/libemulexhbaapi.so
with this line
com.emulex.emulexapilibrary /usr/lib64/libemulexhbaapi.so

ppc64/(non-sles8) and amd64 NOTE:
If you want to use the 64bit HBAAPI libraries you must add the following line in /etc/hba.conf:
com.emulex.emulexapilibrary /usr/lib64/libemulexhbaapi.so

HBAnyware Help:
To view the HBAnyware help pages or to access the Emulex Technical support pages you must have one of the
following web browsers installed:
mozilla, konqueror
Helpful scripts

/usr/sbin/hbanyware/stop_hbanyware - This script will stop all HBAnyware daemons and GUIs.
Run this if you need to unload the driver.

/usr/sbin/hbanyware/start_rmserver - This script will re-start the rmserver daemon.
Run this if you manually load the lpfc driver.

RHEL4 Update 3 x86 (Intel), x86-64 (AMD and Intel) and IA64
Tar file containing install script and scripted source RPM to build and install the IOCTL application helper module. This is needed with the RHEL 4 Update 3 distribution (which contains the 8.0.16.18 driver). This driver allows applications to communicate with the 8.0.16.18 driver.

1. System Requirements
2. Installation Process
3. Release Notes
3.1 Red Hat Enterprise Linux 'kernel-devel' Package Requirement

----------------------------------------------------------------------

1. System Requirements

The following distribution of Linux is supported by the Emulex
LPFC Application Helper Module:

Red Hat Enterprise Linux 4 Update 3

This Emulex LPFC Application Helper Module will function with the
Emulex LPFC driver that ships with this distribution of Linux.
Other versions of the LPFC driver will not function properly with
this version of the Application Helper Module.

2. Installation Process

The ioctl-install script can be used to install and uninstall the
LPFC Application Helper Module RPM. This RPM installs the module
sources to the /usr/src/lpfcdfc directory, builds the module for
the currently running kernel, and then installs the module to the
proper directory for the currently running kernel.

Once the RPM is installed, the 'elxlpfc' init script is installed
and configured to start and stop the 'lpfcdfc' driver during system
startup and shutdown.

For usage information, please execute the command:

./ioctl-install --help

3. Release Notes

3.1 Red Hat Enterprise Linux 'kernel-devel' Package Requirement

For Red Hat Enterprise Linux installations, the "Development Tools"
package in the software development environment and the kernel
development package with the same version as the currently running
kernel must be installed for the Application Helper Module build to
succeed.

The name of the kernel development package depends upon the name of
the kernel for which the Application Helper Module will be
installed. For example, a system with the 2.6.9-11.EL kernel
would need the kernel-devel-2.6.9-11.EL package, and a system
with the 2.6.9-11.ELsmp kernel would need the
kernel-smp-devel-2.6.9-11.EL package.

RHEL4 Update 3 x86 (Intel), x86-64 (AMD and Intel) and IA64
Tar file containing the DKMS package installation and DKMS RPMs for the 8.0.16.18 and application helper module. This kit is supported on RHEL 4 distribution only. It automatically installs the drivers; no lpfc.conf parameter customization is needed prior to 1st driver compilation. This is an alternative installation method to using driver kits above, or drivers on the Redhat distribution CDs

1. Introduction
2. Installation
3. Post-Installation
4. Uninstallation
5. Distribution/Platform Support
6. Notes

----------------------------------------------------------------------

1. Introduction

The DKMS (Dynamic Kernel Module System) project is maintained by
Dell. The latest version can be found at:

http://linux.dell.com/dkms/dkms.html

DKMS creates a framework where kernel dependent module source is
stored in the DKMS database. DKMS manages the building and
installation of the lpfc and lpfcdfc modules. These RPMs contain
the same lpfc source code as the non-DKMS RPMs but include DKMS in
the RPM package name to signify that the RPM includes our driver
managed by DKMS. The driver itself is the same, just the packaging
is different.
2. Installation

1. Ensure that DKMS is installed. DKMS version 2.0.5-1 or greater
is required. You may install the DKMS RPM that is included as
part of this package.

rpm -i dkms-2.0.5-1.noarch.rpm

2. Install the dkms specific lpfc driver rpm

rpm -i lpfcdriver_2.6_dkms-8.0.16.18-1.noarch.rpm

3. Install the dkms specific lpfcdfc driver rpm

rpm -i lpfc_2.6_ioctl_module_dkms-2.0.9-2.noarch.rpm
3. Post-Installation

1. Use the DKMS status command to verify that DKMS has built and
installed the drivers.

e.g.
[root]# dkms status
lpfc, 8.0.16.18, 2.6.9-22.ELsmp, i686: installed (original_module exists)
lpfcdfc, 2.0.9, 2.6.9-22.ELsmp, i686: installed

RHEL4 Update 3 x86 (Intel), x86-64 (AMD and Intel) and IA64
Installation, Configuration and Troubleshooting (500 KB) Chapter 1 Introduction
Purpose of this document................................................................ 12
Host connectivity .............................................................................. 12
Fibre Channel ..............................................................................12
Fibre Channel over Ethernet .....................................................12
EMC storage array-specific settings............................................... 13
Boot device support.......................................................................... 13
Zoning ................................................................................................ 14
Useful Linux utilities and functions............................................... 14
Chapter 2 Installation Steps
Prerequisites for first-time installation .......................................... 16
Summary of installation steps......................................................... 18
Installing the adapter ....................................................................... 20
Matching the adapter with the correct PCI slot .....................22
Chapter 3 Installing and Configuring the BIOS Settings
Verifying and updating the Emulex boot BIOS............................ 28
Verifying the correct BIOS version...........................................28
Updating the boot BIOS.............................................................29
Method One — Updating the adapter boot BIOS with
hbacmd............................................................................................... 30
Method Two – Booting from a DOS bootable diskette and
using the lp6dutil utility .................................................................. 33
Chapter 4 Installing and Configuring the Driver
Installation instructions for the Emulex v8.x-series driver......... 36
Downloading the Emulex v8.x-series adapter driver for
the v2.6.x kernel .......................................................................... 37
Installing the Emulex CNA v8.x-series driver on RHEL
5.2 and SLES 10 SP2 hosts ......................................................... 38
Installing the Emulex v8.x-series driver on SLES 9 SP1
hosts.............................................................................................. 39
Installing the Emulex v8.x-series driver on RHEL 4
hosts.............................................................................................. 42
Included Emulex driver on RHEL 4, RHEL 5, OEL 4,
OEL 5, Asianux 2.0, Asianux 3.0, SLES 9, and SLES 10 ........ 45
Uninstalling the Emulex v8.x-series driver................................... 47
Installing the Emulex HBAnywhere applications kit.................. 48
Editing the configuration files ........................................................ 51
Description of the Emulex lpfc driver parameters ................ 51
Descriptions of the Emulex parameters .................................. 52
Editing the Emulex driver parameters on hosts with
SLES 9 and SLES 10 .................................................................... 54
Editing the Emulex driver parameters on hosts with
RHEL 4 and RHEL 5 .................................................................. 55
Editing the Emulex driver parameters on hosts with
Asianux 2.0 and Asianux 3.0..................................................... 56
Editing the Emulex driver parameters on hosts with
OEL 4 and OEL 5 ........................................................................ 57
Exercising the Emulex v8.x-series device driver.......................... 58
Loading and unloading the Emulex v8.x-series driver......... 58
Target information exported to the /proc filesystem ........... 59
Dynamically modifying the driver and device
information exported to the /sys filesystem.......................... 59

RHEL4 Update 2 x86 (Intel), x86-64 (AMD and Intel), IA64
and SLES 9 SP3 x86 (Intel), X86-64 (AMD and Intel), IA64
Tar file containing the DKMS package installation and DKMS RPMs for the 8.0.16.17 and application helper module. This kit is supported on RHEL 4 distribution only. It automatically installs the drivers; no lpfc.conf parameter customization is needed prior to 1st driver compilation. This is an alternative installation method to using driver kits above, or drivers on the Redhat distribution CDs.

1. System Requirements
2. Installation Process
3. Release Notes
3.1 Red Hat Enterprise Linux 'kernel-devel' Package Requirement
3.2 SuSE Linux Enterprise Server 'kernel-source' Package Requirement

----------------------------------------------------------------------

1. System Requirements

The following distribution of Linux is supported by the Emulex
LPFC Application Helper Module:

Red Hat Enterprise Linux 4 Update 2

This Emulex LPFC Application Helper Module will function with the
Emulex LPFC driver that ships with this distribution of Linux.
Other versions of the LPFC driver will not function properly with
this version of the Application Helper Module.

2. Installation Process

The ioctl-install script can be used to install and uninstall the
LPFC Application Helper Module RPM. This RPM installs the module
sources to the /usr/src/lpfcdfc directory, builds the module for
the currently running kernel, and then installs the module to the
proper directory for the currently running kernel.

Once the RPM is installed, the 'elxlpfc' init script is installed
and configured to start and stop the 'lpfcdfc' driver during system
startup and shutdown.

For usage information, please execute the command:

./ioctl-install --help

3. Release Notes

3.1 Red Hat Enterprise Linux 'kernel-devel' Package Requirement

For Red Hat Enterprise Linux installations, the "Development Tools"
package in the software development environment and the kernel
development package with the same version as the currently running
kernel must be installed for the Application Helper Module build to
succeed.

The name of the kernel development package depends upon the name of
the kernel for which the Application Helper Module will be
installed. For example, a system with the 2.6.9-11.EL kernel
would need the kernel-devel-2.6.9-11.EL package, and a system
with the 2.6.9-11.ELsmp kernel would need the
kernel-smp-devel-2.6.9-11.EL package.

RHEL4 Update 2 x86 (Intel), x86-64 (AMD and Intel), IA64
and SLES 9 SP3 x86 (Intel), X86-64 (AMD and Intel), IA64
HBAnyware utility 2.1a25, lputil 2.0a9 (169 MB tar file)

HBAnyware 2.1a25 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 2.1a25
SSC version 2.1a25
DFC Library version 80.161-5
Lputil version 2.0a9
HBAAPI version 2.1.a

Dependencies:

lpfc driver version 8.0.16.17 or later
HBAnyware is dependant on lpfc being installed, so install lpfc first if it is not already installed.

HBAnyware requires a minimum screen resolution of 1024 x 768.

Installing HBAnyware

1. Copy the applications kit tar file to a directory on the install machine
2. cd to the directory which you copied the tar file
3. Untar the file: tar -xvf tarfilename
4. su to root
5. Run the install script: ./install
Uninstalling HBAnyware

1. Complete steps 1 through 4 from "Installing HBAnyware" above.
2. Run the uninstall script: ./uninstall
Running the HBAnyware GUI

1. su to root
2. Run the script /usr/sbin/hbanyware/hbanyware
ppc64/sles8 NOTE:
If you want to use the 64bit HBAAPI libraries you must replace the following line in /etc/hba.conf:
com.emulex.emulexapilibrary /usr/lib/libemulexhbaapi.so
with this line
com.emulex.emulexapilibrary /usr/lib64/libemulexhbaapi.so

ppc64/(non-sles8) and amd64 NOTE:
If you want to use the 64bit HBAAPI libraries you must add the following line in /etc/hba.conf:
com.emulex.emulexapilibrary /usr/lib64/libemulexhbaapi.so

HBAnyware Help:
To view the HBAnyware help pages or to access the Emulex Technical support pages you must have one of the
following web browsers installed:
mozilla, konqueror
Helpful scripts

/usr/sbin/hbanyware/stop_hbanyware - This script will stop all HBAnyware daemons and GUIs.
Run this if you need to unload the driver.

/usr/sbin/hbanyware/start_rmserver - This script will re-start the rmserver daemon.
Run this if you manually load the lpfc driver.

RHEL4 Update 2 x86 (Intel), x86-64 (AMD and Intel), IA64
and SLES 9 SP3 x86 (Intel), X86-64 (AMD and Intel), IA64
Tar file containing install script and scripted source RPM to build and install the IOCTL application helper module. This is needed with the RHEL 4 Update 2 distribution (which contains the 8.0.16.17 driver). This driver allows applications to communicate with the 8.0.16.17 driver.

1. System Requirements
2. Description of Changes
3. Release Notes
3.1 Red Hat Enterprise Linux 'kernel-devel' Package Requirement
3.2 SuSE Linux Enterprise Server 'kernel-source' Package Requirement

----------------------------------------------------------------------

1. System Requirements

The following distributions of Linux are supported by the Emulex
LPFC Application Helper Module:

Red Hat Enterprise Linux 4 Update 1
SuSE Linux Enterprise Server 9 SP2

2. Description of Changes

The ioctl-install script installs the LPFC Application Helper
Module RPM. This RPM installs the module sources to the
/usr/src/lpfcdfc directory, builds the module for the currently
running kernel, and then installs the module to the proper
directory for the currently running kernel.

Once the RPM is installed, the 'elxlpfc' init script is installed
and configured to start and stop the 'lpfcdfc' driver during system
startup and shutdown.

3. Release Notes

3.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 Application Helper Module build to succeed.
For example, a system with the 2.6.9-6.37.EL kernel would need the
kernel-devel-2.6.9-6.37.EL package, and a system with the
2.6.9-6.37.ELsmp kernel would need the
kernel-smp-devel-2.6.9-6.37.EL package.

3.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 Application Helper Module build to succeed.
For example, a system with the 2.6.5-7.166-bigsmp kernel would need
the kernel-source-2.6.5-7.166 package.

RHEL4 Update 2 x86 (Intel), x86-64 (AMD and Intel), IA64
and SLES 9 SP3 x86 (Intel), X86-64 (AMD and Intel), IA64
Installation, Configuration and Troubleshooting (452 KB) Chapter 1 Introduction
Purpose of this document................................................................ 12
Host connectivity .............................................................................. 12
Fibre Channel ..............................................................................12
Fibre Channel over Ethernet .....................................................12
EMC storage array-specific settings............................................... 13
Boot device support.......................................................................... 13
Zoning ................................................................................................ 14
Useful Linux utilities and functions............................................... 14
Chapter 2 Installation Steps
Prerequisites for first-time installation .......................................... 16
Summary of installation steps......................................................... 18
Installing the adapter ....................................................................... 20
Matching the adapter with the correct PCI slot .....................22
Chapter 3 Installing and Configuring the BIOS Settings
Verifying and updating the Emulex boot BIOS............................ 28
Verifying the correct BIOS version...........................................28
Updating the boot BIOS.............................................................29
Method One — Updating the adapter boot BIOS with
hbacmd............................................................................................... 30
Method Two – Booting from a DOS bootable diskette and
using the lp6dutil utility .................................................................. 33
Chapter 4 Installing and Configuring the Driver
Installation instructions for the Emulex v8.x-series driver......... 36
Downloading the Emulex v8.x-series adapter driver for
the v2.6.x kernel .......................................................................... 37
Installing the Emulex CNA v8.x-series driver on RHEL
5.2 and SLES 10 SP2 hosts ......................................................... 38
Installing the Emulex v8.x-series driver on SLES 9 SP1
hosts.............................................................................................. 39
Installing the Emulex v8.x-series driver on RHEL 4
hosts.............................................................................................. 42
Included Emulex driver on RHEL 4, RHEL 5, OEL 4,
OEL 5, Asianux 2.0, Asianux 3.0, SLES 9, and SLES 10 ........ 45
Uninstalling the Emulex v8.x-series driver................................... 47
Installing the Emulex HBAnywhere applications kit.................. 48
Editing the configuration files ........................................................ 51
Description of the Emulex lpfc driver parameters ................ 51
Descriptions of the Emulex parameters .................................. 52
Editing the Emulex driver parameters on hosts with
SLES 9 and SLES 10 .................................................................... 54
Editing the Emulex driver parameters on hosts with
RHEL 4 and RHEL 5 .................................................................. 55
Editing the Emulex driver parameters on hosts with
Asianux 2.0 and Asianux 3.0..................................................... 56
Editing the Emulex driver parameters on hosts with
OEL 4 and OEL 5 ........................................................................ 57
Exercising the Emulex v8.x-series device driver.......................... 58
Loading and unloading the Emulex v8.x-series driver......... 58
Target information exported to the /proc filesystem ........... 59
Dynamically modifying the driver and device
information exported to the /sys filesystem.......................... 59

RHEL 3.0 Update 8 x86 (Intel), x86-64 (AMD and Intel), IA64
Includes HBAnyware v2.1a29 and LPUTIL v2.0a12. (180 MB tar file)

HBAnyware 2.1a29 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 2.1a29
SSC version 2.1a29
DFC Library version 1.2.1-1
Lputil version 2.0a12
HBAAPI version 2.0.f

Dependencies:

lpfc driver version 7.3.6 or later
HBAnyware is dependant on lpfc being installed, so install lpfc first if it is not already installed.

HBAnyware requires a minimum screen resolution of 1024 x 768.

Installing HBAnyware

1. Copy the applications kit tar file to a directory on the install machine
2. cd to the directory which you copied the tar file
3. Untar the file: tar -xvf tarfilename
4. su to root
5. Run the install script: ./install
Uninstalling HBAnyware

1. Complete steps 1 through 4 from "Installing HBAnyware" above.
2. Run the uninstall script: ./uninstall
Running the HBAnyware GUI

1. su to root
2. Run the script /usr/sbin/hbanyware/hbanyware
ppc64/sles8 NOTE:
If you want to use the 64bit HBAAPI libraries you must replace the following line in /etc/hba.conf:
com.emulex.emulexapilibrary /usr/lib/libemulexhbaapi.so
with this line
com.emulex.emulexapilibrary /usr/lib64/libemulexhbaapi.so

ppc64/(non-sles8) and amd64 NOTE:
If you want to use the 64bit HBAAPI libraries you must add the following line in /etc/hba.conf:
com.emulex.emulexapilibrary /usr/lib64/libemulexhbaapi.so

RHEL 3.0 Update 8 x86 (Intel), x86-64 (AMD and Intel), IA64
Installation, Configuration and Troubleshooting (663 KB pdf file) Chapter 1 Introduction
Purpose of this Document .............................................................. 1-2
Related Documentation .................................................................. 1-2
Host Connectivity ............................................................................ 1-2
EMC Storage Array-Specific Settings ........................................... 1-3
CLARiiON ................................................................................. 1-3
Symmetrix.................................................................................. 1-3
Boot Device Support........................................................................ 1-4
Zoning ............................................................................................... 1-4
Useful Linux Utilities and Functions ............................................ 1-5
Chapter 2 Installing and Configuring the Emulex HBA and
v7.x-Series Driver
Installing the HBA........................................................................... 2-2
Updating the Flash Firmware/BIOS............................................. 2-3
Method One - Booting from a DOS Bootable Floppy and
using the lp6dutil Utility ......................................................... 2-4
Method Two – Using lputil at the Command Line.............. 2-5
Installation Instructions for the Emulex v7.x-Series Driver .... 2-10
Enabling the Emulex v7.x-Series Driver in RHEL 3.0 U4
and U5 ...................................................................................... 2-10
Enabling the Emulex v7.x-Series Driver in Asianux 1.0
U1.............................................................................................. 2-11
Installing the IOCTL Application Helper Module on RHEL
3.0 U4 ........................................................................................ 2-12
Enabling the Emulex v7.3.2 Driver in RHEL 3.0 U6.......... 2-14
Installing the Emulex v7.x-Series Driver............................. 2-16
Installing the Emulex Applications Kit ............................... 2-25
Uninstallation of the Emulex v7.x-Series Driver....................... 2-27
Uninstallation Methods for the Emulex v7.x-Series
Driver ....................................................................................... 2-27
Uninstalling the Emulex v7.x-Series Driver, Method
One............................................................................................ 2-27
Upgrading from the Emulex v2.x-Series Driver to the
v7.x-Series Driver ................................................................... 2-28
Uninstalling the Emulex v7.x-Series Driver, Method
Two........................................................................................... 2-28
Editing the lpfc.conf File............................................................... 2-32
Emulex lpfc.conf Parameters ................................................ 2-32
Descriptions of lpfc.conf Parameters................................... 2-34
Enabling Persistent Binding......................................................... 2-38
Obtaining Initiator and Target Information ....................... 2-38
Editing /usr/src/lpfc/lpfc.conf .......................................... 2-39
Editing /etc/modules.conf ................................................... 2-41
Additional Notes ........................................................................... 2-44
Linux Device-Naming Convention...................................... 2-44
Device Reconfiguration: Procedures ................................... 2-48
Using the Emulex lun_scan script........................................ 2-50
Device Reconfiguration: Device Numbering ..................... 2-52

RHEL 3.0 Update 7 x86 (Intel), x86-64 (AMD and Intel) and IA64
Applications kit includes HBAnyware v2.1a29 and LPUTIL v2.0a12. (180 MB tar file)

HBAnyware 2.1a29 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 2.1a29
SSC version 2.1a29
DFC Library version 1.2.1-1
Lputil version 2.0a12
HBAAPI version 2.0.f

Dependencies:

lpfc driver version 7.3.3 or later
HBAnyware is dependant on lpfc being installed, so install lpfc first if it is not already installed.

HBAnyware requires a minimum screen resolution of 1024 x 768.

Installing HBAnyware

1. Copy the applications kit tar file to a directory on the install machine
2. cd to the directory which you copied the tar file
3. Untar the file: tar -xvf tarfilename
4. su to root
5. Run the install script: ./install
Uninstalling HBAnyware

1. Complete steps 1 through 4 from "Installing HBAnyware" above.
2. Run the uninstall script: ./uninstall
Running the HBAnyware GUI

1. su to root
2. Run the script /usr/sbin/hbanyware/hbanyware
ppc64/sles8 NOTE:
If you want to use the 64bit HBAAPI libraries you must replace the following line in /etc/hba.conf:
com.emulex.emulexapilibrary /usr/lib/libemulexhbaapi.so
with this line
com.emulex.emulexapilibrary /usr/lib64/libemulexhbaapi.so

ppc64/(non-sles8) and amd64 NOTE:
If you want to use the 64bit HBAAPI libraries you must add the following line in /etc/hba.conf:
com.emulex.emulexapilibrary /usr/lib64/libemulexhbaapi.so

HBAnyware Help:
To view the HBAnyware help pages or to access the Emulex Technical support pages you must have one of the
following web browsers installed:
mozilla, konqueror
Helpful scripts

/usr/sbin/hbanyware/stop_hbanyware - This script will stop all HBAnyware daemons and GUIs.
Run this if you need to unload the driver.

/usr/sbin/hbanyware/start_rmserver - This script will re-start the rmserver daemon.
Run this if you manually load the lpfc driver.

RHEL 3.0 Update 7 x86 (Intel), x86-64 (AMD and Intel) and IA64
Tar file containing the DKMS package installation and DKMS RPMs for the 7.3.3 module. This kit is supported on Red Hat distributions only. It automatically installs the drivers; no lpfc.conf parameter customization is needed prior to 1st driver compilation. This is an alternative installation method to using driver kits, or drivers on the Redhat distribution CDs. (344 KB gz file)

The DKMS (Dynamic Kernel Module System) project is maintained by Dell.
The latest version can be found at:

http://linux.dell.com/dkms/dkms.html

DKMS creates a framework where kernel dependent module source is
stored in the DKMS database. DKMS manages the building and
installation of the lpfc and lpfcdfc modules. These RPMs contain the
same lpfc source code as the non-DKMS RPMs but include DKMS in the RPM
package name to signify that the RPM includes our driver managed by
DKMS. The driver itself is the same, just the packaging is different.
DKMS RPMs for Emulex 7.3.3 linux FC driver
-------------------------------------------

Installation:
------------
1. Ensure that DKMS is installed. DKMS version 2.0.5-1 or greater is
required. You may install the DKMS RPM that is included as part of
this package.

rpm -i dkms-2.0.5-1.noarch.rpm

2. Install the dkms specific lpfc driver rpm

rpm -i lpfcdkms-7.3.3-1.noarch.rpm

3. Install the dkms specific lpfcdfc driver rpm

rpm -i lpfcdfcdkms-1.2.1-1.noarch.rpm

Post-Install:
-----------
1. Use the DKMS status command to verify that DKMS has built and
installed the drivers:

[root]# dkms status
lpfc, 7.3.3, 2.4.21-15.ELsmp, i686: installed (original_module exists)
lpfcdfc, 1.2.1, 2.4.21-15.ELsmp, i686: installed (original_module exists)

2. DKMS automatically builds the lpfc driver into the initial ram disk
so that lpfc is loaded on boot. To load the driver either reboot
or issue the following commands:

modprobe lpfc

3. The lpfcdfc module will not be automatically loaded at boot time.
This module is required for the HBAnyware and lputil applications
to execute properly. To load this module, issue the following
command:

modprobe lpfcdfc

RHEL 3.0 Update 7 x86 (Intel), x86-64 (AMD and Intel) and IA64
Installation, Configuration and Troubleshooting (663 KB) Chapter 1 Introduction
Purpose of this Document .............................................................. 1-2
Related Documentation .................................................................. 1-2
Host Connectivity ............................................................................ 1-2
EMC Storage Array-Specific Settings ........................................... 1-3
CLARiiON ................................................................................. 1-3
Symmetrix.................................................................................. 1-3
Boot Device Support........................................................................ 1-4
Zoning ............................................................................................... 1-4
Useful Linux Utilities and Functions ............................................ 1-5
Chapter 2 Installing and Configuring the Emulex HBA and
v7.x-Series Driver
Installing the HBA........................................................................... 2-2
Updating the Flash Firmware/BIOS............................................. 2-3
Method One - Booting from a DOS Bootable Floppy and
using the lp6dutil Utility ......................................................... 2-4
Method Two – Using lputil at the Command Line.............. 2-5
Installation Instructions for the Emulex v7.x-Series Driver .... 2-10
Enabling the Emulex v7.x-Series Driver in RHEL 3.0 U4
and U5 ...................................................................................... 2-10
Enabling the Emulex v7.x-Series Driver in Asianux 1.0
U1.............................................................................................. 2-11
Installing the IOCTL Application Helper Module on RHEL
3.0 U4 ........................................................................................ 2-12
Enabling the Emulex v7.3.2 Driver in RHEL 3.0 U6.......... 2-14
Installing the Emulex v7.x-Series Driver............................. 2-16
Installing the Emulex Applications Kit ............................... 2-25
Uninstallation of the Emulex v7.x-Series Driver....................... 2-27
Uninstallation Methods for the Emulex v7.x-Series
Driver ....................................................................................... 2-27
Uninstalling the Emulex v7.x-Series Driver, Method
One............................................................................................ 2-27
Upgrading from the Emulex v2.x-Series Driver to the
v7.x-Series Driver ................................................................... 2-28
Uninstalling the Emulex v7.x-Series Driver, Method
Two........................................................................................... 2-28
Editing the lpfc.conf File............................................................... 2-32
Emulex lpfc.conf Parameters ................................................ 2-32
Descriptions of lpfc.conf Parameters................................... 2-34
Enabling Persistent Binding......................................................... 2-38
Obtaining Initiator and Target Information ....................... 2-38
Editing /usr/src/lpfc/lpfc.conf .......................................... 2-39
Editing /etc/modules.conf ................................................... 2-41
Additional Notes ........................................................................... 2-44
Linux Device-Naming Convention...................................... 2-44
Device Reconfiguration: Procedures ................................... 2-48
Using the Emulex lun_scan script........................................ 2-50
Device Reconfiguration: Device Numbering ..................... 2-52

RHEL 3.0 Update 6 x86 (Intel), x86-64 (AMD and Intel) and IA64
HBAnyware utility 2.1a24, lputil 2.0a9 (180 MB tar file)

HBAnyware 2.1a24 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 2.1a24
SSC version 2.1a24
DFC Library version 1.2.1-1
Lputil version 2.0a9
HBAAPI version 2.0.f

Dependencies:

lpfc driver version 7.3.2-1 or later
HBAnyware is dependant on lpfc being installed, so install lpfc first if it is not already installed.

HBAnyware requires a minimum screen resolution of 1024 x 768.

Installing HBAnyware

1. Copy the applications kit tar file to a directory on the install machine
2. cd to the directory which you copied the tar file
3. Untar the file: tar -xvf tarfilename
4. su to root
5. Run the install script: ./install
Uninstalling HBAnyware

1. Complete steps 1 through 4 from "Installing HBAnyware" above.
2. Run the uninstall script: ./uninstall
Running the HBAnyware GUI

1. su to root
2. Run the script /usr/sbin/hbanyware/hbanyware
ppc64/sles8 NOTE:
If you want to use the 64bit HBAAPI libraries you must replace the following line in /etc/hba.conf:
com.emulex.emulexapilibrary /usr/lib/libemulexhbaapi.so
with this line
com.emulex.emulexapilibrary /usr/lib64/libemulexhbaapi.so

ppc64/(non-sles8) and amd64 NOTE:
If you want to use the 64bit HBAAPI libraries you must add the following line in /etc/hba.conf:
com.emulex.emulexapilibrary /usr/lib64/libemulexhbaapi.so

HBAnyware Help:
To view the HBAnyware help pages or to access the Emulex Technical support pages you must have one of the
following web browsers installed:
mozilla, konqueror
Helpful scripts

/usr/sbin/hbanyware/stop_hbanyware - This script will stop all HBAnyware daemons and GUIs.
Run this if you need to unload the driver.

/usr/sbin/hbanyware/start_rmserver - This script will re-start the rmserver daemon.
Run this if you manually load the lpfc driver.

RHEL 3.0 Update 6 x86 (Intel), x86-64 (AMD and Intel) and IA64
Tar file containing the DKMS package installation and DKMS RPMs for the 7.3.2 module. This kit is supported on Red Hat distributions only. It automatically installs the drivers; no lpfc.conf parameter customization is needed prior to 1st driver compilation. This is an alternative installation method to using driver kits above, or drivers on the Redhat distribution CDs. (344KB gz file)

Emulex 7.3.2 FC Driver and IOCTL Package

Introduction
------------

The DKMS (Dynamic Kernel Module System) project is maintained by Dell.
The latest version can be found at:

http://linux.dell.com/dkms/dkms.html

DKMS creates a framework where kernel dependent module source is
stored in the DKMS database. DKMS manages the building and
installation of the lpfc and lpfcdfc modules. These RPMs contain the
same lpfc source code as the non-DKMS RPMs but include DKMS in the RPM
package name to signify that the RPM includes our driver managed by
DKMS. The driver itself is the same, just the packaging is different.
DKMS RPMs for Emulex 7.3.2 linux FC driver
-------------------------------------------

Installation:
------------
1. Ensure that DKMS is installed. DKMS version 2.0.5-1 or greater is
required. You may install the DKMS RPM that is included as part of
this package.

rpm -i dkms-2.0.5-1.noarch.rpm

2. Install the dkms specific lpfc driver rpm

rpm -i lpfcdkms-7.3.2-1.noarch.rpm

3. Install the dkms specific lpfcdfc driver rpm

rpm -i lpfcdfcdkms-1.2.1-1.noarch.rpm

Post-Install:
-----------
1. Use the DKMS status command to verify that DKMS has built and
installed the drivers:

[root]# dkms status
lpfc, 7.3.2, 2.4.21-15.ELsmp, i686: installed (original_module exists)
lpfcdfc, 1.2.1, 2.4.21-15.ELsmp, i686: installed (original_module exists)

2. DKMS automatically builds the lpfc driver into the initial ram disk
so that lpfc is loaded on boot. To load the driver either reboot
or issue the following commands:

modprobe lpfc
modprobe lpfcdfc

RHEL 3.0 Update 6 x86 (Intel), x86-64 (AMD and Intel) and IA64
Installation, Configuration and Troubleshooting (663 KB) Chapter 1 Introduction
Purpose of this Document .............................................................. 1-2
Related Documentation .................................................................. 1-2
Host Connectivity ............................................................................ 1-2
EMC Storage Array-Specific Settings ........................................... 1-3
CLARiiON ................................................................................. 1-3
Symmetrix.................................................................................. 1-3
Boot Device Support........................................................................ 1-4
Zoning ............................................................................................... 1-4
Useful Linux Utilities and Functions ............................................ 1-5
Chapter 2 Installing and Configuring the Emulex HBA and
v7.x-Series Driver
Installing the HBA........................................................................... 2-2
Updating the Flash Firmware/BIOS............................................. 2-3
Method One - Booting from a DOS Bootable Floppy and
using the lp6dutil Utility ......................................................... 2-4
Method Two – Using lputil at the Command Line.............. 2-5
Installation Instructions for the Emulex v7.x-Series Driver .... 2-10
Enabling the Emulex v7.x-Series Driver in RHEL 3.0 U4
and U5 ...................................................................................... 2-10
Enabling the Emulex v7.x-Series Driver in Asianux 1.0
U1.............................................................................................. 2-11
Installing the IOCTL Application Helper Module on RHEL
3.0 U4 ........................................................................................ 2-12
Enabling the Emulex v7.3.2 Driver in RHEL 3.0 U6.......... 2-14
Installing the Emulex v7.x-Series Driver............................. 2-16
Installing the Emulex Applications Kit ............................... 2-25
Uninstallation of the Emulex v7.x-Series Driver....................... 2-27
Uninstallation Methods for the Emulex v7.x-Series
Driver ....................................................................................... 2-27
Uninstalling the Emulex v7.x-Series Driver, Method
One............................................................................................ 2-27
Upgrading from the Emulex v2.x-Series Driver to the
v7.x-Series Driver ................................................................... 2-28
Uninstalling the Emulex v7.x-Series Driver, Method
Two........................................................................................... 2-28
Editing the lpfc.conf File............................................................... 2-32
Emulex lpfc.conf Parameters ................................................ 2-32
Descriptions of lpfc.conf Parameters................................... 2-34
Enabling Persistent Binding......................................................... 2-38
Obtaining Initiator and Target Information ....................... 2-38
Editing /usr/src/lpfc/lpfc.conf .......................................... 2-39
Editing /etc/modules.conf ................................................... 2-41
Additional Notes ........................................................................... 2-44
Linux Device-Naming Convention...................................... 2-44
Device Reconfiguration: Procedures ................................... 2-48
Using the Emulex lun_scan script........................................ 2-50
Device Reconfiguration: Device Numbering ..................... 2-52

RHEL 3.0 Update 6 x86 (Intel), x86-64 (AMD and Intel) and IA64
32-Bit SuSE SLES 8 Intel (9.8 MB gz file)

This kit contains the following components:

lpfcdriver-2.02e.tgz - Emulex Fibre Channel Linux Driver
EmlxApps300a8-i386-SL8-TAR.tar - Emulex Applications kit
readme.first.txt - this file

It is important that the components of this kit be installed in the
appropriate order:

1) The driver kit must be installed first, followed by the applications
kit. Instructions for installing the driver kit can be found on the
Emulex website - www.emulex.com, under /ts/docfc/linuxframe.htm.

2) Once the driver has been successfully installed, then the applications
kit must be installed. Instructions for installing the applications kit
can be found in the README.txt file contained in the EmlxApps300a8-i386-SL8-TAR.tar package.

RHEL 3.0 Update 6 x86 (Intel), x86-64 (AMD and Intel) and IA64
32-Bit RHEL 2.1 Intel (10 MB gz file)

This kit contains the following components:

lpfcdriver-2.02e.tgz - Emulex Fibre Channel Linux Driver
EmlxApps300a8-i386-RH2.1-TAR.tar - Emulex Applications kit
readme.first.txt - this file

It is important that the components of this kit be installed in the
appropriate order:

1) The driver kit must be installed first, followed by the applications
kit. Instructions for installing the driver kit can be found on the
Emulex website - www.emulex.com, under /ts/docfc/linuxframe.htm.

2) Once the driver has been successfully installed, then the applications
kit must be installed. Instructions for installing the applications kit
can be found in the README.txt file contained in the EmlxApps300a8-i386-RH2.1-TAR.tar package.

RHEL 3.0 Update 6 x86 (Intel), x86-64 (AMD and Intel) and IA64
32-Bit RHEL 3.0 Intel (9 MB gz file)

This kit contains the following components:

lpfcdriver-2.02e.tgz - Emulex Fibre Channel Linux Driver
EmlxApps300a8-i386-RH3.0-TAR.tar - Emulex Applications kit
readme.first.txt - this file

It is important that the components of this kit be installed in the
appropriate order:

1) The driver kit must be installed first, followed by the applications
kit. Instructions for installing the driver kit can be found on the
Emulex website - www.emulex.com, under /ts/docfc/linuxframe.htm.

2) Once the driver has been successfully installed, then the applications
kit must be installed. Instructions for installing the applications kit
can be found in the README.txt file contained in the EmlxApps300a8-i386-RH3.0-TAR.tar package.

RHEL 3.0 Update 6 x86 (Intel), x86-64 (AMD and Intel) and IA64
EMC-approved RPM for Red Hat distributions only which automatically installs driver and application software; no parameter customization prior to 1st driver compilation. 32-Bit RHEL 2.1/3.0 Intel(330 KB gz file)

RHEL 3.0 Update 6 x86 (Intel), x86-64 (AMD and Intel) and IA64
Installation, Configuration and Troubleshooting (471 KB) Chapter 1 Introduction
Purpose of This Document ............................................................. 1-2
Related Documentation .................................................................. 1-2
Host Connectivity ............................................................................ 1-2
Director Bit Settings......................................................................... 1-3
Boot Device Support........................................................................ 1-3
Addressing........................................................................................ 1-3
Zoning ............................................................................................... 1-4
Useful Linux Utilities and Functions ............................................ 1-4
Chapter 2 Installing and Configuring the HBA and Driver
Installing the HBA........................................................................... 2-2
Updating the Flash Firmware/BIOS............................................. 2-3
Downloading the Emulex v2.x-Series HBA Driver for
the v2.4.x Kernel............................................................................... 2-5
What Next? ................................................................................ 2-5
Configuring the Host with the Emulex v2.x-Series HBA
Driver................................................................................................. 2-6
SuSE SLES 8 SP3 and the Emulex v2.02e Driver.................. 2-6
RHEL 2.1 and the Emulex v2.02e Driver............................. 2-10
RHEL 3.0 and the Emulex v2.02e Driver............................. 2-12
Recommended Changes to lpfc.conf ................................... 2-15
What Next? .............................................................................. 2-17
Enabling Persistent Binding ......................................................... 2-18
Obtaining Initiator and Target Information ....................... 2-18
Editing lpfc.conf...................................................................... 2-19
Editing /etc/modules.conf ................................................... 2-20
Additional Notes ........................................................................... 2-23
Linux Device-Naming Convention...................................... 2-23
Dynamic Device Reconfiguration: Procedures .................. 2-27
Dynamic Device Reconfiguration: Device Numbering .... 2-28
HPQ Server-Specific Note ..................................................... 2-29
(CLARiiON only) Required /etc/modules.conf Edit for
Red Hat Enterprise Linux 2.1 and 3.0 and SLES 8.0
Default Modular Kernels....................................................... 2-30
(CLARiiON only) Linux Naviagent Limitation with
fdisk on CLARiiON................................................................ 2-33
(CLARiiON only) Linux Naviagent Limitation with
VERITAS Volume Manager v3.2 on CLARiiON ............... 2-35
(CLARiiON only) Linux Naviagent Requirement for
Intel Itanium Systems on CLARiiON.................................. 2-36
(CLARiiON only) Passive-Not-Ready/ FailOverMode SP
Bit Setting and Spinning Up Devices................................... 2-37
Incorporating EMC Fibre Channel.............................................. 2-39
Review the EMC Support Matrix for the latest information on
approved HBAs and drivers.
? Purpose of This Document ...............................................................1-2
? Related Documentation.....................................................................1-2
? Host Connectivity ..............................................................................1-2
? Director Bit Settings ...........................................................................1-3
? Boot Device Support..........................................................................1-3
? Addressing..........................................................................................1-3
? Zoning..................................................................................................1-4
? Useful Linux Utilities and Functions ..............................................1-4

RHEL 3.0 Update 5 x86 (Intel), x86-64 (AMD and Intel) and x64 (Intel); Asianux 1.0 and SP1.
This kit includes the gz file containing an install script and 2 scripted source RPMs. (296 KB).

1. System Requirements
2. Description of Changes
3. Driver Installation
4. Driver Uninstallation
5. Errata

----------------------------------------------------------------------

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 3
Red Hat Enterprise Linux 2.1
SuSE Linux Enterprise Server 8 with Service Pack 3

2. Description of Changes

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.
The 'elxlpfc' init script is also installed and configured to start
and stop the 'lpfcdfc' driver during system startup and shutdown.

3. Driver Installation

Please refer to the LPFC Linux 7.1 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.

Emulex strongly recommends uninstalling any old LPFC driver kits
before installing the new driver kit. Please refer to the "Driver
Uninstallation" section to uninstall previous versions of the
Emulex LPFC 7.x or older driver.

Log in as the user 'root' to a terminal, change to the directory in
which the Emulex LPFC 7.1 driver kit is installed, 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.

RHEL 3.0 Update 5 x86 (Intel), x86-64 (AMD and Intel) and x64 (Intel); Asianux 1.0 and SP1.
Tar file containing install script and scripted source RPM to build and install the IOCTL application helper module. This is needed with the RHEL 3 Update 1 distribution (which contains the 7.1.14 driver). This driver allows applications to communicate with the 7.1.14 driver.

1. System Requirements
2. Description of Changes
3. Errata

----------------------------------------------------------------------

1. System Requirements

The Emulex LPFC DFC driver RPM requires that the kernel sources 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 3 Update 3

2. Description of Changes

The ioctl-install script installs the LPFC DFC driver RPM. This
RPM installs the driver sources to the /usr/src/lpfcdfc directory,
builds the driver for the currently running kernel, and then
installs the drivers to the proper directory for the currently
running kernel.

Once the RPM is installed, the 'elxlpfc' init script is installed
and configured to start and stop the 'lpfcdfc' driver during system
startup and shutdown.

3. Errata

- The Emulex HBAnyware configuration utility is not supported in
this release.

- On some large configurations, with many targets and other
initiators, FC discovery may not complete before the SCSI
subsystem probes for devices. If this occurs, some SCSI devices
may not be detected at boot. The missing devices can be detected
by requesting the SCSI subsystem to rescan via /proc/scsi/scsi
and the "scsi add-single-device "
mechanism. Emulex provides a script, called lun_scan, which
automates the scan requests for Emulex adapters. This script is
contained the driver applications kit. This script can be
integrated into the system run-level transitions to ensure that
all devices are fully detected.

RHEL 3.0 Update 5 x86 (Intel), x86-64 (AMD and Intel) and x64 (Intel); Asianux 1.0 and SP1.
Tar file containing the DKMS package installation and DKMS RPMs for the 7.1.14 and IOCTL application helper module. This kit is supported on Red Hat 2.1 and 3.0 distributions only. It automatically installs the drivers; no lpfc.conf parameter customization is needed prior to 1st driver compilation. This is an alternative installation method to using driver kits above, or drivers on the Redhat distribution CDs. (345 KB).

The DKMS (Dynamic Kernel Module System) project
is maintained by Dell. The latest version can
be found at http://linux.dell.com/dkms/dkms.html

DKMS creates a framework where kernel dependent
module source is stored in the DKMS database.
DKMS manages the building and installation
of the lpfc and lpfcdfc modules. These RPMs
contain the same lpfc source code as the non-DKMS
RPMs but include DKMS in the RPM package name to
signify that the RPM includes our driver managed by DKMS.
The driver itself is the same, just the packaging
is different.
DKMS RPMs for Emulex 7.1.14 linux FC driver
-------------------------------------------

Installation:
------------
1. Ensure that DKMS is installed. DKMS version
2.0.4-1 or greater is required. You may install
the DKMS RPM that is included as part of this
package.

rpm -i dkms-2.0.4-1.noarch.rpm

2. Install the dkms specific lpfc driver rpm

rpm -i lpfcdkms-7.1.14-3.noarch.rpm

3. Install the dkms specific lpfcdfc driver rpm

rpm -i lpfcdfcdkms-1.0.13-2.noarch.rpm
Post-Install:
-----------
1. Use the DKMS status command to verify that DKMS has
built and installed the drivers.

e.g.
[root]# dkms status
lpfc, 7.1.14, 2.4.21-15.ELsmp, i686: installed (original_module exists)
lpfcdfc, 1.0.13, 2.4.21-15.ELsmp, i686: installed (original_module exists)

2. DKMS automatically builds the lpfc driver into the initial ram disk so that
lpfc is loaded on boot. To load the driver either reboot or issue comamnds;

modprobe lpfc
modprobe lpfcdfc

RHEL 3.0 Update 5 x86 (Intel), x86-64 (AMD and Intel) and x64 (Intel); Asianux 1.0 and SP1.
This kit includes the Tar file containing the management utilites: HBAnyware v2.0a20 and LPUTIL v1.6a10. (143 MB).

HBAnyware 2.0a20 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 2.0a20
SSC version 2.0a15
DFC Library version 7.1.14
Lputil version 1.6a10
HBAAPI version 2.0.f

Dependencies:

lpfc 7.1.14
HBAnyware is dependant on lpfc being installed, so install lpfc first if it is not already installed.

Installing HBAnyware

1. Copy the ElxLinuxApps-2.0a20-7.1.14-1.tar file to a directory on the install machine
2. cd to the directory which you copied the tar file
3. Untar the file: tar -xvf ElxLinuxApps-2.0a20-7.1.14-1.tar
4. su to root
5. Run the install script: ./install
Uninstalling HBAnyware

1. Complete steps 1 through 4 from "Installing HBAnyware" above.
2. Run the uninstall script: ./uninstall
Running the HBAnyware GUI

1. su to root
2. Run the script /usr/sbin/hbanyware/hbanyware
ppc64/sles8 NOTE:
If you want to use the 64bit HBAAPI libraries you must replace the following line in /etc/hba.conf:
com.emulex.emulexapilibrary /usr/lib/libemulexhbaapi.so
with this line
com.emulex.emulexapilibrary /usr/lib64/libemulexhbaapi.so

ppc64/(non-sles8) and amd64 NOTE:
If you want to use the 64bit HBAAPI libraries you must add the following line in /etc/hba.conf:
com.emulex.emulexapilibrary /usr/lib64/libemulexhbaapi.so

HBAnyware Help:
To view the HBAnyware help pages or to access the Emulex Technical support pages you must have one of the
following web browsers installed:
mozilla, konqueror
Helpful scripts

/usr/sbin/hbanyware/stop_hbanyware - This script will stop all HBAnyware daemons and GUIs.
Run this if you need to unload the driver.

/usr/sbin/hbanyware/start_rmserver - This script will re-start the rmserver daemon.
Run this if you manually load the lpfc driver.

RHEL 3.0 Update 5 x86 (Intel), x86-64 (AMD and Intel) and x64 (Intel); Asianux 1.0 and SP1.
Installation, Configuration and Troubleshooting (663 KB) Chapter 1 Introduction
Purpose of this Document .............................................................. 1-2
Related Documentation .................................................................. 1-2
Host Connectivity ............................................................................ 1-2
EMC Storage Array-Specific Settings ........................................... 1-3
CLARiiON ................................................................................. 1-3
Symmetrix.................................................................................. 1-3
Boot Device Support........................................................................ 1-4
Zoning ............................................................................................... 1-4
Useful Linux Utilities and Functions ............................................ 1-5
Chapter 2 Installing and Configuring the Emulex HBA and
v7.x-Series Driver
Installing the HBA........................................................................... 2-2
Updating the Flash Firmware/BIOS............................................. 2-3
Method One - Booting from a DOS Bootable Floppy and
using the lp6dutil Utility ......................................................... 2-4
Method Two – Using lputil at the Command Line.............. 2-5
Installation Instructions for the Emulex v7.x-Series Driver .... 2-10
Enabling the Emulex v7.x-Series Driver in RHEL 3.0 U4
and U5 ...................................................................................... 2-10
Enabling the Emulex v7.x-Series Driver in Asianux 1.0
U1.............................................................................................. 2-11
Installing the IOCTL Application Helper Module on RHEL
3.0 U4 ........................................................................................ 2-12
Enabling the Emulex v7.3.2 Driver in RHEL 3.0 U6.......... 2-14
Installing the Emulex v7.x-Series Driver............................. 2-16
Installing the Emulex Applications Kit ............................... 2-25
Uninstallation of the Emulex v7.x-Series Driver....................... 2-27
Uninstallation Methods for the Emulex v7.x-Series
Driver ....................................................................................... 2-27
Uninstalling the Emulex v7.x-Series Driver, Method
One............................................................................................ 2-27
Upgrading from the Emulex v2.x-Series Driver to the
v7.x-Series Driver ................................................................... 2-28
Uninstalling the Emulex v7.x-Series Driver, Method
Two........................................................................................... 2-28
Editing the lpfc.conf File............................................................... 2-32
Emulex lpfc.conf Parameters ................................................ 2-32
Descriptions of lpfc.conf Parameters................................... 2-34
Enabling Persistent Binding......................................................... 2-38
Obtaining Initiator and Target Information ....................... 2-38
Editing /usr/src/lpfc/lpfc.conf .......................................... 2-39
Editing /etc/modules.conf ................................................... 2-41
Additional Notes ........................................................................... 2-44
Linux Device-Naming Convention...................................... 2-44
Device Reconfiguration: Procedures ................................... 2-48
Using the Emulex lun_scan script........................................ 2-50
Device Reconfiguration: Device Numbering ..................... 2-52

RHEL5 x86 (Intel), x86-64 (AMD and Intel), IA64
and SLES 9 SP1 x86 (Intel) x86-64 (AMD and Intel), IA64
Installation, Configuration and Troubleshooting (500 KB) Chapter 1 Introduction
Purpose of this document................................................................ 12
Host connectivity .............................................................................. 12
Fibre Channel ..............................................................................12
Fibre Channel over Ethernet .....................................................12
EMC storage array-specific settings............................................... 13
Boot device support.......................................................................... 13
Zoning ................................................................................................ 14
Useful Linux utilities and functions............................................... 14
Chapter 2 Installation Steps
Prerequisites for first-time installation .......................................... 16
Summary of installation steps......................................................... 18
Installing the adapter ....................................................................... 20
Matching the adapter with the correct PCI slot .....................22
Chapter 3 Installing and Configuring the BIOS Settings
Verifying and updating the Emulex boot BIOS............................ 28
Verifying the correct BIOS version...........................................28
Updating the boot BIOS.............................................................29
Method One — Updating the adapter boot BIOS with
hbacmd............................................................................................... 30
Method Two – Booting from a DOS bootable diskette and
using the lp6dutil utility .................................................................. 33
Chapter 4 Installing and Configuring the Driver
Installation instructions for the Emulex v8.x-series driver......... 36
Downloading the Emulex v8.x-series adapter driver for
the v2.6.x kernel .......................................................................... 37
Installing the Emulex CNA v8.x-series driver on RHEL
5.2 and SLES 10 SP2 hosts ......................................................... 38
Installing the Emulex v8.x-series driver on SLES 9 SP1
hosts.............................................................................................. 39
Installing the Emulex v8.x-series driver on RHEL 4
hosts.............................................................................................. 42
Included Emulex driver on RHEL 4, RHEL 5, OEL 4,
OEL 5, Asianux 2.0, Asianux 3.0, SLES 9, and SLES 10 ........ 45
Uninstalling the Emulex v8.x-series driver................................... 47
Installing the Emulex HBAnywhere applications kit.................. 48
Editing the configuration files ........................................................ 51
Description of the Emulex lpfc driver parameters ................ 51
Descriptions of the Emulex parameters .................................. 52
Editing the Emulex driver parameters on hosts with
SLES 9 and SLES 10 .................................................................... 54
Editing the Emulex driver parameters on hosts with
RHEL 4 and RHEL 5 .................................................................. 55
Editing the Emulex driver parameters on hosts with
Asianux 2.0 and Asianux 3.0..................................................... 56
Editing the Emulex driver parameters on hosts with
OEL 4 and OEL 5 ........................................................................ 57
Exercising the Emulex v8.x-series device driver.......................... 58
Loading and unloading the Emulex v8.x-series driver......... 58
Target information exported to the /proc filesystem ........... 59
Dynamically modifying the driver and device
information exported to the /sys filesystem.......................... 59

SLES10 (x86 Intel, x86-64 AMD and Intel), IA64
Includes HBAnyware utility 3.0a15, lputil 2.0a14 (163 MB tar file)

HBAnyware 3.0a15 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 3.0a15
SSC version 3.0a15
DFC Library version 80.162-1
Lputil version 2.0a14
HBAAPI version 2.1.c
DFC helper module

Dependencies:

lpfc driver version 8.1.6-2 or later

HBAnyware requires that the lpfc driver module be installed.

HBAnyware requires a minimum screen resolution of 1024 x 768.

HBAnyware requires the kernel development environment as described here:

This kit installs the Emulex Application Helper Module for the
currently running kernel. Since this installation procedure builds
the module for the currently running kernel, the kernel development
environment must be installed. For systems running Red Hat Enterprise
Linux (RHEL) 4, the appropriate kernel-devel package is required; 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. For
systems running SuSE Linux Enterprise Server (SLES) 9, the appropriate
kernel-source package is required; for example, a system with the
2.6.5-7.139-bigsmp kernel would need the kernel-source-2.6.5-7.139
package.
A log of each installation and uninstallation is recorded in the
following file:

/usr/src/lpfcdfc/utils-install.log
Installing HBAnyware:

1. Copy the applications kit tar file to a directory on the install machine
2. cd to the directory which you copied the tar file
3. Untar the file: tar -xvf tarfilename
4. cd (change directory) to the "ElxLinuxApps.." directory created by step 3
5. su to root
6. If earlier HBAnyware version currently installed, type : ./uninstall
7. Run the install script: ./install

SLES10 (x86 Intel, x86-64 AMD and Intel), IA64
Installation, Configuration and Troubleshooting (299 KB pdf file) Chapter 1 Introduction
Purpose of this document............................................................... 1-2
Related documentation ................................................................... 1-2
Host connectivity ............................................................................. 1-2
EMC storage array-specific settings.............................................. 1-3
For CLARiiON arrays .............................................................. 1-3
For Symmetrix arrays............................................................... 1-3
Boot device support......................................................................... 1-4
Zoning ............................................................................................... 1-4
Useful Linux utilities and functions.............................................. 1-5
Chapter 2 Installing and Configuring the Emulex HBA and
v8.x-Series Driver
Installing the HBA........................................................................... 2-2
Updating the Emulex HBA firmware and boot BIOS ................ 2-3
Method One – Using lputil at the Command Line .............. 2-4
Method Two - Booting from a DOS bootable
diskette and using the lp6dutil utility ................................ 2-9
Installation instructions for the Emulex v8.x-series driver...... 2-10
Downloading the Emulex v8.x-series HBA driver
for the v2.6.x kernel ............................................................. 2-11
Installing the Emulex v8.x-series driver on
SLES 9 SP1 hosts .................................................................. 2-11
Installing the Emulex v8.x-series driver on
RHEL 4.0 hosts ..................................................................... 2-14
Uninstalling the Emulex v8.x-series driver ........................ 2-17
Included Emulex driver on RHEL 4.0, SLES9,
SLES 10, and Asianux 2.0 ................................................... 2-18
Installing the Emulex Applications Kit ............................... 2-18
Editing the configuration files ..................................................... 2-20
Description of the Emulex lpfc driver parameters ............ 2-20
Descriptions of the Emulex parameters .............................. 2-21
Editing the Emulex driver parameters on hosts
with SLES 9 and SLES 10.................................................... 2-23
Editing the Emulex driver parameters on hosts
with RHEL 4.0...................................................................... 2-24
Editing the Emulex driver parameters on hosts
with Asianux 2.0 .................................................................. 2-25
Exercising the Emulex v8.x-series device driver....................... 2-26
Loading and unloading the Emulex v8.x-series driver..... 2-26
Target information exported to the /proc filesystem ....... 2-27
Dynamically modifying the driver and device
information exported to the /sys filesystem................... 2-27
Additional notes ............................................................................ 2-32
Using the Emulex lun-scan script ........................................ 2-32
Device reconfiguration: Procedures .................................... 2-33
Device reconfiguration: Device numbering........................ 2-35
HPQ server-specific note....................................................... 2-36
LUN 000 requirement for the Linux v2.6.x kernel............. 2-37
Incorporating EMC Fibre Channel ...................................... 2-37
Chapter 3 Configuring a Boot Device on the EMC Storage Array
Cautions and restrictions booting from an EMC storage
array................................................................................................ 3-2
CLARiiON-specific................................................................... 3-2
Symmetrix-specific ................................................................... 3-3
Common limitations........................................................................ 3-4
CLARiiON-specific................................................................... 3-6
Symmetrix-specific ................................................................... 3-6
Configuring the Emulex boot BIOS .............................................. 3-7

RHEL 4.6 and SLES 9 SP4 (x86 Intel,x86-64 AMD & Intel, IA64)
HBAnyware 3.03a20 lputil 2.0a14

HBAnyware 3.3a20 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 3.3a20
SSC version 3.3a20
DFC Library version 80.164-2
Lputil version 2.0a14
HBAAPI version 2.1.d_1

Dependencies:

lpfc driver version 8.0.16.34 or later

HBAnyware requires that the lpfc driver module be installed.

HBAnyware requires a minimum screen resolution of 1024 x 768.
Installing HBAnyware:

1. Copy the applications kit tar file to a directory on the install machine
2. cd to the directory which you copied the tar file
3. Untar the file: tar -xvf tarfilename
4. cd (change directory) to the "ElxLinuxApps.." directory created by step 3
5. su to root
6. If earlier HBAnyware version currently installed, type : ./uninstall
7. Run the install script: ./install
8. When prompted, answer the following question:

Select desired mode of operation for HBAnyware

1 Local Mode : HBA's on this Platform can be managed by HBAnyware
clients on this platform only.
2 Managed Mode : HBA's on this Platform can be managed by local or
remote HBAnyware clients
3 Remote Mode : Same as '2' plus HBAnyware clients on this Platform
can manage local and remote clients.

Enter the number '1' or '2' or '3'
9. When prompted, answer the following question:

Do you want to allow user to make subsequent management mode changes
using 'set_operating_mode' script
Enter the letter 'Y' for yes or 'N' for no

10. Installation Complete: type /usr/sbin/hbanyware/hbanyware
to start GUI or type /usr/sbin/hbanyware/hbacmd list
to run script utility

RHEL 4.6 and SLES 9 SP4 (x86 Intel,x86-64 AMD & Intel, IA64)
Installation, Configuration and Troubleshooting (500 KB pdf file) Chapter 1 Introduction
Purpose of this document................................................................ 12
Host connectivity .............................................................................. 12
Fibre Channel ..............................................................................12
Fibre Channel over Ethernet .....................................................12
EMC storage array-specific settings............................................... 13
Boot device support.......................................................................... 13
Zoning ................................................................................................ 14
Useful Linux utilities and functions............................................... 14
Chapter 2 Installation Steps
Prerequisites for first-time installation .......................................... 16
Summary of installation steps......................................................... 18
Installing the adapter ....................................................................... 20
Matching the adapter with the correct PCI slot .....................22
Chapter 3 Installing and Configuring the BIOS Settings
Verifying and updating the Emulex boot BIOS............................ 28
Verifying the correct BIOS version...........................................28
Updating the boot BIOS.............................................................29
Method One — Updating the adapter boot BIOS with
hbacmd............................................................................................... 30
Method Two – Booting from a DOS bootable diskette and
using the lp6dutil utility .................................................................. 33
Chapter 4 Installing and Configuring the Driver
Installation instructions for the Emulex v8.x-series driver......... 36
Downloading the Emulex v8.x-series adapter driver for
the v2.6.x kernel .......................................................................... 37
Installing the Emulex CNA v8.x-series driver on RHEL
5.2 and SLES 10 SP2 hosts ......................................................... 38
Installing the Emulex v8.x-series driver on SLES 9 SP1
hosts.............................................................................................. 39
Installing the Emulex v8.x-series driver on RHEL 4
hosts.............................................................................................. 42
Included Emulex driver on RHEL 4, RHEL 5, OEL 4,
OEL 5, Asianux 2.0, Asianux 3.0, SLES 9, and SLES 10 ........ 45
Uninstalling the Emulex v8.x-series driver................................... 47
Installing the Emulex HBAnywhere applications kit.................. 48
Editing the configuration files ........................................................ 51
Description of the Emulex lpfc driver parameters ................ 51
Descriptions of the Emulex parameters .................................. 52
Editing the Emulex driver parameters on hosts with
SLES 9 and SLES 10 .................................................................... 54
Editing the Emulex driver parameters on hosts with
RHEL 4 and RHEL 5 .................................................................. 55
Editing the Emulex driver parameters on hosts with
Asianux 2.0 and Asianux 3.0..................................................... 56
Editing the Emulex driver parameters on hosts with
OEL 4 and OEL 5 ........................................................................ 57
Exercising the Emulex v8.x-series device driver.......................... 58
Loading and unloading the Emulex v8.x-series driver......... 58
Target information exported to the /proc filesystem ........... 59
Dynamically modifying the driver and device
information exported to the /sys filesystem.......................... 59

RHEL4 Update 2 x86 (Intel), x86-64 (AMD and Intel), IA64
and SLES 9 SP3 x86 (Intel), X86-64 (AMD and Intel), IA64
Tar file containing the DKMS package installation and DKMS RPMs for the 8.0.16.17 and application helper module. This kit is supported on RHEL 4 distribution only. It automatically installs the drivers; no lpfc.conf parameter customization is needed prior to 1st driver compilation. This is an alternative installation method to using driver kits above, or drivers on the Redhat distribution CDs.

1. System Requirements
2. Installation Process
3. Release Notes
3.1 Red Hat Enterprise Linux 'kernel-devel' Package Requirement
3.2 SuSE Linux Enterprise Server 'kernel-source' Package Requirement

----------------------------------------------------------------------

1. System Requirements

The following distribution of Linux is supported by the Emulex
LPFC Application Helper Module:

Red Hat Enterprise Linux 4 Update 2

This Emulex LPFC Application Helper Module will function with the
Emulex LPFC driver that ships with this distribution of Linux.
Other versions of the LPFC driver will not function properly with
this version of the Application Helper Module.

2. Installation Process

The ioctl-install script can be used to install and uninstall the
LPFC Application Helper Module RPM. This RPM installs the module
sources to the /usr/src/lpfcdfc directory, builds the module for
the currently running kernel, and then installs the module to the
proper directory for the currently running kernel.

Once the RPM is installed, the 'elxlpfc' init script is installed
and configured to start and stop the 'lpfcdfc' driver during system
startup and shutdown.

For usage information, please execute the command:

./ioctl-install --help

3. Release Notes

3.1 Red Hat Enterprise Linux 'kernel-devel' Package Requirement

For Red Hat Enterprise Linux installations, the "Development Tools"
package in the software development environment and the kernel
development package with the same version as the currently running
kernel must be installed for the Application Helper Module build to
succeed.

The name of the kernel development package depends upon the name of
the kernel for which the Application Helper Module will be
installed. For example, a system with the 2.6.9-11.EL kernel
would need the kernel-devel-2.6.9-11.EL package, and a system
with the 2.6.9-11.ELsmp kernel would need the
kernel-smp-devel-2.6.9-11.EL package.

RHEL4 Update 2 x86 (Intel), x86-64 (AMD and Intel), IA64
and SLES 9 SP3 x86 (Intel), X86-64 (AMD and Intel), IA64
HBAnyware utility 2.1a25, lputil 2.0a9 (169 MB tar file)

HBAnyware 2.1a25 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 2.1a25
SSC version 2.1a25
DFC Library version 80.161-5
Lputil version 2.0a9
HBAAPI version 2.1.a

Dependencies:

lpfc driver version 8.0.16.17 or later
HBAnyware is dependant on lpfc being installed, so install lpfc first if it is not already installed.

HBAnyware requires a minimum screen resolution of 1024 x 768.

Installing HBAnyware

1. Copy the applications kit tar file to a directory on the install machine
2. cd to the directory which you copied the tar file
3. Untar the file: tar -xvf tarfilename
4. su to root
5. Run the install script: ./install
Uninstalling HBAnyware

1. Complete steps 1 through 4 from "Installing HBAnyware" above.
2. Run the uninstall script: ./uninstall
Running the HBAnyware GUI

1. su to root
2. Run the script /usr/sbin/hbanyware/hbanyware
ppc64/sles8 NOTE:
If you want to use the 64bit HBAAPI libraries you must replace the following line in /etc/hba.conf:
com.emulex.emulexapilibrary /usr/lib/libemulexhbaapi.so
with this line
com.emulex.emulexapilibrary /usr/lib64/libemulexhbaapi.so

ppc64/(non-sles8) and amd64 NOTE:
If you want to use the 64bit HBAAPI libraries you must add the following line in /etc/hba.conf:
com.emulex.emulexapilibrary /usr/lib64/libemulexhbaapi.so

HBAnyware Help:
To view the HBAnyware help pages or to access the Emulex Technical support pages you must have one of the
following web browsers installed:
mozilla, konqueror
Helpful scripts

/usr/sbin/hbanyware/stop_hbanyware - This script will stop all HBAnyware daemons and GUIs.
Run this if you need to unload the driver.

/usr/sbin/hbanyware/start_rmserver - This script will re-start the rmserver daemon.
Run this if you manually load the lpfc driver.

RHEL4 Update 2 x86 (Intel), x86-64 (AMD and Intel), IA64
and SLES 9 SP3 x86 (Intel), X86-64 (AMD and Intel), IA64
Tar file containing install script and scripted source RPM to build and install the IOCTL application helper module. This is needed with the RHEL 4 Update 2 distribution (which contains the 8.0.16.17 driver). This driver allows applications to communicate with the 8.0.16.17 driver.

1. System Requirements
2. Description of Changes
3. Release Notes
3.1 Red Hat Enterprise Linux 'kernel-devel' Package Requirement
3.2 SuSE Linux Enterprise Server 'kernel-source' Package Requirement

----------------------------------------------------------------------

1. System Requirements

The following distributions of Linux are supported by the Emulex
LPFC Application Helper Module:

Red Hat Enterprise Linux 4 Update 1
SuSE Linux Enterprise Server 9 SP2

2. Description of Changes

The ioctl-install script installs the LPFC Application Helper
Module RPM. This RPM installs the module sources to the
/usr/src/lpfcdfc directory, builds the module for the currently
running kernel, and then installs the module to the proper
directory for the currently running kernel.

Once the RPM is installed, the 'elxlpfc' init script is installed
and configured to start and stop the 'lpfcdfc' driver during system
startup and shutdown.

3. Release Notes

3.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 Application Helper Module build to succeed.
For example, a system with the 2.6.9-6.37.EL kernel would need the
kernel-devel-2.6.9-6.37.EL package, and a system with the
2.6.9-6.37.ELsmp kernel would need the
kernel-smp-devel-2.6.9-6.37.EL package.

3.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 Application Helper Module build to succeed.
For example, a system with the 2.6.5-7.166-bigsmp kernel would need
the kernel-source-2.6.5-7.166 package.

RHEL4 Update 2 x86 (Intel), x86-64 (AMD and Intel), IA64
and SLES 9 SP3 x86 (Intel), X86-64 (AMD and Intel), IA64
Installation, Configuration and Troubleshooting (452 KB) Chapter 1 Introduction
Purpose of this document................................................................ 12
Host connectivity .............................................................................. 12
Fibre Channel ..............................................................................12
Fibre Channel over Ethernet .....................................................12
EMC storage array-specific settings............................................... 13
Boot device support.......................................................................... 13
Zoning ................................................................................................ 14
Useful Linux utilities and functions............................................... 14
Chapter 2 Installation Steps
Prerequisites for first-time installation .......................................... 16
Summary of installation steps......................................................... 18
Installing the adapter ....................................................................... 20
Matching the adapter with the correct PCI slot .....................22
Chapter 3 Installing and Configuring the BIOS Settings
Verifying and updating the Emulex boot BIOS............................ 28
Verifying the correct BIOS version...........................................28
Updating the boot BIOS.............................................................29
Method One — Updating the adapter boot BIOS with
hbacmd............................................................................................... 30
Method Two – Booting from a DOS bootable diskette and
using the lp6dutil utility .................................................................. 33
Chapter 4 Installing and Configuring the Driver
Installation instructions for the Emulex v8.x-series driver......... 36
Downloading the Emulex v8.x-series adapter driver for
the v2.6.x kernel .......................................................................... 37
Installing the Emulex CNA v8.x-series driver on RHEL
5.2 and SLES 10 SP2 hosts ......................................................... 38
Installing the Emulex v8.x-series driver on SLES 9 SP1
hosts.............................................................................................. 39
Installing the Emulex v8.x-series driver on RHEL 4
hosts.............................................................................................. 42
Included Emulex driver on RHEL 4, RHEL 5, OEL 4,
OEL 5, Asianux 2.0, Asianux 3.0, SLES 9, and SLES 10 ........ 45
Uninstalling the Emulex v8.x-series driver................................... 47
Installing the Emulex HBAnywhere applications kit.................. 48
Editing the configuration files ........................................................ 51
Description of the Emulex lpfc driver parameters ................ 51
Descriptions of the Emulex parameters .................................. 52
Editing the Emulex driver parameters on hosts with
SLES 9 and SLES 10 .................................................................... 54
Editing the Emulex driver parameters on hosts with
RHEL 4 and RHEL 5 .................................................................. 55
Editing the Emulex driver parameters on hosts with
Asianux 2.0 and Asianux 3.0..................................................... 56
Editing the Emulex driver parameters on hosts with
OEL 4 and OEL 5 ........................................................................ 57
Exercising the Emulex v8.x-series device driver.......................... 58
Loading and unloading the Emulex v8.x-series driver......... 58
Target information exported to the /proc filesystem ........... 59
Dynamically modifying the driver and device
information exported to the /sys filesystem.......................... 59

SUSE SLES9 SP2 x86 (Intel), x64 (Intel), x86-64 (AMD and Intel), IA64
Applications kit includes HBAnyware v2.1a14 and LPUTIL v2.0a4. (158 MB tar file)

HBAnyware 2.1a14 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 2.1a14
SSC version 2.1a14
DFC Library version 8.0.16.7
Lputil version 2.0a4
HBAAPI version 2.1.a

Dependencies:

lpfc 8.0.16.7
HBAnyware is dependant on lpfc being installed, so install lpfc first if it is not already installed.

HBAnyware requires a minimum screen resolution of 1024 x 768.

Installing HBAnyware

1. Copy the ElxLinuxApps-2.1a14-8.0.16.7-1.tar file to a directory on the install machine
2. cd to the directory which you copied the tar file
3. Untar the file: tar -xvf ElxLinuxApps-2.1a14-8.0.16.7-1.tar
4. su to root
5. Run the install script: ./install
Uninstalling HBAnyware

1. Complete steps 1 through 4 from "Installing HBAnyware" above.
2. Run the uninstall script: ./uninstall
Running the HBAnyware GUI

1. su to root
2. Run the script /usr/sbin/hbanyware/hbanyware
ppc64/sles8 NOTE:
If you want to use the 64bit HBAAPI libraries you must replace the following line in /etc/hba.conf:
com.emulex.emulexapilibrary /usr/lib/libemulexhbaapi.so
with this line
com.emulex.emulexapilibrary /usr/lib64/libemulexhbaapi.so

ppc64/(non-sles8) and amd64 NOTE:
If you want to use the 64bit HBAAPI libraries you must add the following line in /etc/hba.conf:
com.emulex.emulexapilibrary /usr/lib64/libemulexhbaapi.so

HBAnyware Help:
To view the HBAnyware help pages or to access the Emulex Technical support pages you must have one of the
following web browsers installed:
mozilla, konqueror
Helpful scripts

/usr/sbin/hbanyware/stop_hbanyware - This script will stop all HBAnyware daemons and GUIs.
Run this if you need to unload the driver.

/usr/sbin/hbanyware/start_rmserver - This script will re-start the rmserver daemon.
Run this if you manually load the lpfc driver.

SUSE SLES9 SP2 x86 (Intel), x64 (Intel), x86-64 (AMD and Intel), IA64
Use this file only with the SUSE SLES9 SP2 distribution, which contains the 8.0.16.6_p3 driver. Note: The same Application Helper Module is applicable to both RHEL4 and SLES9. (201 KB gz file)

1. System Requirements
2. Description of Changes
3. Release Notes
3.1 Red Hat Enterprise Linux 'kernel-devel' Package Requirement
3.2 SuSE Linux Enterprise Server 'kernel-source' Package Requirement

----------------------------------------------------------------------

1. System Requirements

The following distributions of Linux are supported by the Emulex
LPFC Application Helper Module:

Red Hat Enterprise Linux 4 Update 1
SuSE Linux Enterprise Server 9 SP2

2. Description of Changes

The ioctl-install script installs the LPFC Application Helper
Module RPM. This RPM installs the module sources to the
/usr/src/lpfcdfc directory, builds the module for the currently
running kernel, and then installs the module to the proper
directory for the currently running kernel.

Once the RPM is installed, the 'elxlpfc' init script is installed
and configured to start and stop the 'lpfcdfc' driver during system
startup and shutdown.

3. Release Notes

3.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 Application Helper Module build to succeed.
For example, a system with the 2.6.9-6.37.EL kernel would need the
kernel-devel-2.6.9-6.37.EL package, and a system with the
2.6.9-6.37.ELsmp kernel would need the
kernel-smp-devel-2.6.9-6.37.EL package.

3.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 Application Helper Module build to succeed.
For example, a system with the 2.6.5-7.166-bigsmp kernel would need
the kernel-source-2.6.5-7.166 package.

SUSE SLES9 SP2 x86 (Intel), x64 (Intel), x86-64 (AMD and Intel), IA64
Installation, Configuration and Troubleshooting (2.33 MB) Chapter 1 Introduction
Purpose of this document................................................................ 12
Host connectivity .............................................................................. 12
Fibre Channel ..............................................................................12
Fibre Channel over Ethernet .....................................................12
EMC storage array-specific settings............................................... 13
Boot device support.......................................................................... 13
Zoning ................................................................................................ 14
Useful Linux utilities and functions............................................... 14
Chapter 2 Installation Steps
Prerequisites for first-time installation .......................................... 16
Summary of installation steps......................................................... 18
Installing the adapter ....................................................................... 20
Matching the adapter with the correct PCI slot .....................22
Chapter 3 Installing and Configuring the BIOS Settings
Verifying and updating the Emulex boot BIOS............................ 28
Verifying the correct BIOS version...........................................28
Updating the boot BIOS.............................................................29
Method One — Updating the adapter boot BIOS with
hbacmd............................................................................................... 30
Method Two – Booting from a DOS bootable diskette and
using the lp6dutil utility .................................................................. 33
Chapter 4 Installing and Configuring the Driver
Installation instructions for the Emulex v8.x-series driver......... 36
Downloading the Emulex v8.x-series adapter driver for
the v2.6.x kernel .......................................................................... 37
Installing the Emulex CNA v8.x-series driver on RHEL
5.2 and SLES 10 SP2 hosts ......................................................... 38
Installing the Emulex v8.x-series driver on SLES 9 SP1
hosts.............................................................................................. 39
Installing the Emulex v8.x-series driver on RHEL 4
hosts.............................................................................................. 42
Included Emulex driver on RHEL 4, RHEL 5, OEL 4,
OEL 5, Asianux 2.0, Asianux 3.0, SLES 9, and SLES 10 ........ 45
Uninstalling the Emulex v8.x-series driver................................... 47
Installing the Emulex HBAnywhere applications kit.................. 48
Editing the configuration files ........................................................ 51
Description of the Emulex lpfc driver parameters ................ 51
Descriptions of the Emulex parameters .................................. 52
Editing the Emulex driver parameters on hosts with
SLES 9 and SLES 10 .................................................................... 54
Editing the Emulex driver parameters on hosts with
RHEL 4 and RHEL 5 .................................................................. 55
Editing the Emulex driver parameters on hosts with
Asianux 2.0 and Asianux 3.0..................................................... 56
Editing the Emulex driver parameters on hosts with
OEL 4 and OEL 5 ........................................................................ 57
Exercising the Emulex v8.x-series device driver.......................... 58
Loading and unloading the Emulex v8.x-series driver......... 58
Target information exported to the /proc filesystem ........... 59
Dynamically modifying the driver and device
information exported to the /sys filesystem.......................... 59

RHEL5 x86 (Intel), x86-64 (AMD and Intel), IA64
and SLES 9 SP1 x86 (Intel) x86-64 (AMD and Intel), IA64
HBAnyware utility 3.2a5, lputil 2.0a14 (169 MB tar file)

HBAnyware 3.2a5 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 3.2a5
SSC version 3.2a5
DFC Library version 2.15.1000
Lputil version 2.0a14
HBAAPI version 2.1.e

Dependencies:

lpfc driver version 8.1.10.3 or later

HBAnyware requires that the lpfc driver module be installed.

HBAnyware requires a minimum screen resolution of 1024 x 768.
Installing HBAnyware:

1. Copy the applications kit tar file to a directory on the install machine
2. cd to the directory which you copied the tar file
3. Untar the file: tar -xvf tarfilename
4. cd (change directory) to the "ElxLinuxApps.." directory created by step 3
5. su to root
6. If earlier HBAnyware version currently installed, type : ./uninstall
7. Run the install script: ./install
8. When prompted, answer the following question:

Select desired mode of operation for HBAnyware

1 Local Mode : HBA's on this Platform can be managed by HBAnyware clients on this platform only.
2 Managed Mode : HBA's on this Platform can be managed by local or remote HBAnyware clients
3 Remote Mode : Same as '2' plus HBAnyware clients on this Platform can manage local and remote clients.

Enter the number '1' or '2' or '3'
9. When prompted, answer the following question:

Do you want to allow user to make subsequent management mode changes using 'set_operating_mode' script
Enter the letter 'Y' for yes or 'N' for no

10. Installation Complete: type /usr/sbin/hbanyware/hbanyware
to start GUI
or type /usr/sbin/hbanyware/hbacmd list
to run script utility

RHEL5 x86 (Intel), x86-64 (AMD and Intel), IA64
and SLES 9 SP1 x86 (Intel) x86-64 (AMD and Intel), IA64
Installation, Configuration and Troubleshooting (500 KB) Chapter 1 Introduction
Purpose of this document................................................................ 12
Host connectivity .............................................................................. 12
Fibre Channel ..............................................................................12
Fibre Channel over Ethernet .....................................................12
EMC storage array-specific settings............................................... 13
Boot device support.......................................................................... 13
Zoning ................................................................................................ 14
Useful Linux utilities and functions............................................... 14
Chapter 2 Installation Steps
Prerequisites for first-time installation .......................................... 16
Summary of installation steps......................................................... 18
Installing the adapter ....................................................................... 20
Matching the adapter with the correct PCI slot .....................22
Chapter 3 Installing and Configuring the BIOS Settings
Verifying and updating the Emulex boot BIOS............................ 28
Verifying the correct BIOS version...........................................28
Updating the boot BIOS.............................................................29
Method One — Updating the adapter boot BIOS with
hbacmd............................................................................................... 30
Method Two – Booting from a DOS bootable diskette and
using the lp6dutil utility .................................................................. 33
Chapter 4 Installing and Configuring the Driver
Installation instructions for the Emulex v8.x-series driver......... 36
Downloading the Emulex v8.x-series adapter driver for
the v2.6.x kernel .......................................................................... 37
Installing the Emulex CNA v8.x-series driver on RHEL
5.2 and SLES 10 SP2 hosts ......................................................... 38
Installing the Emulex v8.x-series driver on SLES 9 SP1
hosts.............................................................................................. 39
Installing the Emulex v8.x-series driver on RHEL 4
hosts.............................................................................................. 42
Included Emulex driver on RHEL 4, RHEL 5, OEL 4,
OEL 5, Asianux 2.0, Asianux 3.0, SLES 9, and SLES 10 ........ 45
Uninstalling the Emulex v8.x-series driver................................... 47
Installing the Emulex HBAnywhere applications kit.................. 48
Editing the configuration files ........................................................ 51
Description of the Emulex lpfc driver parameters ................ 51
Descriptions of the Emulex parameters .................................. 52
Editing the Emulex driver parameters on hosts with
SLES 9 and SLES 10 .................................................................... 54
Editing the Emulex driver parameters on hosts with
RHEL 4 and RHEL 5 .................................................................. 55
Editing the Emulex driver parameters on hosts with
Asianux 2.0 and Asianux 3.0..................................................... 56
Editing the Emulex driver parameters on hosts with
OEL 4 and OEL 5 ........................................................................ 57
Exercising the Emulex v8.x-series device driver.......................... 58
Loading and unloading the Emulex v8.x-series driver......... 58
Target information exported to the /proc filesystem ........... 59
Dynamically modifying the driver and device
information exported to the /sys filesystem.......................... 59

EMC qualifies operation of the hardware, drivers, firmware and Boot Bios for the products referenced, as documented in the current EMC ESM (EMC Support Matrix). Utility software, including HBAnyware and various stand alone utilities used to manage or maintain Emulex products, are not tested by EMC. Utility software is provided for the convenience of EMC customers. Emulex is responsible for the integrity, functionality and support.
WARNING: You are about to download the EMC Approved HBA driver. This driver is optimized for use with EMC "-E" HBAs. It is being made available to you to update your approved EMC HBAs to support your EMC and non-EMC hardware environments. Downloading this EMC approved driver for use with an unqualified or unsupported HBA may be inconsistent with applicable terms and conditions. If you have any questions about the suitability of downloading this driver, contact your Emulex or EMC sales team.

Installation ...............................................................................................1
Driver Information .................................................................................................... 1
Supported Features........................................................................................... 1
New Features in this Release............................................................................ 1
Prerequisites ..................................................................................................... 2
For the lpfc Driver Kit .................................................................................. 2
Compatibility...................................................................................................... 2
Things to Know Before You Download .............................................................. 3
Known Issues .................................................................................................... 3
Installing the Driver Kit ............................................................................................ 3
Driver Kit Install Script Options.......................................................................... 4
Driver Kit Directory Structure ............................................................................. 4
Installing the Driver on Unsupported Linux Distributions.......................................... 5
Upgrading the Kernel or Applying a Distribution Service Pack or Update ................ 5
Installing the Driver Kit into an Upgraded Kernel ............................................... 5
Booting From a Non-Zero LUN Attached to an Emulex Adapter .............................. 6
Installing the HBAnyware Utility ............................................................................... 6
Uninstalling the Driver Kit .................................................................................. 7
Configuration ..........................................................................................8
Driver Configuration Methods Using modprobe and
/etc/modprobe.conf............................................................................................ 8
Temporary Configuration Method ................................................................ 8
Persistent Configuration Method ................................................................. 8
Temporary Driver Configuration by Read/Write to sysfs .................................... 9
Creating a New Ramdisk Image ...................................................................... 10
For Installed lpfc Driver Kits ...................................................................... 10
For Distribution In-Box lpfc Drivers............................................................ 10
Dynamically Adding LUNs and Targets............................................................ 10
Driver Parameters Reference Table ................................................................ 11
Using udev for Persistent Naming ................................................................... 15
Using udev to Discover Logical to Physical Mappings for sd Devices ....... 15
Configuring the System to Boot From SAN Using Persistent Names ........ 15
Using udev with st Devices ....................................................................... 16
Further Information About Persistent Names ............................................ 17
Working with Virtual Ports (vports)......................................................................... 18
Creating, Deleting and Displaying vports......................................................... 18
The mkvport.sh Script ............................................................................... 18
The rmvport.sh Script................................................................................ 19
The lsvport.sh Script ................................................................................. 19
The vport Sysfs Tree ....................................................................................... 19
Driver Version 8.2.8.14 sysfs Structure............................................................ 20
Vport sysfs Entries .................................................................................... 21
Vport Configuration Limits ............................................................................... 23
DHCHAP Authentication and Configuration ........................................................... 24
Authentication Configuration Parameters ........................................................ 25
Setting Remote and Local Passwords ............................................................. 25

Please note: EMC qualifies operation of the hardware, drivers, firmware and Boot Bios for the products referenced, as documented in the current EMC ESM (EMC Support Matrix). Utility software, including HBAnyware and various stand alone utilities used to manage or maintain Emulex products, are not tested by EMC. Utility software is provided for the convenience of EMC customers. Emulex is responsible for the integrity, functionality and support.
WARNING: You are about to download the EMC Approved HBA driver. This driver is optimized for use with EMC "-E" HBAs. It is being made available to you to update your approved EMC HBAs to support your EMC and non-EMC hardware environments. Downloading this EMC approved driver for use with an unqualified or unsupported HBA may be inconsistent with applicable terms and conditions. If you have any questions about the suitability of downloading this driver, contact your Emulex or EMC sales team.

vSphere 4 (ESX 4.0/ESX 4.0 U1, vCenter 4.0) - 2, 4 & 8 Gb/s HBAs and 10 Gb/s CNAs
HBAnyware 4.0a44 agent, hbacmd, HP Rubah library version 9.0 (2.02 MB rpm file)

vSphere 4 (ESX 4.0/ESX 4.0 U1, vCenter 4.0) - 2, 4 & 8 Gb/s HBAs and 10 Gb/s CNAs
Driver for VMware User Manual, version 8.2.0.30.52vmw

Installation...............................................................................................1
Driver Information .................................................................................................... 1
Supported Features........................................................................................... 1
New Features in this Release............................................................................ 1
Prerequisites ..................................................................................................... 1
Compatibility...................................................................................................... 2
Known Issues .................................................................................................... 2
Installing the Driver.................................................................................................. 2
Installing the Emulex Utilities................................................................................... 3
Installing the HBAnyware Agent and lputil ......................................................... 3
Prerequisites ............................................................................................... 3
Procedures.................................................................................................. 3
Uninstalling the Emulex Utilities............................................................................... 4
Uninstalling the HBAnyware Agent and lputil..................................................... 4
Configuration ..........................................................................................5
Introduction.............................................................................................................. 5
Configuration Methods Using Native ESX Tools................................................ 5
Permanent Configuration Methods.............................................................. 5
Temporary Configuration Method ................................................................ 6
Dynamically Add LUNs and Targets......................................................................... 7
Driver Configuration Parameters ............................................................................. 7
Creating a Fibre Channel Remote Boot Disk ......................................................... 10
Troubleshooting....................................................................................11
Introduction............................................................................................................ 11
Unusual Situations and Their Resolutions ............................................................. 11
General Situations........................................................................................... 11
lpfc Log Messages................................................................................................. 13
Introducton ...................................................................................................... 13
Severity Codes.......................................................................................... 13
Message Group Masks ............................................................................. 13
Message Log Example.............................................................................. 14
ELS Events (0100 - 0199) ............................................................................... 15
Link Discovery Events (0200 - 0299) ............................................................... 19
Mailbox Events (0300 - 0399).......................................................................... 28
Initialization Events (0400 - 0499) ................................................................... 33
FCP Traffic History (0700 - 0799) .................................................................... 39
Node Table Events (0900 - 0999) .................................................................... 42
Miscellaneous Events (1200 - 1299) ............................................................... 44
Link Events (1300 - 1399) ............................................................................... 45
Log Messages - LIBDFC Events (1600 - 1699) ............................................... 47
Supported Features
• Supports 256 (0-255) logical unit numbers (LUNs)
• Supports dynamically adding LUNs and targets
• Topology support: FC-AL, point-to-point, fabric with auto-topology negotiation
• Support for 1, 2 and 4 Gb with auto rate negotiation
• Protocols: SCSI-FCP, FCP-2 (FC-Tape profile, including use of ADISC instead of PLOGI), FC
initiator mode
• Support for up to sixteen host bus adapter (HBA) ports
• Monitoring and parameter configuration using Emulex's HBAnyware™ Java-based graphical
user interface utility and the HBACMD scriptable command-line interface
• Parameter configuration using Emulex's LightPulse® lputil command-line interface utility
• Support for Common HBA API

vSphere 4 (ESX 4.0/ESX 4.0 U1, vCenter 4.0) - 2, 4 & 8 Gb/s HBAs and 10 Gb/s CNAs
HBAnyware Command Line Version 4.0 (812 KB pdf file)

Installation ...............................................................................................1
Driver Information .................................................................................................... 1
Supported Features........................................................................................... 1
New Features in this Release............................................................................ 1
Prerequisites ..................................................................................................... 2
For the lpfc Driver Kit .................................................................................. 2
Compatibility...................................................................................................... 2
Things to Know Before You Download .............................................................. 3
Known Issues .................................................................................................... 3
Installing the Driver Kit ............................................................................................ 3
Driver Kit Install Script Options.......................................................................... 4
Driver Kit Directory Structure ............................................................................. 4
Installing the Driver on Unsupported Linux Distributions.......................................... 5
Upgrading the Kernel or Applying a Distribution Service Pack or Update ................ 5
Installing the Driver Kit into an Upgraded Kernel ............................................... 5
Booting From a Non-Zero LUN Attached to an Emulex Adapter .............................. 6
Installing the HBAnyware Utility ............................................................................... 6
Uninstalling the Driver Kit .................................................................................. 7
Configuration ..........................................................................................8
Driver Configuration Methods Using modprobe and
/etc/modprobe.conf............................................................................................ 8
Temporary Configuration Method ................................................................ 8
Persistent Configuration Method ................................................................. 8
Temporary Driver Configuration by Read/Write to sysfs .................................... 9
Creating a New Ramdisk Image ...................................................................... 10
For Installed lpfc Driver Kits ...................................................................... 10
For Distribution In-Box lpfc Drivers............................................................ 10
Dynamically Adding LUNs and Targets............................................................ 10
Driver Parameters Reference Table ................................................................ 11
Using udev for Persistent Naming ................................................................... 15
Using udev to Discover Logical to Physical Mappings for sd Devices ....... 15
Configuring the System to Boot From SAN Using Persistent Names ........ 15
Using udev with st Devices ....................................................................... 16
Further Information About Persistent Names ............................................ 17
Working with Virtual Ports (vports)......................................................................... 18
Creating, Deleting and Displaying vports......................................................... 18
The mkvport.sh Script ............................................................................... 18
The rmvport.sh Script................................................................................ 19
The lsvport.sh Script ................................................................................. 19
The vport Sysfs Tree ....................................................................................... 19
Driver Version 8.2.8.14 sysfs Structure............................................................ 20
Vport sysfs Entries .................................................................................... 21
Vport Configuration Limits ............................................................................... 23
DHCHAP Authentication and Configuration ........................................................... 24
Authentication Configuration Parameters ........................................................ 25
Setting Remote and Local Passwords ............................................................. 25

Virtual Infrastructure 3 v3.5 (ESX 3.5 U4, Virtual Center 2.5) - 10 Gb/s CNAs
The ESX 3.5 U2 lpdf Driver Version 7.4.0.41 is embedded in the VMware release.
HBAnyware 4.0a45 agent, hbacmd, HP Rubah library version 9.0 (932 KB rpm file)

Virtual Infrastructure 3 v3.5 (ESX 3.5 U4, Virtual Center 2.5) - 10 Gb/s CNAs
The ESX 3.5 U2 lpdf Driver Version 7.4.0.41 is embedded in the VMware release.
Driver for VMware User Manual, version 7.4.0.41

Installation...............................................................................................1
Driver Information .................................................................................................... 1
Supported Features........................................................................................... 1
New Features in this Release............................................................................ 1
Prerequisites ..................................................................................................... 1
Compatibility...................................................................................................... 2
Known Issues .................................................................................................... 2
Installing the Driver.................................................................................................. 2
Installing the Emulex Utilities................................................................................... 3
Installing the HBAnyware Agent and lputil ......................................................... 3
Prerequisites ............................................................................................... 3
Procedures.................................................................................................. 3
Uninstalling the Emulex Utilities............................................................................... 4
Uninstalling the HBAnyware Agent and lputil..................................................... 4
Configuration ..........................................................................................5
Introduction.............................................................................................................. 5
Configuration Methods Using Native ESX Tools................................................ 5
Permanent Configuration Methods.............................................................. 5
Temporary Configuration Method ................................................................ 6
Dynamically Add LUNs and Targets......................................................................... 7
Driver Configuration Parameters ............................................................................. 7
Creating a Fibre Channel Remote Boot Disk ......................................................... 10
Troubleshooting....................................................................................11
Introduction............................................................................................................ 11
Unusual Situations and Their Resolutions ............................................................. 11
General Situations........................................................................................... 11
lpfc Log Messages................................................................................................. 13
Introducton ...................................................................................................... 13
Severity Codes.......................................................................................... 13
Message Group Masks ............................................................................. 13
Message Log Example.............................................................................. 14
ELS Events (0100 - 0199) ............................................................................... 15
Link Discovery Events (0200 - 0299) ............................................................... 19
Mailbox Events (0300 - 0399).......................................................................... 28
Initialization Events (0400 - 0499) ................................................................... 33
FCP Traffic History (0700 - 0799) .................................................................... 39
Node Table Events (0900 - 0999) .................................................................... 42
Miscellaneous Events (1200 - 1299) ............................................................... 44
Link Events (1300 - 1399) ............................................................................... 45
Log Messages - LIBDFC Events (1600 - 1699) ............................................... 47
Supported Features
• Supports 256 (0-255) logical unit numbers (LUNs)
• Supports dynamically adding LUNs and targets
• Topology support: FC-AL, point-to-point, fabric with auto-topology negotiation
• Support for 1, 2 and 4 Gb with auto rate negotiation
• Protocols: SCSI-FCP, FCP-2 (FC-Tape profile, including use of ADISC instead of PLOGI), FC
initiator mode
• Support for up to sixteen host bus adapter (HBA) ports
• Monitoring and parameter configuration using Emulex's HBAnyware™ Java-based graphical
user interface utility and the HBACMD scriptable command-line interface
• Parameter configuration using Emulex's LightPulse® lputil command-line interface utility
• Support for Common HBA API

Virtual Infrastructure 3 v3.5 (ESX 3.5 U4, Virtual Center 2.5) - 10 Gb/s CNAs
The ESX 3.5 U2 lpdf Driver Version 7.4.0.41 is embedded in the VMware release.
HBAnyware Utility Version 4.0 Introduction.............................................................................................................. 1
Known Issues .................................................................................................... 1
Installing HBAnyware Components.......................................................................... 2
Installing the HBAnyware Utility......................................................................... 2
Installing the HBAnyware Utility with Web Launch............................................. 4
Installing the HBAnyware Utility Security Configurator ...................................... 5
Uninstalling the HBAnyware Security Configurator............................................ 6
Uninstalling HBAnyware Web Launch Only ....................................................... 7
Uninstalling the Utility Package ......................................................................... 7
Using the HBAnyware Components......................................................................... 8
Starting the HBAnyware Utility........................................................................... 8
Starting HBAnyware with Web Launch .............................................................. 8
Starting the HBAnyware Security Configurator .................................................. 8
Starting HBAnyware from the Command Line ................................................... 9
Examples of Modifications .................................................................... 9
The HBAnyware Utility Window Element Definitions ....................................... 10
The Menu Bar ........................................................................................... 11
The Toolbar ............................................................................................... 11
The Toolbar Buttons .................................................................................. 11
Sort Toolbar Buttons ........................................................................... 11
The Discovery-Tree................................................................................... 12
Discovery-Tree Icons .......................................................................... 12
Property Tabs............................................................................................ 13
Status Bar ................................................................................................. 13
Changing Management Mode ......................................................................... 13
Resetting HBAs ............................................................................................... 14
Discovering HBAs ........................................................................................... 14
Automatic Fibre Channel Discovery .......................................................... 14
Remote SAN Management Using TCP/IP Access Protocol....................... 15
Adding a Single Host .......................................................................... 15
Adding a Range of Hosts .................................................................... 16
Removing Hosts.................................................................................. 17
Configuring Discovery Settings ................................................................. 18
Sorting HBA Information.................................................................................. 19
Viewing Remote and Local HBAs.............................................................. 19
Viewing HBA Information................................................................................. 20
Viewing Discovery Information .................................................................. 20
Viewing Host Information .......................................................................... 21
The Host Information Tab.................................................................... 21
The Driver Parameters Tab................................................................. 22
Viewing General HBA Attributes ............................................................... 23
Viewing Detailed HBA Information ............................................................ 24
Viewing Fabric Information........................................................................ 26
Viewing Target Information........................................................................ 27
Viewing LUN Information........................................................................... 28
Masking and Unmasking LUNs (Windows, Solaris LPFC and
Solaris SFS)........................................................................................ 29
Viewing Port Statistics............................................................................... 31
Viewing Firmware Information ................................................................... 33
Viewing Target Mapping (Windows, Solaris LPFC and Solaris SFS)......... 34
Viewing Target Mapping (Linux) ................................................................ 35

Microsoft WHQL Qualified for Windows 2000 Server
Base driver, HBAnyware utility 2.1a21 and elxcfg version 1.41a17 (14 MB exe file)

Microsoft WHQL Qualified for Windows 2000 Server
Installation, Configuration and Troubleshooting (2,918 KB pdf file) Chapter 1 Installation and Configuration
How this guide works...................................................................... 18
Downloading latest Emulex drivers/firmware/BIOS
files ............................................................................................... 18
Installing the adapter ....................................................................... 20
Matching the adapter with the correct PCI slot .................... 22
Fibre Channel over Ethernet (FCoE) .............................................. 27
Booting from the external storage array........................................ 28
Updating the flash firmware/BIOS ........................................ 28
Emulex LightPulse-based Fibre Channel adapter
BIOS/boot LUN settings .......................................................... 36
Installing a RAMDISK under the EFI shell ............................ 76
Installing Windows on an external SAN disk using an EFI
RAMDISK .......................................................................................... 77
Windows 2000/2003 external boot disk installation ............ 77
Windows 2008 internal/external boot disk installation ...... 84
Windows 2008 Server Core operating system option.................. 94
Limitations.................................................................................. 95
EMC support .............................................................................. 95
Installing adapter driver and software utilities............................ 97
Pre-installation guidelines........................................................ 97
Installing or upgrading the driver and utilities .................... 98
Updating the adapter firmware using the HBAnyware
utility ......................................................................................... 107
Adapter BIOS upgrade................................................................... 111
Fibre Channel over Ethernet (FCoE) Converged Network
Adapter (CNA) procedures........................................................... 115
Overview .................................................................................. 115
Installing Fibre Channel firmware on an Emulex CNA.... 118
Installing Menlo firmware on an Emulex CNA.................. 124
Installing or upgrading the driver and utilities on an
Emulex OCe10102-FM CNA.................................................. 130
Updating adapter firmware on an Emulex OCe10102-FM
CNA........................................................................................... 137
Configuring Emulex OneConnect FCoE BIOS/boot LUN
settings for OCe10102-FM CNA adapters ........................... 144
Establishing connectivity to the storage array ........................... 154
Verifying connectivity to the storage array................................. 155
Starting HBAnyware for Windows ...................................... 155
Starting device manager for Windows................................. 157
Starting disk management for Windows ............................. 157
Starting PowerPath GUI for Windows................................. 158
Installing additional Navisphere Host Agent software ............ 160
Emulex NPIV solution ................................................................... 162
Chapter 2 Miscellaneous Planning and Procedures

Microsoft WHQL Qualified for Windows 2000 Server
Base driver, HBAnyware utility 2.1a21 and elxcfg version 1.41a17 (14 MB exe file)

Microsoft WHQL Qualified for Windows 2000 Server
Installation, Configuration and Troubleshooting (2,918 KB) Chapter 1 Installation and Configuration
How this guide works...................................................................... 18
Downloading latest Emulex drivers/firmware/BIOS
files ............................................................................................... 18
Installing the adapter ....................................................................... 20
Matching the adapter with the correct PCI slot .................... 22
Fibre Channel over Ethernet (FCoE) .............................................. 27
Booting from the external storage array........................................ 28
Updating the flash firmware/BIOS ........................................ 28
Emulex LightPulse-based Fibre Channel adapter
BIOS/boot LUN settings .......................................................... 36
Installing a RAMDISK under the EFI shell ............................ 76
Installing Windows on an external SAN disk using an EFI
RAMDISK .......................................................................................... 77
Windows 2000/2003 external boot disk installation ............ 77
Windows 2008 internal/external boot disk installation ...... 84
Windows 2008 Server Core operating system option.................. 94
Limitations.................................................................................. 95
EMC support .............................................................................. 95
Installing adapter driver and software utilities............................ 97
Pre-installation guidelines........................................................ 97
Installing or upgrading the driver and utilities .................... 98
Updating the adapter firmware using the HBAnyware
utility ......................................................................................... 107
Adapter BIOS upgrade................................................................... 111
Fibre Channel over Ethernet (FCoE) Converged Network
Adapter (CNA) procedures........................................................... 115
Overview .................................................................................. 115
Installing Fibre Channel firmware on an Emulex CNA.... 118
Installing Menlo firmware on an Emulex CNA.................. 124
Installing or upgrading the driver and utilities on an
Emulex OCe10102-FM CNA.................................................. 130
Updating adapter firmware on an Emulex OCe10102-FM
CNA........................................................................................... 137
Configuring Emulex OneConnect FCoE BIOS/boot LUN
settings for OCe10102-FM CNA adapters ........................... 144
Establishing connectivity to the storage array ........................... 154
Verifying connectivity to the storage array................................. 155
Starting HBAnyware for Windows ...................................... 155
Starting device manager for Windows................................. 157
Starting disk management for Windows ............................. 157
Starting PowerPath GUI for Windows................................. 158
Installing additional Navisphere Host Agent software ............ 160
Emulex NPIV solution ................................................................... 162
Chapter 2 Miscellaneous Planning and Procedures

Microsoft WHQL Qualified for Windows 2000 Server and 32-bit Windows Server 2003
Base driver, HBAnyware utility 2.1a21 and elxcfg version 1.41a17 (14 MB exe file)

Microsoft WHQL Qualified for Windows 2000 Server and 32-bit Windows Server 2003
Installation, Configuration and Troubleshooting (2,918 KB) Chapter 1 Installation and Configuration
How this guide works...................................................................... 18
Downloading latest Emulex drivers/firmware/BIOS
files ............................................................................................... 18
Installing the adapter ....................................................................... 20
Matching the adapter with the correct PCI slot .................... 22
Fibre Channel over Ethernet (FCoE) .............................................. 27
Booting from the external storage array........................................ 28
Updating the flash firmware/BIOS ........................................ 28
Emulex LightPulse-based Fibre Channel adapter
BIOS/boot LUN settings .......................................................... 36
Installing a RAMDISK under the EFI shell ............................ 76
Installing Windows on an external SAN disk using an EFI
RAMDISK .......................................................................................... 77
Windows 2000/2003 external boot disk installation ............ 77
Windows 2008 internal/external boot disk installation ...... 84
Windows 2008 Server Core operating system option.................. 94
Limitations.................................................................................. 95
EMC support .............................................................................. 95
Installing adapter driver and software utilities............................ 97
Pre-installation guidelines........................................................ 97
Installing or upgrading the driver and utilities .................... 98
Updating the adapter firmware using the HBAnyware
utility ......................................................................................... 107
Adapter BIOS upgrade................................................................... 111
Fibre Channel over Ethernet (FCoE) Converged Network
Adapter (CNA) procedures........................................................... 115
Overview .................................................................................. 115
Installing Fibre Channel firmware on an Emulex CNA.... 118
Installing Menlo firmware on an Emulex CNA.................. 124
Installing or upgrading the driver and utilities on an
Emulex OCe10102-FM CNA.................................................. 130
Updating adapter firmware on an Emulex OCe10102-FM
CNA........................................................................................... 137
Configuring Emulex OneConnect FCoE BIOS/boot LUN
settings for OCe10102-FM CNA adapters ........................... 144
Establishing connectivity to the storage array ........................... 154
Verifying connectivity to the storage array................................. 155
Starting HBAnyware for Windows ...................................... 155
Starting device manager for Windows................................. 157
Starting disk management for Windows ............................. 157
Starting PowerPath GUI for Windows................................. 158
Installing additional Navisphere Host Agent software ............ 160
Emulex NPIV solution ................................................................... 162
Chapter 2 Miscellaneous Planning and Procedures

Qualification: Microsoft WHQL Qualified for Windows 2000 Server and 32-bit Windows Server 2003
Note This driver requires hot fix Q903081 for SP1 and non-SP1 Windows 2003 configurations including x86, x64, and IA64.
Base driver, HBAnyware utility 2.1a17 and lputilnt version 1.8a15 (15 MB exe file)

Qualification: Microsoft WHQL Qualified for Windows 2000 Server and 32-bit Windows Server 2003
Note This driver requires hot fix Q903081 for SP1 and non-SP1 Windows 2003 configurations including x86, x64, and IA64.
Base driver, HBAnyware utility 2.1a17 and elxcfg version 1.41a17

This kit contains the following components:

elxstorinstall5111a0c.zip - Emulex Fibre Channel Storport Miniport Driver
EmlxApps21a17-1b.zip - Emulex Applications Kit
readme.first.txt - this file

The detailed contents for each of these components can be found in
the readme files included in each individual kit. The specific minimum
system requirements for each of these kits can be found in the same files.

It is important that the components of this kit be installed in the
appropriate order:

1) The driver kit must be installed first, followed by the applications
kit. Instructions for installing the driver kit can be found in the
relnotes.doc file included in the Emulex Driver Kit listed above.

2) Once the driver has been successfully installed, then the applications
kit must be installed. Instructions for installing the applications
kit can be found in the readme.pdf file contained in the Emulex
Applications Kit listed above.

Qualification: Microsoft WHQL Qualified for Windows 2000 Server and 32-bit Windows Server 2003
Note This driver requires hot fix Q903081 for SP1 and non-SP1 Windows 2003 configurations including x86, x64, and IA64.
Base driver, HBAnyware utility 2.1a17 and elxcfg version 1.41a17

This kit contains the following components:

elxstorinstall6111a0dc.zip - Emulex Fibre Channel Storport Miniport Driver
EmlxApps21a17-1b.zip - Emulex Applications Kit
readme.first.txt - this file

The detailed contents for each of these components can be found in
the readme files included in each individual kit. The specific minimum
system requirements for each of these kits can be found in the same files.

It is important that the components of this kit be installed in the
appropriate order:

1) The driver kit must be installed first, followed by the applications
kit. Instructions for installing the driver kit can be found in the
relnotes.doc file included in the Emulex Driver Kit listed above.

2) Once the driver has been successfully installed, then the applications
kit must be installed. Instructions for installing the applications
kit can be found in the readme.pdf file contained in the Emulex
Applications Kit listed above.

Qualification: Microsoft WHQL Qualified for Windows 2000 Server and 32-bit Windows Server 2003
Note This driver requires hot fix Q903081 for SP1 and non-SP1 Windows 2003 configurations including x86, x64, and IA64.
Base driver, HBAnyware utility 2.1a17 and elxcfg version 1.41a17

This kit contains the following components:

elxstorinstall7111a0c.zip - Emulex Fibre Channel Storport Miniport Driver
EmlxApps21a17-1b.zip - Emulex Applications Kit
readme.first.txt - this file

The detailed contents for each of these components can be found in
the readme files included in each individual kit. The specific minimum
system requirements for each of these kits can be found in the same files.

It is important that the components of this kit be installed in the
appropriate order:

1) The driver kit must be installed first, followed by the applications
kit. Instructions for installing the driver kit can be found in the
relnotes.doc file included in the Emulex Driver Kit listed above.

2) Once the driver has been successfully installed, then the applications
kit must be installed. Instructions for installing the applications
kit can be found in the readme.pdf file contained in the Emulex
Applications Kit listed above.

Qualification: Microsoft WHQL Qualified for Windows 2000 Server and 32-bit Windows Server 2003
Note This driver requires hot fix Q903081 for SP1 and non-SP1 Windows 2003 configurations including x86, x64, and IA64.
Installation, Configuration and Troubleshooting (2,918 KB) Chapter 1 Installation and Configuration
How this guide works...................................................................... 18
Downloading latest Emulex drivers/firmware/BIOS
files ............................................................................................... 18
Installing the adapter ....................................................................... 20
Matching the adapter with the correct PCI slot .................... 22
Fibre Channel over Ethernet (FCoE) .............................................. 27
Booting from the external storage array........................................ 28
Updating the flash firmware/BIOS ........................................ 28
Emulex LightPulse-based Fibre Channel adapter
BIOS/boot LUN settings .......................................................... 36
Installing a RAMDISK under the EFI shell ............................ 76
Installing Windows on an external SAN disk using an EFI
RAMDISK .......................................................................................... 77
Windows 2000/2003 external boot disk installation ............ 77
Windows 2008 internal/external boot disk installation ...... 84
Windows 2008 Server Core operating system option.................. 94
Limitations.................................................................................. 95
EMC support .............................................................................. 95
Installing adapter driver and software utilities............................ 97
Pre-installation guidelines........................................................ 97
Installing or upgrading the driver and utilities .................... 98
Updating the adapter firmware using the HBAnyware
utility ......................................................................................... 107
Adapter BIOS upgrade................................................................... 111
Fibre Channel over Ethernet (FCoE) Converged Network
Adapter (CNA) procedures........................................................... 115
Overview .................................................................................. 115
Installing Fibre Channel firmware on an Emulex CNA.... 118
Installing Menlo firmware on an Emulex CNA.................. 124
Installing or upgrading the driver and utilities on an
Emulex OCe10102-FM CNA.................................................. 130
Updating adapter firmware on an Emulex OCe10102-FM
CNA........................................................................................... 137
Configuring Emulex OneConnect FCoE BIOS/boot LUN
settings for OCe10102-FM CNA adapters ........................... 144
Establishing connectivity to the storage array ........................... 154
Verifying connectivity to the storage array................................. 155
Starting HBAnyware for Windows ...................................... 155
Starting device manager for Windows................................. 157
Starting disk management for Windows ............................. 157
Starting PowerPath GUI for Windows................................. 158
Installing additional Navisphere Host Agent software ............ 160
Emulex NPIV solution ................................................................... 162
Chapter 2 Miscellaneous Planning and Procedures