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

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

Contains: x86 BootBIOS 1.71a0, OpenBoot 1.50a9 and EFIBoot 3.11a5 This Universal Boot version 5.02a1 contains:

(1) x86 BootBIOS version 1.71a0
(2) OpenBoot version 1.50a9
(3) EFIBoot version 3.11a5

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

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

\502a1.txt this file you are reading
\HU502a1.PRG LP9802 Universal Boot
\TU502a1.PRG LP10000 Universal Boot
\BU502a1.PRG LP11000 Universal Boot
\ZU502a1.PRG LPe11000 Universal Boot
\elxcli311a5.efi EFI 3.11a5 Driver
Universal Boot Load Procedure

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

1. "Drvcfg" : EFI based Systems.

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

2. LP6DUTIL.EXE : DOS based utility.

Please refer to the LP6DUTIL version 9.0a13, or later, documentation for user
interface how to download EFIBoot in DOS PCI systems.

3. LPUTILNT : Windows Miniport Driver.

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

4. Emulex Configuration Tool : Windows Port Driver.

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

Platform: Intel Itanium (64-bit) The current EFI (Extensible Firmware Interface) Boot provides 64-bit system
boot capability through the use of the EFI Shell. EFIBoot supports EFI
Specification 1.10 and EFI Source Code version 1.10.14.61 and 1.10.14.62.

EFIBoot supports:

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

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

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

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

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

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

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

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

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

EFI Byte Code Driver Images:

\rel_notes.txt the file you are reading
\DE311A5.PRG Lp8000 EFIBoot version 3.11a5
\CE311A5.PRG Lp9000 EFIBoot version 3.11a5
\HE311A5.PRG Lp9802 EFIBoot version 3.11a5
\QE311A5.PRG Lp850 EFIBoot version 3.11a5
\HE311A5.PRG Lp9802 EFIBoot version 3.11a5
\LE311A5.PRG Lp982 EFIBoot version 3.11a5
\TE311A5.PRG Lp10000 EFIBoot version 3.11a5
\ME311A5.PRG Lp1050 EFIBoot version 3.11a5
\EE311A5.PRG Lp101 EFIBoot version 3.11a5
\BE311A5.PRG Lp11000 EFIBoot version 3.11a5
\JE311A5.PRG Lp1150 EFIBoot version 3.11a5
\ZE311A5.PRG Lpe11000 EFIBoot version 3.11a5
\WE311A5.PRG Lpe1150 EFIBoot version 3.11a5
\ElxCli311a5.efi


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

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

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

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

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

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

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

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

Platform: SPARC, PowerPC This version of Open Boot supports FC-AL: Private loop and Public
loop, and Fabric Point to Point. Also, it supports multi-initiators
and multi-LUNs (0 through 255).
\O150a8.txt The file you are reading

\SO150a8.PRG Lp7000 Open Firmware 1.50a8
\DO150a8.PRG Lp8000 Open Firmware 1.50a8
\CO150a8.PRG Lp9000 Open Firmware 1.50a8
\HO150a8.PRG Lp9802 Open Firmware 1.50a8
\TO150a8.PRG Lp10000 Open Firmware 1.50a8
\BO150a8.PRG Lp11000 Open Firmware 1.50a8
\ZO150a8.PRG Lpe11000 Open Firmware 1.50a8
--------------- NOTES and CAUTIONS ---------------------
** Ensure that critical files on local boot disk are backed up
as a measure of protection.

(1) This procedure assumes there is already a 'local' boot disk.

(2) The size of the intended (target) fibre channel disk should
be big enough to hold all the file systems, and swap slice
of the local current boot disk.

(3) As there will probably be more than one logical disk drive on
the fibre channel adapter it will be necessary to use persistent
binding ('nailing' a specific scsi id to a specific wwpn or did).

(4) It will be necessary to correlate the intended boot disk displayed
by the 'probe-scsi-all' command to the devices displayed by the
operating system.

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

----------------------- NEW CHANGES 1.50a8 ------------------------

1. The PCI device ID for Lpe11000 in make file wasn't a correct value,
and cause probe process does not find the Fcode image during POST.
The new release fixed this issue by update the correct PCI device
ID in make file. (CR18053)
----------------------- NEW CHANGES 1.50a7 ------------------------

1. The command of report-luns is not setup as external variable in
FCode, this caused the system fail to compile the report-luns into
the RAM during the boot time, and result a boot failure. The new
fix has setup the report-luns as external variable. (CR17926)
----------------------- NEW CHANGES 1.50a6 ------------------------

1. Added the Report LUN before Test Unit Ready command. (CR17835)

2. Added 60ms delay after PRLI and before the first Report Luns command
is sent out. (CR17836)

3. Changed the FCP Port Completion Timeout to 90 seconds for Start/Stop Unit
command, and others for 30 seconds timeout. (CR17837)

4. Fixed the bug on system hangs during "probe-scsi-all", because the timeout
for FCP completion was greater FCP Response. The new fix will be increased
FCP Response Timeout to 100 seconds for Start/Stop Unit command, and others
for 40 seconds timeout. (CR17838)

5. Fixed the bug for mishandle the return value of TUR when FC cable was not
connect properly during boot time and result an error message of
"STACK UNDERFLOW" issue. (CR17839)

Platform: Intel (32-bit)

Contains: x86 BootBIOS 1.70a3, OpenBoot 1.50a8 and EFIBoot 3.11a4 This Universal Boot version 5.01a9 contains:

(1) x86 BootBIOS version 1.70a3
(2) OpenBoot version 1.50a8
(3) EFIBoot version 3.11a4

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

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

\readme.txt this file you are reading
\HU501A9.PRG LP9802 Universal Boot
\TU501A9.PRG LP10000 Universal Boot
\BU501A9.PRG LP11000 Universal Boot
\ZU501A9.PRG LPe11000 Universal Boot
\elxcli311a4.efi EFI 3.11a4 Driver
Universal Boot Load Procedure

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

1. "Drvcfg" : EFI based Systems.

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

2. LP6DUTIL.EXE : DOS based utility.

Please refer to the LP6DUTIL version 9.0a13, or later, documentation for user
interface how to download EFIBoot in DOS PCI systems.

3. LPUTILNT : Windows Miniport Driver.

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

4. Emulex Configuration Tool : Windows Port Driver.

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

Contains: x86 BootBIOS 1.70a3, OpenBoot 1.50a8 and EFIBoot 3.11a5 This Universal Boot version 5.01a9 contains:

(1) x86 BootBIOS version 1.70a3
(2) OpenBoot version 1.50a8
(3) EFIBoot version 3.11a5

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

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

\readme.txt this file you are reading
\HU502A0.PRG LP9802 Universal Boot
\TU502A0.PRG LP10000 Universal Boot
\BU502A0.PRG LP11000 Universal Boot
\ZU502A0.PRG LPe11000 Universal Boot
\elxcli311a5.efi EFI 3.11a5 Driver
Universal Boot Load Procedure

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

1. "Drvcfg" : EFI based Systems.

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

2. LP6DUTIL.EXE : DOS based utility.

Please refer to the LP6DUTIL version 9.0a13, or later, documentation for user
interface how to download EFIBoot in DOS PCI systems.

3. LPUTILNT : Windows Miniport Driver.

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

4. Emulex Configuration Tool : Windows Port Driver.

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

Contains: x86 BootBIOS 2.00a1, OpenBoot 1.50a9 and EFIBoot 3.11a5 This Universal Boot version 5.02a4 contains:

(1) x86 BootBIOS version 2.00a1
(2) OpenBoot version 1.50a9
(3) EFIBoot version 3.11a5

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

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

\502a4.txt this file you are reading
\HU502a4.PRG LP9802 Universal Boot
\TU502a4.PRG LP10000 Universal Boot
\BU502a4.PRG LP11000 Universal Boot
\ZU502a4.PRG LPe11000 Universal Boot
\elxcli311a5.efi EFI 3.11a5 Driver
Universal Boot Load Procedure

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

1. "Drvcfg" : EFI based Systems.

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

2. LP6DUTIL.EXE : DOS based utility.

Please refer to the LP6DUTIL version 9.0a13, or later, documentation for user
interface how to download EFIBoot in DOS PCI systems.

3. LPUTILNT : Windows Miniport Driver.

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

4. Emulex Configuration Tool : Windows Port Driver.

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

Contains: x86 BootBIOS 2.01a2, OpenBoot 3.01a1 and EFIBoot 4.00a1 This Universal Boot version 5.03a0 contains:

(1) x86 BootBIOS version 2.01a2
(2) OpenBoot version 3.01a1
(3) EFIBoot version 4.00a1

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

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

\503a0.txt this file you are reading
\HU503a0.PRG LP9802 Universal Boot
\TU503a0.PRG LP10000 Universal Boot
\BU503a0.PRG LP11000 Universal Boot
\ZU503a0.PRG LPe11000 Universal Boot
\UU503a0.PRG LPe12000 Universal Boot
\elxcli400a1.efi EFI 4.00a1 Driver
Universal Boot Load Procedure

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

1. "Drvcfg" : EFI based Systems.

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

2. LP6DUTIL.EXE : DOS based utility.

Please refer to the LP6DUTIL version 9.0a13, or later, documentation for user
interface how to download EFIBoot in DOS PCI systems.

3. LPUTILNT : Windows Miniport Driver.

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

4. Emulex Configuration Tool : Windows Port Driver.

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

Contains: x86 BootBIOS 2.02a1, OpenBoot 3.01a1 and EFIBoot 4.00a1 This Universal Boot version 5.03a2 contains:

(1) x86 BootBIOS version 2.02a1
(2) OpenBoot version 3.01a1
(3) EFIBoot version 4.00a1

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

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

\503a2.txt this file you are reading
\HU503a2.PRG LP9802 Universal Boot
\TU503a2.PRG LP10000 Universal Boot
\BU503a2.PRG LP11000 Universal Boot
\ZU503a2.PRG LPe11000 Universal Boot
\UU503a2.PRG LPe12000 Universal Boot
\elxcli400a1.efi EFI 4.00a1 Driver
Universal Boot Load Procedure

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

1. "Drvcfg" : EFI based Systems.

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

2. LP6DUTIL.EXE : DOS based utility.

Please refer to the LP6DUTIL version 9.0a13, or later, documentation for user
interface how to download EFIBoot in DOS PCI systems.

3. LPUTILNT : Windows Miniport Driver.

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

4. Emulex Configuration Tool : Windows Port Driver.

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

PCIe System Tests in process The current EFI (Extensible Firmware Interface) Boot provides 64-bit system
boot capability through the use of the EFI Shell. EFIBoot supports EFI
Specification 1.10 and EFI Source Code version 1.10.14.61 and 1.10.14.62.

EFIBoot supports:

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

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

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

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

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

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

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

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

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

EFI Byte Code Driver Images:

\311A3.txt this file you are reading
\DE311A3.PRG Lp8000 EFIBoot version 3.11a3
\CE311A3.PRG Lp9000 EFIBoot version 3.11a3
\HE311A3.PRG Lp9802 EFIBoot version 3.11a3
\QE311A3.PRG Lp850 EFIBoot version 3.11a3
\HE311A3.PRG Lp9802 EFIBoot version 3.11a3
\LE311A3.PRG Lp982 EFIBoot version 3.11a3
\TE311A3.PRG Lp10000 EFIBoot version 3.11a3
\ME311A3.PRG Lp1050 EFIBoot version 3.11a3
\EE311A3.PRG Lp101 EFIBoot version 3.11a3
\BE311A3.PRG Lp11000 EFIBoot version 3.11a3
\JE311A3.PRG Lp1150 EFIBoot version 3.11a3
\IE311A3.PRG Lp111 EFIBoot version 3.11a3
\ZE311A3.PRG Lpe11000 EFIBoot version 3.11a3
\WE311A3.PRG Lpe1150 EFIBoot version 3.11a3
\YE311A3.PRG Lpe111 EFIBoot version 3.11a3
\ElxCli311a3.efi


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

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

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

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

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

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

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

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

Platform: Intel Itanium (64-bit) The current EFI (Extensible Firmware Interface) Boot provides 64-bit system
boot capability through the use of the EFI Shell. EFIBoot supports EFI
Specification 1.10 and EFI Source Code version 1.10.14.61 and 1.10.14.62.

EFIBoot supports:

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

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

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

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

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

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

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

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

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

EFI Byte Code Driver Images:

\rel_notes.txt this file you are reading
\DE311A4.PRG Lp8000 EFIBoot version 3.11a4
\CE311A4.PRG Lp9000 EFIBoot version 3.11a4
\HE311A4.PRG Lp9802 EFIBoot version 3.11a4
\QE311A4.PRG Lp850 EFIBoot version 3.11a4
\HE311A4.PRG Lp9802 EFIBoot version 3.11a4
\LE311A4.PRG Lp982 EFIBoot version 3.11a4
\TE311A4.PRG Lp10000 EFIBoot version 3.11a4
\ME311A4.PRG Lp1050 EFIBoot version 3.11a4
\EE311A4.PRG Lp101 EFIBoot version 3.11a4
\BE311A4.PRG Lp11000 EFIBoot version 3.11a4
\JE311A4.PRG Lp1150 EFIBoot version 3.11a4
\ZE311A4.PRG Lpe11000 EFIBoot version 3.11a4
\WE311A4.PRG Lpe1150 EFIBoot version 3.11a4
\ElxCli311a4.efi


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

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

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

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

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

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

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

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

Platform: Intel Itanium (64-bit) The current EFI (Extensible Firmware Interface) Boot provides 64-bit system
boot capability through the use of the EFI Shell. EFIBoot supports EFI
Specification 1.10 and EFI Source Code version 1.10.14.61 and 1.10.14.62.

EFIBoot supports:

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

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

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

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

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

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

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

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

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

EFI Byte Code Driver Images:

\rel_notes.txt this file you are reading
\HE321A5.PRG Lp9802 EFIBoot version 3.21A5
\LE321A5.PRG Lp982 EFIBoot version 3.21A5
\TE321A5.PRG Lp10000 EFIBoot version 3.21A5
\ME321A5.PRG Lp1050 EFIBoot version 3.21A5
\EE321A5.PRG Lp101 EFIBoot version 3.21A5
\BE321A5.PRG Lp11000 EFIBoot version 3.21A5
\JE321A5.PRG Lp1150 EFIBoot version 3.21A5
\ZE321A5.PRG Lpe11000 EFIBoot version 3.21A5
\WE321A5.PRG Lpe1150 EFIBoot version 3.21A5
\YE321A5.PRG Lpe111 EFIBoot version 3.21A5
\ElxCli321A5.efi

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

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

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

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

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

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

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

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

Compatibility:

This kit supports the LPe11002 PCI host adapter.

This kit includes the following files:

README.TXT The file you are reading

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

-- Version 2.50a2 --

This is the first general release of firmware for this product.
Earlier versions were for prototype builds, pre-release software,
and test purposes.

Compatibility:

This kit supports the LPe11002 PCI host adapter.

This kit includes the following files:

README.TXT The file you are reading

ZF250A4.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 2.50a4 and 2.50a2:

Changes in power management reset handling prevent certain machines
from issuing hardware malfunction errors. (CR 17263, 17382)

The PCI Revision is now matched between the ASIC and the firmware
to avoid confusing the driver during hot swap or driver update.
(CR 17320, 17451, 17454)

The address cache buffer entries stored in FLASH which are required
for proper operation during FLASH lockout are now initialized properly.
(CR 16573, 17296, 17367, 17497, 17498)

Removed extraneous debug code which caused a Slim Parity Status Error.
(CR 17495, 17499)

-- Version 2.50a2 was the initial general release of this firmware.

Compatibility:

This kit supports the LPe11002 PCI host adapter.

This kit includes the following files:

README.TXT The file you are reading

ZF250A6.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 2.50a6 and 2.50a5:

Corrected UART interrupt handling to eliminate chance of channel lock up
on first POST after flash is programmed. (CR 18621, 19083)

Corrected a programming error which disabled changing the speed from 1G
during auto speed select.(CR 18858)

Pre-initialize configuration region to avoid errors if host reads it
before the initial configuration is complete. (CR 19177, 19187, 19188)

-- Changes and corrections between 2.50a5 and 2.50a4:

Debounced cable pull indication to allow compatability with a wider
choice of SFP types. (CR 16383, 18304, 18396)

Improved handling of unexpected link events after a DownLink command by
returning to a non-active state after the command is processed.
(CR 17081, 17577, 17606, 18281)

Improved handling of queued data from tape. Recovery of CRC errors
no longer indirectly trigger an abort on slow PCI environments.
(CR 17410, 17510, 17520, 17608, 17610, 17633, 17634, 17635, 18280,
18343)

The maximum IOCB value reported by read_config now reports the correct
number of buffers in the pool. (CR 18223, 18289, 18290, 18348)

Improved buffer handling logic during error conditions to avoid aborted
exchanges. (CR 17701, 18291, 18292, 18349)

Loopback operation has been changed so that loopback activity is not
transmitted to the link. (CR 18311, 18315, 17776, 18301, 18302, 18395)

Improved handling of erroneously-sized ECHO responses. (CR 18330,
18332,18333)

The HBA now transmits all outstanding ACKs before processing any
previously blocked data. (CR 16354, 18334, 18335)

Correct address values are now returned in Dump Table data.
(CR 18313, 18337, 18338)

The transmit queue is now restarted after ACK handling to avoid a
transmit hang in Class 2. (CR 18362, 18363, 18364)

Removed toggle of transmitter during speed negotiation to avoid going
into loopback mode. (CR 18012, 18305, 18392)

Added support for Blade product. (CR 18320, 18321, 18350, 18368, 18370)

Added custom features or configurations as per customer request.
(CR 17479, 17482, 17684, 17688, 17381, 18339, 18340, 18371, 16069,
18282, 18285, 18344)

Note: For the Solaris SFS driver, version 1.11i or 2.11i (or later) must be installed before you update to firmware version 2.70a5. Compatibility:

This kit supports the LPe11002 PCI host adapter.

This kit includes the following files:

README.TXT The file you are reading

ZF270A5.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 between 2.70a5 and previous releases ----

With VNP enabled and no registered VNPs, firmware will now function
as if VNPs are not enabled. (CR 23132)

Port number generation for virtual ports has been corrected.
(CR 23051, 23131)

Corrected handling of AHB parity errors. (CR 23049, 23050)

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 22563)

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

Any attentions pending during link down are now sent. (CR 22510)

Firmware now seperates BDL DMA requests so that one is stopped before
another is started. (CR 22162, 22179)

QDR memory POST was modified to establish proper ECC and prevent false
memory read errors. (CR 22519, 22520)

Corrected processing of BDL with unexpected offset to properly handle
incoming data frame. (CR 22564)

Incorporated new Emulex SLI-3 protocol. (CR 20834, 20843)

SLI-3 coding inconsistencies were found during in-house test with no
reported instances of failure.
- Proper wakeup parameters have been generated (CR 21597)
- Mailbox response interlock correction (CR 22051)
- READ_REV command had to be corrected (CR 22067, 22114)
- Corrected data abort by assuring all data structures
are initialized to zero before allocation. (CR 22513)

Allow VPD offset to be outside of specification for greater flexibility
with some systems. (CR 21548)

Corrected PCI configuration to advertise VPD access for Zephyr 1.1 ASICs.
(CR 21391)

Protocol testing with invalid conditions revealed protocol response
errors which have had no reported instances of failure in the field.
(CR 17199, 17200, 17203, 20788)

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

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

Note: For the Solaris SFS driver, version 1.11i or 2.11i (or later) must be installed before you update to firmware version 2.72a2. 1. Released Version Identification
Software: Firmware for HBA/Blade
Version: 2.72a2
Date: August 14, 2007
2. Update severity

___ Urgent: This version fixes one or more potentially severe or
critical problems.

_X_ Normal: This version is a regular maintenance update of
various problem fixes.

___ Minor: This version addresses minor issues such as cosmetic
changes, problems found by code review with no reported
failures, and configuration changes.
3. Compatibility
The following is a list of compatible hardware products, drivers,
operating system types, files, etc. for the version and type of
software described above.

BD272A2.ALL LP11000 4Gb/s PCI-X single-channel enterprise HBA
BF272A2.ALL LP11002 4Gb/s PCI-X dual-channel enterprise HBA
BF272A2.ALL LP1105 4Gb/s PCI-X dual-channel blade mezzanine card
JF272A2.ALL LP1150 4Gb/s PCI-X mid-range HBA
ZD272A2.ALL LPe11000 4Gb/s PCI Express single-channel enterprise HBA
ZF272A2.ALL LPe11020-S 4Gb/s PCI Express Network Express Module
ZF272A2.ALL LPe11002 4Gb/s PCI Express dual-channel enterprise HBA
ZF272A2.ALL LPe1105 4Gb/s PCI Express dual-channel blade mezz. card
ZF272A2.ALL LPem11002 4Gb/s PCI Express dual-channel Express Module
WF272A2.ALL LPe1150 4Gb/s PCI Express mid-range HBA
YM272A2.ALL LPe111 4Gb/s PCI Express Small-Medium Business HBA
4. New Features
The following is a list of all new features included in this version
of software, and a brief description of their use.

Increased the virtual N-port count from 8 to 16 for mid-range HBAs.
(CR 25595)
-
Modified stub and kernel code to support volatile WWN capability.
(CR 24852, 24853, 24854)

Additional support for MSI/X added to 8 Gigabit products only.
(CR 24685)

SLI-3: Added performance improvements. (CR 24833)

Increased SLI-3 feature level to "9" to indicate more robust NPIV
handling. (CR 24923)
5. Resolved Issues
The following is a list of all the corrections that have been made in
this version of software.

The kernel has been fixed so that, while pre-loading TLBs on Helios
and Zephyr dual-channel cards, we no longer inadvertently write to
completion RAM. (CR 25765, 25778)
-
Tape issue: The FCP2 recovery now releases an exchange to the free
pool only once. (CR 25114, 25572)

SLI-3: Delinking an exchange which gets an ABTS while waiting for a
frame to transmit ABTS or BA_ACC has been improved and no longer
corrupts the list. (CR 25216)

Note: For the Solaris SFS driver, version 1.11i or 2.11i (or later) must be installed before you update to firmware version 2.82a3. RELEASE NOTES FOR FIRMWARE VERSION 2.82A3

Date: June 2009
Product: Emulex® LightPulse® adapters: LPe11000, LPe11002, LPe1104, LPe1150, LP11000, LP11002, LP1150 and LPe111
Version:2.82a3 Firmware

This document describes the known issues associated with this firmware 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 representative.

New Feature in Firmware Version 2.82a3

Added Host Pointer SLIM (HPS) bit support.

Resolved Issues Firmware Version 2.82a3

1. Improved reset handling.
2. Improved internal retransmission of an FCP command during FC-Tape recovery.
3. Eliminated spurious firmware interrupts[JB4].
4. A word check now correctly verifies that the Abort Sequence frame (ABTS) is the first frame of exchange.
5. Adapters now handle IERR and link down reset automatically.
6. Enhanced handling of multiple split errors. The firmware had previously returned trap code 0x40000005 caused by multiple split errors from the host bus.
7. The N_Port_ID now is handled correctly in REG_VPI after a link down followed by a link up.
8. For LP11000, LP1150, LPe11000 and LPe1150 adapters, the correct VNPid is saved into the entry VPIO when the ELS_REQUEST64 cmd is used with CT= 0 and RPI = 0.
9. Resolved general NPIV issues.
10. The LPe1150 adapter now correctly saves the max_payload_size value across a warm system reboot (PCIE reset).
11. Corrected RSCN processing.
12. Correct link speed is negotiated when directly connected to a specific OEM array.

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.

Compatibility:

This kit supports the LPe11002, LPe11004, and LPe1105 PCI Express
host adapters.

This kit includes the following files:

README.TXT The file you are reading
ZF280A4.ALL All firmware components, no boot code
Changes and Corrections:

-- Changes in version 2.80a4 --

Volatile WWNs now indicate presence in the Host Status Register.
(CR 83090, 83091, 83092)

-- Changes in version 2.80a3 --

Bringing up the loop was made more tolerant and consistent. (CR 82586,
82587)

READ_CONFIG mailbox command no longer returns wrong information on system
running Solaris for x86. (CR 82588)

Changed Receive Timeout default timer value to avoid one-second
shortfall. (CR 82591)

-- Changes in version 2.80a2 --

VPI values are now set to zero after a system reboot. (CR 75272)

Fixed code to correctly process link counter update on link down (cable
pull). (CR 75618, 82314)

Performing a firmware update using HBAnyware 4.0 across platforms no
longer results in the firmware update failing and causing the HBA to
appear offline when seen from a remote HBA while appearing online to
the local system. (CR 82162, 82163)

Revised command queueing method so that transmit buffer actions do not
starve generic sequence operations. (CR 82331, 82332)

Corrected dump table formatting and size issue. (CR 82361, 82362)

-- Changes in version 2.80a1 --

Allow 32-bit firmware counters RxWords, TxWords, RxFrames, and TxFrames
to roll over for continued use by statistical applications. (CR 74512,
74911)

The internal loopback test now works properly. (CR 74539)

PCI-e HBAs use "no soft reset" capability present in PCIPM 1.2 to
preserve values across reset. (CR 75198, 75199, 75200, 75201)

UNREG_LOGIN with RPI=0xFFFF and VPI=0xFFFF now performs an
UNREG_LOGIN_ALL for all virtual N_Ports. (CR 75273)

Correct code is used for VNP FLOGI handling. (CR 75274)

Enhanced SLI-3 UNREG_LOGIN command to check for RPI. (CR 75336)

-- Changes in version 2.80a0 --

Firmware download is now successful on both ports of a dual-port HBA.
(CR 25956, 28844)

The link activity LED no longer continues to blink after link down
following a cable pull. (CR 26947, 28876)

Overview................................................................................................................ 1
Be Informed, Stay Informed, Stay Current 1
The Importance of Compatibility, Driver Updates and Firmware Updates 1
Driver Updates........................................................................................... 1
Firmware Updates...................................................................................... 2
Emulex Configuration Parameters 3
How Emulex Device Driver Configuration Parameters Work...................... 3
Emulex Applications 3
Troubleshooting...................................................................................................... 4
Observing the Problem 4
Isolating the Problem 4
SAN Components...................................................................................... 4
Server Components................................................................................... 5
Checklists 6
Connectivity Checklist................................................................................ 6
Installation Checklist.................................................................................. 7
Upgrade Checklist...................................................................................... 8
Configuration Checklist.............................................................................. 8
Tools to Collect Data 9
Driver Tools - Event Logging...................................................................... 9
The OneCommand Manager and HBAnyware Applications....................... 9
Other Ways to Collect Data...................................................................... 10
Common Problems 10
Hardware Issues...................................................................................... 10
Link Down................................................................................................ 10
Cannot See Devices or Drives................................................................. 11
Out-of-Date Driver Version....................................................................... 12
Out-of-Date Firmware Version.................................................................. 12
OneConnect and LightPulse LP21000 Adapters 13
OneConnect and LP21000 Checklist....................................................... 13
OneConnect and LP21000 Symptoms..................................................... 13
When to Contact Emulex...................................................................................... 14
Emulex Web Site and Emulex Support................................................................. 15
Emulex Support Page 15
Contact Emulex After Hours, Weekends or Holidays............................... 17
LED Reference Information.................................................................................. 18
Firmware Operation and Port Activity LEDs 18
Common LED States 18
Normal Link Up........................................................................................ 18
Link-Down or adapter waiting................................................................... 19
Heart-beat indication................................................................................ 19
OneConnect CNA LEDs........................................................................... 19
LP21000 LEDs......................................................................................... 19
LED Table................................................................................................ 21

Driver Updates
To update your driver, download the latest Emulex driver and utilities from the Emulex Web site. From
the main Emulex Web site, click Downloads, click your vendor and then click the link for your operating
system (OS).
Drivers for Windows
• The drivers for Windows include support for Windows Server 2008 R2, Windows Server 2008,
Windows Server 2003, Windows 2000 Server and Windows NT (No future versions of drivers for
Windows 2000 Server or Windows NT are planned.)
•The driver kit download includes the base driver and the OneCommand Manager application.
•If you are running Windows Server 2008 R2, Windows Server 2008, Windows Server 2003 or Windows 2000 Server, the driver kit download includes AutoPilot Installer®, which enables you to quickly install or update drivers and utilities and configure adapters, drivers and utilities.

Introduction..................................................................................................................................................1
Major Features...............................................................................................................................1
Compatibility...................................................................................................................................2
Prerequisites...................................................................................................................................2
Setting the Jumpers.....................................................................................................................................2
Installing the Host Bus Adapter....................................................................................................................3
Attaching Media...........................................................................................................................................5
Applying Power............................................................................................................................................6
Viewing the LEDs...........................................................................................................................6
POST Conditions and Results.........................................................................................................6
References..................................................................................................................................................8
Specifications.................................................................................................................................8
FCC and Regulatory Notices...........................................................................................................9
Declaration of Conformity..............................................................................................................10
Laser Safety Notice.......................................................................................................................12

Introduction
The Emulex® LPe11002 host bus adapter (HBA) is a dual-channel, 4.25 gigabit per second (Gb/s), Fibre
Channel (FC) Peripheral Component Interconnect Express (PCIe) HBA. The core technology of this
HBA is Emulex’s eighth generation FC controller. The controller incorporates a multifunction native PCIe
core that is compliant to the PCIe Base Specification 1.0a and PCI Express CEM Specification 1.0a. The
HBA supports packet transfers up to 2048 bytes on the PCIe link with support for x1 or x4 lane
negotiation. The supported physical PCIe connector is x4 or higher (x8 or x16). The two independent,
fully featured FC ports are compliant to various American National Standards Institute (ANSI) FC
standards. The product is targeted at FC storage networking environments that require the highest
degrees of robustness, performance and ease of management.

Major Features
• Multifunction PCIe device with two fully independent FC ports
• Auto-negotiation between 1-Gb, 2-Gb or 4-Gb link attachments
• High performance FC HBA with the PCIe to FC controller with two internal processors
• Full support for all FC topologies including point-to-point, arbitrated loop and fabric
• Full support for FC service class 2 and 3
• Maximum FC throughput achieved via full duplex hardware support
• End-to-end data path-parity and cyclical redundancy check (CRC) protection, including internal
data path random-access memory (RAM)
• Architectural support for multiple upper layer protocols
• State-of-the-art circuitry:
•All PCIe and FC functionality contained within a single, custom, high-density, fully integrated FC controller
•Internal ARM 1136J-S processors with instruction and data cache for each port
•Internal serializer deserializer (SerDes) 1-Gb/2-Gb/4-Gb cores for FC and 2.5-Gb cores for PCIe
• Complies with the PCIe base and CEM 1.0a specifications:
•x1 or x4 lane link interface (auto-negotiated with system) at 2.5-Gb/s
•Supports VC0 (1 Virtual Channel) and TC0 (1 Traffic Class)
•Configuration /IO/ Memory read/write, completion and message
•Supports 64-bit addressing
•ECRC for all transmitted PCIe data packets
•Link CRC on all PCIe packets and message
information
•Supports large payload size- 2048 bytes for read/write
•Supports large read request size- 4096 bytes
• Internal high-speed static RAM (SRAM)
• Error correcting code (ECC) protection of local memory, including single-bit correction and
double-bit protection
• The LPe11002 HBA provides two embedded short wave optical (LC) connections with link
diagnostics capability.
• Host interface via Emulex standard drivers or through custom drivers written to the Emulex
Service Level Interface (SLI-2) that is compatible with the many existing Emulex drivers for
products such as LP8000, LP9002L, LP9802, LP10000 HBAs
• Comprehensive array of operating system (OS) drivers:
•Emulex standard and OEM derivatives of device drivers for Windows 2000 Server, Windows Server 2003, Novell NetWare, Sun Solaris, Linux and HP-UX
•OEM-specific drivers for AIX and some other operating systems
•Some drivers support both SCSI and IP protocols
•Support for remote and fabric boot functionality
• On-board context management by the firmware (per port):
•Up to 510 FC port logins
•Up to 1023 concurrent exchanges

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

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)
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 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
Oracle Enterprise Linux 5 or later (x86 and x64 architectures)
HBAnyware Utility User Manual

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 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
Oracle Enterprise Linux 5 or 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.0 and later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
SUSE Linux Enterprise Server 10 SP1 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
Oracle Enterprise Linux 5 or later (x86 and x64 architectures)
HBAnyware utility 3.4a14 (198 MB tar file)

HBAnyware 3.4a14 Linux Installation Instructions

This installation kit contains the following components:

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

Dependencies:

lpfc driver version 8.2.0.22 or later

HBAnyware requires that the lpfc driver module be installed.

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

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

Select desired mode of operation for HBAnyware

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

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

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

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

Red Hat Enterprise Linux 5.0 and later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
SUSE Linux Enterprise Server 10 SP1 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
Oracle Enterprise Linux 5 or later (x86 and x64 architectures)
Base driver and install script (273 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

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

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.

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 driver build to succeed. For example, a
system with the 2.6.16.46-0.7-bigsmp kernel would need the
kernel-source-2.6.16.46-0.7 package.

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

Support Resources for PRIMEQUEST Servers
SLES9 SP3 (2.6.5-7.244)
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 9 Service Pack 1 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
Red Hat Enterprise Linux 4 Update 1 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
Use this file only with the RHEL 4 Update 2 or SLES9 SP3 distributions, which contain the 8.0.16.17 driver -- do not use with the driver kit above

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

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

1. System Requirements

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

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

2. Description of Changes

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

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

3. Release Notes

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

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

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

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

SUSE Linux Enterprise Server 9 Service Pack 1 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
Red Hat Enterprise Linux 4 Update 1 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
HBAnyware utility 2.1a25, lputil 2.0a9 (169 MB tar file)

HBAnyware 2.1a25 Linux Installation Instructions

This installation kit contains the following components:

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

Dependencies:

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

HBAnyware requires a minimum screen resolution of 1024 x 768.

Installing HBAnyware

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

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

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

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

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

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

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

SUSE Linux Enterprise Server 9 Service Pack 1 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
Red Hat Enterprise Linux 4 Update 1 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
Base driver, application helper module and install script

1. System Requirements
2. Description of Changes
3. Release Notes
3.1 Red Hat Enterprise Linux 'kernel-devel' Package Requirement
3.2 SuSE Linux Enterprise Server 'kernel-source' Package Requirement
3.3 Kernel Upgrade
3.4 Changing Target Timeout
3.4.1 Background
3.4.2 Observed Problem
3.4.3 Workaround
3.5 Machine Check Exception
3.5.1 Observed problem
3.5.2 Workaround
----------------------------------------------------------------------

1. System Requirements

The following distributions of Linux are supported by the Emulex
drivers:

Red Hat Enterprise Linux 4
SuSE Linux Enterprise Server 9

2. Description of Install Procedure

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

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

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

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

For SuSE Linux Enterprise Server installations, the kernel-source
package with the same version as the currently running kernel must
be installed for the 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 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
Red Hat Enterprise Linux 4 Update 2 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
Oracle Enterprise Linux 4 Update 4 or later (x86 and x64 architectures)
Asianux 2.0 SP2 or later (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 2 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
Red Hat Enterprise Linux 4 Update 2 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
Oracle Enterprise Linux 4 Update 4 or later (x86 and x64 architectures)
Asianux 2.0 SP2 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
SUSE Linux Enterprise Server 9 (ia64)

RELEASE NOTES for Emulex SMI-S HBA Provider
Version 1.1.6
SECTION 1. Introduction
SECTION 2. System Prerequisites
SECTION 3. Supported and Tested Operating Systems
SECTION 4. Installation
SECTION 5. Directory Structure
SECTION 6. HBAnyware WebLaunch Integration (Optional)
SECTION 7. Known Limitations
SECTION 8. 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.5.1 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.1.0.85, and it is fully compliant with SMI-S v1.1.0.

SLP (Service Location Protocol) and OpenSSL are included with the Emulex
SMI-S HBA Provider kit on Windows and are installed by default if not
already present. See Section 2 for Linux specific details.

For security purposes, you might want to replace the sample certificates
(privkey.cert and elxhba.cert) with your own signed certificates.

NOTE: The included 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.
Members of the local group "Administrators" have full access to the CIM
server by default on Windows.

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

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

RELEASE NOTES for Emulex SMI-S HBA Provider
Version 1.1.6
SECTION 1. Introduction
SECTION 2. System Prerequisites
SECTION 3. Supported and Tested Operating Systems
SECTION 4. Installation
SECTION 5. Directory Structure
SECTION 6. HBAnyware WebLaunch Integration (Optional)
SECTION 7. Known Limitations
SECTION 8. 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.5.1 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.1.0.85, and it is fully compliant with SMI-S v1.1.0.

SLP (Service Location Protocol) and OpenSSL are included with the Emulex
SMI-S HBA Provider kit on Windows and are installed by default if not
already present. See Section 2 for Linux specific details.

For security purposes, you might want to replace the sample certificates
(privkey.cert and elxhba.cert) with your own signed certificates.

NOTE: The included 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.
Members of the local group "Administrators" have full access to the CIM
server by default on Windows.

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

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

RELEASE NOTES for Emulex SMI-S HBA Provider
Version 1.1.6
SECTION 1. Introduction
SECTION 2. System Prerequisites
SECTION 3. Supported and Tested Operating Systems
SECTION 4. Installation
SECTION 5. Directory Structure
SECTION 6. HBAnyware WebLaunch Integration (Optional)
SECTION 7. Known Limitations
SECTION 8. 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.5.1 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.1.0.85, and it is fully compliant with SMI-S v1.1.0.

SLP (Service Location Protocol) and OpenSSL are included with the Emulex
SMI-S HBA Provider kit on Windows and are installed by default if not
already present. See Section 2 for Linux specific details.

For security purposes, you might want to replace the sample certificates
(privkey.cert and elxhba.cert) with your own signed certificates.

NOTE: The included 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.
Members of the local group "Administrators" have full access to the CIM
server by default on Windows.

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

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

RELEASE NOTES for Emulex SMI-S HBA Provider
Version 1.1.6
SECTION 1. Introduction
SECTION 2. System Prerequisites
SECTION 3. Supported and Tested Operating Systems
SECTION 4. Installation
SECTION 5. Directory Structure
SECTION 6. HBAnyware WebLaunch Integration (Optional)
SECTION 7. Known Limitations
SECTION 8. 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.5.1 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.1.0.85, and it is fully compliant with SMI-S v1.1.0.

SLP (Service Location Protocol) and OpenSSL are included with the Emulex
SMI-S HBA Provider kit on Windows and are installed by default if not
already present. See Section 2 for Linux specific details.

For security purposes, you might want to replace the sample certificates
(privkey.cert and elxhba.cert) with your own signed certificates.

NOTE: The included 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.
Members of the local group "Administrators" have full access to the CIM
server by default on Windows.

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

SUSE Linux Enterprise Server 9 Service Pack 2 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
Red Hat Enterprise Linux 4 Update 2 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
Oracle Enterprise Linux 4 Update 4 or later (x86 and x64 architectures)
Asianux 2.0 SP2 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
HBAnyware utility 3.0a14, lputil 2.0a13, Application helper module 2.0.15 (187 MB tar file)

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

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 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
Red Hat Enterprise Linux 4 Update 2 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
Oracle Enterprise Linux 4 Update 4 or later (x86 and x64 architectures)
Asianux 2.0 SP2 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)

HBAnyware 3.2a7 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 3.2a7
SSC version 3.2a7
DFC Library version 80.163-11
Lputil version 2.0a14
HBAAPI version 2.1.d
DFC helper module

Dependencies:

lpfc driver version 8.0.16.32 or later

HBAnyware requires that the lpfc driver module be installed.

HBAnyware requires a minimum screen resolution of 1024 x 768.

HBAnyware requires the kernel development environment as described here:

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

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

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

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

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

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 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
Red Hat Enterprise Linux 4 Update 2 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
Oracle Enterprise Linux 4 Update 4 or later (x86 and x64 architectures)
Asianux 2.0 SP2 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)

Introduction.............................................................................................................. 1
Installing lputil .......................................................................................................... 1
Starting lputil............................................................................................................ 2
Discovering HBAs.................................................................................................... 4
Viewing HBA Information......................................................................................... 4
Resetting an HBA .................................................................................................... 5
Updating an HBA’s Firmware or Boot Code ............................................................. 5
Enabling or Disabling Boot Code ............................................................................. 6
Downloading PCI Configuration............................................................................... 7
Setting Up Persistent Binding (Solaris Only)............................................................ 7
Using the Command Line Interface ......................................................................... 9
Examples of lputil Commands................................................................... 11

Introduction
The LightPulse® diagnostic utility (lputil) for Linux and Solaris is a console application that enables you
to manage local Emulex® host bus adapters (HBAs).
Use lputil to do any of the following:
• Discover HBAs
• View HBA information
• Reset HBAs
• Update firmware or boot code on the local HBA
• Enable or disable the boot code on the HBA
• Download PCI Configuration
• Set Up Persistent Binding (Solaris only)
• Use the Command Line Interface (CLI)
Prerequisites
Before using lputil, ensure the following prerequisites are met:
• The Emulex driver is installed.
• The lputil utility is installed.
• If you are updating firmware, the firmware file is downloaded to a local drive. Firmware versions
differ between HBA versions. Make sure you have downloaded the appropriate firmware for your
HBA.
• I/O activity on the bus is quieted.
• Any software that relies on the HBA to be available is stopped or paused.
Installing lputil
To install lputil:
1. Download the lputil.tar file from the Emulex Web site to a directory on a local drive on the server.
2. Untar the contents of the lputil.tar file.
3. Run the lputil installation script.

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

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 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
Red Hat Enterprise Linux 4 Update 2 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
Oracle Enterprise Linux 4 Update 4 or later (x86 and x64 architectures)
Asianux 2.0 SP2 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)

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 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
Red Hat Enterprise Linux 4 Update 2 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)
Oracle Enterprise Linux 4 Update 4 or later (x86 and x64 architectures)
Asianux 2.0 SP2 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures)

HBAnyware 3.3a20 Linux Installation Instructions

This installation kit contains the following components:

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

Dependencies:

lpfc driver version 8.0.16.34 or later

HBAnyware requires that the lpfc driver module be installed.

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

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

Select desired mode of operation for HBAnyware

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

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

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

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

Red Hat Enterprise Linux 5.0 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP1 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5 or later (x86 and x64 architectures)
HBAnyware Utility 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.0 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP1 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5 or later (x86 and x64 architectures)
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.0 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP1 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5 or later (x86 and x64 architectures)
HBAnyware utility 4.0a31 (179 MB tar file)

HBAnyware 4.0a31 Linux Installation Instructions

This installation kit contains the following components:

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

lpfc driver version 8.2.0.29 or later

HBAnyware requires that the lpfc driver module be installed.

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

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

Select desired mode of operation for HBAnyware

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

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

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

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

Red Hat Enterprise Linux 5.0 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures) SUSE Linux Enterprise Server 10 SP1 or later (x86 and x64, Intel Itanium2 and PowerPC 64-bit architectures) Oracle Enterprise Linux 5 or later (x86 and x64 architectures)
Base driver and install script (288 KB gz file)

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

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

1. System Requirements

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

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

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

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

SUSE Linux Enterprise Server 9 Service Pack 2 or later (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and PowerPC 64-bit architectures) Red Hat Enterprise Linux 4 Update 2 or later (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and PowerPC 64-bit architectures) Oracle Enterprise Linux 4 Update 4 or later (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and PowerPC 64-bit architectures)Asianux 2.0 SP2 or later (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and PowerPC 64-bit architectures)
HBAnyware Utility User Manual

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 or later (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and PowerPC 64-bit architectures) Red Hat Enterprise Linux 4 Update 2 or later (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and PowerPC 64-bit architectures) Oracle Enterprise Linux 4 Update 4 or later (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and PowerPC 64-bit architectures)Asianux 2.0 SP2 or later (Intel x86, Intel Itanium2, Intel EM64T, AMD64, 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 or later (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and PowerPC 64-bit architectures) Red Hat Enterprise Linux 4 Update 2 or later (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and PowerPC 64-bit architectures) Oracle Enterprise Linux 4 Update 4 or later (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and PowerPC 64-bit architectures)Asianux 2.0 SP2 or later (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and PowerPC 64-bit architectures)
HBAnyware utility 3.4a14, Application helper module 2.0.30

HBAnyware 3.4a14 Linux Installation Instructions

This installation kit contains the following components:

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

Dependencies:

lpfc driver version 8.0.16.40 or later

HBAnyware requires that the lpfc driver module be installed.

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

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

Select desired mode of operation for HBAnyware

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

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

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

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

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

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

Emulex LightPulse PCI Fibre Channel Adapter
for Novell Netware 5.1, 6.0, and 6.5

Emulex Corporation

Release 2.20e September 30, 2005
This Readme file contains the description of the 2.20e version
of the LPFC.HAM driver for the Emulex LightPulse adapter family
and Novell NetWare 5.1, 6.0 and 6.5. It provides support for
switched Fabric operation and multi-initiator environments and
for up to 16 adapter channels using single or dual channel HBAs.

The Emulex LPFC.HAM driver has been tested in the following
environments:

1. OS Versions:
- Netware 6.5 with Support Pack 3 (NW65SP3)
- NetWare 6.0 with Support Pack 5 (NW6SP5 )
- NetWare 5.1 with Support Pack 7 (NW51SP7)
- untested with Netware 5.0 with Support Pack 6a (SP6a).
Netware 5.0 is supported by Novell, however no future work is planned for this version.
- NetWare 4.2 is not supported at this time; use Emulex driver version 1.23c to support NetWare 4.2.
2. Arbitrated Loop Environment
3. Switched Fabric Environment
4. Emulex Fibre Channel adapters
- LP11000 series adapters (minimum firmware revision 1.91a1)
- LP1150 series adapters (minimum firmware revision 1.91a1)
- LPe11000 series adapters (minimum firmware revision 1.91a1)
- LPe1150 series adapters (minimum firmware revision 1.91a1)
- LP10000 series adapters (minimum firmware revision 1.91a1)
- LP1050 series adapters (minimum firmware revision 1.91a1)
- LP101 series adapters (minimum firmware revision 1.82a0)
- LP9802DC, LP9802 and LP982 (minimum firmware version 1.91a1)
- LP9402DC, LP9002L, LP9002DC, LP9000 or LP952L (recommended firmware version 3.92a2)
- LP8000, LP8000DC and LP850
-- If your HBA has a Dragonfly chip version 2.00 or greater
use firmware version 3.92a2.
-- If your HBA has a Dragonfly chip below version 2.00,
use firmware version 3.30a7.
- LP7000E (minimum firmware version 3.21a0)
5. Suitable target hardware; lpfc.ham complies with SAN protocols
for switched fabrics and arbitrated loops.

This release includes the following files:

1. LPFC.HAM - Emulex Fibre Channel adapter HAM driver
2. lpfc.ddi - driver description file
3. readme.txt - readme file (this file)
INSTALLATION INSTRUCTIONS ON AN EXISTING NETWARE SERVER:

1. The server must support PCI 2.2 standard slots or PCI-X 1.1
standard slots.

2. At the server console load the install program. On
Netware 6.5 enter

LOAD HDETECT

On Netware 6.0, 5.1, or 5.0, enter

LOAD NWCONFIG

3. Select "Driver Options".

4. Select "Configure disk and storage device drivers".

5. Select "Select an additional driver".

6. Press to install a driver not on the list.
(If there is a previously installed version of the driver,
this will update and replace it).

Solaris 2.6, 7, 8, 9 and 10 (32-bit and 64-bit)
Installing and using the FCA utilities

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

Solaris 2.6, 7, 8, 9 and 10 (32-bit and 64-bit)
emlxadm version 1.00r and emlxdrv version 1.00k for SPARC; emlxdrv is needed for a fresh installation of Solaris 10 Update 1 (75.5 KB tar file)

Solaris 2.6, 7, 8, 9 and 10 (32-bit and 64-bit)
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

Solaris 2.6, 7, 8, 9 and 10 (32-bit and 64-bit)
Base driver, HBAnyware utility 2.1a18, HBAnyware Security Configurator 2.1a18 and lputil 2.0a9

HBAnyware 2.1a18 Solaris Installation Instructions

Dependencies:

lpfcdriver 6.02c, or later
hbaapi 2.0e

Java Runtime Environment

Version 1.4 or later of the Java Runtime Environment (JRE) must
be installed. HBAnyware will not run under earlier versions of
the JRE.

HBAnyware and hbacmd currently will not run under Solaris 6.

The JRE and instructions for installation can be found at http://java.sun.com/downloads/index.html

JAVA NOTE:
HBAnyware needs the java runtime binaries and libraries, so their path needs to be included in the PATH
environment variable. For example, if your java runtime binaries are in /usr/java/bin, then include this path
in your PATH environment variable. (bash> export PATH="$PATH:/usr/java/bin")


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

1. Run the pkgrm routine to remove any previous version of HBAnyware: pkgrm HBAnyware
2. Copy the HBAnyware-2.1a18-sparc.tar.gz file to a directory on the install machine
3. cd to the directory which you copied the tar file
4. Unzip the file: gunzip HBAnyware-2.1a18-sparc.tar.gz
5. Untar the file: tar -xvf HBAnyware-2.1a18-sparc.tar
6. Run the pkgadd routine: pkgadd -d .
7. When prompted by pkadd, choose to install HBAnyware
Running the HBAnyware GUI

1. su to root
2. Run the script /usr/sbin/hbanyware/hbanyware
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.

Solaris 2.6, 7, 8, 9 and 10 (32-bit and 64-bit) Solaris 10 Updates and the lpfc
Driver
The behavior of the Solaris operating system changes beginning with Solaris 10 Update 1 (also referred
to as Solaris 10 1/06 release). Starting with this version, a bare-metal installation of the operating system
automatically discovers all SFS-recognized HBAs (Sun-branded, Emulex, or EMC-branded) and binds
them to the “emlxs” SFS driver. A subsequent installation of lpfc will not discover and bind these HBAs;
you must use the emlxdrv utility to unbind the HBAs from the SFS driver as described in this document.

Note: You do not need to follow the procedure described in this document in the following
circumstances:
• If the server contains any Sun-branded HBAs, which are recognized
and supported only by the emlxs driver and not by the lpfc driver; you
must use the emlxs driver on all HBAs.
• If you installed an earlier version of Solaris and bound the HBAs to the
lpfc driver; updating to Solaris 10 Update 1 (or later) by applying
patches will not unbind the HBAs from the lpfc driver.

Prerequisites:
• SPARC platform
• Solaris 10 Update 1 or later installed on a local drive
• Sun released patch 120222-06 or later installed
• Emulex® FCA utility version 1.00m (which includes emlxdrv 1.00j for SPARC) or later installed
(see the Emulex FCA Utilities Reference Manual for installation instructions)
• Emulex lpfc driver not yet installed
To unbind the HBAs from the SFS driver, do the following:
1. Start the emlxdrv utility as described in the Emulex FCA Utilities Reference Manual.
2. Type the following command at the emlxdrv prompt:
clear_all
This unbinds from emlxs all HBAs that are recognized by both emlxs and lpfc drivers.
3. Exit the emlxdrv utility by typing the following:
q
Install the lpfc driver as instructed in the documentation that accompanies the driver.

Solaris 8, 9 and 10 (32-bit and 64-bit)
Note Emulex recommends installing driver version 6.10gx2, which adds a critical fix to the previously posted 6.10g driver. Driver functionality and behavior are otherwise identical.
Note Emulex supports current Solaris x86 systems through an SFS driver
For a legacy lpfc driver for Solaris 9 x86, or for Solaris 8 SPARC legacy drivers that are not listed under Previous Releases
Installing and using the FCA utilities

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

Solaris 8, 9 and 10 (32-bit and 64-bit)
Note Emulex recommends installing driver version 6.10gx2, which adds a critical fix to the previously posted 6.10g driver. Driver functionality and behavior are otherwise identical.
Note Emulex supports current Solaris x86 systems through an SFS driver
For a legacy lpfc driver for Solaris 9 x86, or for Solaris 8 SPARC legacy drivers that are not listed under Previous Releases
emlxadm version 1.00r and emlxdrv version 1.00k for SPARC; emlxdrv is needed for a fresh installation of Solaris 10 Update 1 (75.5 KB tar file)

Solaris 8, 9 and 10 (32-bit and 64-bit)
Note Emulex recommends installing driver version 6.10gx2, which adds a critical fix to the previously posted 6.10g driver. Driver functionality and behavior are otherwise identical.
Note Emulex supports current Solaris x86 systems through an SFS driver
For a legacy lpfc driver for Solaris 9 x86, or for Solaris 8 SPARC legacy drivers that are not listed under Previous Releases
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

Solaris 8, 9 and 10 (32-bit and 64-bit)
Note Emulex recommends installing driver version 6.10gx2, which adds a critical fix to the previously posted 6.10g driver. Driver functionality and behavior are otherwise identical.
Note Emulex supports current Solaris x86 systems through an SFS driver
For a legacy lpfc driver for Solaris 9 x86, or for Solaris 8 SPARC legacy drivers that are not listed under Previous Releases
Base driver, HBAnyware utility 3.0a17 and lputil 2.0a13

HBAnyware 3.0a17 Solaris Installation Instructions

Dependencies:

lpfcdriver 6.10b, or later
hbaapi 2.0f

Java Runtime Environment

Version 1.4 or later of the Java Runtime Environment (JRE) must
be installed. HBAnyware will not run under earlier versions of
the JRE.

HBAnyware and hbacmd currently will not run under Solaris 6. HBAnyware and hbacmd target OS versions
include Solaris 5.8, 5.9, and 5.10.

The JRE and instructions for installation can be found at http://java.sun.com/downloads/index.html

JAVA NOTE:
HBAnyware needs the java runtime binaries and libraries, so their path needs to be included in the PATH
environment variable. For example, if your java runtime binaries are in /usr/java/bin, then include this path
in your PATH environment variable. (bash> export PATH="$PATH:/usr/java/bin")


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

1. Run the pkgrm routine to remove any previous version of HBAnyware: pkgrm HBAnyware
2. Run the unpack script : ./unpack_apps
to obtain correct package version
3. Unzip the file: gunzip HBAnyware-3.0a17-sparc.tar.gz
4. Untar the file: tar -xvf HBAnyware-3.0a17-sparc.tar
5. Run the pkgadd utility: pkgadd -d .
6. When prompted by pkadd, choose to install HBAnyware
7. When prompted by pkadd, answer the HBAnyware installation option questions
Running the HBAnyware GUI

1. su to root
2. Run the script /usr/sbin/hbanyware/hbanyware
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.

Solaris 8, 9 and 10 (32-bit and 64-bit)
Note Emulex recommends installing driver version 6.10gx2, which adds a critical fix to the previously posted 6.10g driver. Driver functionality and behavior are otherwise identical.
Note Emulex supports current Solaris x86 systems through an SFS driver
For a legacy lpfc driver for Solaris 9 x86, or for Solaris 8 SPARC legacy drivers that are not listed under Previous Releases Solaris 10 Updates and the lpfc
Driver
The behavior of the Solaris operating system changes beginning with Solaris 10 Update 1 (also referred
to as Solaris 10 1/06 release). Starting with this version, a bare-metal installation of the operating system
automatically discovers all SFS-recognized HBAs (Sun-branded, Emulex, or EMC-branded) and binds
them to the “emlxs” SFS driver. A subsequent installation of lpfc will not discover and bind these HBAs;
you must use the emlxdrv utility to unbind the HBAs from the SFS driver as described in this document.

Note: You do not need to follow the procedure described in this document in the following
circumstances:
• If the server contains any Sun-branded HBAs, which are recognized
and supported only by the emlxs driver and not by the lpfc driver; you
must use the emlxs driver on all HBAs.
• If you installed an earlier version of Solaris and bound the HBAs to the
lpfc driver; updating to Solaris 10 Update 1 (or later) by applying
patches will not unbind the HBAs from the lpfc driver.

Prerequisites:
• SPARC platform
• Solaris 10 Update 1 or later installed on a local drive
• Sun released patch 120222-06 or later installed
• Emulex® FCA utility version 1.00m (which includes emlxdrv 1.00j for SPARC) or later installed
(see the Emulex FCA Utilities Reference Manual for installation instructions)
• Emulex lpfc driver not yet installed
To unbind the HBAs from the SFS driver, do the following:
1. Start the emlxdrv utility as described in the Emulex FCA Utilities Reference Manual.
2. Type the following command at the emlxdrv prompt:
clear_all
This unbinds from emlxs all HBAs that are recognized by both emlxs and lpfc drivers.
3. Exit the emlxdrv utility by typing the following:
q
Install the lpfc driver as instructed in the documentation that accompanies the driver.

Solaris 8, 9 and 10 (32-bit and 64-bit)
Note: Emulex recommends installing driver version 6.11cx2, which adds a critical fix to the previously posted 6.11c driver. Driver functionality and behavior are otherwise identical.
Note Emulex supports current Solaris x86 systems through an SFS driver
For a legacy lpfc driver for Solaris 9 x86, or for Solaris 8 SPARC legacy drivers that are not listed under Previous Releases
emlxadm version 1.01a and emlxdrv version 1.00k for SPARC; emlxdrv is needed for a fresh installation of Solaris 10 Update 1 (75.5 KB tar file)

Solaris 8, 9 and 10 (32-bit and 64-bit)
Note: Emulex recommends installing driver version 6.11cx2, which adds a critical fix to the previously posted 6.11c driver. Driver functionality and behavior are otherwise identical.
Note Emulex supports current Solaris x86 systems through an SFS driver
For a legacy lpfc driver for Solaris 9 x86, or for Solaris 8 SPARC legacy drivers that are not listed under Previous Releases

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

Solaris 8, 9 and 10 (32-bit and 64-bit)
Note: Emulex recommends installing driver version 6.11cx2, which adds a critical fix to the previously posted 6.11c driver. Driver functionality and behavior are otherwise identical.
Note Emulex supports current Solaris x86 systems through an SFS driver
For a legacy lpfc driver for Solaris 9 x86, or for Solaris 8 SPARC legacy drivers that are not listed under Previous Releases
Base driver, HBAnyware utility 3.1a12 and lputil 2.0a13

HBAnyware 3.1a12 Solaris Installation Instructions

Dependencies:

lpfcdriver 6.11c, emlxsdriver 2.20a, or later
hbaapi 2.0f

Java Runtime Environment

Version 1.5 or later of the Java Runtime Environment (JRE) must
be installed. HBAnyware will not run under earlier versions of
the JRE.

HBAnyware and hbacmd currently will not run under Solaris 6. HBAnyware and hbacmd target OS versions
include Solaris 5.8, 5.9, and 5.10.

The JRE and instructions for installation can be found at http://java.sun.com/downloads/index.html

JAVA NOTE:
HBAnyware needs the java runtime binaries and libraries, so their path needs to be included in the PATH
environment variable. For example, if your java runtime binaries are in /usr/java/bin, then include this path
in your PATH environment variable. (bash> export PATH="$PATH:/usr/java/bin")


HBAnyware is dependant on a driver being installed, so install lpfcdriver or emlxsdriver first if it is not already installed.

1. Run the pkgrm routine to remove any previous version of HBAnyware: pkgrm HBAnyware
2. Run the unpack script : ./unpack_apps
to obtain correct package version
3. Unzip the file: gunzip HBAnyware-3.1a12-sparc.tar.gz
4. Untar the file: tar -xvf HBAnyware-3.1a12-sparc.tar
5. Run the pkgadd utility: pkgadd -d .
6. When prompted by pkadd, choose to install HBAnyware
7. When prompted by pkadd, answer the HBAnyware installation option questions
Running the HBAnyware GUI

1. su to root
2. Run the script /usr/sbin/hbanyware/hbanyware
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.

Solaris 8, 9 and 10 (32-bit and 64-bit)
Note: Emulex recommends installing driver version 6.11cx2, which adds a critical fix to the previously posted 6.11c driver. Driver functionality and behavior are otherwise identical.
Note Emulex supports current Solaris x86 systems through an SFS driver
For a legacy lpfc driver for Solaris 9 x86, or for Solaris 8 SPARC legacy drivers that are not listed under Previous Releases Solaris 10 Updates and the lpfc
Driver
The behavior of the Solaris operating system changes beginning with Solaris 10 Update 1 (also referred
to as Solaris 10 1/06 release). Starting with this version, a bare-metal installation of the operating system
automatically discovers all SFS-recognized HBAs (Sun-branded, Emulex, or EMC-branded) and binds
them to the “emlxs” SFS driver. A subsequent installation of lpfc will not discover and bind these HBAs;
you must use the emlxdrv utility to unbind the HBAs from the SFS driver as described in this document.

Note: You do not need to follow the procedure described in this document in the following
circumstances:
• If the server contains any Sun-branded HBAs, which are recognized
and supported only by the emlxs driver and not by the lpfc driver; you
must use the emlxs driver on all HBAs.
• If you installed an earlier version of Solaris and bound the HBAs to the
lpfc driver; updating to Solaris 10 Update 1 (or later) by applying
patches will not unbind the HBAs from the lpfc driver.

Prerequisites:
• SPARC platform
• Solaris 10 Update 1 or later installed on a local drive
• Sun released patch 120222-06 or later installed
• Emulex® FCA utility version 1.00m (which includes emlxdrv 1.00j for SPARC) or later installed
(see the Emulex FCA Utilities Reference Manual for installation instructions)
• Emulex lpfc driver not yet installed
To unbind the HBAs from the SFS driver, do the following:
1. Start the emlxdrv utility as described in the Emulex FCA Utilities Reference Manual.
2. Type the following command at the emlxdrv prompt:
clear_all
This unbinds from emlxs all HBAs that are recognized by both emlxs and lpfc drivers.
3. Exit the emlxdrv utility by typing the following:
q
Install the lpfc driver as instructed in the documentation that accompanies the driver.

Solaris 8, 9 and 10 (32-bit and 64-bit)
Note This driver version requires patch #112438 for
Solaris 8 operation.
Starting with this Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
Note Emulex supports current Solaris x86 systems through an SFS driver
Note For a legacy lpfc driver for Solaris 9 x86, or for Solaris 8 SPARC legacy drivers that are not listed under Previous Releases
emlxadm version 1.01a and emlxdrv version 1.00k for SPARC; emlxdrv is needed for a fresh installation of Solaris 10 Update 1 (75.5 KB tar file)

Solaris 8, 9 and 10 (32-bit and 64-bit)
Note This driver version requires patch #112438 for
Solaris 8 operation.
Starting with this Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
Note Emulex supports current Solaris x86 systems through an SFS driver
Note For a legacy lpfc driver for Solaris 9 x86, or for Solaris 8 SPARC legacy drivers that are not listed under Previous Releases
lputil Utility User Manual

Introduction.............................................................................................................. 1
Installing lputil .......................................................................................................... 1
Starting lputil............................................................................................................ 2
Discovering HBAs.................................................................................................... 4
Viewing HBA Information......................................................................................... 4
Resetting an HBA .................................................................................................... 5
Updating an HBA’s Firmware or Boot Code ............................................................. 5
Enabling or Disabling Boot Code ............................................................................. 6
Downloading PCI Configuration............................................................................... 7
Setting Up Persistent Binding (Solaris Only)............................................................ 7
Using the Command Line Interface ......................................................................... 9
Examples of lputil Commands................................................................... 11

Introduction
The LightPulse® diagnostic utility (lputil) for Linux and Solaris is a console application that enables you
to manage local Emulex® host bus adapters (HBAs).
Use lputil to do any of the following:
• Discover HBAs
• View HBA information
• Reset HBAs
• Update firmware or boot code on the local HBA
• Enable or disable the boot code on the HBA
• Download PCI Configuration
• Set Up Persistent Binding (Solaris only)
• Use the Command Line Interface (CLI)
Prerequisites
Before using lputil, ensure the following prerequisites are met:
• The Emulex driver is installed.
• The lputil utility is installed.
• If you are updating firmware, the firmware file is downloaded to a local drive. Firmware versions
differ between HBA versions. Make sure you have downloaded the appropriate firmware for your
HBA.
• I/O activity on the bus is quieted.
• Any software that relies on the HBA to be available is stopped or paused.
Installing lputil
To install lputil:
1. Download the lputil.tar file from the Emulex Web site to a directory on a local drive on the server.
2. Untar the contents of the lputil.tar file.
3. Run the lputil installation script.

Solaris 8, 9 and 10 (32-bit and 64-bit)
Note This driver version requires patch #112438 for
Solaris 8 operation.
Starting with this Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
Note Emulex supports current Solaris x86 systems through an SFS driver
Note For a legacy lpfc driver for Solaris 9 x86, or for Solaris 8 SPARC legacy drivers that are not listed under Previous Releases
HBAnyware Utility User Manual

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

Solaris 8, 9 and 10 (32-bit and 64-bit)
Note This driver version requires patch #112438 for
Solaris 8 operation.
Starting with this Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
Note Emulex supports current Solaris x86 systems through an SFS driver
Note For a legacy lpfc driver for Solaris 9 x86, or for Solaris 8 SPARC legacy drivers that are not listed under Previous Releases
LPFC Driver for Solaris User Manual (1.67 MB)

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

Solaris 8, 9 and 10 (32-bit and 64-bit)
Note This driver version requires patch #112438 for
Solaris 8 operation.
Starting with this Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
Note Emulex supports current Solaris x86 systems through an SFS driver
Note For a legacy lpfc driver for Solaris 9 x86, or for Solaris 8 SPARC legacy drivers that are not listed under Previous Releases
Base driver, HBAnyware utility 3.3a22 and lputil 2.0a13 (21.5 MB tar file)

Solaris 8, 9 and 10 (32-bit and 64-bit)
Note This driver version requires patch #112438 for
Solaris 8 operation.
Starting with this Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
Note Emulex supports current Solaris x86 systems through an SFS driver
Note For a legacy lpfc driver for Solaris 9 x86, or for Solaris 8 SPARC legacy drivers that are not listed under Previous Releases Solaris 10 Updates and the lpfc
Driver
The behavior of the Solaris operating system changes beginning with Solaris 10 Update 1 (also referred
to as Solaris 10 1/06 release). Starting with this version, a bare-metal installation of the operating system
automatically discovers all SFS-recognized HBAs (Sun-branded, Emulex, or EMC-branded) and binds
them to the “emlxs” SFS driver. A subsequent installation of lpfc will not discover and bind these HBAs;
you must use the emlxdrv utility to unbind the HBAs from the SFS driver as described in this document.

Note: You do not need to follow the procedure described in this document in the following
circumstances:
• If the server contains any Sun-branded HBAs, which are recognized
and supported only by the emlxs driver and not by the lpfc driver; you
must use the emlxs driver on all HBAs.
• If you installed an earlier version of Solaris and bound the HBAs to the
lpfc driver; updating to Solaris 10 Update 1 (or later) by applying
patches will not unbind the HBAs from the lpfc driver.

Prerequisites:
• SPARC platform
• Solaris 10 Update 1 or later installed on a local drive
• Sun released patch 120222-06 or later installed
• Emulex® FCA utility version 1.00m (which includes emlxdrv 1.00j for SPARC) or later installed
(see the Emulex FCA Utilities Reference Manual for installation instructions)
• Emulex lpfc driver not yet installed
To unbind the HBAs from the SFS driver, do the following:
1. Start the emlxdrv utility as described in the Emulex FCA Utilities Reference Manual.
2. Type the following command at the emlxdrv prompt:
clear_all
This unbinds from emlxs all HBAs that are recognized by both emlxs and lpfc drivers.
3. Exit the emlxdrv utility by typing the following:
q
Install the lpfc driver as instructed in the documentation that accompanies the driver.

Solaris 8, 9 and 10 (32-bit and 64-bit)
Note This driver version requires patch #112438 for
Solaris 8 operation.
Starting with Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
Note - Emulex supports current Solaris x86 systems through an SFS driver
Note - For legacy lpfc drivers that are not listed under Previous Releases
Instructions for using emlxdrv

Introduction.............................................................................................................. 1
Fibre Channel Overview .................................................................................... 1
The Solaris Fibre Channel Stack ....................................................................... 1
Installing the Utilities................................................................................................ 3
Compatibility...................................................................................................... 3
Installing or Updating the Utilities Using the emlxu_install Script....................... 4
Removing the Utilities Using the emlxu_remove Script ..................................... 5
Installing the Utilities Package Manually............................................................ 6
Removing the Utilities Package Manually.......................................................... 7
Updating the Utilities Package Manually ........................................................... 7
Using the emlxadm Utility ........................................................................................ 8
Modes of Operation (emlxadm) ......................................................................... 8
Interactive Mode (emlxadm)........................................................................ 8
CLI Mode (emlxadm)................................................................................... 9
Command Descriptions (emlxadm) ................................................................. 11
Using the emlxdrv Utility ........................................................................................ 31
Modes of Operation (emlxdrv) ......................................................................... 31
Interactive Mode (emlxdrv)........................................................................ 31
CLI Mode (emlxdrv)................................................................................... 33
Command Descriptions (emlxdrv) ................................................................... 33

This document provides the information needed to use the Emulex® emlxadm and elmxdrv utility
programs. For system administrators, this document includes information about the installation and
removal of these utilities.
At the very least, system administrators should be familiar with Solaris and the Sun StorEdge SAN
Foundation Software (SFS) and should have access to standard system documentation. Anyone
working with this product should have some familiarity with the nature and use of Fibre Channel.

Solaris 8, 9 and 10 (32-bit and 64-bit)
Note This driver version requires patch #112438 for
Solaris 8 operation.
Starting with Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
Note - Emulex supports current Solaris x86 systems through an SFS driver
Note - For legacy lpfc drivers that are not listed under Previous Releases
emlxadm version 1.01a and emlxdrv version 1.00k for SPARC; emlxdrv is needed for a fresh installation of Solaris 10 Update 1 (75.5 KB tar file)

Solaris 8, 9 and 10 (32-bit and 64-bit)
Note This driver version requires patch #112438 for
Solaris 8 operation.
Starting with Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
Note - Emulex supports current Solaris x86 systems through an SFS driver
Note - For legacy lpfc drivers that are not listed under Previous Releases
HBAnyware Utility User Manual

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

Solaris 8, 9 and 10 (32-bit and 64-bit)
Note This driver version requires patch #112438 for
Solaris 8 operation.
Starting with Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
Note - Emulex supports current Solaris x86 systems through an SFS driver
Note - For legacy lpfc drivers that are not listed under Previous Releases
LPFC Driver for Solaris 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

Solaris 8, 9 and 10 (32-bit and 64-bit)
Note This driver version requires patch #112438 for
Solaris 8 operation.
Starting with Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
Note - Emulex supports current Solaris x86 systems through an SFS driver
Note - For legacy lpfc drivers that are not listed under Previous Releases
Base driver, HBAnyware utility 3.4a15, emlxdrv utility 1.00l; emlxdrv is needed for a fresh installation of Solaris 10 Update 1

HBAnyware 3.4a15 Solaris Installation Instructions

Dependencies:

lpfcdriver 6.21a, emlxsdriver 2.20a, or later
hbaapi 2.0.f

Java Runtime Environment

Version 1.5 or later of the Java Runtime Environment (JRE) must
be installed. HBAnyware will not run under earlier versions of
the JRE.

HBAnyware and hbacmd currently will not run under Solaris 6. HBAnyware and hbacmd target OS versions
include Solaris 5.8, 5.9, 5.10, and 5.11.

The JRE and instructions for installation can be found at http://java.sun.com/downloads/index.html

JAVA NOTE:
HBAnyware needs the java runtime binaries and libraries, so their path needs to be included in the PATH
environment variable. For example, if your java runtime binaries are in /usr/java/bin, then include this path
in your PATH environment variable. (bash> export PATH="$PATH:/usr/java/bin")


HBAnyware is dependant on a driver being installed, so install lpfcdriver or emlxsdriver first if it is not already installed.

1. Run the pkgrm routine to remove any previous version of HBAnyware: pkgrm HBAnyware
2. Run the unpack script : ./unpack_apps
to obtain correct package version
3. Unzip the file: gunzip HBAnyware-3.4a15-sparc.tar.gz
4. Untar the file: tar -xvf HBAnyware-3.4a15-sparc.tar
5. Run the pkgadd utility: pkgadd -d .
6. When prompted by pkgadd, choose to install HBAnyware
7. When prompted by pkgadd, answer the HBAnyware installation option questions
Running the HBAnyware GUI

1. su to root
2. Run the script /opt/emulex/hbanyware/hbanyware

Solaris 8, 9 and 10 (32-bit and 64-bit)
Note This driver version requires patch #112438 for
Solaris 8 operation.
Starting with Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information. Solaris 10 Updates and the lpfc
Driver
The behavior of the Solaris operating system changes beginning with Solaris 10 Update 1 (also referred
to as Solaris 10 1/06 release). Starting with this version, a bare-metal installation of the operating system
automatically discovers all SFS-recognized HBAs (Sun-branded, Emulex, or EMC-branded) and binds
them to the “emlxs” SFS driver. A subsequent installation of lpfc will not discover and bind these HBAs;
you must use the emlxdrv utility to unbind the HBAs from the SFS driver as described in this document.

Note: You do not need to follow the procedure described in this document in the following
circumstances:
• If the server contains any Sun-branded HBAs, which are recognized
and supported only by the emlxs driver and not by the lpfc driver; you
must use the emlxs driver on all HBAs.
• If you installed an earlier version of Solaris and bound the HBAs to the
lpfc driver; updating to Solaris 10 Update 1 (or later) by applying
patches will not unbind the HBAs from the lpfc driver.

Prerequisites:
• SPARC platform
• Solaris 10 Update 1 or later installed on a local drive
• Sun released patch 120222-06 or later installed
• Emulex® FCA utility version 1.00m (which includes emlxdrv 1.00j for SPARC) or later installed
(see the Emulex FCA Utilities Reference Manual for installation instructions)
• Emulex lpfc driver not yet installed
To unbind the HBAs from the SFS driver, do the following:
1. Start the emlxdrv utility as described in the Emulex FCA Utilities Reference Manual.
2. Type the following command at the emlxdrv prompt:
clear_all
This unbinds from emlxs all HBAs that are recognized by both emlxs and lpfc drivers.
3. Exit the emlxdrv utility by typing the following:
q
Install the lpfc driver as instructed in the documentation that accompanies the driver.

SPARC Solaris 8, 9 and 10 (32-bit and 64-bit)
Note This driver version requires patch #112438 for Solaris 8 operation.
Starting with Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
Instructions for using the FCA utilities

SPARC Solaris 8, 9 and 10 (32-bit and 64-bit)
Note This driver version requires patch #112438 for Solaris 8 operation.
Starting with Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
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

Note This driver is posted as is, with no new version planned.
This driver version requires patch #112438 for Solaris 8 operation.
Starting with Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
LPFC Driver for Solaris 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

SPARC Solaris 8, 9 and 10 (32-bit and 64-bit)
Note This driver version requires patch #112438 for Solaris 8 operation.
Starting with Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
Base driver, HBAnyware utility 4.0a37, emlxdrv utility 1.00m; emlxdrv is needed for a fresh installation of Solaris 10 Update 1

HBAnyware 4.0a37 Solaris Installation Instructions

Dependencies:

lpfc driver 6.30g or later
hbaapi 2.0.f
Java Runtime Environment

Version 1.5 or later of the Java Runtime Environment (JRE) must
be installed. HBAnyware will not run under earlier versions of
the JRE.

The JRE and instructions for installation can be found at http://java.com.

JAVA NOTE:
HBAnyware needs the Java runtime binaries and libraries, so their path needs to be included
in the PATH environment variable. For example, if your java runtime binaries are in /usr/java/bin,
then include this path in your PATH environment variable. (bash> export PATH="$PATH:/usr/java/bin")


HBAnyware and hbacmd currently will not run under Solaris 6. The HBAnyware and hbacmd target OS versions
include Solaris 5.8, 5.9, and 5.10.

HBAnyware is dependent on the Emulex lpfc driver being installed. Please ensure that this package is
installed prior to installing HBAnyware.

HBAnyware Installation Instructions
-----------------------------------
1. Run the pkgrm routine to remove any previous version of HBAnyware: pkgrm HBAnyware
2. Run the unpack script : ./unpack_apps
to obtain correct package version
3. Unzip the file: gunzip HBAnyware-4.0a37-sparc.tar.gz
4. Untar the file: tar -xvf HBAnyware-4.0a37-sparc.tar
5. Run the pkgadd utility: pkgadd -d .
6. When prompted by pkgadd, choose to install HBAnyware
7. When prompted by pkgadd, answer the HBAnyware installation option questions
Running the HBAnyware GUI
-------------------------
1. su to root
2. Execute the command: /opt/HBAnyware/hbanyware

SCSI Port Driver - IA32
Qualification: The SCSIport Miniport driver is Microsoft WHQL qualified and digitally signed for Windows Server 2003 on x86 and Itanium 64-bit platforms. The 64-bit Itanium SCSIport Miniport driver is also Microsoft WHQL qualified and digitally signed for Windows Server 2003, Datacenter Edition. The SCSIport Miniport driver is Microsoft WHQL qualified and digitally signed for Windows 2000 Server.
For Windows 2000 Server, Service Pack 4 is required.
Windows Server 2003 Upgrade Notice: If you are currently running the Emulex SCSIport Miniport driver version 5.10a10 or earlier, follow these Upgrade Instructions before upgrading from Windows 2000 Server to Windows Server 2003.
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

SCSI Port Driver - IA32
Qualification: The SCSIport Miniport driver is Microsoft WHQL qualified and digitally signed for Windows Server 2003 on x86 and Itanium 64-bit platforms. The 64-bit Itanium SCSIport Miniport driver is also Microsoft WHQL qualified and digitally signed for Windows Server 2003, Datacenter Edition. The SCSIport Miniport driver is Microsoft WHQL qualified and digitally signed for Windows 2000 Server.
For Windows 2000 Server, Service Pack 4 is required.
Windows Server 2003 Upgrade Notice: If you are currently running the Emulex SCSIport Miniport driver version 5.10a10 or earlier, follow these Upgrade Instructions before upgrading from Windows 2000 Server to Windows Server 2003.
Installing the driver using AutoPilot Installer (468 KB)

Introduction
AutoPilot Installer™ for Emulex® drivers provides installation options that range from a simple
installation with a few mouse clicks to custom unattended installations using predefined script files.
AutoPilot Installer is included with Emulex drivers and utilities in Windows executable files that can be
downloaded from the Emulex Web site. Run the distribution executable file to extract all of the software
needed for an installation, then complete the installation using AutoPilot Installer.
AutoPilot Installer allows you to install a driver using any of the following methods:
Hardware-first installation. The host bus adapter (HBA) is installed before the downloaded Emulex
drivers and utilities are installed. See page 3 for this procedure.
Software-first installation. This new installation method allows drivers and utilities to be downloaded
from the Emulex Web site and installed using AutoPilot Installer prior to the installation of any HBAs. The
drivers and utilities are automatically used when HBAs are installed at a later time. See page 4 for this
procedure.
Unattended installation. This new installation method allows you to set up AutoPilot Installer to run
unattended using customized scripts. Unattended installation can be used for both hardware-first and
software-first installations. See the complete Installation section of the driver user manual for more
information.

Updating the Driver Using AutoPilot Installer
If you are currently running an older driver version, use the hardware-first installation procedure to
update your driver. Begin at step 2 to update the driver.
You can also update the Emulex drivers following the manual installation method. See the complete
Installation section of the driver user manual for this procedure.

Distribution Executable File Overview
The distribution executable file is a self-extracting file that includes the following:
• AutoPilot Installer - installs driver and utilities.
• Driver - manages communication and data transfer between applications and I/O devices, using
HBAs as agents.
• HBAnyware utility - performs installation and configuration tasks on remote and local adapters.
• Driver-specific utility (elxcfg for FC Port, lputilnt for Storport Miniport and SCSIport Miniport) -
provides a user-friendly interface that allows you to examine, manage and configure local HBAs.
4. The default installation location is displayed. Browse to a different location, if desired. Click
Install to continue the installation.
5. The Progress window is displayed. As each task is completed, the corresponding checkbox is
automatically selected.
6. After all tasks are completed, a confirmation window is displayed. The Start AutoPilot Installer
checkbox is automatically selected. To start AutoPilot Installer later, clear this checkbox.
7. Click Finish to close the distribution executable file.
AutoPilot Installer Introduction
The Emulex AutoPilot Installer is a Fibre Channel HBA installation wizard for Windows. The AutoPilot
Installer installs (or updates) Emulex drivers and utilities and configures HBAs, drivers and utilities.

Prerequisites
• One of the following operating systems:
•Windows Server 2003 running on an x86, x64 or Itanium 64-bit platform.
•For the Emulex Storport Miniport driver, a Microsoft driver update may be required. See the Emulex Web site for the latest update to the Microsoft Storport driver.
•Windows 2000 Server - Service Pack 4 or later is recommended for all installations. Storport Miniport is not compatible with Windows 2000 Server.

SCSI Port Driver - IA32
Qualification: The SCSIport Miniport driver is Microsoft WHQL qualified and digitally signed for Windows Server 2003 on x86 and Itanium 64-bit platforms. The 64-bit Itanium SCSIport Miniport driver is also Microsoft WHQL qualified and digitally signed for Windows Server 2003, Datacenter Edition. The SCSIport Miniport driver is Microsoft WHQL qualified and digitally signed for Windows 2000 Server.
For Windows 2000 Server, Service Pack 4 is required.
Windows Server 2003 Upgrade Notice: If you are currently running the Emulex SCSIport Miniport driver version 5.10a10 or earlier, follow these Upgrade Instructions before upgrading from Windows 2000 Server to Windows Server 2003.
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 (6.97 MB exe file)

SCSI Port Driver - IA32
Qualification: The SCSIport Miniport driver is Microsoft WHQL qualified and digitally signed for Windows Server 2003 on x86 and Itanium 64-bit platforms. The 64-bit Itanium SCSIport Miniport driver is also Microsoft WHQL qualified and digitally signed for Windows Server 2003, Datacenter Edition. The SCSIport Miniport driver is Microsoft WHQL qualified and digitally signed for Windows 2000 Server.
For Windows 2000 Server, Service Pack 4 is required.
Windows Server 2003 Upgrade Notice: If you are currently running the Emulex SCSIport Miniport driver version 5.10a10 or earlier, follow these Upgrade Instructions before upgrading from Windows 2000 Server to Windows Server 2003.
Base driver, HBAnyware utility 3.0a9 and lputilnt 1.8a18 (18 MB exe file)

Port Driver - IA32
Microsoft WHQL qualified for Windows 2000 Server and 32-bit Windows Server 2003
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

Port Driver - IA32
Microsoft WHQL qualified for Windows 2000 Server and 32-bit Windows Server 2003
Quick Install Installing the driver using AutoPilot Installer (90 KB)

Port Driver - IA32
Microsoft WHQL qualified for Windows 2000 Server and 32-bit Windows Server 2003
Base driver and Emulex Configuration Utility (elxcfg) version 1.41a16 (12,927 KB exe file)

Qualification: The Storport Miniport driver is WHQL qualified for the Microsoft "Designed for Windows" logo program and digitally signed for x86, Itanium and x64 Editions versions of Windows Server 2003 and Windows Server 2008.
Note For Windows Server 2003, SP1 or SP2 and the KB932755 update to the Microsoft Storport driver are required. The KB932755 update must be applied before the Emulex Storport Miniport driver version 2.01a4 can be installed.
HBAnyware Utility Version 3.4

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

Qualification: The Storport Miniport driver is WHQL qualified for the Microsoft "Designed for Windows" logo program and digitally signed for x86, Itanium and x64 Editions versions of Windows Server 2003 and Windows Server 2008.
Note For Windows Server 2003, SP1 or SP2 and the KB932755 update to the Microsoft Storport driver are required. The KB932755 update must be applied before the Emulex Storport Miniport driver version 2.01a4 can be installed.
Storport Miniport Driver Version 2.01 for Windows Server 2003 and Windows Server 2008

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

Qualification: The Storport Miniport driver is WHQL qualified for the Microsoft "Designed for Windows" logo program and digitally signed for x86, Itanium and x64 Editions versions of Windows Server 2003 and Windows Server 2008.
Note For Windows Server 2003, SP1 or SP2 and the KB932755 update to the Microsoft Storport driver are required. The KB932755 update must be applied before the Emulex Storport Miniport driver version 2.01a4 can be installed.
AutoPilot Installer for Windows Server 2003 and Windows Server 2008

Introduction
AutoPilot Installer® for Emulex® drivers provides installation options that range from a simple installation
with a few mouse clicks to custom unattended installations using predefined script files.
AutoPilot Installer is included with Emulex drivers and utilities in Windows executable files that can be
downloaded from the Emulex Web site. Run the distribution executable file to extract all of the software
needed for an installation, then complete the installation using AutoPilot Installer.
AutoPilot Installer allows you to install a driver using any of the following methods:
Hardware-first installation. The host bus adapter (HBA) is installed before the downloaded Emulex
drivers and utilities are installed. See page 3 for this procedure.
Software-first installation. This new installation method allows drivers and utilities to be downloaded
from the Emulex Web site and installed using AutoPilot Installer prior to the installation of any HBAs. The
drivers and utilities are automatically used when HBAs are installed at a later time. See page 4 for this
procedure.
Unattended installation. This new installation method allows you to set up AutoPilot Installer to run
unattended using customized scripts. Unattended installation can be used for both hardware-first and
software-first installations. See the complete Installation section of the driver user manual for more
information.
Note: Complete driver and utilities documentation may be downloaded from the Emulex Web site
(www.emulex.com). Click Support at the top of the Web page and navigate by clicking the appropriate
links.
Updating the Driver Using AutoPilot Installer
If you are currently running an older driver version, use the hardware-first installation procedure to
update your driver. Begin at step 2 to update the driver.
You can also update the Emulex drivers following the manual installation method. See the complete
Installation section of the driver user manual for this procedure.
Distribution Executable File Overview
The distribution executable file is a self-extracting file that includes the following:
• AutoPilot Installer - installs driver and utilities.
• Driver - manages communication and data transfer between applications and I/O devices, using
HBAs as agents.
• HBAnyware utility - performs installation and configuration tasks on remote and local adapters.
Distribution Executable File Procedure
To run the distribution executable file:
1. Download the distribution executable file from the Emulex Web site to your system.
2. Double-click the distribution executable file. A window is displayed with driver version
information and Emulex contact information
3. Click Next to access the Location window or click Cancel to close the window.
4. The default installation location is displayed. Browse to a different location, if desired. Click
Install to continue the installation.
5. The Progress window is displayed. As each task is completed, the corresponding checkbox is
automatically selected.
6. After all tasks are completed, a confirmation window is displayed. The Start AutoPilot Installer
checkbox is automatically selected. To start AutoPilot Installer later, clear this checkbox.
7. Click Finish to close the distribution executable file.

Qualification: The Storport Miniport driver is WHQL qualified for the Microsoft "Designed for Windows" logo program and digitally signed for x86, Itanium and x64 Editions versions of Windows Server 2003 and Windows Server 2008.
Note For Windows Server 2003, SP1 or SP2 and the KB932755 update to the Microsoft Storport driver are required. The KB932755 update must be applied before the Emulex Storport Miniport driver version 2.01a4 can be installed.
Base driver, HBAnyware utility 3.4a9 (8.83 MB exe file)

Qualification: The SCSIport Miniport driver is Microsoft WHQL qualified and digitally signed for Windows Server 2003 on x86 and Itanium 64-bit platforms. The 64-bit Itanium SCSIport Miniport driver is also Microsoft WHQL qualified and digitally signed for Windows Server 2003, Datacenter Edition. The SCSIport Miniport driver is Microsoft WHQL qualified and digitally signed for Windows 2000 Server.
For Windows 2000 Server, Service Pack 4 is required.
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

Qualification: The SCSIport Miniport driver is Microsoft WHQL qualified and digitally signed for Windows Server 2003 on x86 and Itanium 64-bit platforms. The 64-bit Itanium SCSIport Miniport driver is also Microsoft WHQL qualified and digitally signed for Windows Server 2003, Datacenter Edition. The SCSIport Miniport driver is Microsoft WHQL qualified and digitally signed for Windows 2000 Server.
For Windows 2000 Server, Service Pack 4 is required.
Installing the driver using AutoPilot Installer (468 KB)

Qualification: The SCSIport Miniport driver is Microsoft WHQL qualified and digitally signed for Windows Server 2003 on x86 and Itanium 64-bit platforms. The 64-bit Itanium SCSIport Miniport driver is also Microsoft WHQL qualified and digitally signed for Windows Server 2003, Datacenter Edition. The SCSIport Miniport driver is Microsoft WHQL qualified and digitally signed for Windows 2000 Server.
For Windows 2000 Server, Service Pack 4 is required.
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
(6.97 MB exe file)

Qualification: The SCSIport Miniport driver is Microsoft WHQL qualified and digitally signed for Windows Server 2003 on x86 and Itanium 64-bit platforms. The 64-bit Itanium SCSIport Miniport driver is also Microsoft WHQL qualified and digitally signed for Windows Server 2003, Datacenter Edition. The SCSIport Miniport driver is Microsoft WHQL qualified and digitally signed for Windows 2000 Server.
For Windows 2000 Server, Service Pack 4 is required.
Base driver, HBAnyware utility 2.1a17 and lputilnt 1.8a15 (15 MB exe file)

Qualification: The Storport Miniport driver is WHQL qualified for the Microsoft "Designed for Windows" logo program and digitally signed for x86, Itanium and x64 Editions versions of Windows Server 2003 and Windows Server 2003 Datacenter Edition.
Note The KB916048 update to the Microsoft Storport driver is required.
Installation, Configuration and Troubleshooting (3,264 KB)

Introduction.............................................................................................................. 1
Important Considerations......................................................................................... 2
Changing Driver Types...................................................................................... 2
Microsoft Storport Driver Update ....................................................................... 2
Updating the Storport Miniport Driver Using AutoPilot Installer.......................... 2
Definitions................................................................................................................ 2
Storport Miniport Driver Information ......................................................................... 3
Prerequisites ..................................................................................................... 3
Compatibility...................................................................................................... 3
New in This Release ......................................................................................... 3
Known Issues .................................................................................................... 3
Files Included in this AutoPilot Installer ............................................................. 4
Distribution Executable File Overview ..................................................................... 5
Running the Distribution Executable File ........................................................... 5
AutoPilot Installer..................................................................................................... 6
Introduction ....................................................................................................... 6
Prerequisites ............................................................................................... 6
AutoPilot Installer Features ......................................................................... 6
Configuration Questions.............................................................................. 6
Installation Planning .......................................................................................... 6
AutoPilot Installation Procedures ............................................................................. 7
Hardware-First Installation................................................................................. 7
If the Installation Fails ................................................................................. 8
Software-First Installation .................................................................................. 8
Installing the HBAnyware Security Configurator ...................................................... 9
Unattended Installation .......................................................................................... 10
AutoPilot Configuration File Format................................................................. 10
Mandatory Configuration File Changes ........................................................... 10
Deleting Questions in the APInstall.cfg File ..................................................... 11
Optional Configuration File Changes............................................................... 11
Setting Up Driver Parameters.......................................................................... 14
Setting Up System Parameters ....................................................................... 14
Unattended Error Codes Reference Table....................................................... 14
Invoking AutoPilot Installer .............................................................................. 15
Batch File Example ......................................................................................... 15
Manually Installing or Updating the Storport Miniport Driver .................................. 17
Overview ......................................................................................................... 17
Removing the Adjunct Driver Registry Key...................................................... 17
Manually Installing the Emulex PLUS (ElxPlus) Driver .................................... 17
Manually Updating the Emulex PLUS (ElxPlus) Driver .................................... 18
Manually Installing or Updating the Storport Miniport Driver ............................ 19
Manually Installing the Driver Utilities .............................................................. 20
Uninstalling the Utility Package ....................................................................... 20
Uninstalling the Emulex Drivers....................................................................... 22
Configuration ...........................................................................................................23
Introduction............................................................................................................ 23
Starting HBAnyware from the Desktop ............................................................ 24

Qualification: The Storport Miniport driver is WHQL qualified for the Microsoft "Designed for Windows" logo program and digitally signed for x86, Itanium and x64 Editions versions of Windows Server 2003 and Windows Server 2003 Datacenter Edition.
Note Windows Server 2003 SP1 or later, and the KB932755 update to the Microsoft Storport driver, are required.
Installing the driver using AutoPilot Installer (498 KB)

Introduction
AutoPilot Installer™ for Emulex® drivers provides installation options that range from a simple
installation with a few mouse clicks to custom unattended installations using predefined script files.
AutoPilot Installer is included with Emulex drivers and utilities in Windows executable files that can be
downloaded from the Emulex Web site. Run the distribution executable file to extract all of the software
needed for an installation, then complete the installation using AutoPilot Installer.
AutoPilot Installer allows you to install a driver using any of the following methods:
Hardware-first installation. The host bus adapter (HBA) is installed before the downloaded Emulex
drivers and utilities are installed. See page 3 for this procedure.
Software-first installation. This new installation method allows drivers and utilities to be downloaded
from the Emulex Web site and installed using AutoPilot Installer prior to the installation of any HBAs. The
drivers and utilities are automatically used when HBAs are installed at a later time. See page 4 for this
procedure.
Unattended installation. This new installation method allows you to set up AutoPilot Installer to run
unattended using customized scripts. Unattended installation can be used for both hardware-first and
software-first installations. See the complete Installation section of the driver user manual for more
information.

Updating the Driver Using AutoPilot Installer
If you are currently running an older driver version, use the hardware-first installation procedure to
update your driver. Begin at step 2 to update the driver.
You can also update the Emulex drivers following the manual installation method. See the complete
Installation section of the driver user manual for this procedure.

Distribution Executable File Overview
The distribution executable file is a self-extracting file that includes the following:
• AutoPilot Installer - installs driver and utilities.
• Driver - manages communication and data transfer between applications and I/O devices, using
HBAs as agents.
• HBAnyware utility - performs installation and configuration tasks on remote and local adapters.
• Driver-specific utility (elxcfg for FC Port, lputilnt for Storport Miniport and SCSIport Miniport) -
provides a user-friendly interface that allows you to examine, manage and configure local HBAs.
4. The default installation location is displayed. Browse to a different location, if desired. Click
Install to continue the installation.
5. The Progress window is displayed. As each task is completed, the corresponding checkbox is
automatically selected.
6. After all tasks are completed, a confirmation window is displayed. The Start AutoPilot Installer
checkbox is automatically selected. To start AutoPilot Installer later, clear this checkbox.
7. Click Finish to close the distribution executable file.
AutoPilot Installer Introduction
The Emulex AutoPilot Installer is a Fibre Channel HBA installation wizard for Windows. The AutoPilot
Installer installs (or updates) Emulex drivers and utilities and configures HBAs, drivers and utilities.

Prerequisites
• One of the following operating systems:
•Windows Server 2003 running on an x86, x64 or Itanium 64-bit platform.
•For the Emulex Storport Miniport driver, a Microsoft driver update may be required. See the Emulex Web site for the latest update to the Microsoft Storport driver.
•Windows 2000 Server - Service Pack 4 or later is recommended for all installations. Storport Miniport is not compatible with Windows 2000 Server.

Qualification: The Storport Miniport driver is WHQL qualified for the Microsoft "Designed for Windows" logo program and digitally signed for x86, Itanium and x64 Editions versions of Windows Server 2003 and Windows Server 2003 Datacenter Edition.
Note The KB916048 update to the Microsoft Storport driver is required.
SMI-S HBA Provider, compliant with the SMI-S 1.1.0 specification and certified against the SNIA-CTP v1.1.0.85 suite
Pre-packaged with OpenPegasus CIMOM v2.5.1, as a turnkey SMI-S agent for ease of installation and deployment
(7.18 MB exe file)

Qualification: The Storport Miniport driver is WHQL qualified for the Microsoft "Designed for Windows" logo program and digitally signed for x86, Itanium and x64 Editions versions of Windows Server 2003 and Windows Server 2003 Datacenter Edition.
Note The KB916048 update to the Microsoft Storport driver is required.
Base driver, HBAnyware utility 3.0a16 and lputilnt version 1.8a19 (17.9 MB exe file)

Qualification: The Storport Miniport driver is WHQL qualified for the Microsoft "Designed for Windows" logo program and digitally signed for x86, Itanium and x64 Editions versions of Windows Server 2003 and Windows Server 2003 Datacenter Edition.
Note Windows Server 2003 SP1 or later, and the KB932755 update to the Microsoft Storport driver, are required.
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

Qualification: The Storport Miniport driver is WHQL qualified for the Microsoft "Designed for Windows" logo program and digitally signed for x86, Itanium and x64 Editions versions of Windows Server 2003 and Windows Server 2003 Datacenter Edition.
Note Windows Server 2003 SP1 or later, and the KB932755 update to the Microsoft Storport driver, are required.
Installing the driver using AutoPilot Installer (498 KB)

Introduction
AutoPilot Installer™ for Emulex® drivers provides installation options that range from a simple
installation with a few mouse clicks to custom unattended installations using predefined script files.
AutoPilot Installer is included with Emulex drivers and utilities in Windows executable files that can be
downloaded from the Emulex Web site. Run the distribution executable file to extract all of the software
needed for an installation, then complete the installation using AutoPilot Installer.
AutoPilot Installer allows you to install a driver using any of the following methods:
Hardware-first installation. The host bus adapter (HBA) is installed before the downloaded Emulex
drivers and utilities are installed. See page 3 for this procedure.
Software-first installation. This new installation method allows drivers and utilities to be downloaded
from the Emulex Web site and installed using AutoPilot Installer prior to the installation of any HBAs. The
drivers and utilities are automatically used when HBAs are installed at a later time. See page 4 for this
procedure.
Unattended installation. This new installation method allows you to set up AutoPilot Installer to run
unattended using customized scripts. Unattended installation can be used for both hardware-first and
software-first installations. See the complete Installation section of the driver user manual for more
information.

Updating the Driver Using AutoPilot Installer
If you are currently running an older driver version, use the hardware-first installation procedure to
update your driver. Begin at step 2 to update the driver.
You can also update the Emulex drivers following the manual installation method. See the complete
Installation section of the driver user manual for this procedure.

Distribution Executable File Overview
The distribution executable file is a self-extracting file that includes the following:
• AutoPilot Installer - installs driver and utilities.
• Driver - manages communication and data transfer between applications and I/O devices, using
HBAs as agents.
• HBAnyware utility - performs installation and configuration tasks on remote and local adapters.
• Driver-specific utility (elxcfg for FC Port, lputilnt for Storport Miniport and SCSIport Miniport) -
provides a user-friendly interface that allows you to examine, manage and configure local HBAs.
4. The default installation location is displayed. Browse to a different location, if desired. Click
Install to continue the installation.
5. The Progress window is displayed. As each task is completed, the corresponding checkbox is
automatically selected.
6. After all tasks are completed, a confirmation window is displayed. The Start AutoPilot Installer
checkbox is automatically selected. To start AutoPilot Installer later, clear this checkbox.
7. Click Finish to close the distribution executable file.
AutoPilot Installer Introduction
The Emulex AutoPilot Installer is a Fibre Channel HBA installation wizard for Windows. The AutoPilot
Installer installs (or updates) Emulex drivers and utilities and configures HBAs, drivers and utilities.

Prerequisites
• One of the following operating systems:
•Windows Server 2003 running on an x86, x64 or Itanium 64-bit platform.
•For the Emulex Storport Miniport driver, a Microsoft driver update may be required. See the Emulex Web site for the latest update to the Microsoft Storport driver.
•Windows 2000 Server - Service Pack 4 or later is recommended for all installations. Storport Miniport is not compatible with Windows 2000 Server.

Qualification: The Storport Miniport driver is WHQL qualified for the Microsoft "Designed for Windows" logo program and digitally signed for x86, Itanium and x64 Editions versions of Windows Server 2003 and Windows Server 2003 Datacenter Edition.
Note Windows Server 2003 SP1 or later, and the KB932755 update to the Microsoft Storport driver, are required.
SMI-S HBA Provider, compliant with the SMI-S 1.1.0 specification and certified against the SNIA-CTP v1.1.0.85 suite
Pre-packaged with OpenPegasus CIMOM v2.5.1, as a turnkey SMI-S agent for ease of installation and deployment
(7.18 MB exe file)

Qualification: The Storport Miniport driver is WHQL qualified for the Microsoft "Designed for Windows" logo program and digitally signed for x86, Itanium and x64 Editions versions of Windows Server 2003 and Windows Server 2003 Datacenter Edition.
Note Windows Server 2003 SP1 or later, and the KB932755 update to the Microsoft Storport driver, are required.
Base driver, HBAnyware utility 3.1a8 and lputilnt version 1.8a19 (24 MB exe file)

Qualification: The Storport Miniport driver is WHQL qualified for the Microsoft "Designed for Windows" logo program and digitally signed for x86, Itanium and x64 Editions versions of Windows Server 2003 and Windows Server 2003 Datacenter Edition.
Note Windows Server 2003 SP1 or SP2 and the KB932755 update to the Microsoft Storport driver are required. The KB932755 update must be applied before the Emulex Storport Miniport driver version 2.00 can be installed.
HBAnyware Utility Version 3.3

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