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

Platform: Intel (32-bit) The adapter boot BIOS provides x86 boot capability through the use of INT13
system BIOS calls. The adapter Boot BIOS supports:

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

\DB201a2.PRG Lp8000 adapter boot BIOS version 2.01a2
\CB201a2.PRG Lp9000 adapter boot BIOS version 2.01a2
\HB201a2.PRG Lp9802 adapter boot BIOS version 2.01a2
\TB201a2.PRG Lp10000 adapter boot BIOS version 2.01a2
\BB201a2.PRG Lp11000 adapter boot BIOS version 2.01a2
\QB201a2.PRG Lp850 adapter boot BIOS version 2.01a2
\RB201a2.PRG Lp952 adapter boot BIOS version 2.01a2
\LB201a2.PRG Lp982 adapter boot BIOS version 2.01a2
\MB201a2.PRG Lp1050 adapter boot BIOS version 2.01a2
\JB201a2.PRG Lp1150 adapter boot BIOS version 2.01a2
\EB201a2.PRG Lp101 adapter boot BIOS version 2.01a2
\YB201a2.PRG LPe111 adapter boot BIOS version 2.01a2
\WB201a2.PRG LPe1150 adapter boot BIOS version 2.01a2
\ZB201a2.PRG LPe11000 adapter boot BIOS version 2.01a2
\UB201a2.PRG LPe12000 adapter boot BIOS version 2.01a2
\OB201a2.PRG LPe1250 adapter boot BIOS version 2.01a2
\PB201a2.PRG LPe121 adapter boot BIOS version 2.01a2


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

(1) BIOS downloading

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

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

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).
\readme.txt This file you are reading

\DO301a1.PRG Lp8000 Open Firmware 3.01a1
\CO301a1.PRG Lp9000 Open Firmware 3.01a1
\HO301a1.PRG Lp9802 Open Firmware 3.01a1
\MO301a1.PRG Lp1050 Open Firmware 3.01a1
\TO301a1.PRG Lp10000 Open Firmware 3.01a1
\BO301a1.PRG Lp11000 Open Firmware 3.01a1
\ZO301a1.PRG Lpe11000 Open Firmware 3.01a1
\UO301a1.PRG LPe12000 Open Firmware 3.01a1

--------------- 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 3.01a1 ------------------------

1. Some variable in the scsidisk file was create as local variable, and
cause system fail to boot with "Last Trap: Illegal Instruction" error
message. The new fixed by change some variables to external variable
instead of local variable. (CR27598)

----------------------- NEW CHANGES 3.01a0 ------------------------

1. Support 8Gb/s HBA.
----------------------- NEW CHANGES 3.00a2 ------------------------
1. Fixed the issue if the len size of the decode-unit on device path /fp
is large than 2 digits, the decode-unit is fails to convert text
unit-string, and cause system is not bootable, and boot command
disabled. (CR25215)

2. Fixed the issue on some systems the probe-scsi-all command fails
if the HBA has no link. (CR25036)

3. In PCI Configuration Register there is a bit to control the HBA
bus master capability (BME). In dual channel HBA when one of the
Bus Master Enable bit is cleared can cause other channel HBA DMA
to be stuck, and cause system hangs or failure during the boot
time. This release takes care this issue by set the BME bit on
forever. (CR24911)(CR25005)

4. If there is some unsolicited frame coming from the switch or service
provider, and the Boot code is not configure to response the FC-CT
Unsolicited, this can cause the system hangs during boot or scan targets.
In order not to sent any FC-CT request, the new release removed the
mailbox config_ring command. (CR25233)

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
\HE400A1.PRG Lp9802 EFIBoot version 4.00A1
\LE400A1.PRG Lp982 EFIBoot version 4.00A1
\TE400A1.PRG Lp10000 EFIBoot version 4.00A1
\ME400A1.PRG Lp1050 EFIBoot version 4.00A1
\EE400A1.PRG Lp101 EFIBoot version 4.00A1
\BE400A1.PRG Lp11000 EFIBoot version 4.00A1
\JE400A1.PRG Lp1150 EFIBoot version 4.00A1
\ZE400A1.PRG Lpe11000 EFIBoot version 4.00A1
\WE400A1.PRG Lpe1150 EFIBoot version 4.00A1
\YE400A1.PRG Lpe111 EFIBoot version 4.00A1
\UE400A1.PRG Lpe12000 EFIBoot version 4.00A1
\OE400A1.PRG Lpe1250 EFIBoot version 4.00A1
\ElxCli400A1.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.

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.

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

Platform: Intel (32-bit) The adapter boot BIOS provides x86 boot capability through the use of INT13
system BIOS calls. The adapter Boot BIOS supports:

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

\DB202a1.PRG Lp8000 adapter boot BIOS version 2.02a1
\CB202a1.PRG Lp9000 adapter boot BIOS version 2.02a1
\HB202a1.PRG Lp9802 adapter boot BIOS version 2.02a1
\TB202a1.PRG Lp10000 adapter boot BIOS version 2.02a1
\BB202a1.PRG Lp11000 adapter boot BIOS version 2.02a1
\QB202a1.PRG Lp850 adapter boot BIOS version 2.02a1
\RB202a1.PRG Lp952 adapter boot BIOS version 2.02a1
\LB202a1.PRG Lp982 adapter boot BIOS version 2.02a1
\MB202a1.PRG Lp1050 adapter boot BIOS version 2.02a1
\JB202a1.PRG Lp1150 adapter boot BIOS version 2.02a1
\EB202a1.PRG Lp101 adapter boot BIOS version 2.02a1
\YB202a1.PRG LPe111 adapter boot BIOS version 2.02a1
\AB202a1.PRG Lp21000 adapter boot BIOS version 2.02a1
\WB202a1.PRG LPe1150 adapter boot BIOS version 2.02a1
\ZB202a1.PRG LPe11000 adapter boot BIOS version 2.02a1
\UB202a1.PRG LPe12000 adapter boot BIOS version 2.02a1
\OB202a1.PRG LPe1250 adapter boot BIOS version 2.02a1
\PB202a1.PRG LPe121 adapter boot BIOS version 2.02a1


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

(1) BIOS downloading

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

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

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.

Compatibility:

This kit supports the LPe12000 and LPe12002 PCI Express host adapters.

This kit includes the following files:

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

-- Changes in version 1.10a5 --

Firmware now ensures that it returns BA_ACC response to ABTS.
(CR 83432)
-- Changes in version 1.10a4 --

HBA now resets properly after firmware downgrade.
(CR 82517)

Volatile WWNs are now properly presented in the Host Status Register.
(CR 82945, 83089)

Performance improvements on reads and writes.
(CR 82992, 83054)

Turn on hardware EOF check.
(CR 83119)
-- Changes in version 1.10a3 --

Identical method of sync detect is now used in both point-to-point
and loop modes. (CR 82351)

Corrected reporting of vpi_max and vpi_inuse when using DFC_VPGetResource
API command (currently only used by emlxadm utility). (CR 82450)

ELS REC request timeout default was increased to 12. (CR 82592)

Improved handling of READ_EVENT_LOG completion when mailbox is used for
response. (CR 82615)

Added custom features or configurations as per customer request.
(CR 82584)
-- Changes in version 1.10a2 --

Fixed link counter update. (CR 75619)

Corrected handling of queued buffers upon closed exchange. (CR 81939)

The restart after firmware download and system reset is now more robust.
(CR 81955)

The firmware now checks the direction of an exchange no matter what
state the board is in. (CR 81996)

An End Sequence will now stop the EDTOV timer to avoid an incorrect
sequence timeout if the next frame is delayed.
(CR 82177)

Fairness method adopted for FCP sequences so as not to starve other
generic sequence traffic using the same buffer pool. (CR 82330)

Fixed an uninitialized pointer in a recent SLI-3 fix which caused an
internal error attention in firmware. (CR 82344)

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.

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

Introduction
This manual describes the Emulex® LPe12000, LPe12002 and LPe12004, 8 gigabit per second (Gb/s)
Fibre Channel (FC) to Peripheral Component Interconnect Express (PCIe) host bus adapters (HBAs).
They feature a revolutionary design with integrated ARM-1156 cores, integrated SERDES, integrated
SRAM, and external Double-Data Rate (DDRII SRAM) memory structure. The LPe12000 is a singlechannel
adapter. The LPe12002 is a dual-channel adapter.The LPe12004 is a four-channel adapter.
The core technology of these HBAs is the ninth generation FC controller by Emulex. The controller
incorporates a multifunction native PCIe core that is compliant to the PCIe Base Specification 2.0 and
PCI Express CEM Specification 2.0. The HBAs support packet transfers up to 5 gigatransfers per
second (5.0 GT/s) on the PCIe link. The supported physical PCIe connector is x4 or x8. The fully
featured FC port is 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.

Note: Illustrations in this manual are only examples. The actual hardware may vary.

Major Features
• Multifunction PCIe 2.0 device with one (LPe12000), two (LPe12002) or four (LPe12004)
independent FC ports
• Auto-negotiation between 2-Gb/s, 4-Gb/s or 8-Gb/s FC link attachments
• Complies with the PCIe base and CEM 2.0 specifications:
• Built-in temperature sensor

Prerequisites
• PCIe 2.0 compliant systems: x4 or x8 lane transfer link interface
• 3.3 V and 12 V power from PCIe slot required for operation

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.

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.

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)
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 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)
Base driver and install script

1. System Requirements
1.1 Red Hat Enterprise Linux 'kernel-devel' Package Requirement
1.2 SuSE Linux Enterprise Server 'kernel-source' Package Requirement
2. Description of Install Procedure
3. Informational
3.1 Packaging Change Involving The Application Helper Module
3.1.1 Background
3.1.2 Observed Behavior
4. Known Issues
4.1 Uninstalling the Driver Kit on Boot-from-SAN Configurations
4.1.1 Observed problem
4.1.2 Resolution
4.2 Machine Check Exception
4.2.1 Observed problem
4.2.2 Workaround
4.3 Loading order of LPFC driver in initial ramdisk
4.3.1 Background
4.3.2 Observed Problem
4.3.3 Workaround
4.4 System panic while unloading the lpfc module
4.4.1 Background
4.4.2 Observed Problem
4.4.3 Resolution
4.5 PCI Hot Plug Support for applications
4.5.1 Observed problem
4.5.2 Workaround
4.6 Storage Array discovery issues in direct-attach configurations
4.6.1 Observed problem
4.6.2 Workaround

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

1. System Requirements

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

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

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

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

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

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

SUSE Linux Enterprise Server 9 Service Pack 2 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)
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

Support Resources for PRIMERGY Servers
RHEL5.2, SLES10 SP2
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 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.

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

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

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

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

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

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

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

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

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)

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
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.
Base driver, HBAnyware utility 3.0a9 and lputilnt 1.8a18 (18 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.
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.
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.
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

Storport Miniport Driver
Qualification: Microsoft currently does not offer an FCoE WHQL "Certified for Windows" logo program. When the Storport Miniport driver is used with a standard Fibre Channel HBA, the driver is qualified for the "Certified for Windows" logo program. When the Storport MiniPort driver is used with an FCoE CNA, the driver is considered "unclassified" by Microsoft. In both cases, the Storport Miniport drivers are digitally signed by Microsoft and will be recognized by both Windows Sever 2003 and Windows Server 2008.
Note For Windows Server 2003, SP2 and the KB932755 update to the Microsoft Storport driver are required. KB945119 is recommended. The Storport KB update must be applied before the Emulex Storport Miniport driver can be installed.
Base driver, HBAnyware utility 4.0a32 (11.6 MB exe file)

Storport Miniport Driver
Qualification: Microsoft currently does not offer an FCoE WHQL "Certified for Windows" logo program. When the Storport Miniport driver is used with a standard Fibre Channel HBA, the driver is qualified for the "Certified for Windows" logo program. When the Storport MiniPort driver is used with an FCoE CNA, the driver is considered "unclassified" by Microsoft. In both cases, the Storport Miniport drivers are digitally signed by Microsoft and will be recognized by both Windows Sever 2003 and Windows Server 2008.
Note For Windows Server 2003, SP2 and the KB932755 update to the Microsoft Storport driver are required. KB945119 is recommended. The Storport KB update must be applied before the Emulex Storport Miniport driver 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.

Storport Miniport Driver
Qualification: Microsoft currently does not offer an FCoE WHQL "Certified for Windows" logo program. When the Storport Miniport driver is used with a standard Fibre Channel HBA, the driver is qualified for the "Certified for Windows" logo program. When the Storport MiniPort driver is used with an FCoE CNA, the driver is considered "unclassified" by Microsoft. In both cases, the Storport Miniport drivers are digitally signed by Microsoft and will be recognized by both Windows Sever 2003 and Windows Server 2008.
Note For Windows Server 2003, SP2 and the KB932755 update to the Microsoft Storport driver are required. KB945119 is recommended. The Storport KB update must be applied before the Emulex Storport Miniport driver can be installed.
Storport Miniport Driver Version 2.10 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

Storport Miniport Driver
Qualification: Microsoft currently does not offer an FCoE WHQL "Certified for Windows" logo program. When the Storport Miniport driver is used with a standard Fibre Channel HBA, the driver is qualified for the "Certified for Windows" logo program. When the Storport MiniPort driver is used with an FCoE CNA, the driver is considered "unclassified" by Microsoft. In both cases, the Storport Miniport drivers are digitally signed by Microsoft and will be recognized by both Windows Sever 2003 and Windows Server 2008.
Note For Windows Server 2003, SP2 and the KB932755 update to the Microsoft Storport driver are required. KB945119 is recommended. The Storport KB update must be applied before the Emulex Storport Miniport driver can be installed.
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