Emulex LP10000ExDC Download Drivers, Utilities, Manual, Firmware and BIOS

Bus Type PCI Express
Max Bus Speed 2.5 Gb/s lane (x4)
Product Type HBA
Platform: Intel (32-bit) 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.
\2.02a2.txt this file you are reading

\DB202a2.PRG Lp8000 adapter boot BIOS version 2.02a2
\CB202a2.PRG Lp9000 adapter boot BIOS version 2.02a2
\HB202a2.PRG Lp9802 adapter boot BIOS version 2.02a2
\TB202a2.PRG Lp10000 adapter boot BIOS version 2.02a2
\BB202a2.PRG Lp11000 adapter boot BIOS version 2.02a2
\QB202a2.PRG Lp850 adapter boot BIOS version 2.02a2
\RB202a2.PRG Lp952 adapter boot BIOS version 2.02a2
\LB202a2.PRG Lp982 adapter boot BIOS version 2.02a2
\MB202a2.PRG Lp1050 adapter boot BIOS version 2.02a2
\JB202a2.PRG Lp1150 adapter boot BIOS version 2.02a2
\EB202a2.PRG Lp101 adapter boot BIOS version 2.02a2
\YB202a2.PRG LPe111 adapter boot BIOS version 2.02a2
\AB202a2.PRG Lp21000 adapter boot BIOS version 2.02a2
\WB202a2.PRG LPe1150 adapter boot BIOS version 2.02a2
\ZB202a2.PRG LPe11000 adapter boot BIOS version 2.02a2
\UB202a2.PRG LPe12000 adapter boot BIOS version 2.02a2
\OB202a2.PRG LPe1250 adapter boot BIOS version 2.02a2
\PB202a2.PRG LPe121 adapter boot BIOS version 2.02a2


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

(1) BIOS downloading

The adapter boot BIOS image has increased in size to 49K. 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.

Bus Type PCI Express
Max Bus Speed 2.5 Gb/s lane (x4)
Product Type HBA Introduction..............................................................................................................1
Emulex Boot Code Files....................................................................................1
Boot from SAN.........................................................................................................2
Windows Server 2008 and Windows Server 2003.............................................2
Configure Boot from SAN on Windows Server 2008 and Windows Server 2003 (x86 and x64)..........................................................2
Configure Boot from SAN on Windows Server 2008 and Windows Server 2003 (Itanium)..................................................................3
New Installation of Windows 2008 UEFI- Aware Operating System
on a UEFI-based x64 Server.................................................................3
Direct a UEFI-Based Server to a Windows Server 2008 OS Image (Installed as UEFI-Aware) Already Installed on the SAN.......................4
The GUID Partition Table......................................................................4
Install Windows Server 2008 on an FC Boot Disk (x86, x64 and Itanium)...5
Install Windows Server 2003 on an FC Boot Disk (x86, and x64
and Itanium)................................................................................................6
Linux and VMware.............................................................................................7
Configure Boot from SAN on Linux or VMware (x86 and x64).....................7
Configure Boot from SAN on Linux (PowerPC)...........................................7
Configure Boot from SAN on Linux (Itanium)..............................................7
Solaris...............................................................................................................8
Configure Boot from SAN on Solaris SFS (x86 and x64)............................8
Determine LUNs to Select for Boot from SAN.......................................8
Configure Boot from SAN on Solaris SFS (SPARC)....................................8
Configure Boot from SAN on Solaris LPFC (SPARC)..................................9
Install Solaris from a Network Image..................................................10
Install Solaris by Migrating an Image from a Local SCSI Disk.............11
Install, Update and Enable Boot Code...................................................................14
BIOS Utility............................................................................................................15
Start the BIOS Utility.................................................................................15
Enable an Adapter to Boot from SAN........................................................17
Configure Boot Devices...................................................................................17
Configure Adapter Parameters........................................................................21
Change the Default AL_PA (Arbitrated Loop Physical Address)................22
Change the PLOGI Retry Timer................................................................23
Change Topology......................................................................................24
Enable or Disable the Spinup Delay..........................................................25
Set Auto Scan...........................................................................................26
Enable or Disable EDD 3.0.......................................................................27
Enable or Disable the Start Unit Command...............................................28
Enable or Disable the Environment Variable.............................................29
Enable or Disable Auto Boot Sector..........................................................30
Change Link Speed...................................................................................31
Reset to Default Values.............................................................................32
Use Multi-Path Boot from SAN..................................................................33
OpenBoot..............................................................................................................34
Attribute Commands.................................................................................34
Functional Commands..............................................................................35
EFIBoot.................................................................................................................37
Install the EFI Utility..................................................................................37
Start the EFI Utility....................................................................................38

Bus Type PCI Express
Max Bus Speed 2.5 Gb/s lane (x4)
Product Type HBA Compatibility:

This kit supports the LP10000, LP10000DC and LP10000ExDC
PCI host adapters.

This kit includes the following files:

README.TXT The file you are reading

TD192A1.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)

Improved operation of Pegasus Rx DMA firmware on PCI-X bus.
(CR 21542)

Bus Type PCI Express
Max Bus Speed 2.5 Gb/s lane (x4)
Product Type HBA Introduction.............................................................................................................. 1
Prerequisites ..................................................................................................... 1
Things to Know Before You Download ............................................................. 1
Update Utilities ........................................................................................................ 2

Introduction
For information about any firmware release, see the release notes on the Emulex Web site. Release
notes include information such as new features, compatibility, known issues and resolved known issues.
This manual does not contain the procedures themselves. It serves as a guide to the publication that
contains the procedures you need.

Prerequisites
• Local boot disk.
• The intended Fibre Channel target should be big enough to hold all system files and the swap
slice of the current local boot disk.

Things to Know Before You Download
• Before you download the OneConnect or LightPulse files, create a directory for them.
• As a measure of protection, ensure that critical files on your local boot disk are backed up.
• Firmware may be bundled with boot code. Boot code allows you to designate a device that is
attached to the adapter as a boot drive. If you select a firmware image that includes boot code,
the update procedure will load both the new firmware and the boot code at the same time. After
updating, refer to the Emulex Boot Manual for procedures on enabling the boot code on your
adapter.
• Emulex firmware files support both OneConnect and LightPulse adapters.
• For OneConnect adapters:
• Firmware and boot code are provided in a single flash image called a .UFI file.
• The UFI file contains all of the files that support all OneConnect adapters. The latest
files for your adapter are installed automatically when you use an Emulex utility to
update the firmware.
• The UFI file contains both firmware and boot code.
• For LightPulse adapters:
• Firmware is provided in a .ZIP file as a .ALL file or a .AWC file. You must manually unzip
the .ALL or .AWC file from the .ZIP file before you can use an Emulex utility to install it.
• Firmware differs between adapter models. Make sure you download the appropriate
firmware for your adapter.
• The .ZIP file may or may not include a boot code (.PRG) file.

SUSE Linux Enterprise Server 8 Service Pack 4 (x86, x64 and Intel Itanium2 architectures) Red Hat Enterprise Linux 2.1 Updates 7 and 8 (x86 and Intel Itanium2 architectures) Red Hat Enterprise Linux 3 Updates 6, 7 and 8 (x86, x64 and Intel Itanium2 architectures)
Base driver, application helper module and install script (299 KB gz file)

SUSE Linux Enterprise Server 8 Service Pack 4 (x86, x64 and Intel Itanium2 architectures) Red Hat Enterprise Linux 2.1 Updates 7 and 8 (x86 and Intel Itanium2 architectures) Red Hat Enterprise Linux 3 Updates 6, 7 and 8 (x86, x64 and Intel Itanium2 architectures)
HBAnyware utility 2.1a29, lputil 2.0a12 (175 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

SUSE Linux Enterprise Server 8 Service Pack 4 (x86, x64 and Intel Itanium2 architectures) Red Hat Enterprise Linux 2.1 Updates 7 and 8 (x86 and Intel Itanium2 architectures) Red Hat Enterprise Linux 3 Updates 6, 7 and 8 (x86, x64 and Intel Itanium2 architectures)
SMI-S HBA Provider, compliant with the SMI-S 1.0.2 specification and certified against the SNIA-CTP v1.0.2.23 suite. Pre-packaged with OpenPegasus CIMOM v2.3.2, as a turnkey SMI-S agent for ease of installation and deployment

RELEASE NOTES for Emulex SMI-S HBA Provider
Version 1.0.12
SECTION 1. Introduction
SECTION 2. System Prerequisites
SECTION 3. Supported and Tested Operating Systems
SECTION 4. Installation
SECTION 5. Directory Structure
SECTION 6. Known Limitations
SECTION 7. Frequently Asked Questions
SECTION 1. Introduction

The Emulex SMI HBA Provider is integrated/bundled with OpenPegasus Common
Information Model Object Manager (CIMOM) as a pre-packaged, ready to deploy
SMI-S agent. This package incorporates version 2.3.2 of the OpenPegasus
CIMOM ("http://www.openpegasus.org").

This release supports the FC HBA profile, Server profile and a partial
implementation of the Host Discovered Resources (HDR) profile. The Emulex
SMI-S HBA Provider is certified by SNIA Conformance Testing Program (CTP)
v1.0.2.23, and it is fully compliant with SMI-S v1.0.2.

SLPD (Service Location Protocol) is included with the Emulex SMI-S HBA Provider
kit and run by default if the system does not have one. For security purposes,
you might want to replace the sample certificates (privkey.cert and elxhba.cert)
with your own signed certificates.

Please refer to "http://www.openssl.org/docs/HOWTO/" for more details on how
to create a certificate.

NOTE: The OpenSSL library was built to exclude support for the IDEA, MDC2
and RC5 encryption algorithms.

License agreements for these Open Source components and the Emulex software
are found in the ancillary.txt file.

The Emulex SMI-S HBA Provider is registered under the namespace: root/emulex.
By default, the following account is created only on Windows:
User Name: cimadmin
Password: pwd580

On Linux, the default user account is:
User Name: root
Password: pwd580

SUSE Linux Enterprise Server 8 Service Pack 4 (x86, x64 and Intel Itanium2 architectures) Red Hat Enterprise Linux 2.1 Updates 7 and 8 (x86 and Intel Itanium2 architectures) Red Hat Enterprise Linux 3 Updates 6, 7 and 8 (x86, x64 and Intel Itanium2 architectures)
SMI-S HBA Provider, compliant with the SMI-S 1.0.2 specification and certified against the SNIA-CTP v1.0.2.23 suite. Pre-packaged with OpenPegasus CIMOM v2.3.2, as a turnkey SMI-S agent for ease of installation and deployment

RELEASE NOTES for Emulex SMI-S HBA Provider
Version 1.0.12
SECTION 1. Introduction
SECTION 2. System Prerequisites
SECTION 3. Supported and Tested Operating Systems
SECTION 4. Installation
SECTION 5. Directory Structure
SECTION 6. Known Limitations
SECTION 7. Frequently Asked Questions
SECTION 1. Introduction

The Emulex SMI HBA Provider is integrated/bundled with OpenPegasus Common
Information Model Object Manager (CIMOM) as a pre-packaged, ready to deploy
SMI-S agent. This package incorporates version 2.3.2 of the OpenPegasus
CIMOM ("http://www.openpegasus.org").

This release supports the FC HBA profile, Server profile and a partial
implementation of the Host Discovered Resources (HDR) profile. The Emulex
SMI-S HBA Provider is certified by SNIA Conformance Testing Program (CTP)
v1.0.2.23, and it is fully compliant with SMI-S v1.0.2.

SLPD (Service Location Protocol) is included with the Emulex SMI-S HBA Provider
kit and run by default if the system does not have one. For security purposes,
you might want to replace the sample certificates (privkey.cert and elxhba.cert)
with your own signed certificates.

Please refer to "http://www.openssl.org/docs/HOWTO/" for more details on how
to create a certificate.

NOTE: The OpenSSL library was built to exclude support for the IDEA, MDC2
and RC5 encryption algorithms.

License agreements for these Open Source components and the Emulex software
are found in the ancillary.txt file.

The Emulex SMI-S HBA Provider is registered under the namespace: root/emulex.
By default, the following account is created only on Windows:
User Name: cimadmin
Password: pwd580

On Linux, the default user account is:
User Name: root
Password: pwd580

SUSE Linux Enterprise Server 8 Service Pack 4 (x86, x64 and Intel Itanium2 architectures) Red Hat Enterprise Linux 2.1 Updates 7 and 8 (x86 and Intel Itanium2 architectures) Red Hat Enterprise Linux 3 Updates 6, 7 and 8 (x86, x64 and Intel Itanium2 architectures)
Installation, Configuration and Troubleshooting (3,451 KB pdf file)

SUSE Linux Enterprise Server 8 Service Pack 3 (x86 and x64 and Intel Itanium2 architectures)
Red Hat Enterprise Linux 2.1 Updates 5 and 6 (x86 and Intel Itanium2 architectures)
Red Hat Enterprise Linux 3 Updates 2, 3, 4 and 5 (x86 and x64 and Intel Itanium2 architectures)
Base driver, application helper module and install script
(297 KB gz file)

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.3 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.3 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.

SUSE Linux Enterprise Server 8 Service Pack 3 (x86 and x64 and Intel Itanium2 architectures)
Red Hat Enterprise Linux 2.1 Updates 5 and 6 (x86 and Intel Itanium2 architectures)
Red Hat Enterprise Linux 3 Updates 2, 3, 4 and 5 (x86 and x64 and Intel Itanium2 architectures)
HBAnyware utility 2.1a24, lputil 2.0a9 (175 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.

SUSE Linux Enterprise Server 8 Service Pack 3 (x86 and x64 and Intel Itanium2 architectures)
Red Hat Enterprise Linux 2.1 Updates 5 and 6 (x86 and Intel Itanium2 architectures)
Red Hat Enterprise Linux 3 Updates 2, 3, 4 and 5 (x86 and x64 and Intel Itanium2 architectures)
SMI-S HBA Provider, compliant with the SMI-S 1.0.2 specification and certified against the SNIA-CTP v1.0.2.23 suite
Pre-packaged with OpenPegasus CIMOM v2.3.2, as a turnkey SMI-S agent for ease of installation and deployment

RELEASE NOTES for Emulex SMI-S HBA Provider
Version 1.0.12
SECTION 1. Introduction
SECTION 2. System Prerequisites
SECTION 3. Supported and Tested Operating Systems
SECTION 4. Installation
SECTION 5. Directory Structure
SECTION 6. Known Limitations
SECTION 7. Frequently Asked Questions
SECTION 1. Introduction

The Emulex SMI HBA Provider is integrated/bundled with OpenPegasus Common
Information Model Object Manager (CIMOM) as a pre-packaged, ready to deploy
SMI-S agent. This package incorporates version 2.3.2 of the OpenPegasus
CIMOM ("http://www.openpegasus.org").

This release supports the FC HBA profile, Server profile and a partial
implementation of the Host Discovered Resources (HDR) profile. The Emulex
SMI-S HBA Provider is certified by SNIA Conformance Testing Program (CTP)
v1.0.2.23, and it is fully compliant with SMI-S v1.0.2.

SLPD (Service Location Protocol) is included with the Emulex SMI-S HBA Provider
kit and run by default if the system does not have one. For security purposes,
you might want to replace the sample certificates (privkey.cert and elxhba.cert)
with your own signed certificates.

Please refer to "http://www.openssl.org/docs/HOWTO/" for more details on how
to create a certificate.

NOTE: The OpenSSL library was built to exclude support for the IDEA, MDC2
and RC5 encryption algorithms.

License agreements for these Open Source components and the Emulex software
are found in the ancillary.txt file.

The Emulex SMI-S HBA Provider is registered under the namespace: root/emulex.
By default, the following account is created only on Windows:
User Name: cimadmin
Password: pwd580

On Linux, the default user account is:
User Name: root
Password: pwd580

SUSE Linux Enterprise Server 8 Service Pack 3 (x86 and x64 and Intel Itanium2 architectures)
Red Hat Enterprise Linux 2.1 Updates 5 and 6 (x86 and Intel Itanium2 architectures)
Red Hat Enterprise Linux 3 Updates 2, 3, 4 and 5 (x86 and x64 and Intel Itanium2 architectures)
SMI-S HBA Provider, compliant with the SMI-S 1.0.2 specification and certified against the SNIA-CTP v1.0.2.23 suite
Pre-packaged with OpenPegasus CIMOM v2.3.2, as a turnkey SMI-S agent for ease of installation and deployment

RELEASE NOTES for Emulex SMI-S HBA Provider
Version 1.0.12
SECTION 1. Introduction
SECTION 2. System Prerequisites
SECTION 3. Supported and Tested Operating Systems
SECTION 4. Installation
SECTION 5. Directory Structure
SECTION 6. Known Limitations
SECTION 7. Frequently Asked Questions
SECTION 1. Introduction

The Emulex SMI HBA Provider is integrated/bundled with OpenPegasus Common
Information Model Object Manager (CIMOM) as a pre-packaged, ready to deploy
SMI-S agent. This package incorporates version 2.3.2 of the OpenPegasus
CIMOM ("http://www.openpegasus.org").

This release supports the FC HBA profile, Server profile and a partial
implementation of the Host Discovered Resources (HDR) profile. The Emulex
SMI-S HBA Provider is certified by SNIA Conformance Testing Program (CTP)
v1.0.2.23, and it is fully compliant with SMI-S v1.0.2.

SLPD (Service Location Protocol) is included with the Emulex SMI-S HBA Provider
kit and run by default if the system does not have one. For security purposes,
you might want to replace the sample certificates (privkey.cert and elxhba.cert)
with your own signed certificates.

Please refer to "http://www.openssl.org/docs/HOWTO/" for more details on how
to create a certificate.

NOTE: The OpenSSL library was built to exclude support for the IDEA, MDC2
and RC5 encryption algorithms.

License agreements for these Open Source components and the Emulex software
are found in the ancillary.txt file.

The Emulex SMI-S HBA Provider is registered under the namespace: root/emulex.
By default, the following account is created only on Windows:
User Name: cimadmin
Password: pwd580

On Linux, the default user account is:
User Name: root
Password: pwd580

SUSE Linux Enterprise Server 8 Service Pack 3 (x86 and x64 and Intel Itanium2 architectures)
Red Hat Enterprise Linux 2.1 Updates 5 and 6 (x86 and Intel Itanium2 architectures)
Red Hat Enterprise Linux 3 Updates 2, 3, 4 and 5 (x86 and x64 and Intel Itanium2 architectures)
Installation, Configuration and Troubleshooting (3,451 KB)

SUSE Linux Enterprise Server 8 Service Pack 3 (x86 and x64 and Intel Itanium2 architectures)
Red Hat Enterprise Linux 2.1 Updates 5 and 6 (x86 and Intel Itanium2 architectures)
Red Hat Enterprise Linux 3 Updates 2, 3 and 4 (x86 and x64 and Intel Itanium2 architectures)
Base driver, application helper module and install script (298 KB gz file)

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.2 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.2 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.

SUSE Linux Enterprise Server 8 Service Pack 3 (x86 and x64 and Intel Itanium2 architectures)
Red Hat Enterprise Linux 2.1 Updates 5 and 6 (x86 and Intel Itanium2 architectures)
Red Hat Enterprise Linux 3 Updates 2, 3 and 4 (x86 and x64 and Intel Itanium2 architectures)
HBAnyware utility 2.1a12, HBAnyware Security Configurator 2.1a12, lputil 2.0a4, DFC library 7.2.4 and HBA API 2.0f (167 MB tar file)

HBAnyware 2.1a12 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 2.1a12
SSC version 2.1a12
DFC Library version 7.2.4
Lputil version 2.0a4
HBAAPI version 2.0.f

Dependencies:

lpfc 7.2.4
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.1a12-7.2.4-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.1a12-7.2.4-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

SUSE Linux Enterprise Server 8 Service Pack 3 (x86 and x64 and Intel Itanium2 architectures)
Red Hat Enterprise Linux 2.1 Updates 5 and 6 (x86 and Intel Itanium2 architectures)
Red Hat Enterprise Linux 3 Updates 2, 3 and 4 (x86 and x64 and Intel Itanium2 architectures)
Installation, Configuration and Troubleshooting (2,945 KB)

7.1.14 RHEL3 u5 (Linux CD), u4, u3, SLES8 SP4
Red Hat Enterprise Linux 3 Update 4 (PowerPC 64-bit architectures)
SUSE Linux Enterprise Server 8 Service Pack 4 (SVC, ESS , DS6000, DS8000)Utilities: Remote Management Utility (HBAnyware) version 2.0a20 and Diagnostic Utility (lputil) version 1.6a10
This kit includes the gz file containing an install script and 2 scripted source RPMs. (295 KB gz file).

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

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

1. System Requirements

The Emulex LPFC driver and LPFC DFC driver RPMs require 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 2.1
Red Hat Enterprise Linux 3
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. Errata

- On SLES 8 SP3, the uninstall procedure does not fully remove all
of the driver files that get built during installation. Run the
'lpfc-install --uninstall' command twice to remove all the
driver files.

- SLES 8 does not handle the Peripheral Qualifier Bit set to 1
correctly. If you need to use some lun scanning software to
dynamically add new luns to a SLES 8 system, you must to set the
lpfc_inq_pqb_filter parameter.

- 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.

SUSE Linux Enterprise Server 8 Service Pack 3
(x86 and x64 architectures)
Red Hat Enterprise Linux 2.1 Updates 5 and 6 (x86 and x64 architectures)
Red Hat Enterprise Linux 3 Updates 2, 3 and 4
(x86 and x64 architectures)
Utility - Remote Management Utility (HBAnyware) version 2.0a20 and Diagnostic Utility (lputil) version 1.6a10
This kit includes the Tar file containing the management utilites: HBAnyware v2.0a20 and LPUTIL v1.6a10. (145 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.

SUSE Linux Enterprise Server 8 Service Pack 3
(x86 and x64 architectures)
Red Hat Enterprise Linux 2.1 Updates 5 and 6 (x86 and x64 architectures)
Red Hat Enterprise Linux 3 Updates 2, 3 and 4
(x86 and x64 architectures)
Utility - Remote Management Utility (HBAnyware) version 2.0a20 and Diagnostic Utility (lputil) version 1.6a10
This kit includes the Tar file containing install script and scripted source RPM (69 KB).

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 4

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.

SUSE Linux Enterprise Server 8 Service Pack 3
(x86 and x64 architectures)
Red Hat Enterprise Linux 2.1 Updates 5 and 6 (x86 and x64 architectures)
Red Hat Enterprise Linux 3 Updates 2, 3 and 4
(x86 and x64 architectures)
Utility - Remote Management Utility (HBAnyware) version 2.0a20 and Diagnostic Utility (lputil) version 1.6a10
Installation, Configuration and Troubleshooting (2,778 KB)

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
64-bit Itanium Processor Family

This kit contains the following components:

lpfcdriver-2.01g-1.ia64.tar - Emulex Fibre Channel Linux Driver
EmlxApps300a6-ia64-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 EmlxApps300a6-ia64-RH2.1-TAR.tar package.

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
64-bit Itanium Processor Family

This kit contains the following components:

lpfcdriver-2.01g-1.ia64.rpm - Emulex Fibre Channel Linux Driver
EmlxApps300a6-ia64-RH2.1-RPM.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 EmlxApps300a6-ia64-RH2.1-RPM.tar package.

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
32-bit Intel Architecture

This kit contains the following components:

lpfcdriver-2.01g-1.i386.tar - Emulex Fibre Channel Linux Driver
EmlxApps300a6-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 EmlxApps300a6-i386-RH2.1-TAR.tar package.

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
32-bit Intel Architecture

This kit contains the following components:

lpfcdriver-2.01g-1.i386.rpm - Emulex Fibre Channel Linux Driver
EmlxApps300a6-i386-RH2.1-RPM.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 EmlxApps300a6-i386-RH2.1-RPM.tar package.

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
64-bit Itanium Processor Family

This kit contains the following components:

lpfcdriver-2.01g-1.ia64.tar - Emulex Fibre Channel Linux Driver
EmlxApps300a6-ia64-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 EmlxApps300a6-ia64-RH3.0-TAR.tar package.

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
64-bit Itanium Processor Family

This kit contains the following components:

lpfcdriver-2.01g-1.ia64.rpm - Emulex Fibre Channel Linux Driver
EmlxApps300a6-ia64-RH3.0-RPM.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 EmlxApps300a6-ia64-RH3.0-RPM.tar package.

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
32-bit Intel Architecture

This kit contains the following components:

lpfcdriver-2.01g-1.i386.tar - Emulex Fibre Channel Linux Driver
EmlxApps300a6-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 EmlxApps300a6-i386-RH3.0-TAR.tar package.

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
32-bit Intel Architecture

This kit contains the following components:

lpfcdriver-2.01g-1.i386.rpm - Emulex Fibre Channel Linux Driver
EmlxApps300a6-i386-RH3.0-RPM.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 EmlxApps300a6-i386-RH3.0-RPM.tar package.

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
64-bit Itanium Processor Family

This kit contains the following components:

lpfcdriver-2.01g-1.ia64.tar - Emulex Fibre Channel Linux Driver
EmlxApps300a6-ia64-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 EmlxApps300a6-ia64-SL8-TAR.tar package.

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
64-bit Itanium Processor Family

This kit contains the following components:

lpfcdriver-2.01g-1.ia64.rpm - Emulex Fibre Channel Linux Driver
EmlxApps300a6-ia64-SL8-RPM.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 EmlxApps300a6-ia64-SL8-RPM.tar package.

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
32-bit Intel Architecture

This kit contains the following components:

lpfcdriver-2.01g-1.i386.tar - Emulex Fibre Channel Linux Driver
EmlxApps300a6-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 EmlxApps300a6-i386-SL8-TAR.tar package.

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
32-bit Intel Architecture

This kit contains the following components:

lpfcdriver-2.01g-1.i386.rpm - Emulex Fibre Channel Linux Driver
EmlxApps300a6-i386-SL8-RPM.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 EmlxApps300a6-i386-SL8-RPM.tar package.

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
64-bit Itanium Processor Family

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
32-bit Intel Architecture

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
64-bit Itanium Processor Family

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
32-bit Intel Architecture

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
64-bit Itanium Processor Family

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
32-bit Intel Architecture

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
64-bit Itanium Processor Family

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
32-bit Intel Architecture

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
64-bit Itanium Processor Family

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
32-bit Intel Architecture

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
64-bit Itanium Processor Family

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
32-bit Intel Architecture

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6

This Application kit has been designed for the following environment:

- Supported Hardware architecture platforms:
- 32-bit Intel platforms (I386)
- 64-bit Intel platforms (IA64)
- 64-bit Power PC platforms (PPC64)

- Supported Linux Distributions:
Redhat Enterprise Linux AS 2.1
Redhat Enterprise Linux AS 3
SuSE SLES 8
Please refer to Emulex Website (www.emulex.com) for an update and accurate list of kernel versions.


- Supported Emulex enterprise adapters:
- LP10000DC
- LP10000
- LP1050DC
- LP1050
- LP9802DC
- LP9802
- LP982
- LP9402DC
- LP9002DC
- LP9002L
- LP9000
- LP952L
- LP8000DC
- LP8000

- This driver supports any mix of the above Emulex adapters within a single host system.

Main driver features:
1. Full fabric support, discovery, FCP and fibre channel device/error and exception handling
2. Concurrent multi-protocol (FCP and IP) support
3. Supports INT13 (EDD 2.1/3.0) fabric boot.
4. This driver is entirely self-contained and intended for configuration using lpfc. No external utility is required or supported.
5. This driver will not be dependent on any non-open source program for its execution. It will not taint an open source kernel.

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
This script enables you to dynamically add LUNs and targets without unloading or reloading the lpfcdd module and without resetting the adapter.

Tested distributions for 32-bit Intel and 64-bit Itanium Processor Family architectures
Red Hat Enterprise Linux 2.1 including all published updates
Red Hat Enterprise Linux 3.0 including all published updates
Utility - Remote Management Utility (HBAnyware) version 2.0a13 and Diagnostic Utility (lputil) version 1.6a6
Includes the Installation, Configuration and Troubleshooting sections

SUSE Linux Enterprise Server 11 (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures)
Base driver and install script (448 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
3.9 lspci utility displays "Device 0704" for OneConnect Universal CNAs
3.9.1 Observed Problem
3.9.2 Background
3.10 Adapter Initialization on SLES11 with INTx interrupt mode
3.10.1 Observed Problem
3.10.2 Background

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

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)

Release Notes
Date: February 2010
Product: Driver for Linux
Version: FC and FCoE version 8.2.8.x
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 Resolved
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 Resolved
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 Resolved
Corrected an issue that prevented a VPort to log out if deleted.
7. mbox sysfs Attribute Resolved
Corrected an issue that resulted in the mbox sysfs attribute smaller than the mailbox extension size.
8. LUN Panic Resolved
Corrected a potential panic if LUNs were unmapped.
9. CPU Lockup Corrected
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
Corrected a potential system panic issue during PCI Hot Plug.
11. List Corruption Corrected
Corrected an issue that caused a list corruption while unloading the driver.
12. Fabric Login Issue Corrected
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 Corrected
Corrected handling of unsolicited CT exchange sequences.
16. Clear Virtual Link Support Added
Added support for Clear Virtual Link command.
17. devloss Timeout Issue Corrected
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)
OneCommand Manager 5.0 enterprise application (189 MB tgz file)

SUSE Linux Enterprise Server 11 (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures)
OneCommand Manager version 5.0

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

Installation ..................................................................................................................... 1
Driver Information .................................................................................................... 1
Supported Features........................................................................................... 1
New Features in this Release............................................................................ 1
Prerequisites ..................................................................................................... 2
For the LPFC Driver Kit............................................................................... 2
For the ULDK .............................................................................................. 2
Compatibility...................................................................................................... 2
Things to Know Before You Download .............................................................. 3
Known Issues .................................................................................................... 3
Installing the LPFC Driver Kit................................................................................... 3
LPFC Driver Kit Install Script Options................................................................ 4
LPFC Driver Kit Directory Structure................................................................... 4
Installing the LPFC Driver on Unsupported Linux Distributions ......................... 4
Upgrading the Kernel or Applying a Distribution Service Pack or Update.......... 5
Installing the LPFC Driver Kit into an Upgraded Kernel............................... 5
Installing the Unified Linux Drivers Kit ..................................................................... 5
Uninstalling the ULDK ....................................................................................... 6
Booting From a Non-Zero LUN Attached to an Emulex Adapter .............................. 6
Installing the OneCommand Manager Application ................................................... 7
Uninstalling the LPFC Driver Kit ........................................................................ 7
Configuration ................................................................................................................. 8
LPFC Driver Configuration Methods Using modprobe and
/etc/modprobe.conf............................................................................................ 8
Temporary Configuration Method ................................................................ 8
Persistent Configuration Method ................................................................. 8
Temporary LPFC 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
LPFC 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
LPFC Driver Version 8.2.8.2x 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

SUSE Linux Enterprise Server 11 (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures)
Manual for OneCommand Manager Application Version 5.0

Introduction.............................................................................................................. 1
Supported Features by Operating System......................................................... 2
Known Issues .................................................................................................... 3
Installing and Uninstalling OneCommand Manager
Application Components.......................................................................................... 4
Installing the OneCommand Manager Application............................................. 4
In Windows ................................................................................................. 4
In Solaris SFS ............................................................................................. 4
In Linux ....................................................................................................... 5
In VMware ESX Server ............................................................................... 6
Installing the OneCommand Manager Application Web Launch Interface ... 6
Prerequisites ............................................................................................... 6
Procedures.................................................................................................. 7
Installing the OneCommand Manager Application Command Line Interface ..... 8
In Windows ................................................................................................. 9
In a New VMware ESX Server .................................................................... 9
Prerequisites....................................................................................... 10
Procedures ......................................................................................... 10
In a VMware ESX Server with an Existing HBAnyware CLI Kit Installed ... 10
Uninstalling Older HBAnyware Kits on VMware .................................. 10
In a New Linux System ............................................................................. 11
Prerequisites....................................................................................... 11
Procedures ......................................................................................... 11
In a Linux System with an Existing HBAnyware CLI Kit InstalledI ............. 12
Uninstalling Older HBAnyware Kits on Linux....................................... 12
In Solaris SFS ........................................................................................... 13
Prerequisites....................................................................................... 13
Procedures ......................................................................................... 13
Upgrading from the OneCommand Manager Application CLI to the Full-Featured
OneCommand Manager Application Enterprise Kit ......................................... 14
In Windows ............................................................................................... 14
In Linux ..................................................................................................... 14
In Solaris SFS ........................................................................................... 14
In VMware ESX Server ............................................................................. 14
Uninstalling the OneCommand Manager Application .................................. 14
In Windows .............................................................................................. 15
In Solaris SFS ........................................................................................... 15
In Linux ..................................................................................................... 15
In VMware................................................................................................. 15
Uninstalling the OneCommand Manager Application Web Launch
Interface Only .................................................................................................. 15
Starting the OneCommand Manager Application ................................................... 17
Starting the OneCommand Manager Application Web Launch Interface ......... 17
Managing Files when Running the OneCommand Manager Application
Web Launch Interface ............................................................................... 17
Using the OneCommand Manager Application ...................................................... 18
The OneCommand Manager Application Window Element Definitions ........... 18
The Menu Bar ........................................................................................... 19
The Toolbar ............................................................................................... 19
The Toolbar Buttons ................................................................................. 19
The Discovery-Tree .................................................................................. 20
Discovery-Tree Icons ......................................................................... 21
Expanding or Collapsing the Discovery-Tree View ...................... 22
The Property Tabs .................................................................................... 22
The Status Bar ......................................................................................... 22
Changing Management and Read-Only Mode ........................................... 22

SUSE Linux Enterprise Server 11 (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures)
OneCommand Manager 5.0 core application (19.5 MB tgz file)

SUSE Linux Enterprise Server 11 (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures)
Manual for OneCommand Manager Command Line Version 5.0

Introduction.............................................................................................................. 1
Installing the OneCommand Manager Application CLI............................................. 2
In Windows........................................................................................................ 2
In a new VMware ESX Server ........................................................................... 2
Prerequisites ............................................................................................... 2
Procedures.................................................................................................. 2
In a VMware ESX Server with an Existing HBAnyware CLI Kit Installed ........... 3
In a New Linux System...................................................................................... 3
Prerequisites ............................................................................................... 3
Procedures.................................................................................................. 4
In a Linux System with an Existing HBAnyware CLI Kit Installed....................... 4
In Solaris SFS ................................................................................................... 6
Prerequisites ............................................................................................... 6
Procedures.................................................................................................. 6
Uninstalling the OneCommand Manager Application CLI ........................................ 6
In VMware ESX Server...................................................................................... 6
In Linux ............................................................................................................. 7
Upgrading from the OneCommand Manager Application CLI to the Full-Featured
OneCommand Manager Application Enterprise Kit.................................................. 8
In Windows........................................................................................................ 8
In Linux ............................................................................................................. 8
In Solaris SFS ................................................................................................... 8
In VMware ESX Server...................................................................................... 8
Using the OneCommand Manager Application Command-Line Interface ................ 9
Using the CLI Client ........................................................................................ 12
Syntax Rules............................................................................................. 12
The CLI Client Command Reference............................................................... 12
Parameters Not Supported by CIM Interface............................................. 13
Read-Only Mode ....................................................................................... 17
Help Commands ....................................................................................... 17
Attributes Commands................................................................................ 18
Authentication Commands ........................................................................ 19
Boot Commands ....................................................................................... 21
CEE Commands ....................................................................................... 22
FCoE Commands...................................................................................... 26
Diagnostic Commands .............................................................................. 27
Driver Parameter Commands.................................................................... 30
Dump Commands ..................................................................................... 33
LUN Masking Commands ......................................................................... 34
Miscellaneous Commands ........................................................................ 35
Persistent Binding Commands .................................................................. 39
TCP/IP Management Host File Commands............................................... 41
VPort Commands...................................................................................... 41
WWN Management Commands................................................................ 43
iSCSI Commands...................................................................................... 44
ASCII Strings that May Be Returned ............................................................... 58

Red Hat Enterprise Linux 5.3 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.3 and later (x86 and x64 architectures)
Base driver and install script (468 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 LILO Boot Loader is not supported - i386 and x86_64 architectures
3.3.1 Observed Problem
3.3.2 Background
3.4 Order of lpfc module in initrd module list
3.4.1 Observed Problem
3.4.2 Workaround
3.5 Devloss timeout after swapping ports
3.5.1 Observed Problem
3.5.2 Workaround
3.6 Suspend to disk and Resume support
3.6.1 Observed Problem
3.6.2 Background
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
3.9 Potential error messages during driver kit removal process
3.9.1 Observed Problem
3.9.2 Resolution
3.10 lspci utility displays "Unknown Device" for OneConnect Universal CNAs
3.10.1 Observed Problem
3.10.2 Background
----------------------------------------------------------------------

1. System Requirements

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

Red Hat Enterprise Linux 5.3 or later
SuSE Linux Enterprise Server 10 SP2 or later

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 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.3 and later (x86 and x64 architectures)

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.

Red Hat Enterprise Linux 5.3 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.3 and later (x86 and x64 architectures)
OneCommand Manager 5.0 enterprise application (290 MB tgz file)

Red Hat Enterprise Linux 5.3 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.3 and later (x86 and x64 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

Red Hat Enterprise Linux 5.3 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.3 and later (x86 and x64 architectures)
Manual for OneCommand Manager Application Version 5.0

Introduction.............................................................................................................. 1
Supported Features by Operating System......................................................... 2
Known Issues .................................................................................................... 3
Installing and Uninstalling OneCommand Manager
Application Components.......................................................................................... 4
Installing the OneCommand Manager Application............................................. 4
In Windows ................................................................................................. 4
In Solaris SFS ............................................................................................. 4
In Linux ....................................................................................................... 5
In VMware ESX Server ............................................................................... 6
Installing the OneCommand Manager Application Web Launch Interface ... 6
Prerequisites ............................................................................................... 6
Procedures.................................................................................................. 7
Installing the OneCommand Manager Application Command Line Interface ..... 8
In Windows ................................................................................................. 9
In a New VMware ESX Server .................................................................... 9
Prerequisites....................................................................................... 10
Procedures ......................................................................................... 10
In a VMware ESX Server with an Existing HBAnyware CLI Kit Installed ... 10
Uninstalling Older HBAnyware Kits on VMware .................................. 10
In a New Linux System ............................................................................. 11
Prerequisites....................................................................................... 11
Procedures ......................................................................................... 11
In a Linux System with an Existing HBAnyware CLI Kit InstalledI ............. 12
Uninstalling Older HBAnyware Kits on Linux....................................... 12
In Solaris SFS ........................................................................................... 13
Prerequisites....................................................................................... 13
Procedures ......................................................................................... 13
Upgrading from the OneCommand Manager Application CLI to the Full-Featured
OneCommand Manager Application Enterprise Kit ......................................... 14
In Windows ............................................................................................... 14
In Linux ..................................................................................................... 14
In Solaris SFS ........................................................................................... 14
In VMware ESX Server ............................................................................. 14
Uninstalling the OneCommand Manager Application .................................. 14
In Windows .............................................................................................. 15
In Solaris SFS ........................................................................................... 15
In Linux ..................................................................................................... 15
In VMware................................................................................................. 15
Uninstalling the OneCommand Manager Application Web Launch
Interface Only .................................................................................................. 15
Starting the OneCommand Manager Application ................................................... 17
Starting the OneCommand Manager Application Web Launch Interface ......... 17
Managing Files when Running the OneCommand Manager Application
Web Launch Interface ............................................................................... 17
Using the OneCommand Manager Application ...................................................... 18
The OneCommand Manager Application Window Element Definitions ........... 18
The Menu Bar ........................................................................................... 19
The Toolbar ............................................................................................... 19
The Toolbar Buttons ................................................................................. 19
The Discovery-Tree .................................................................................. 20
Discovery-Tree Icons ......................................................................... 21
Expanding or Collapsing the Discovery-Tree View ...................... 22
The Property Tabs .................................................................................... 22
The Status Bar ......................................................................................... 22
Changing Management and Read-Only Mode ........................................... 22

Red Hat Enterprise Linux 5.3 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.3 and later (x86 and x64 architectures)
OneCommand Manager 5.0 core application (47 MB tgz file)

Red Hat Enterprise Linux 5.3 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.3 and later (x86 and x64 architectures)
Manual for OneCommand Manager Command Line Version 5.0

Introduction.............................................................................................................. 1
Installing the OneCommand Manager Application CLI............................................. 2
In Windows........................................................................................................ 2
In a new VMware ESX Server ........................................................................... 2
Prerequisites ............................................................................................... 2
Procedures.................................................................................................. 2
In a VMware ESX Server with an Existing HBAnyware CLI Kit Installed ........... 3
In a New Linux System...................................................................................... 3
Prerequisites ............................................................................................... 3
Procedures.................................................................................................. 4
In a Linux System with an Existing HBAnyware CLI Kit Installed....................... 4
In Solaris SFS ................................................................................................... 6
Prerequisites ............................................................................................... 6
Procedures.................................................................................................. 6
Uninstalling the OneCommand Manager Application CLI ........................................ 6
In VMware ESX Server...................................................................................... 6
In Linux ............................................................................................................. 7
Upgrading from the OneCommand Manager Application CLI to the Full-Featured
OneCommand Manager Application Enterprise Kit.................................................. 8
In Windows........................................................................................................ 8
In Linux ............................................................................................................. 8
In Solaris SFS ................................................................................................... 8
In VMware ESX Server...................................................................................... 8
Using the OneCommand Manager Application Command-Line Interface ................ 9
Using the CLI Client ........................................................................................ 12
Syntax Rules............................................................................................. 12
The CLI Client Command Reference............................................................... 12
Parameters Not Supported by CIM Interface............................................. 13
Read-Only Mode ....................................................................................... 17
Help Commands ....................................................................................... 17
Attributes Commands................................................................................ 18
Authentication Commands ........................................................................ 19
Boot Commands ....................................................................................... 21
CEE Commands ....................................................................................... 22
FCoE Commands...................................................................................... 26
Diagnostic Commands .............................................................................. 27
Driver Parameter Commands.................................................................... 30
Dump Commands ..................................................................................... 33
LUN Masking Commands ......................................................................... 34
Miscellaneous Commands ........................................................................ 35
Persistent Binding Commands .................................................................. 39
TCP/IP Management Host File Commands............................................... 41
VPort Commands...................................................................................... 41
WWN Management Commands................................................................ 43
iSCSI Commands...................................................................................... 44
ASCII Strings that May Be Returned ............................................................... 58

Red Hat Enterprise Linux 5.1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.1 and later (x86 and x64 architectures)
Base driver and install script (299 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
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.1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.1 and later (x86 and x64 architectures)
New features, fixed issues and known issues in the driver

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.
2. Deleting virtual ports or performing a PCI Hot Unplug may result in SCSI errors When you delete a virtual port via the sysfs interface or perform a PCI Hot Unplug of an Emulex HBA, the kernel may report one of the following errors: kernel: Synchronizing SCSI cache for disk kernel: FAILED or SCSI error: return code = 0x00010000. Workaround: These messages do not indicate a functional failure and can be ignored. 3. LILO is not Supported The LILO Boot Loader on i386 and x86_64 architectures is not supported for this driver stream. If the LILO boot loader is used, after the LPFC driver package is installed and upon reboot, an incorrect initial ramdisk is used. The system may not boot correctly. Workaround: Use the GRUB boot loader. This is the default boot loader for most of the Linux distributions. 4. Issue with the LPFC module order in the INITRD_MODULES list. On the SLES10 SP1 system, if another SCSI driver such as aic79xx, is loaded right after the LPFC driver through the initrd image, an interruption might occur in the SCSI mid-layer discovery process on the LUNs connected to LPFC’s Fibre Channel. This interruption can prevent the release of the SCSI discovery reference count and the LPFC driver cannot unload. Workaround: Do not add SCSI drivers right after the LPFC module in the INITRD_MODULES list. 5. The LPFC driver may not finish discovery when two initiator ports are swapped. This causes all devices accessible through one or both of these initiator ports to time out and all I/O to fail. Workaround: Do one of the following:
• When swapping cables replace each cable, one at a time, and allow for discovery to complete before replacing the next cable. To determine if discovery is complete read the "state" sysfs parameter.
• When swapping cables, allow devloss timeout to fire before replacing the cables. (This fails all outstanding I/O.)
6. Deleted virtual ports may appear to be mounted, but are inaccessible. While Emulex provides management utilities to enable you to delete virtual ports, the LPFC driver cannot detect whether devices accessed through a virtual port are in use. You can delete a virtual port even when devices accessible through the virtual port are mounted or when I/O is outstanding to the device. If file systems are mounted on a virtual port and that virtual port is deleted, the file systems still appear to be mounted but are not be accessible. Workaround: Before deleting virtual ports, prepare the system affected by unmounting all the devices accessible through the virtual ports, and verifying that there is no outstanding I/O. 7. 4 Gb/s HBAs in virtualized environments that use Direct I/O or SFPT do not Initialize. Default driver configuration fails to initialize 4 Gb/s HBAs in virtualized environments that use Direct I/O or SFPT(Storage Fixed Pass through) .This may result in a system hang or uninitialized LPFC HBA in Intel VT-d and AMD-V IOMMU systems.

Red Hat Enterprise Linux 5.1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.1 and later (x86 and x64 architectures)
HBAnyware utility 4.1a36 (208 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.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.39 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.1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.1 and later (x86 and x64 architectures)
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.

Red Hat Enterprise Linux 5.1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.1 and later (x86 and x64 architectures)
Driver for Linux User Manual

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

Red Hat Enterprise Linux 5.1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.1 and later (x86 and x64 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

Red Hat Enterprise Linux 5.1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.1 and later (x86 and x64 architectures)
HBAnyware utility 4.1a36 (38.9 MB tar file)

HBAnyware CoreKit Linux Installation Instructions

This installation kit contains the following components:

HBACMD version 4.1a36
DFC Library version 3.0.35-1-1
HBAAPI version 2.1.g
Fcauth version 1.20-1-1
Multipulse version 3.0.30-1


Dependencies:

lpfc driver version 8.2.0.39 or later


HBAnyware CoreKit requires that the lpfc driver module be installed.
Installing HBAnyware CoreKit:

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 appropriate sub-directory associated to the
target machine architecture and OS distribution
5. su to root
6. type : rpm -Uhv *.rpm

7. Installation Complete: type /usr/sbin/hbanyware/hbacmd listhbas
to run script utility
Uninstalling HBAnyware CoreKit

1. obtain current CoreKit RPM package name using query :
rpm -qa | grep elxlinux
2. erase core kit package returned in step 1 using RPM erase
(rpm -e xxxx) command
----------------------------------------------------------------------
Known Issues

A. The following issues apply to all Linux distributions

A.1. Virtual Connect backwards compatibility

A.1.1 Background
Starting with HBAnyware CoreKit version 3.2, Emulex provides support for LightPulse
adapters that are reprogrammed with WWPNs outside the typical Emulex range,
such as HP's upcoming Virtual Connect for Fibre Channel on the BladeSystem
c-Class platform.

Red Hat Enterprise Linux 5.1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.1 and later (x86 and x64 architectures)
HBAnyware Command Line Version 4.1

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

Red Hat Enterprise Linux 5.1 and 5.2 (x86, x64 and Intel Itanium2 architectures)
x86 architecture (5.97 MB ISO image file)

Red Hat Enterprise Linux 5.1 and 5.2 (x86, x64 and Intel Itanium2 architectures)
x64 architecture (4.59 MB ISO image file)

SUSE Linux Enterprise Server 10 SP2 (x86, x64 and Intel Itanium2
architectures)
HBAnyware utility 4.0a31 (179 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.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.1 and 5.2 (x86, x64 and Intel Itanium2 architectures)
Driver for Linux User Manual

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

Red Hat Enterprise Linux 5.1 and 5.2 (x86, x64 and Intel Itanium2 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.1 and 5.2 (x86, x64 and Intel Itanium2 architectures)
Intel Itanium2 architecture (5.12 MB ISO image file)

Red Hat Enterprise Linux 5.1 and 5.2 (x86, x64 and Intel Itanium2 architectures)
HBAnyware utility 4.0a31 (15.3 MB tar file)

Red Hat Enterprise Linux 5.1 and 5.2 (x86, x64 and Intel Itanium2 architectures)
HBAnyware Command Line Version 4.0

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

SUSE Linux Enterprise Server 10 SP2 (x86, x64 and Intel Itanium2
architectures)
HBAnyware utility 4.0a31 (179 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.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

SUSE Linux Enterprise Server 10 SP2 (x86, x64 and Intel Itanium2
architectures)
Driver for Linux User Manual

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

SUSE Linux Enterprise Server 10 SP2 (x86, x64 and Intel Itanium2
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

SUSE Linux Enterprise Server 10 SP2 (x86, x64 and Intel Itanium2 architectures)
HBAnyware utility 4.0a31 (15.3 MB tar file)

SUSE Linux Enterprise Server 10 SP2 (x86, x64 and Intel Itanium2 architectures)
HBAnyware Command Line Version 4.0

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

SUSE Linux Enterprise Server 9 Service Pack 3 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Red Hat Enterprise Linux 4 Update 4 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 4 Update 4 and later (x86 and x64 architectures)Asianux 2.0 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit 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. Informational
3.1 Packaging Change Involving The Application Helper Module
3.1.1 Background
3.1.2 Observed Behavior
4. Known Issues
4.1 Uninstalling the Driver Kit on Boot-from-SAN Configurations
4.1.1 Observed problem
4.1.2 Resolution
4.2 Machine Check Exception
4.2.1 Observed problem
4.2.2 Workaround
4.3 Loading order of LPFC driver in initial ramdisk
4.3.1 Background
4.3.2 Observed Problem
4.3.3 Workaround
4.4 System panic while unloading the lpfc module
4.4.1 Background
4.4.2 Observed Problem
4.4.3 Resolution
4.5 PCI Hot Plug Support for applications
4.5.1 Observed problem
4.5.2 Workaround
4.6 Storage Array discovery issues in direct-attach configurations
4.6.1 Observed problem
4.6.2 Workaround

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

1. System Requirements

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

Red Hat Enterprise Linux 4 (Update 3 or higher)
SuSE Linux Enterprise Server 9 (SP2 or higher)

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

For Red Hat Enterprise Linux installations, the kernel development
package with the same version as the currently running kernel must
be installed for the LPFC 8.0 driver build to succeed. For
example, a system with the 2.6.9-22.EL kernel would need the
kernel-devel-2.6.9-22.EL package, and a system with the
2.6.9-22.ELsmp kernel would need the kernel-smp-devel-2.6.9-22.EL
package.

1.2 SuSE Linux Enterprise Server 'kernel-source' Package Requirement

For SuSE Linux Enterprise Server installations, the kernel-source
package with the same version as the currently running kernel must
be installed for the LPFC 8.0 driver build to succeed. For
example, a system with the 2.6.5-7.139-bigsmp kernel would need the
kernel-source-2.6.5-7.139 package.

SUSE Linux Enterprise Server 9 Service Pack 3 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Red Hat Enterprise Linux 4 Update 4 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 4 Update 4 and later (x86 and x64 architectures)Asianux 2.0 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures)
New features, fixed issues and known issues in the driver

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.
2. Deleting virtual ports or performing a PCI Hot Unplug may result in SCSI errors When you delete a virtual port via the sysfs interface or perform a PCI Hot Unplug of an Emulex HBA, the kernel may report one of the following errors: kernel: Synchronizing SCSI cache for disk kernel: FAILED or SCSI error: return code = 0x00010000. Workaround: These messages do not indicate a functional failure and can be ignored. 3. LILO is not Supported The LILO Boot Loader on i386 and x86_64 architectures is not supported for this driver stream. If the LILO boot loader is used, after the LPFC driver package is installed and upon reboot, an incorrect initial ramdisk is used. The system may not boot correctly. Workaround: Use the GRUB boot loader. This is the default boot loader for most of the Linux distributions. 4. Issue with the LPFC module order in the INITRD_MODULES list. On the SLES10 SP1 system, if another SCSI driver such as aic79xx, is loaded right after the LPFC driver through the initrd image, an interruption might occur in the SCSI mid-layer discovery process on the LUNs connected to LPFC’s Fibre Channel. This interruption can prevent the release of the SCSI discovery reference count and the LPFC driver cannot unload. Workaround: Do not add SCSI drivers right after the LPFC module in the INITRD_MODULES list. 5. The LPFC driver may not finish discovery when two initiator ports are swapped. This causes all devices accessible through one or both of these initiator ports to time out and all I/O to fail. Workaround: Do one of the following:
• When swapping cables replace each cable, one at a time, and allow for discovery to complete before replacing the next cable. To determine if discovery is complete read the "state" sysfs parameter.
• When swapping cables, allow devloss timeout to fire before replacing the cables. (This fails all outstanding I/O.)
6. Deleted virtual ports may appear to be mounted, but are inaccessible. While Emulex provides management utilities to enable you to delete virtual ports, the LPFC driver cannot detect whether devices accessed through a virtual port are in use. You can delete a virtual port even when devices accessible through the virtual port are mounted or when I/O is outstanding to the device. If file systems are mounted on a virtual port and that virtual port is deleted, the file systems still appear to be mounted but are not be accessible. Workaround: Before deleting virtual ports, prepare the system affected by unmounting all the devices accessible through the virtual ports, and verifying that there is no outstanding I/O. 7. 4 Gb/s HBAs in virtualized environments that use Direct I/O or SFPT do not Initialize. Default driver configuration fails to initialize 4 Gb/s HBAs in virtualized environments that use Direct I/O or SFPT(Storage Fixed Pass through) .This may result in a system hang or uninitialized LPFC HBA in Intel VT-d and AMD-V IOMMU systems.

SUSE Linux Enterprise Server 9 Service Pack 3 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Red Hat Enterprise Linux 4 Update 4 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 4 Update 4 and later (x86 and x64 architectures)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

SUSE Linux Enterprise Server 9 Service Pack 3 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Red Hat Enterprise Linux 4 Update 4 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 4 Update 4 and later (x86 and x64 architectures)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

SUSE Linux Enterprise Server 9 Service Pack 3 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Red Hat Enterprise Linux 4 Update 4 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 4 Update 4 and later (x86 and x64 architectures)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

SUSE Linux Enterprise Server 9 Service Pack 3 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Red Hat Enterprise Linux 4 Update 4 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 4 Update 4 and later (x86 and x64 architectures)Asianux 2.0 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures)
HBAnyware utility 4.0a38

HBAnyware CoreKit Linux Installation Instructions

This installation kit contains the following components:

HBACMD version 4.0a38
DFC Library version 80.208-1
HBAAPI version 2.1.g
Multipulse version 3.0.30-1


Dependencies:

lpfc driver version 8.0.16.46 or later
IOCTL Module 2.0.38-1

HBAnyware CoreKit requires that the lpfc driver module be installed.
Installing HBAnyware CoreKit:

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 appropriate sub-directory associated to the
target machine architecture and OS distribution
5. su to root
6. type : rpm -Uhv *.rpm

7. Installation Complete: type /usr/sbin/hbanyware/hbacmd listhbas
to run script utility
Uninstalling HBAnyware CoreKit

1. obtain current CoreKit RPM package name using query :
rpm -qa | grep elxlinux
2. erase core kit package returned in step 1 using RPM erase
(rpm -e xxxx) command
----------------------------------------------------------------------
Known Issues

A. The following issues apply to all Linux distributions

A.1. Virtual Connect backwards compatibility

A.1.1 Background
Starting with HBAnyware CoreKit version 3.2, Emulex provides support for LightPulse
adapters that are reprogrammed with WWPNs outside the typical Emulex range,
such as HP's upcoming Virtual Connect for Fibre Channel on the BladeSystem
c-Class platform.

A.1.2 Resolution
In such environments, HBAnyware CoreKit version 3.2 must be deployed across all
servers on the SAN, as well as any other management console used for
out-of-band management, so that all adapters appear in the discovery tree.

SUSE Linux Enterprise Server 9 Service Pack 3 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Red Hat Enterprise Linux 4 Update 4 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 4 Update 4 and later (x86 and x64 architectures)Asianux 2.0 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures)
HBAnyware Command Line Version 4.0

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

Emulex driver version 8.2.0.29 (or later) for Linux Emulex driver version 8.0.16.44 (or later) for Linux
(26.1 MB tgz file)

Emulex driver version 8.2.0.29 (or later) for Linux Emulex driver version 8.0.16.44 (or later) for Linux

Emulex driver version 8.2.0.29 (or later) for Linux Emulex driver version 8.0.16.44 (or later) for Linux
(1.01 MB pdf file)

The Offline Utilities..................................................................................................1
Introduction.......................................................................................................1
Installation.........................................................................................................2
The WinPE Offline Utility.............................................................................2
The DOS Offline Utility................................................................................2
The Linux Offline Utility...............................................................................3
Known Issues....................................................................................................3
Using the Offline Utilities...................................................................................3
The DOS Offline Utility................................................................................4
Running the Offline Utilities from the Command Prompt.............................4
Offline Utility Commands...................................................................................5
Supported Commands................................................................................5
....................................................................................................................
8
Viewing the Syntax for Commands - help or ?............................................8
Resetting an Adapter - reset.......................................................................8
Running the Power-On Self-Test - posttest.................................................9
Viewing Adapter Information.............................................................................9
Viewing Emulex conventional names instead of Vital Product Data (VPD) - /c...............................................................................................................9
Viewing the Offline Utilities’ Version Information - version...........................9
Viewing Vital Product Data - vpd...............................................................10
Viewing Boot Device Info, WWN, LUN and Topology - readbootdevice.....10
Viewing BootBIOS Versions - listboot........................................................11
Viewing all Adapters in the System - listhba..............................................11
Viewing WWN of all adapters in the System - listwwn...............................12
Sample response: ....................................................................................12
Viewing Firmware Program Revisions - listrev..........................................12
Viewing Selected Configuration Numbers - readconfig.............................13
Firmware and Boot Code Download Commands.............................................13
Downloading a File - download.................................................................13
Accessing the Flash Device Directly - directdownload..............................14
World Wide Name Commands........................................................................15
Writing WWN and Updating NVPARMS - writewwn...................................15
Saving WWN data to a file - savewwn.......................................................16
Restoring WWN and Updating NVPARMS - restorewwn...........................16
Restoring NVPARMS - restorenvwwn.......................................................16
Restoring the IEEE address - restoredefwwn............................................16
Boot Code Commands....................................................................................17
Enabling or Disabling BootBIOS or boot code - enableboot/disableboot...17
Selecting a Boot Device - setbootdevice...................................................17
Read All Alternative Boot Devices - readaltboot........................................18
Selecting One or More Alternate Boot Devices - setaltboot.......................19
Configuration Commands................................................................................19
Setting the Adapter to Use Soft Jumpers or Hardware Default - jumper...19
Updating Configuration Regions - config...................................................19
Running Tests..................................................................................................20
Running the External Loopback Test - extloopback...................................20
Running the Internal Loopback Test - intloopback.....................................21
Running the PCI Loopback Test - pciloopback..........................................21

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.

SUSE Linux Enterprise Server 11 (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures)
HBAnyware utility 4.1a36 (170 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.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

SUSE Linux Enterprise Server 11 (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures)
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

SUSE Linux Enterprise Server 11 (x86, x64, Intel Itanium2 and PowerPC 64-bit 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

Red Hat Enterprise Linux 5.3 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.3 and later (x86 and x64 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.3 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.3 and later (x86 and x64 architectures)
New features, fixed issues and known issues in the driver (147 KB)

Release Notes
Date: March 2009
Product: Driver for Linux
Version: 8.2.0.39
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.0.39
1. Supports the LP21000 and LP21002 FCoE adapters.
2. (10 Gb/s capable)
Supports the LPe1250, LPe1252, LPe12000 and LPe12002 adapters.
3. (2, 4 and 8 Gb/s capable)
Supports the latest HBAnyware utility version 4.1 as part of master kit.
4. Refer to the HBAnyware Utility User Manual for more information.
5.
Adds the ability to control I/O queue depth based on the I/O completion time.
Adds interfaces via the sysfs filesystem to update speed and topology parameters without
Resolved Issues in Driver for Linux 8.2.0.39
requiring link bounce.
1. A CEE firmware upgrade with a Converged Network Adapter (CNA) did not work properly. This discovery issue has been resolved.
2. The firmware diagnostic dump process took too long to complete. This logging issue has been resolved.
3. Loopback tests failed on CNAs. This loopback mode issue has been resolved.
4. Echo tests failed when NPIV was enabled.This issue has been resolved.
5. Emulex HBAs potentially could not initialize properly when used in Virtualized Environments with SFPT (Storage Fixed Pass through) or Direct I/O. This potential issue has been resolved.
6. The RSCN address format was not handled properly. This event qualifier issue has been resolved.
7. The Emulex LPFC driver used the mdelay function in the IOCTL process path. The driver was updated to use the msleep function instead.
8. The HBAnyware Security Configurator could not communicate with certain servers. This issue was resolved by increasing internal buffers to support 40KB SSC sequences.
9. Updates to the WWN via management utilities were taking effect immediately. This issue was resolved by allowing the updates to take effect after a (warm) system reboot.

Red Hat Enterprise Linux 5.3 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.3 and later (x86 and x64 architectures)
HBAnyware utility 4.1a36 (208 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.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.3 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.3 and later (x86 and x64 architectures)
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.

Red Hat Enterprise Linux 5.3 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.3 and later (x86 and x64 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

Red Hat Enterprise Linux 5.3 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.3 and later (x86 and x64 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

This driver version is also available in-box, and it is supported by the following Linux distributions: RHEL 5.2, OEL 5.2, and SLES 10 SP2
Red Hat Enterprise Linux 5.1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.1 and later (x86 and x64 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.

This driver version is also available in-box, and it is supported by the following Linux distributions: RHEL 5.2, OEL 5.2, and SLES 10 SP2
Red Hat Enterprise Linux 5.1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.1 and later (x86 and x64 architectures)
HBAnyware utility 4.1a36 (208 MB tar file)
Note: This kit does not support the Intel Itanium2 architecture. For Intel Itanium2 architecture support, download the corresponding core (CLI) applications kit.

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

This driver version is also available in-box, and it is supported by the following Linux distributions: RHEL 5.2, OEL 5.2, and SLES 10 SP2
Red Hat Enterprise Linux 5.1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.1 and later (x86 and x64 architectures)
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.

This driver version is also available in-box, and it is supported by the following Linux distributions: RHEL 5.2, OEL 5.2, and SLES 10 SP2
Red Hat Enterprise Linux 5.1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.1 and later (x86 and x64 architectures)
Driver for Linux User Manual

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

This driver version is also available in-box, and it is supported by the following Linux distributions: RHEL 5.2, OEL 5.2, and SLES 10 SP2
Red Hat Enterprise Linux 5.1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP1 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5.1 and later (x86 and x64 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

Red Hat Enterprise Linux 5.0 and later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
SUSE Linux Enterprise Server 10 SP1 (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
Base driver and install script

1. System Requirements
1.1 Red Hat Enterprise Linux 'kernel-devel' 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

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

1. System Requirements

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

Red Hat Enterprise Linux 5

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.
2. Description of Install Procedure

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

Once the RPM is 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.
3. Known Issues

3.1 PCI Hot Plug Support for applications

3.1.1 Observed problem

PCI Hot Plug has been found to cause applications (HBAnyware utilities or
third party applications) that use the Emulex libraries (i.e. HBAAPI), to
misbehave or malfunction.

3.1.2 Workaround

A user should 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

After performing PCI Hot Plug of the HBA you can restart the applications.

Red Hat Enterprise Linux 5.0 and later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
SUSE Linux Enterprise Server 10 SP1 (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
HBAnyware utility 3.2a16, lputil 2.0a14

HBAnyware 3.2a16 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 3.2a16
SSC version 3.2a16
DFC Library version 2.15.1007-1-1
Lputil version 2.0a14
HBAAPI version 2.1.e

Dependencies:

lpfc driver version 8.1.10.12 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.0 and later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
SUSE Linux Enterprise Server 10 SP1 (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
Installation, Configuration and Troubleshooting

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

SUSE Linux Enterprise Server 9 Service Pack 3 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Red Hat Enterprise Linux 4 Update 4 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 4 Update 4 and later (x86 and x64 architectures)Asianux 2.0 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit 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. Informational
3.1 Packaging Change Involving The Application Helper Module
3.1.1 Background
3.1.2 Observed Behavior
4. Known Issues
4.1 Uninstalling the Driver Kit on Boot-from-SAN Configurations
4.1.1 Observed problem
4.1.2 Resolution
4.2 Machine Check Exception
4.2.1 Observed problem
4.2.2 Workaround
4.3 Loading order of LPFC driver in initial ramdisk
4.3.1 Background
4.3.2 Observed Problem
4.3.3 Workaround
4.4 System panic while unloading the lpfc module
4.4.1 Background
4.4.2 Observed Problem
4.4.3 Resolution
4.5 PCI Hot Plug Support for applications
4.5.1 Observed problem
4.5.2 Workaround
4.6 Storage Array discovery issues in direct-attach configurations
4.6.1 Observed problem
4.6.2 Workaround

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

1. System Requirements

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

Red Hat Enterprise Linux 4 (Update 3 or higher)
SuSE Linux Enterprise Server 9 (SP2 or higher)

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

For Red Hat Enterprise Linux installations, the kernel development
package with the same version as the currently running kernel must
be installed for the LPFC 8.0 driver build to succeed. For
example, a system with the 2.6.9-22.EL kernel would need the
kernel-devel-2.6.9-22.EL package, and a system with the
2.6.9-22.ELsmp kernel would need the kernel-smp-devel-2.6.9-22.EL
package.

1.2 SuSE Linux Enterprise Server 'kernel-source' Package Requirement

For SuSE Linux Enterprise Server installations, the kernel-source
package with the same version as the currently running kernel must
be installed for the LPFC 8.0 driver build to succeed. For
example, a system with the 2.6.5-7.139-bigsmp kernel would need the
kernel-source-2.6.5-7.139 package.

SUSE Linux Enterprise Server 9 Service Pack 3 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Red Hat Enterprise Linux 4 Update 4 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 4 Update 4 and later (x86 and x64 architectures)Asianux 2.0 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures)

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.
2. Deleting virtual ports or performing a PCI Hot Unplug may result in SCSI errors When you delete a virtual port via the sysfs interface or perform a PCI Hot Unplug of an Emulex HBA, the kernel may report one of the following errors: kernel: Synchronizing SCSI cache for disk kernel: FAILED or SCSI error: return code = 0x00010000. Workaround: These messages do not indicate a functional failure and can be ignored. 3. LILO is not Supported The LILO Boot Loader on i386 and x86_64 architectures is not supported for this driver stream. If the LILO boot loader is used, after the LPFC driver package is installed and upon reboot, an incorrect initial ramdisk is used. The system may not boot correctly. Workaround: Use the GRUB boot loader. This is the default boot loader for most of the Linux distributions. 4. Issue with the LPFC module order in the INITRD_MODULES list. On the SLES10 SP1 system, if another SCSI driver such as aic79xx, is loaded right after the LPFC driver through the initrd image, an interruption might occur in the SCSI mid-layer discovery process on the LUNs connected to LPFC’s Fibre Channel. This interruption can prevent the release of the SCSI discovery reference count and the LPFC driver cannot unload. Workaround: Do not add SCSI drivers right after the LPFC module in the INITRD_MODULES list. 5. The LPFC driver may not finish discovery when two initiator ports are swapped. This causes all devices accessible through one or both of these initiator ports to time out and all I/O to fail. Workaround: Do one of the following:
• When swapping cables replace each cable, one at a time, and allow for discovery to complete before replacing the next cable. To determine if discovery is complete read the "state" sysfs parameter.
• When swapping cables, allow devloss timeout to fire before replacing the cables. (This fails all outstanding I/O.)
6. Deleted virtual ports may appear to be mounted, but are inaccessible. While Emulex provides management utilities to enable you to delete virtual ports, the LPFC driver cannot detect whether devices accessed through a virtual port are in use. You can delete a virtual port even when devices accessible through the virtual port are mounted or when I/O is outstanding to the device. If file systems are mounted on a virtual port and that virtual port is deleted, the file systems still appear to be mounted but are not be accessible. Workaround: Before deleting virtual ports, prepare the system affected by unmounting all the devices accessible through the virtual ports, and verifying that there is no outstanding I/O. 7. 4 Gb/s HBAs in virtualized environments that use Direct I/O or SFPT do not Initialize. Default driver configuration fails to initialize 4 Gb/s HBAs in virtualized environments that use Direct I/O or SFPT(Storage Fixed Pass through) .This may result in a system hang or uninitialized LPFC HBA in Intel VT-d and AMD-V IOMMU systems.

SUSE Linux Enterprise Server 9 Service Pack 3 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Red Hat Enterprise Linux 4 Update 4 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 4 Update 4 and later (x86 and x64 architectures)Asianux 2.0 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures)
HBAnyware utility 4.0a38, Application helper module 2.0.38-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.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

SUSE Linux Enterprise Server 9 Service Pack 3 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Red Hat Enterprise Linux 4 Update 4 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 4 Update 4 and later (x86 and x64 architectures)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

SUSE Linux Enterprise Server 9 Service Pack 2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Red Hat Enterprise Linux 4 Update 2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 4 Update 4 and later (x86 and x64 architectures)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

SUSE Linux Enterprise Server 9 Service Pack 2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Red Hat Enterprise Linux 4 Update 2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 4 Update 4 and later (x86 and x64 architectures)Asianux 2.0 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit 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. Informational
3.1 Packaging Change Involving The Application Helper Module
3.1.1 Background
3.1.2 Observed Behavior
4. Known Issues
4.1 Uninstalling the Driver Kit on Boot-from-SAN Configurations
4.1.1 Observed problem
4.1.2 Resolution
4.2 Machine Check Exception
4.2.1 Observed problem
4.2.2 Workaround
4.3 Loading order of LPFC driver in initial ramdisk
4.3.1 Background
4.3.2 Observed Problem
4.3.3 Workaround
4.4 System panic while unloading the lpfc module
4.4.1 Background
4.4.2 Observed Problem
4.4.3 Resolution
4.5 PCI Hot Plug Support for applications
4.5.1 Observed problem
4.5.2 Workaround
4.6 Storage Array discovery issues in direct-attach configurations
4.6.1 Observed problem
4.6.2 Workaround

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

1. System Requirements

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

Red Hat Enterprise Linux 4 (Update 3 or higher)
SuSE Linux Enterprise Server 9 (SP2 or higher)

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

For Red Hat Enterprise Linux installations, the kernel development
package with the same version as the currently running kernel must
be installed for the LPFC 8.0 driver build to succeed. For
example, a system with the 2.6.9-22.EL kernel would need the
kernel-devel-2.6.9-22.EL package, and a system with the
2.6.9-22.ELsmp kernel would need the kernel-smp-devel-2.6.9-22.EL
package.

1.2 SuSE Linux Enterprise Server 'kernel-source' Package Requirement

For SuSE Linux Enterprise Server installations, the kernel-source
package with the same version as the currently running kernel must
be installed for the LPFC 8.0 driver build to succeed. For
example, a system with the 2.6.5-7.139-bigsmp kernel would need the
kernel-source-2.6.5-7.139 package.

SUSE Linux Enterprise Server 9 Service Pack 2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Red Hat Enterprise Linux 4 Update 2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 4 Update 4 and later (x86 and x64 architectures)Asianux 2.0 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures)
HBAnyware utility 4.0a38, Application helper module 2.0.36-1 (176 MB tar file)
Note: This kit does not support the Intel Itanium2 architecture. For Intel Itanium2 architecture support, download the corresponding core (CLI) applications kit.

HB 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.44 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

SUSE Linux Enterprise Server 9 Service Pack 2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Red Hat Enterprise Linux 4 Update 2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 4 Update 4 and later (x86 and x64 architectures)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 ..................................................................................................... 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

SUSE Linux Enterprise Server 9 Service Pack 2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Red Hat Enterprise Linux 4 Update 2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 4 Update 4 and later (x86 and x64 architectures)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

SUSE Linux Enterprise Server 9 Service Pack 2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Red Hat Enterprise Linux 4 Update 2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 4 Update 4 and later (x86 and x64 architectures)Asianux 2.0 SP2 and later (x86, x64, Intel Itanium2 and PowerPC 64-bit architectures)
HBAnyware utility 4.0a38

HBAnyware CoreKit Linux Installation Instructions

This installation kit contains the following components:

HBACMD version 4.0a38
DFC Library version 80.206-1
HBAAPI version 2.1.g
Multipulse version 3.0.30-1


Dependencies:

lpfc driver version 8.0.16.44 or later
IOCTL Module 2.0.36-1

HBAnyware CoreKit requires that the lpfc driver module be installed.
Installing HBAnyware CoreKit:

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 appropriate sub-directory associated to the
target machine architecture and OS distribution
5. su to root
6. type : rpm -Uhv *.rpm

7. Installation Complete: type /usr/sbin/hbanyware/hbacmd listhbas
to run script utility
Uninstalling HBAnyware CoreKit

1. obtain current CoreKit RPM package name using query :
rpm -qa | grep elxlinux
2. erase core kit package returned in step 1 using RPM erase
(rpm -e xxxx) command
----------------------------------------------------------------------
Known Issues

A. The following issues apply to all Linux distributions

A.1. Virtual Connect backwards compatibility

A.1.1 Background
Starting with HBAnyware CoreKit version 3.2, Emulex provides support for LightPulse
adapters that are reprogrammed with WWPNs outside the typical Emulex range,
such as HP's upcoming Virtual Connect for Fibre Channel on the BladeSystem
c-Class platform.

A.1.2 Resolution
In such environments, HBAnyware CoreKit version 3.2 must be deployed across all
servers on the SAN, as well as any other management console used for
out-of-band management, so that all adapters appear in the discovery tree.