Emulex LPe11002-M4-F Download Drivers, Manual, Firmware and BIOS

Available 38 files for LPe11002-M4-F
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
EFI Boot
Operating Systems
Boot Code
Version Driver
3.11x1
Size Driver
122Kb
File Name
ze311x1_ebc.zip
Information
Support Resources for PRIMEQUEST Servers
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
\DE311X1.PRG Lp8000 EFIBoot version 3.11X1
\CE311X1.PRG Lp9000 EFIBoot version 3.11X1
\HE311X1.PRG Lp9802 EFIBoot version 3.11X1
\QE311X1.PRG Lp850 EFIBoot version 3.11X1
\RE311X1.PRG Lp952 EFIBoot version 3.11X1
\LE311X1.PRG Lp982 EFIBoot version 3.11X1
\TE311X1.PRG Lp10000 EFIBoot version 3.11X1
\ME311X1.PRG Lp1050 EFIBoot version 3.11X1
\EE311X1.PRG Lp101 EFIBoot version 3.11X1
\BE311X1.PRG Lp11000 EFIBoot version 3.11X1
\JE311X1.PRG Lp1150 EFIBoot version 3.11X1
\ZE311X1.PRG Lpe11000 EFIBoot version 3.11X1
\WE311X1.PRG Lpe1150 EFIBoot version 3.11X1
\YE311X1.PRG Lpe111 EFIBoot version 3.11X1
\ElxCli311X1.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.
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
x86 BootBIOS
Operating Systems
Boot Code
Version BIOS
2.02a2
Size BIOS
38Kb
File Name
zb202a2.zip
Information
Support Resources for PRIMERGY Servers
Platform: Intel (32-bit) The adapter boot BIOS provides x86 boot capability through the use of INT13
system BIOS calls. The adapter Boot BIOS supports:

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

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


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

(1) BIOS downloading

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

If the adapter boot BIOS is not enabled by LP6DUTIL or an Emulex O.S.
configuration utility, the adapter and the drives connected to the adapter
cannot not be configured to be used to boot the system. In addition if there is
a "No BIOS support" message displayed next to this adapter in the adapter BIOS
configuration utility the user must use LP6DUTIL or other Emulex O.S.
configuration utility to enable the adapter boot BIOS in order to allow this adapter
to be used a bootable controller by the host system.
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Firmware
Operating Systems
Firmware
Version Firmware
1.11a5
Size Firmware
294Kb
File Name
zf282a3.zip
Information
Support Resources for PRIMERGY Servers RELEASE NOTES FOR FIRMWARE VERSION 2.82A3

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

This document describes the known issues associated with this firmware build release. For the latest product documentation, go to www.emulex.com. If you have any questions or require additional information, contact an authorized Emulex Corporation technical representative.

New Feature in Firmware Version 2.82a3

Added Host Pointer SLIM (HPS) bit support.

Resolved Issues Firmware Version 2.82a3

1. Improved reset handling.
2. Improved internal retransmission of an FCP command during FC-Tape recovery.
3. Eliminated spurious firmware interrupts[JB4].
4. A word check now correctly verifies that the Abort Sequence frame (ABTS) is the first frame of exchange.
5. Adapters now handle IERR and link down reset automatically.
6. Enhanced handling of multiple split errors. The firmware had previously returned trap code 0x40000005 caused by multiple split errors from the host bus.
7. The N_Port_ID now is handled correctly in REG_VPI after a link down followed by a link up.
8. For LP11000, LP1150, LPe11000 and LPe1150 adapters, the correct VNPid is saved into the entry VPIO when the ELS_REQUEST64 cmd is used with CT= 0 and RPI = 0.
9. Resolved general NPIV issues.
10. The LPe1150 adapter now correctly saves the max_payload_size value across a warm system reboot (PCIE reset).
11. Corrected RSCN processing.
12. Correct link speed is negotiated when directly connected to a specific OEM array.
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Firmware Update Manual
Operating Systems
Firmware
Size Firmware
106Kb
File Name
fwupdate.pdf
Information
Support Resources for PRIMERGY Servers 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.
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Firmware
Operating Systems
Firmware
Version Firmware
2.70a5
Size Firmware
431Kb
File Name
zf270a5.zip
Information
Support Resources for PRIMEQUEST Servers Compatibility:

This kit supports the LPe11002 PCI host adapter.

This kit includes the following files:

README.TXT The file you are reading

ZF270A5.ALL All firmware components, no boot code

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

----- Changes between 2.70a5 and previous releases ----

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Improved DMA error handling of split errors where host memory has been
made unavailable. (CR 19348)
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Firmware Update Manual
Operating Systems
Firmware
Size Firmware
106Kb
File Name
fwupdate.pdf
Information
Support Resources for PRIMEQUEST Servers 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.
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Installation Manual
Operating Systems
Hardware Manuals
Size Manual
804Kb
File Name
lpe11002.pdf
Information
Support Resources for PRIMERGY Servers Introduction..................................................................................................................................................1
Major Features...............................................................................................................................1
Compatibility...................................................................................................................................2
Prerequisites...................................................................................................................................2
Setting the Jumpers.....................................................................................................................................2
Installing the Host Bus Adapter....................................................................................................................3
Attaching Media...........................................................................................................................................5
Applying Power............................................................................................................................................6
Viewing the LEDs...........................................................................................................................6
POST Conditions and Results.........................................................................................................6
References..................................................................................................................................................8
Specifications.................................................................................................................................8
FCC and Regulatory Notices...........................................................................................................9
Declaration of Conformity..............................................................................................................10
Laser Safety Notice.......................................................................................................................12

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

Major Features
• Multifunction PCIe device with two fully independent FC ports
• Auto-negotiation between 1-Gb, 2-Gb or 4-Gb link attachments
• High performance FC HBA with the PCIe to FC controller with two internal processors
• Full support for all FC topologies including point-to-point, arbitrated loop and fabric
• Full support for FC service class 2 and 3
• Maximum FC throughput achieved via full duplex hardware support
• End-to-end data path-parity and cyclical redundancy check (CRC) protection, including internal
data path random-access memory (RAM)
• Architectural support for multiple upper layer protocols
• State-of-the-art circuitry:
•All PCIe and FC functionality contained within a single, custom, high-density, fully integrated FC controller
•Internal ARM 1136J-S processors with instruction and data cache for each port
•Internal serializer deserializer (SerDes) 1-Gb/2-Gb/4-Gb cores for FC and 2.5-Gb cores for PCIe
• Complies with the PCIe base and CEM 1.0a specifications:
•x1 or x4 lane link interface (auto-negotiated with system) at 2.5-Gb/s
•Supports VC0 (1 Virtual Channel) and TC0 (1 Traffic Class)
•Configuration /IO/ Memory read/write, completion and message
•Supports 64-bit addressing
•ECRC for all transmitted PCIe data packets
•Link CRC on all PCIe packets and message
information
•Supports large payload size- 2048 bytes for read/write
•Supports large read request size- 4096 bytes
• Internal high-speed static RAM (SRAM)
• Error correcting code (ECC) protection of local memory, including single-bit correction and
double-bit protection
• The LPe11002 HBA provides two embedded short wave optical (LC) connections with link
diagnostics capability.
• Host interface via Emulex standard drivers or through custom drivers written to the Emulex
Service Level Interface (SLI-2) that is compatible with the many existing Emulex drivers for
products such as LP8000, LP9002L, LP9802, LP10000 HBAs
• Comprehensive array of operating system (OS) drivers:
•Emulex standard and OEM derivatives of device drivers for Windows 2000 Server, Windows Server 2003, Novell NetWare, Sun Solaris, Linux and HP-UX
•OEM-specific drivers for AIX and some other operating systems
•Some drivers support both SCSI and IP protocols
•Support for remote and fabric boot functionality
• On-board context management by the firmware (per port):
•Up to 510 FC port logins
•Up to 1023 concurrent exchanges
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Advanced Troubleshooting Manual
Operating Systems
Hardware Manuals
Size Manual
649Kb
File Name
troubleshooting.pdf
Information
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.
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Basic Troubleshooting Manual
Operating Systems
Hardware Manuals
Size Manual
157Kb
File Name
troubleshooting_basic.pdf
Information
Support Resources for PRIMERGY Servers Emulex Product Installation, Upgrades, and Configuration
Installing, upgrading and configuring Emulex products can be easily accomplished by following the checklists provided at the end of this document.
A word about Emulex configuration parameters:
Emulex drivers and software provide a great degree of configurability. In particular, each driver has a number of configuration parameters that allow the customization of the behavior of the driver. Because these parameters can significantly change the behavior of the Emulex product, great care must be taken in the setting of the parameters. Storage and system providers put forth great effort in determining what particular configuration parameters must be set to in order to provide optimal SAN performance.
For best results, never change the driver configuration parameters from their default values or the values that are specified by the storage and systems providers. Doing so can alter to performance of the SAN and possibly place the SAN in a configuration that is not supported or cause it not to operate properly.
How Emulex device driver configuration parameters work
It is very important to understand that Emulex configuration parameters are stored in the server in which the HBA is installed into. The parameters are acted upon by the device driver. Emulex configuration parameters are NOT stored in the HBA flash memory. Unlike some other SCSI and Fibre Channel HBAs, Emulex does not store any configuration information such as timers, Fibre Channel topology or link speed in the HBA flash. When an Emulex HBA is installed into a server, there is no separate configuration step required for the HBA. Proper driver configuration is all that is required. The exception is booting from SAN. In this case, the HBA BIOS utility must be used to configure the boot device. Said differently, the HBA must be told which Fibre Channel device contains the boot volume, and that information is stored in the flash. These settings are only in effect at boot time. Once the operating system loads the device driver, most settings of the driver are used and the HBA BIOS no longer functions.
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Installation
Operating Systems
Hardware Manuals
Size Manual
804Kb
File Name
lpe11002.pdf
Information
Support Resources for PRIMEQUEST Servers Introduction..................................................................................................................................................1
Major Features...............................................................................................................................1
Compatibility...................................................................................................................................2
Prerequisites...................................................................................................................................2
Setting the Jumpers.....................................................................................................................................2
Installing the Host Bus Adapter....................................................................................................................3
Attaching Media...........................................................................................................................................5
Applying Power............................................................................................................................................6
Viewing the LEDs...........................................................................................................................6
POST Conditions and Results.........................................................................................................6
References..................................................................................................................................................8
Specifications.................................................................................................................................8
FCC and Regulatory Notices...........................................................................................................9
Declaration of Conformity..............................................................................................................10
Laser Safety Notice.......................................................................................................................12

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

Major Features
• Multifunction PCIe device with two fully independent FC ports
• Auto-negotiation between 1-Gb, 2-Gb or 4-Gb link attachments
• High performance FC HBA with the PCIe to FC controller with two internal processors
• Full support for all FC topologies including point-to-point, arbitrated loop and fabric
• Full support for FC service class 2 and 3
• Maximum FC throughput achieved via full duplex hardware support
• End-to-end data path-parity and cyclical redundancy check (CRC) protection, including internal
data path random-access memory (RAM)
• Architectural support for multiple upper layer protocols
• State-of-the-art circuitry:
•All PCIe and FC functionality contained within a single, custom, high-density, fully integrated FC controller
•Internal ARM 1136J-S processors with instruction and data cache for each port
•Internal serializer deserializer (SerDes) 1-Gb/2-Gb/4-Gb cores for FC and 2.5-Gb cores for PCIe
• Complies with the PCIe base and CEM 1.0a specifications:
•x1 or x4 lane link interface (auto-negotiated with system) at 2.5-Gb/s
•Supports VC0 (1 Virtual Channel) and TC0 (1 Traffic Class)
•Configuration /IO/ Memory read/write, completion and message
•Supports 64-bit addressing
•ECRC for all transmitted PCIe data packets
•Link CRC on all PCIe packets and message
information
•Supports large payload size- 2048 bytes for read/write
•Supports large read request size- 4096 bytes
• Internal high-speed static RAM (SRAM)
• Error correcting code (ECC) protection of local memory, including single-bit correction and
double-bit protection
• The LPe11002 HBA provides two embedded short wave optical (LC) connections with link
diagnostics capability.
• Host interface via Emulex standard drivers or through custom drivers written to the Emulex
Service Level Interface (SLI-2) that is compatible with the many existing Emulex drivers for
products such as LP8000, LP9002L, LP9802, LP10000 HBAs
• Comprehensive array of operating system (OS) drivers:
•Emulex standard and OEM derivatives of device drivers for Windows 2000 Server, Windows Server 2003, Novell NetWare, Sun Solaris, Linux and HP-UX
•OEM-specific drivers for AIX and some other operating systems
•Some drivers support both SCSI and IP protocols
•Support for remote and fabric boot functionality
• On-board context management by the firmware (per port):
•Up to 510 FC port logins
•Up to 1023 concurrent exchanges
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Advanced Troubleshooting Manual
Operating Systems
Hardware Manuals
Size Manual
649Kb
File Name
troubleshooting.pdf
Information
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.
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Basic Troubleshooting Manual
Operating Systems
Hardware Manuals
Size Manual
157Kb
File Name
troubleshooting_basic.pdf
Information
Support Resources for PRIMEQUEST Servers Emulex Product Installation, Upgrades, and Configuration
Installing, upgrading and configuring Emulex products can be easily accomplished by following the checklists provided at the end of this document.
A word about Emulex configuration parameters:
Emulex drivers and software provide a great degree of configurability. In particular, each driver has a number of configuration parameters that allow the customization of the behavior of the driver. Because these parameters can significantly change the behavior of the Emulex product, great care must be taken in the setting of the parameters. Storage and system providers put forth great effort in determining what particular configuration parameters must be set to in order to provide optimal SAN performance.
For best results, never change the driver configuration parameters from their default values or the values that are specified by the storage and systems providers. Doing so can alter to performance of the SAN and possibly place the SAN in a configuration that is not supported or cause it not to operate properly.
How Emulex device driver configuration parameters work
It is very important to understand that Emulex configuration parameters are stored in the server in which the HBA is installed into. The parameters are acted upon by the device driver. Emulex configuration parameters are NOT stored in the HBA flash memory. Unlike some other SCSI and Fibre Channel HBAs, Emulex does not store any configuration information such as timers, Fibre Channel topology or link speed in the HBA flash. When an Emulex HBA is installed into a server, there is no separate configuration step required for the HBA. Proper driver configuration is all that is required. The exception is booting from SAN. In this case, the HBA BIOS utility must be used to configure the boot device. Said differently, the HBA must be told which Fibre Channel device contains the boot volume, and that information is stored in the flash. These settings are only in effect at boot time. Once the operating system loads the device driver, most settings of the driver are used and the HBA BIOS no longer functions.
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Applications Kit RHEL 4 U4
Operating Systems
Linux 2.6 Kernel
Version Driver
8.0.16.27-1
Size Driver
187.2Mb
File Name
elxlinuxapps-3.0a14-8.0.16.27-1-1.tar
Information
Support Resources for PRIMEQUEST Servers
RHEL4 U4 (2.6.9-42.EL)
AutoPilot Manager 2.0a3

HBAnyware 3.0a14 Linux Installation Instructions

This installation kit contains the following components:

HBAnyware version 3.0a14
SSC version 3.0a14
DFC Library version 80.163.7
Lputil version 2.0a13
HBAAPI version 2.1.c
DFC helper module

Dependencies:

lpfc driver version 8.0.16.27 or later

HBAnyware requires that the lpfc driver module be installed.

HBAnyware requires a minimum screen resolution of 1024 x 768.

HBAnyware requires the kernel development environment as described here:

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

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

1. Copy the applications kit tar file to a directory on the install machine
2. cd to the directory which you copied the tar file
3. Untar the file: tar -xvf tarfilename
4. cd (change directory) to the "ElxLinuxApps.." directory created by step 3
5. su to root
6. If earlier HBAnyware version currently installed, type : ./uninstall
7. Run the install script: ./install
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Applications Kit RHEL 4.5
Operating Systems
Linux 2.6 Kernel
Version Driver
8.0.16.27-1
Size Driver
187.2Mb
File Name
elxlinuxapps-3.0a14-8.0.16.27-1-3.tar
Information
Support Resources for PRIMEQUEST Servers
RHEL4 U4 (2.6.9-42.EL)
AutoPilot Manager 3.0a14 (72.6 MB tar file)
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Driver Kit
Operating Systems
Linux 2.6 Kernel
Version Driver
8.1.10.9-1
Size Driver
190Kb
File Name
lpfc_2.6_driver_kit-8.1.10.9-1.tar.gz
Information
Support Resources for PRIMEQUEST Servers
RHEL 5 GA (2.6.18-8.el5)
Base driver and install script (189 KB gz file)

1. System Requirements
1.1 Red Hat Enterprise Linux 'kernel-devel' Package Requirement
2. Description of Install Procedure
3. Known Issues
3.1 PCI Hot Plug Support for applications
3.1.1 Observed problem
3.1.2 Workaround

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

1. System Requirements

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

Red Hat Enterprise Linux 5

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

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

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

Once the RPM is installed, the lpfc-install script creates a new
ramdisk for the currently running kernel so that the 'lpfc' driver
is loaded when the kernel is initialized during system startup.
3. Known Issues

3.1 PCI Hot Plug Support for applications

3.1.1 Observed problem

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

3.1.2 Workaround

A user should stop all applications that are accessing LPFC's HBAAPI
interface (HBAnyware utilities or third party applications) before
performing PCI Hot Plug of an LPFC HBA.

Use the following command to stop the HBAnyware application:
#/usr/sbin/hbanyware/stop_hbanyware

After performing PCI Hot Plug of the HBA you can restart the applications.
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Applications Kit
Operating Systems
Linux 2.6 Kernel
Version Driver
8.1.10.9-1
Size Driver
207.1Mb
File Name
elxlinuxapps-3.2a14-8.1.10.9-1-6.tar
Information
Support Resources for PRIMEQUEST Servers
RHEL 5 GA (2.6.18-8.el5)
HBAnyware utility 3.2a14, lputil 2.0a14 (207 MB tar file)

HBAnyware 3.2a14 Linux Installation Instructions

This installation kit contains the following components:

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

Dependencies:

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

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

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

Select desired mode of operation for HBAnyware

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

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

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

10. Installation Complete: type /usr/sbin/hbanyware/hbanyware
to start GUI or type /usr/sbin/hbanyware/hbacmd list
to run script utility
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Manual
Operating Systems
Linux 2.6 Kernel
Version Manual
8.1.10.9-1
Size Manual
3.5Mb
File Name
manual.pdf
Information
Support Resources for PRIMEQUEST Servers
RHEL 5 GA (2.6.18-8.el5)
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
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Driver Kit
Operating Systems
Linux 2.6 Kernel
Version Driver
8.0.16.18-1
Size Driver
262Kb
File Name
lpfc_2.6_driver_kit-8.0.16.18-1.tar.gz
Information
Support Resources for PRIMEQUEST Servers
RHEL 4 U3 (2.6.9-34.EL)
Base driver, application helper module and install script

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

1. System Requirements

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

Red Hat Enterprise Linux 4 (Update 2 or higher)
SuSE Linux Enterprise Server 9 (SP1 or higher)

2. Description of Install Procedure

The lpfc-install script installs both the LPFC driver and the LPFC
DFC driver RPMs. These RPMs install their driver sources to the
/usr/src/lpfc directory, build their drivers for the currently
running kernel, and then install the drivers to the proper
directory for the currently running kernel.

Once the RPMs are installed, the lpfc-install script creates a new
ramdisk for the currently running kernel so that the 'lpfc' driver
is loaded when the kernel is initialized during system startup.
The 'elxlpfc' init script is also installed and configured to start
and stop the 'lpfcdfc' driver during system startup and shutdown.

3. Release Notes

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

For Red Hat Enterprise Linux installations, the kernel development
package with the same version as the currently running kernel must
be installed for the LPFC 8.0 driver build to succeed. For
example, a system with the 2.6.9-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.
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Application Helper Module Kit
Operating Systems
Linux 2.6 Kernel
Version Driver
8.0.16.18-1
Size Driver
201Kb
File Name
lpfc_2.6_ioctl_module_kit-2.0.9-2.tar.gz
Information
Support Resources for PRIMEQUEST Servers
RHEL 4 U3 (2.6.9-34.EL)
The Application Helper Module allows the Remote Management and Diagnostic utilities to communicate with the 8.0.16.18 driver.

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

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

1. System Requirements

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

Red Hat Enterprise Linux 4 Update 3

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

2. Installation Process

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

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

For usage information, please execute the command:

./ioctl-install --help

3. Release Notes

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

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

The name of the kernel development package depends upon the name of
the kernel for which the Application Helper Module will be
installed. For example, a system with the 2.6.9-11.EL kernel
would need the kernel-devel-2.6.9-11.EL package, and a system
with the 2.6.9-11.ELsmp kernel would need the
kernel-smp-devel-2.6.9-11.EL package.
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Applications Kit
Operating Systems
Linux 2.6 Kernel
Version Driver
8.0.16.18-1
Size Driver
165.6Mb
File Name
elxlinuxapps-2.1a29-8.0.16.18-1-1.tar
Information
Support Resources for PRIMEQUEST Servers
RHEL 4 U3 (2.6.9-34.EL)
HBAnyware utility 2.1a29, lputil 2.0a12 (170 MB tar file)

HBAnyware 2.1a29 Linux Installation Instructions

This installation kit contains the following components:

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

Dependencies:

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

HBAnyware requires a minimum screen resolution of 1024 x 768.

Installing HBAnyware

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

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

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

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

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

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

/usr/sbin/hbanyware/start_rmserver - This script will re-start the rmserver daemon.
Run this if you manually load the lpfc driver.
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Manual
Operating Systems
Linux 2.6 Kernel
Version Manual
8.0.16.18-1
Size Manual
2.3Mb
File Name
manual.pdf
Information
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
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Driver Kit
Operating Systems
Linux 2.6 Kernel
Version Driver
8.0.16.17-2-all
Size Driver
260Kb
File Name
lpfc_2.6_driver_kit-8.0.16.17-2.tar.gz
Information
Support Resources for PRIMEQUEST Servers
RHEL 4 u2 (2.6.9-22.EL)
Base driver, application helper module and install script
1. System Requirements
2. Description of Changes
3. Release Notes
3.1 Red Hat Enterprise Linux 'kernel-devel' Package Requirement
3.2 SuSE Linux Enterprise Server 'kernel-source' Package Requirement
3.3 Kernel Upgrade
3.4 Changing Target Timeout
3.4.1 Background
3.4.2 Observed Problem
3.4.3 Workaround
3.5 Machine Check Exception
3.5.1 Observed problem
3.5.2 Workaround
----------------------------------------------------------------------

1. System Requirements

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

Red Hat Enterprise Linux 4
SuSE Linux Enterprise Server 9

2. Description of Install Procedure

The lpfc-install script installs both the LPFC driver and the LPFC
DFC driver RPMs. These RPMs install their driver sources to the
/usr/src/lpfc directory, build their drivers for the currently
running kernel, and then install the drivers to the proper
directory for the currently running kernel.

Once the RPMs are installed, the lpfc-install script creates a new
ramdisk for the currently running kernel so that the 'lpfc' driver
is loaded when the kernel is initialized during system startup.
The 'elxlpfc' init script is also installed and configured to start
and stop the 'lpfcdfc' driver during system startup and shutdown.

3. Release Notes

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

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

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

For SuSE Linux Enterprise Server installations, the kernel-source
package with the same version as the currently running kernel must
be installed for the LPFC 8.0 driver build to succeed. For
example, a system with the 2.6.5-7.139-bigsmp kernel would need the
kernel-source-2.6.5-7.139 package.
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Applications Kit
Operating Systems
Linux 2.6 Kernel
Version Driver
8.0.16.17-2-all
Size Driver
165.4Mb
File Name
elxlinuxapps-2.1a25-8.0.16.17-1-1.tar
Information
Support Resources for PRIMEQUEST Servers
RHEL 4 u2 (2.6.9-22.EL)
HBAnyware utility 2.1a25, lputil 2.0a9 (169 MB tar file)

HBAnyware 2.1a25 Linux Installation Instructions

This installation kit contains the following components:

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

Dependencies:

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

HBAnyware requires a minimum screen resolution of 1024 x 768.

Installing HBAnyware

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

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

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

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

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

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

/usr/sbin/hbanyware/start_rmserver - This script will re-start the rmserver daemon.
Run this if you manually load the lpfc driver.
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Application helper module
Operating Systems
Linux 2.6 Kernel
Version Driver
8.0.16.17-2-all
Size Driver
202Kb
File Name
lpfc_2.6_ioctl_module_kit-2.0.9-2.tar.gz
Information
Support Resources for PRIMEQUEST Servers
RHEL 4 u2 (2.6.9-22.EL)
Use this file only with the RHEL 4 Update 2 or SLES9 SP3 distributions, which contain the 8.0.16.17 driver -- do not use with the driver kit above

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

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

1. System Requirements

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

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

2. Description of Changes

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

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

3. Release Notes

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

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

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

For SuSE Linux Enterprise Server installations, the kernel-source
package with the same version as the currently running kernel must
be installed for the Application Helper Module build to succeed.
For example, a system with the 2.6.5-7.166-bigsmp kernel would need
the kernel-source-2.6.5-7.166 package.
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
SMI-S Provider Kit RHEL 4
Operating Systems
Linux 2.6 Kernel
Version Driver
8.0.16.17-2-all
Size Driver
10.9Mb
File Name
elxsmiproviderrhel3_4-1.0.12-1.tar.gz
Information
Support Resources for PRIMEQUEST Servers
RHEL 4 u2 (2.6.9-22.EL)
SMI-S HBA Provider, compliant with the SMI-S 1.0.2 specification and certified against the SNIA-CTP v1.0.2.23 suite
Pre-packaged with OpenPegasus CIMOM v2.3.2, as a turnkey SMI-S agent for ease of installation and deployment

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

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

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

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

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

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

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

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

On Linux, the default user account is:
User Name: root
Password: pwd580
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
SMI-S Provider Kit SLES 9.0
Operating Systems
Linux 2.6 Kernel
Version Driver
8.0.16.17-2-all
Size Driver
11Mb
File Name
elxsmiprovidersles9-1.0.12-1.tar.gz
Information
Support Resources for PRIMEQUEST Servers
RHEL 4 u2 (2.6.9-22.EL)
SMI-S HBA Provider, compliant with the SMI-S 1.0.2 specification and certified against the SNIA-CTP v1.0.2.23 suite
Pre-packaged with OpenPegasus CIMOM v2.3.2, as a turnkey SMI-S agent for ease of installation and deployment

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

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

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

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

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

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

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

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

On Linux, the default user account is:
User Name: root
Password: pwd580
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Manual
Operating Systems
Linux 2.6 Kernel
Version Manual
8.0.16.17-2-all
Size Manual
2.3Mb
File Name
manual.pdf
Information
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
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Driver Kit
Operating Systems
Linux 2.6 Kernel
Version Driver
8.0.16.17-1-all
Size Driver
260Kb
File Name
lpfc_2.6_driver_kit-8.0.16.17-2.tar.gz
Information
Support Resources for PRIMEQUEST Servers
SLES9 SP3 (2.6.5-7.244)
Base driver, application helper module and install script
1. System Requirements
2. Description of Changes
3. Release Notes
3.1 Red Hat Enterprise Linux 'kernel-devel' Package Requirement
3.2 SuSE Linux Enterprise Server 'kernel-source' Package Requirement
3.3 Kernel Upgrade
3.4 Changing Target Timeout
3.4.1 Background
3.4.2 Observed Problem
3.4.3 Workaround
3.5 Machine Check Exception
3.5.1 Observed problem
3.5.2 Workaround
----------------------------------------------------------------------

1. System Requirements

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

Red Hat Enterprise Linux 4
SuSE Linux Enterprise Server 9

2. Description of Install Procedure

The lpfc-install script installs both the LPFC driver and the LPFC
DFC driver RPMs. These RPMs install their driver sources to the
/usr/src/lpfc directory, build their drivers for the currently
running kernel, and then install the drivers to the proper
directory for the currently running kernel.

Once the RPMs are installed, the lpfc-install script creates a new
ramdisk for the currently running kernel so that the 'lpfc' driver
is loaded when the kernel is initialized during system startup.
The 'elxlpfc' init script is also installed and configured to start
and stop the 'lpfcdfc' driver during system startup and shutdown.

3. Release Notes

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

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

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

For SuSE Linux Enterprise Server installations, the kernel-source
package with the same version as the currently running kernel must
be installed for the LPFC 8.0 driver build to succeed. For
example, a system with the 2.6.5-7.139-bigsmp kernel would need the
kernel-source-2.6.5-7.139 package.
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Applications Kit
Operating Systems
Linux 2.6 Kernel
Version Driver
8.0.16.17-1-all
Size Driver
165.4Mb
File Name
elxlinuxapps-2.1a25-8.0.16.17-1-1.tar
Information
Support Resources for PRIMEQUEST Servers
SLES9 SP3 (2.6.5-7.244)
HBAnyware utility 2.1a25, lputil 2.0a9 (169 MB tar file)

HBAnyware 2.1a25 Linux Installation Instructions

This installation kit contains the following components:

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

Dependencies:

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

HBAnyware requires a minimum screen resolution of 1024 x 768.

Installing HBAnyware

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

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

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

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

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

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

/usr/sbin/hbanyware/start_rmserver - This script will re-start the rmserver daemon.
Run this if you manually load the lpfc driver.
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Application helper module
Operating Systems
Linux 2.6 Kernel
Version Driver
8.0.16.17-1-all
Size Driver
203Kb
File Name
lpfc_2.6_ioctl_module_kit-2.0.9-1.tar.gz
Information
Support Resources for PRIMEQUEST Servers
SLES9 SP3 (2.6.5-7.244)
Use this file only with the RHEL 4 Update 2 or SLES9 SP3 distributions, which contain the 8.0.16.17 driver -- do not use with the driver kit above

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

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

1. System Requirements

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

Red Hat Enterprise Linux 4 Update 2

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

2. Installation Process

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

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

For usage information, please execute the command:

./ioctl-install --help

3. Release Notes

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

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

The name of the kernel development package depends upon the name of
the kernel for which the Application Helper Module will be
installed. For example, a system with the 2.6.9-11.EL kernel
would need the kernel-devel-2.6.9-11.EL package, and a system
with the 2.6.9-11.ELsmp kernel would need the
kernel-smp-devel-2.6.9-11.EL package.
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
SMI-S Provider Kit RHEL 4
Operating Systems
Linux 2.6 Kernel
Version Driver
8.0.16.17-1-all
Size Driver
10.9Mb
File Name
elxsmiproviderrhel3_4-1.0.12-1.tar.gz
Information
SUSE Linux Enterprise Server 8 Service Pack 3 (x86 and x64 and Intel Itanium2 architectures)
Red Hat Enterprise Linux 2.1 Updates 5 and 6 (x86 and Intel Itanium2 architectures)
Red Hat Enterprise Linux 3 Updates 2, 3, 4 and 5 (x86 and x64 and Intel Itanium2 architectures)
SMI-S HBA Provider, compliant with the SMI-S 1.0.2 specification and certified against the SNIA-CTP v1.0.2.23 suite
Pre-packaged with OpenPegasus CIMOM v2.3.2, as a turnkey SMI-S agent for ease of installation and deployment

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

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

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

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

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

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

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

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

On Linux, the default user account is:
User Name: root
Password: pwd580
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
SMI-S Provider Kit SLES 9.0
Operating Systems
Linux 2.6 Kernel
Version Driver
8.0.16.17-1-all
Size Driver
11Mb
File Name
elxsmiprovidersles9-1.0.12-1.tar.gz
Information
Support Resources for PRIMEQUEST Servers
RHEL 4 u2 (2.6.9-22.EL)
SMI-S HBA Provider, compliant with the SMI-S 1.0.2 specification and certified against the SNIA-CTP v1.0.2.23 suite
Pre-packaged with OpenPegasus CIMOM v2.3.2, as a turnkey SMI-S agent for ease of installation and deployment

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

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

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

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

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

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

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

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

On Linux, the default user account is:
User Name: root
Password: pwd580
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Manual
Operating Systems
Linux 2.6 Kernel
Version Manual
8.0.16.17-1-all
Size Manual
2.3Mb
File Name
manual.pdf
Information
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
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Applications Kit
Operating Systems
Linux 2.6 Kernel
Version Driver
8.1.6-1-3
Size Driver
159.3Mb
File Name
elxlinuxapps-3.0a15-8.1.6-2-1.tar
Information
8.1.6 SLES10 (Linux CD)
Emulex device driver v8.1.6 is included in the SUSE Linux Enterprise Server 10 distribution
HBAnyware utility 3.0a15, lputil 2.0a14, Application helper module 2.1.1 (163 MB tar file)

HBAnyware 3.0a15 Linux Installation Instructions

This installation kit contains the following components:

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

Dependencies:

lpfc driver version 8.1.6-2 or later

HBAnyware requires that the lpfc driver module be installed.

HBAnyware requires a minimum screen resolution of 1024 x 768.

HBAnyware requires the kernel development environment as described here:

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

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

1. Copy the applications kit tar file to a directory on the install machine
2. cd to the directory which you copied the tar file
3. Untar the file: tar -xvf tarfilename
4. cd (change directory) to the "ElxLinuxApps.." directory created by step 3
5. su to root
6. If earlier HBAnyware version currently installed, type : ./uninstall
7. Run the install script: ./install
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Driver Kit
Operating Systems
Windows 2003
Version Driver
8.1.6-1-3
Size Driver
24Mb
File Name
storportminiportkit_1-30a9-1b.exe
Information
Support Resources for PRIMEQUEST Servers
Qualification: The Storport Miniport driver is WHQL qualified for the Microsoft "Designed for Windows" logo program and digitally signed for 64Bit, Itanium and versions of Windows Server 2003 and Windows Server 2003 Datacenter Edition.
Note The KB916048 update to the Microsoft Storport driver is required.
Base driver, HBAnyware utility 3.1a8 and lputilnt version 1.8a19 (24 MB exe file
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
SMI-S Provider Kit
Operating Systems
Windows 2003
Version Driver
8.1.6-1-3
Size Driver
7.1Mb
File Name
elxsmiprovider1.1.6-2.exe
Information
Support Resources for PRIMEQUEST Servers
Qualification: The Storport Miniport driver is WHQL qualified for the Microsoft "Designed for Windows" logo program and digitally signed for 64Bit, Itanium and versions of Windows Server 2003 and Windows Server 2003 Datacenter Edition.
Note The KB916048 update to the Microsoft Storport driver is required.
SMI-S HBA Provider, compliant with the SMI-S 1.1.0 specification and certified against the SNIA-CTP v1.1.0.85 suite. Pre-packaged with OpenPegasus CIMOM v2.5.1, as a turnkey SMI-S agent for ease of installation and deployment. (7.18 MB exe file)
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Quick Installation Manual
Operating Systems
Windows 2003
Version Manual
8.1.6-1-3
Size Manual
243Kb
File Name
quick_installation_new.pdf
Information
Support Resources for PRIMEQUEST Servers
Qualification: The Storport Miniport driver is WHQL qualified for the Microsoft "Designed for Windows" logo program and digitally signed for 64Bit, Itanium and versions of Windows Server 2003 and Windows Server 2003 Datacenter Edition.
Note The KB916048 update to the Microsoft Storport driver is required.
Installing the driver using AutoPilot Installer (498 KB)

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

Updating the Driver Using AutoPilot Installer
If you are currently running an older driver version, use the hardware-first installation procedure to
update your driver. Begin at step 2 to update the driver.
You can also update the Emulex drivers following the manual installation method. See the complete
Installation section of the driver user manual for this procedure.
Distribution Executable File Overview
The distribution executable file is a self-extracting file that includes the following:
• AutoPilot Installer - installs driver and utilities.
• Driver - manages communication and data transfer between applications and I/O devices, using
HBAs as agents.
• HBAnyware utility - performs installation and configuration tasks on remote and local adapters.

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.

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 Vista running on an X86 or X64 platform.
Company
Emulex
Categories
Networks Cards
Model
Emulex LPe11002-M4-F
Description
Manual
Operating Systems
Windows 2003
Version Manual
8.1.6-1-3
Size Manual
4.6Mb
File Name
manual.pdf
Information
Qualification: The Storport Miniport driver is WHQL qualified for the Microsoft "Designed for Windows" logo program and digitally signed for x86, Itanium and x64 Editions versions of Windows Server 2003 and Windows Server 2003 Datacenter Edition.
Note Windows Server 2003 SP1 or later, and the KB932755 update to the Microsoft Storport driver, are required.
Installation, Configuration and Troubleshooting

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