Emulex LP9002S Download Drivers, Utilities, Manual and Firmware

Available 74 files for LP9002S
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Boot Code User Manual
Operating Systems
Boot Code
Size Manual
4.9Mb
File Name
bootcode.pdf
Information
Bus Type SBus
Max Bus Speed 25 MHz
Product Type HBA Introduction..............................................................................................................1
Emulex Boot Code Files....................................................................................1
Boot from SAN.........................................................................................................2
Windows Server 2008 and Windows Server 2003.............................................2
Configure Boot from SAN on Windows Server 2008 and Windows Server 2003 (x86 and x64)..........................................................2
Configure Boot from SAN on Windows Server 2008 and Windows Server 2003 (Itanium)..................................................................3
New Installation of Windows 2008 UEFI- Aware Operating System
on a UEFI-based x64 Server.................................................................3
Direct a UEFI-Based Server to a Windows Server 2008 OS Image (Installed as UEFI-Aware) Already Installed on the SAN.......................4
The GUID Partition Table......................................................................4
Install Windows Server 2008 on an FC Boot Disk (x86, x64 and Itanium)...5
Install Windows Server 2003 on an FC Boot Disk (x86, and x64
and Itanium)................................................................................................6
Linux and VMware.............................................................................................7
Configure Boot from SAN on Linux or VMware (x86 and x64).....................7
Configure Boot from SAN on Linux (PowerPC)...........................................7
Configure Boot from SAN on Linux (Itanium)..............................................7
Solaris...............................................................................................................8
Configure Boot from SAN on Solaris SFS (x86 and x64)............................8
Determine LUNs to Select for Boot from SAN.......................................8
Configure Boot from SAN on Solaris SFS (SPARC)....................................8
Configure Boot from SAN on Solaris LPFC (SPARC)..................................9
Install Solaris from a Network Image..................................................10
Install Solaris by Migrating an Image from a Local SCSI Disk.............11
Install, Update and Enable Boot Code...................................................................14
BIOS Utility............................................................................................................15
Start the BIOS Utility.................................................................................15
Enable an Adapter to Boot from SAN........................................................17
Configure Boot Devices...................................................................................17
Configure Adapter Parameters........................................................................21
Change the Default AL_PA (Arbitrated Loop Physical Address)................22
Change the PLOGI Retry Timer................................................................23
Change Topology......................................................................................24
Enable or Disable the Spinup Delay..........................................................25
Set Auto Scan...........................................................................................26
Enable or Disable EDD 3.0.......................................................................27
Enable or Disable the Start Unit Command...............................................28
Enable or Disable the Environment Variable.............................................29
Enable or Disable Auto Boot Sector..........................................................30
Change Link Speed...................................................................................31
Reset to Default Values.............................................................................32
Use Multi-Path Boot from SAN..................................................................33
OpenBoot..............................................................................................................34
Attribute Commands.................................................................................34
Functional Commands..............................................................................35
EFIBoot.................................................................................................................37
Install the EFI Utility..................................................................................37
Start the EFI Utility....................................................................................38
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Open Boot
Operating Systems
Boot Code
Version Driver
2.41a5 .tar
Size Driver
55Kb
File Name
tsc241a5.tar
Information
Bus Type SBus
Max Bus Speed 25 MHz
Product Type HBA
Platform: SPARC, PowerPC This version of Open Boot supports FC-AL: Private loop and Public
loop, and Fabric Point to Point. Also, it supports multi-initiators
and multi-LUNs (0 through 255).
\readme.txt This file you are reading
\TSC241A5.PRG Lp9002s S_Bus Open Boot 2.41A5
\TSF241A5.PRG Lp8000s S_Bus Open Boot 2.41A5

\TSC241A5.img Lp9002s S_Bus Open Boot 2.41A5 for image file
\TSF241A5.img Lp8000s S_Bus Open Boot 2.41A5 for image file


\TSC241A5.MSX Lp9002s S_Bus Open Boot 2.41A5 for Motorola-S3 format
\TSF241A5.MSX Lp8000s S_Bus Open Boot 2.41A5 for Motorola-S3 format

--------------- NOTES and CAUTIONS ---------------------
** Ensure that critical files on local boot disk are backed up
as a measure of protection.

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

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

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

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

(5) This version of OpenBoot can download the flash through lpsutil.


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

----------------------- NEW CHANGES 2.41A5 ------------------------

1. The device boot path for S_Bus on previous was not setup correctly,
and it cause "devalias" display incorrectly boot path. The new fixed
is reconfig the S_Bus boot path in "my-path".
----------------------- NEW CHANGES 2.41A4 ------------------------

1. The "ct-req" info. was erased by adding the "memory erase" function
before "ct-req" dma-free in previous release which cause the fcode
fail to see the target in fabric mode, the new fixed is removed the
"memory erase" function from "ct-req" before the dma-free.
(** For PCI_Bus_Only**)
----------------------- NEW CHANGES 2.41A3 ------------------------

1. In some system server, during the DR, there is a WARNING message
with memory leaked issue. The new release corrected this issue by
adding additional memory erase functions to set to 0 all the previously
obtained dma memory before the fcode released out the dma and virtual
address mappings by dma-map-out and dma-free.
(** For PCI_Bus_Only**)

2. In the universal boot code, during the boot time, there is an
warning message "Warning: Fcode sequence resulted in a net stack
depth change of 1", the new release fixed issue by remove some
unnecessarily call function in the fcode.
(** For PCI_Bus_Only**)
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Open Boot
Operating Systems
Boot Code
Version Driver
2.41a5 .zip
Size Driver
28Kb
File Name
tsc241a5.zip
Information
Bus Type SBus
Max Bus Speed 25 MHz
Product Type HBA
Platform: SPARC, PowerPC This version of Open Boot supports FC-AL: Private loop and Public
loop, and Fabric Point to Point. Also, it supports multi-initiators
and multi-LUNs (0 through 255).
\readme.txt This file you are reading
\TSC241A5.PRG Lp9002s S_Bus Open Boot 2.41A5
\TSF241A5.PRG Lp8000s S_Bus Open Boot 2.41A5

\TSC241A5.img Lp9002s S_Bus Open Boot 2.41A5 for image file
\TSF241A5.img Lp8000s S_Bus Open Boot 2.41A5 for image file


\TSC241A5.MSX Lp9002s S_Bus Open Boot 2.41A5 for Motorola-S3 format
\TSF241A5.MSX Lp8000s S_Bus Open Boot 2.41A5 for Motorola-S3 format

--------------- NOTES and CAUTIONS ---------------------
** Ensure that critical files on local boot disk are backed up
as a measure of protection.

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

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

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

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

(5) This version of OpenBoot can download the flash through lpsutil.


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

----------------------- NEW CHANGES 2.41A5 ------------------------

1. The device boot path for S_Bus on previous was not setup correctly,
and it cause "devalias" display incorrectly boot path. The new fixed
is reconfig the S_Bus boot path in "my-path".
----------------------- NEW CHANGES 2.41A4 ------------------------

1. The "ct-req" info. was erased by adding the "memory erase" function
before "ct-req" dma-free in previous release which cause the fcode
fail to see the target in fabric mode, the new fixed is removed the
"memory erase" function from "ct-req" before the dma-free.
(** For PCI_Bus_Only**)
----------------------- NEW CHANGES 2.41A3 ------------------------

1. In some system server, during the DR, there is a WARNING message
with memory leaked issue. The new release corrected this issue by
adding additional memory erase functions to set to 0 all the previously
obtained dma memory before the fcode released out the dma and virtual
address mappings by dma-map-out and dma-free.
(** For PCI_Bus_Only**)

2. In the universal boot code, during the boot time, there is an
warning message "Warning: Fcode sequence resulted in a net stack
depth change of 1", the new release fixed issue by remove some
unnecessarily call function in the fcode.
(** For PCI_Bus_Only**)
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Firmware Update Manual
Operating Systems
Firmware
Size Firmware
106Kb
File Name
fwupdate.pdf
Information
Bus Type SBus
Max Bus Speed 25 MHz
Product Type HBA Introduction.............................................................................................................. 1
Prerequisites ..................................................................................................... 1
Things to Know Before You Download ............................................................. 1
Update Utilities ........................................................................................................ 2

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

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

Things to Know Before You Download
• Before you download the OneConnect or LightPulse files, create a directory for them.
• As a measure of protection, ensure that critical files on your local boot disk are backed up.
• Firmware may be bundled with boot code. Boot code allows you to designate a device that is
attached to the adapter as a boot drive. If you select a firmware image that includes boot code,
the update procedure will load both the new firmware and the boot code at the same time. After
updating, refer to the Emulex Boot Manual for procedures on enabling the boot code on your
adapter.
• Emulex firmware files support both OneConnect and LightPulse adapters.
• For OneConnect adapters:
• Firmware and boot code are provided in a single flash image called a .UFI file.
• The UFI file contains all of the files that support all OneConnect adapters. The latest
files for your adapter are installed automatically when you use an Emulex utility to
update the firmware.
• The UFI file contains both firmware and boot code.
• For LightPulse adapters:
• Firmware is provided in a .ZIP file as a .ALL file or a .AWC file. You must manually unzip
the .ALL or .AWC file from the .ZIP file before you can use an Emulex utility to install it.
• Firmware differs between adapter models. Make sure you download the appropriate
firmware for your adapter.
• The .ZIP file may or may not include a boot code (.PRG) file.
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Firmware
Operating Systems
Firmware
Version Firmware
3.93a0 .tar
Size Firmware
454Kb
File Name
rf393a0s.tar
Information
Bus Type SBus
Max Bus Speed 25 MHz
Product Type HBA Compatibility:

This kit supports the LP9002S series of SBus host adapters.

This kit includes the following files:

README.TXT The file you are reading
RF393A0.AWC Firmware files with POST and loader
Changes and Corrections:

Corrected response in a RCV_SEQ_LIST64 IOCB. (CR 11220)

Ensure that there is at least one credit when doing REG LOGIN to
fabric port. (CR 12460, 12466, 14357)

Parity errors due to loop init received during speed negotiation
are now processed properly. (CR 13463, 14239, 14241)

Corrected a problem where the download of corrupted firmware would
return the proper error, but refuse any further commands.
(CR 13241, 14584)

Improved handling of the RESET_RING command to completely initialize
the ring and no longer return an unnecessary response.
(CR 13325, 13631, 13632, 13374, 14446, 14450, 14589)

Ensure that no frames waiting for resources are accidentally released
on to the link when killing exchanges.
(CR 12183, 13630, 14591, 14447)

Invalid exchange handling was improved by not issuing an error when
buffers are returned for use. (CR 13413, 14593)

Added code to correctly process and count error counter overflows.
(CR 13328, 13629, 14444, 14594)

Receiving a LIP while loop master and while waiting for LIHA will no
longer cause a timeout. (CR 13636, 13638, 14448, 14595)

Response to an unsolicited IP broadcast frame was corrected to comply
with FC spec. (CR 11019, 14596)

Corrected a dropped IWRITE command when using discontinuous buffer
descriptor entries (BDEs). (CR 10342, 10447, 14597)

Allow use of a different FLASH memory chip [AM29LV160DB].
(CR 14599, 13059, 12545)

An uninitialized value (usually zero) was being returned for the ED_TOV
value when a default value of 10 was actually being used by the
firmware. The reported value is now correctly intialized to 10.
(CR 14108, 14603)

Corrected the reason and explanation codes given to the tape drive
in an LS_RJT response to REC ELS. This allows a Solaris host to
retry the command. (CR 10121, 9489)

Development, desk checks and source code review found possible problems
that had no reported instances of failure.
(CR 14066, 14359, 13393, 14586, 14115, 14602, 11934, 14604, 11933,
14605, 11932, 14606, 11931, 14607, 14751)
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Firmware
Operating Systems
Firmware
Version Firmware
3.93a0 .zip
Size Firmware
187Kb
File Name
rf393a0s.zip
Information
Bus Type SBus
Max Bus Speed 25 MHz
Product Type HBA Compatibility:

This kit supports the LP9002S series of SBus host adapters.

This kit includes the following files:

README.TXT The file you are reading
RF393A0.AWC Firmware files with POST and loader
Changes and Corrections:

Corrected response in a RCV_SEQ_LIST64 IOCB. (CR 11220)

Ensure that there is at least one credit when doing REG LOGIN to
fabric port. (CR 12460, 12466, 14357)

Parity errors due to loop init received during speed negotiation
are now processed properly. (CR 13463, 14239, 14241)

Corrected a problem where the download of corrupted firmware would
return the proper error, but refuse any further commands.
(CR 13241, 14584)

Improved handling of the RESET_RING command to completely initialize
the ring and no longer return an unnecessary response.
(CR 13325, 13631, 13632, 13374, 14446, 14450, 14589)

Ensure that no frames waiting for resources are accidentally released
on to the link when killing exchanges.
(CR 12183, 13630, 14591, 14447)

Invalid exchange handling was improved by not issuing an error when
buffers are returned for use. (CR 13413, 14593)

Added code to correctly process and count error counter overflows.
(CR 13328, 13629, 14444, 14594)

Receiving a LIP while loop master and while waiting for LIHA will no
longer cause a timeout. (CR 13636, 13638, 14448, 14595)

Response to an unsolicited IP broadcast frame was corrected to comply
with FC spec. (CR 11019, 14596)

Corrected a dropped IWRITE command when using discontinuous buffer
descriptor entries (BDEs). (CR 10342, 10447, 14597)

Allow use of a different FLASH memory chip [AM29LV160DB].
(CR 14599, 13059, 12545)

An uninitialized value (usually zero) was being returned for the ED_TOV
value when a default value of 10 was actually being used by the
firmware. The reported value is now correctly intialized to 10.
(CR 14108, 14603)

Corrected the reason and explanation codes given to the tape drive
in an LS_RJT response to REC ELS. This allows a Solaris host to
retry the command. (CR 10121, 9489)

Development, desk checks and source code review found possible problems
that had no reported instances of failure.
(CR 14066, 14359, 13393, 14586, 14115, 14602, 11934, 14604, 11933,
14605, 11932, 14606, 11931, 14607, 14751)
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Troubleshooting Manual
Operating Systems
Manual
Size Manual
649Kb
File Name
troubleshooting.pdf
Information
Bus Type SBus
Max Bus Speed 25 MHz
Product Type HBA 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 LP9002S
Description
Installation Manual
Operating Systems
Manual
Size Manual
145Kb
File Name
install.pdf
Information
Bus Type SBus
Max Bus Speed 25 MHz
Product Type HBA Table of Contents
Installation
Compatability
Prerequisites
Install HBA
Attach Media
Apply Power
View LEDs
Reference
Specifications
FCC and Regulatory Notices
Declaration of
Conformity
Laser Safety

Prerequisites
· The host computer must provide 3.3VDC bus power
The open 32-bit or 64-bit (64-bit recommended) PCI bus slot can be
either 3.3 VDC or 5.0 VDC signaling interface
·
· PCI bus clock rate of 66 MHz is preferred
Multimode fiber optic cable (50/125 m m or 62.5/125 m m) with LC
connectors, used with short-wave lasers

Install the Host Bus Adapter Board
Record IEEE and serial numbers.
Each host bus adapter port is shipped with a unique address identifier
called the IEEE address. Since this adapter has two ports, there are two
IEEE addresses. The IEEE address is used when configuring your
system. The serial number is used when communicating with Emulex.
All numbers are clearly marked on the board. We recommend that you
record these numbers before installing the adapter.
Turn off and unplug the computer.
Remove the computer case.
Remove the blank panel from an empty 32 or 64-bit PCI bus slot.
Compare the removed panel to the bracket on the host bus adapter.
Follow steps 5-8 to change the bracket if they are different sizes.

Note The host bus adapter comes with a standard PCI
bracket installed. The low profile mounting bracket is
shorter than the standard bracket; approximately
3.11 in. (7.9cm) compared to 4.75 in. (12.06 cm)
long.

Remove the mounting bracket screws from the top of the host bus
adapter.
Remove the bracket and store it for future use.
Align the new mounting bracket tabs with the holes in the HBA.
Replace the screws that attach the HBA to the bracket.
Insert the host bus adapter into the empty 32 or 64-bit PCI bus slot.
Press firmly until it is seated.
Secure the host bus adapter's mounting bracket to the case with the panel
screw or clip.
Replace the computer case and tighten case screws.
The host bus adapter is now installed in the PC and is ready for media
attachment.
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Boot Code Documentation
Operating Systems
Solaris 10 SPARC
Version Driver
2.31h (SPARC)
Size Driver
4.9Mb
File Name
bootcode.pdf
Information
Note LP21000 and LP21002 adapters require a full-height PCIe slot, which is available in a limited number of Sun servers such as v445, M5000 (with I/O expander), Ultra 25 and Ultra 45.
Describes how to configure an HBA to boot from SAN Introduction..............................................................................................................1
Emulex Boot Code Files....................................................................................1
Boot from SAN.........................................................................................................2
Windows Server 2008 and Windows Server 2003.............................................2
Configure Boot from SAN on Windows Server 2008 and Windows Server 2003 (x86 and x64)..........................................................2
Configure Boot from SAN on Windows Server 2008 and Windows Server 2003 (Itanium)..................................................................3
New Installation of Windows 2008 UEFI- Aware Operating System
on a UEFI-based x64 Server.................................................................3
Direct a UEFI-Based Server to a Windows Server 2008 OS Image (Installed as UEFI-Aware) Already Installed on the SAN.......................4
The GUID Partition Table......................................................................4
Install Windows Server 2008 on an FC Boot Disk (x86, x64 and Itanium)...5
Install Windows Server 2003 on an FC Boot Disk (x86, and x64
and Itanium)................................................................................................6
Linux and VMware.............................................................................................7
Configure Boot from SAN on Linux or VMware (x86 and x64).....................7
Configure Boot from SAN on Linux (PowerPC)...........................................7
Configure Boot from SAN on Linux (Itanium)..............................................7
Solaris...............................................................................................................8
Configure Boot from SAN on Solaris SFS (x86 and x64)............................8
Determine LUNs to Select for Boot from SAN.......................................8
Configure Boot from SAN on Solaris SFS (SPARC)....................................8
Configure Boot from SAN on Solaris LPFC (SPARC)..................................9
Install Solaris from a Network Image..................................................10
Install Solaris by Migrating an Image from a Local SCSI Disk.............11
Install, Update and Enable Boot Code...................................................................14
BIOS Utility............................................................................................................15
Start the BIOS Utility.................................................................................15
Enable an Adapter to Boot from SAN........................................................17
Configure Boot Devices...................................................................................17
Configure Adapter Parameters........................................................................21
Change the Default AL_PA (Arbitrated Loop Physical Address)................22
Change the PLOGI Retry Timer................................................................23
Change Topology......................................................................................24
Enable or Disable the Spinup Delay..........................................................25
Set Auto Scan...........................................................................................26
Enable or Disable EDD 3.0.......................................................................27
Enable or Disable the Start Unit Command...............................................28
Enable or Disable the Environment Variable.............................................29
Enable or Disable Auto Boot Sector..........................................................30
Change Link Speed...................................................................................31
Reset to Default Values.............................................................................32
Use Multi-Path Boot from SAN..................................................................33
OpenBoot..............................................................................................................34
Attribute Commands.................................................................................34
Functional Commands..............................................................................35
EFIBoot.................................................................................................................37
Install the EFI Utility..................................................................................37
Start the EFI Utility....................................................................................38
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
FCA Utilities Manual
Operating Systems
Solaris 10 SPARC
Version Manual
2.31h (SPARC)
Size Manual
876Kb
File Name
sfs_utilities.pdf
Information
LP21000 and LP21002 adapters require a full-height PCIe slot, which is available in a limited number of Sun servers such as v445, M5000 (with I/O expander), Ultra 25 and Ultra 45.
Instructions for using the FCA utilities

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

This document provides the information needed to use the Emulex® emlxadm and elmxdrv utility
programs. For system administrators, this document includes information about the installation and
removal of these utilities.
At the very least, system administrators should be familiar with Solaris and the Sun StorEdge SAN
Foundation Software (SFS) and should have access to standard system documentation. Anyone
working with this product should have some familiarity with the nature and use of Fibre Channel.
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
HBAnyware User Manual
Operating Systems
Solaris 10 SPARC
Version Manual
2.31h (SPARC)
Size Manual
876Kb
File Name
sfs_utilities.pdf
Information
LP21000 and LP21002 adapters require a full-height PCIe slot, which is available in a limited number of Sun servers such as v445, M5000 (with I/O expander), Ultra 25 and Ultra 45.
HBAnyware Utility Version 4.0

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

This document provides the information needed to use the Emulex® emlxadm and elmxdrv utility
programs. For system administrators, this document includes information about the installation and
removal of these utilities.
At the very least, system administrators should be familiar with Solaris and the Sun StorEdge SAN
Foundation Software (SFS) and should have access to standard system documentation. Anyone
working with this product should have some familiarity with the nature and use of Fibre Channel.
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Driver Manual
Operating Systems
Solaris 10 SPARC
Version Manual
2.31h (SPARC)
Size Manual
1.5Mb
File Name
manual.pdf
Information
Note LP21000 and LP21002 adapters require a full-height PCIe slot, which is available in a limited number of Sun servers such as v445, M5000 (with I/O expander), Ultra 25 and Ultra 45.
Instructions for using the sample migration scripts, as well as instructions for migrating from the LPFC driver to the SFS driver

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 LP9002S
Description
Sample Migration Scripts
Operating Systems
Solaris 10 SPARC
Version Driver
2.31h (SPARC)
Size Driver
103Kb
File Name
leadville_migrate_1.0a6.tar
Information
SPARC Dynamic Reconfiguration is not supported on LPe12004, LPe11004, LP1000ExDC, LP9802DC and LP9002DC HBAs.
Note LP21000 and LP21002 adapters require a full-height PCIe slot, which is available in a limited number of Sun servers such as v445, M5000 (with I/O expander), Ultra 25 and Ultra 45.
These unsupported sample script files can help you migrate from the Solaris lpfc driver to the Solaris SFS driver. You can customize these scripts and run them to automate the migration process.

Solaris Instructions for Migration of Emulex Host Bus Adapters to Leadville Stack

Prerequisites:

1. Solaris packages SUNWemlx, lpfc, and HBAnyware must be installed on the machine.
2. all candidate migration candidate adapters must have fcode version 1.50a4 or later

Note:
Scripts unable to migrate machines with Emulex adapter as boot device for that machine.

Migration Steps:

1. run ./start_emlxs_migration.sh script
2. after script has finished successfully, reboot system as requested
3. run ./finish_emlxs_migration.sh script
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Utilities
Operating Systems
Solaris 10 SPARC
Version Utilities
2.31h (SPARC)
Size Utilities
21.8Mb
File Name
solaris-4.0a33-1.02k-1a.tar
Information
LP21000 and LP21002 adapters require a full-height PCIe slot, which is available in a limited number of Sun servers such as v445, M5000 (with I/O expander), Ultra 25 and Ultra 45.
HBAnyware version 4.0a33, emlxadm version 1.02k and emlxdrv version 1.00m for SPARC

Dependencies:

SUNWemlxs driver 2.31 or later (provided by Sun)
EMLXemlxu utility package 1.02k or later (included with the applications kit)

Java Runtime Environment

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

The HBAnyware, HBAnywareSSC and HbaCmd target OS version is Solaris 5.10.

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

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


HBAnyware is dependent on the SUNWemlxs driver package and the EMLXemlxu utilities package being installed.
Please ensure that these packages are installed before installing HBAnyware.
HBAnyware Installation Instructions
-----------------------------------
1. Run the pkgrm routine to remove any previous version of HBAnyware: pkgrm HBAnyware
2. Unzip the file: gunzip HBAnyware-4.0a33-i386.tar.gz
3. Untar the file: tar -xvf HBAnyware-4.0a33-i386.tar
4. Run the pkgadd utility: pkgadd -d .
5. When prompted by pkgadd, choose to install HBAnyware
6. When prompted by pkgadd, answer the HBAnyware installation option questions
Running the HBAnyware GUI
-------------------------
1. su to root
2. Run the script /opt/HBAnyware/hbanyware
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Boot Code Documentation
Operating Systems
Solaris 10 SPARC
Version Driver
2.31p (SPARC)
Size Driver
4.9Mb
File Name
bootcode.pdf
Information
Note SPARC Dynamic Reconfiguration is not supported on LPe12004, LPe11004, LP1000ExDC, LP9802DC and LP9002DC HBAs.
Note LP21000 and LP21002 adapters require a full-height PCIe slot, which is available in a limited number of Sun servers such as v445, M5000 (with I/O expander), Ultra 25 and Ultra 45.
Describes how to configure an HBA to boot from SAN Introduction..............................................................................................................1
Emulex Boot Code Files....................................................................................1
Boot from SAN.........................................................................................................2
Windows Server 2008 and Windows Server 2003.............................................2
Configure Boot from SAN on Windows Server 2008 and Windows Server 2003 (x86 and x64)..........................................................2
Configure Boot from SAN on Windows Server 2008 and Windows Server 2003 (Itanium)..................................................................3
New Installation of Windows 2008 UEFI- Aware Operating System
on a UEFI-based x64 Server.................................................................3
Direct a UEFI-Based Server to a Windows Server 2008 OS Image (Installed as UEFI-Aware) Already Installed on the SAN.......................4
The GUID Partition Table......................................................................4
Install Windows Server 2008 on an FC Boot Disk (x86, x64 and Itanium)...5
Install Windows Server 2003 on an FC Boot Disk (x86, and x64
and Itanium)................................................................................................6
Linux and VMware.............................................................................................7
Configure Boot from SAN on Linux or VMware (x86 and x64).....................7
Configure Boot from SAN on Linux (PowerPC)...........................................7
Configure Boot from SAN on Linux (Itanium)..............................................7
Solaris...............................................................................................................8
Configure Boot from SAN on Solaris SFS (x86 and x64)............................8
Determine LUNs to Select for Boot from SAN.......................................8
Configure Boot from SAN on Solaris SFS (SPARC)....................................8
Configure Boot from SAN on Solaris LPFC (SPARC)..................................9
Install Solaris from a Network Image..................................................10
Install Solaris by Migrating an Image from a Local SCSI Disk.............11
Install, Update and Enable Boot Code...................................................................14
BIOS Utility............................................................................................................15
Start the BIOS Utility.................................................................................15
Enable an Adapter to Boot from SAN........................................................17
Configure Boot Devices...................................................................................17
Configure Adapter Parameters........................................................................21
Change the Default AL_PA (Arbitrated Loop Physical Address)................22
Change the PLOGI Retry Timer................................................................23
Change Topology......................................................................................24
Enable or Disable the Spinup Delay..........................................................25
Set Auto Scan...........................................................................................26
Enable or Disable EDD 3.0.......................................................................27
Enable or Disable the Start Unit Command...............................................28
Enable or Disable the Environment Variable.............................................29
Enable or Disable Auto Boot Sector..........................................................30
Change Link Speed...................................................................................31
Reset to Default Values.............................................................................32
Use Multi-Path Boot from SAN..................................................................33
OpenBoot..............................................................................................................34
Attribute Commands.................................................................................34
Functional Commands..............................................................................35
EFIBoot.................................................................................................................37
Install the EFI Utility..................................................................................37
Start the EFI Utility....................................................................................38
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
FCA Utilities Manual
Operating Systems
Solaris 10 SPARC
Version Manual
2.31p (SPARC)
Size Manual
876Kb
File Name
sfs_utilities.pdf
Information
SPARC Dynamic Reconfiguration is not supported on LPe12004, LPe11004, LP1000ExDC, LP9802DC and LP9002DC HBAs.
Note LP21000 and LP21002 adapters require a full-height PCIe slot, which is available in a limited number of Sun servers such as v445, M5000 (with I/O expander), Ultra 25 and Ultra 45.
Instructions for using the FCA utilities

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

This document provides the information needed to use the Emulex® emlxadm and elmxdrv utility
programs. For system administrators, this document includes information about the installation and
removal of these utilities.
At the very least, system administrators should be familiar with Solaris and the Sun StorEdge SAN
Foundation Software (SFS) and should have access to standard system documentation. Anyone
working with this product should have some familiarity with the nature and use of Fibre Channel.
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
HBAnyware User Manual
Operating Systems
Solaris 10 SPARC
Version Manual
2.31p (SPARC)
Size Manual
5.3Mb
File Name
hbanyware.pdf
Information
SPARC Dynamic Reconfiguration is not supported on LPe12004, LPe11004, LP1000ExDC, LP9802DC and LP9002DC HBAs.
Note LP21000 and LP21002 adapters require a full-height PCIe slot, which is available in a limited number of Sun servers such as v445, M5000 (with I/O expander), Ultra 25 and Ultra 45.
HBAnyware Utility Version 4.0

Introduction.............................................................................................................. 1
Known Issues .................................................................................................... 1
Installing HBAnyware Components.......................................................................... 2
Installing the HBAnyware Utility......................................................................... 2
Installing the HBAnyware Utility with Web Launch............................................. 4
Installing the HBAnyware Utility Security Configurator ...................................... 5
Uninstalling the HBAnyware Security Configurator............................................ 6
Uninstalling HBAnyware Web Launch Only ....................................................... 7
Uninstalling the Utility Package ......................................................................... 7
Using the HBAnyware Components......................................................................... 8
Starting the HBAnyware Utility........................................................................... 8
Starting HBAnyware with Web Launch .............................................................. 8
Starting the HBAnyware Security Configurator .................................................. 8
Starting HBAnyware from the Command Line ................................................... 9
Examples of Modifications .................................................................... 9
The HBAnyware Utility Window Element Definitions ....................................... 10
The Menu Bar ........................................................................................... 11
The Toolbar ............................................................................................... 11
The Toolbar Buttons .................................................................................. 11
Sort Toolbar Buttons ........................................................................... 11
The Discovery-Tree................................................................................... 12
Discovery-Tree Icons .......................................................................... 12
Property Tabs............................................................................................ 13
Status Bar ................................................................................................. 13
Changing Management Mode ......................................................................... 13
Resetting HBAs ............................................................................................... 14
Discovering HBAs ........................................................................................... 14
Automatic Fibre Channel Discovery .......................................................... 14
Remote SAN Management Using TCP/IP Access Protocol....................... 15
Adding a Single Host .......................................................................... 15
Adding a Range of Hosts .................................................................... 16
Removing Hosts.................................................................................. 17
Configuring Discovery Settings ................................................................. 18
Sorting HBA Information.................................................................................. 19
Viewing Remote and Local HBAs.............................................................. 19
Viewing HBA Information................................................................................. 20
Viewing Discovery Information .................................................................. 20
Viewing Host Information .......................................................................... 21
The Host Information Tab.................................................................... 21
The Driver Parameters Tab................................................................. 22
Viewing General HBA Attributes ............................................................... 23
Viewing Detailed HBA Information ............................................................ 24
Viewing Fabric Information........................................................................ 26
Viewing Target Information........................................................................ 27
Viewing LUN Information........................................................................... 28
Masking and Unmasking LUNs (Windows, Solaris LPFC and
Solaris SFS)........................................................................................ 29
Viewing Port Statistics............................................................................... 31
Viewing Firmware Information ................................................................... 33
Viewing Target Mapping (Windows, Solaris LPFC and Solaris SFS)......... 34
Viewing Target Mapping (Linux) ................................................................ 35
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Driver Manual
Operating Systems
Solaris 10 SPARC
Version Manual
2.31p (SPARC)
Size Manual
1.3Mb
File Name
manual.pdf
Information
Note LP21000 and LP21002 adapters require a full-height PCIe slot, which is available in a limited number of Sun servers such as v445, M5000 (with I/O expander), Ultra 25 and Ultra 45.
Instructions for using the sample migration scripts, as well as instructions for migrating from the LPFC driver to the SFS driver

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 LP9002S
Description
Sample Migration Scripts
Operating Systems
Solaris 10 SPARC
Version Driver
2.31p (SPARC)
Size Driver
103Kb
File Name
leadville_migrate_1.0a6.tar
Information
SPARC Dynamic Reconfiguration is not supported on LPe12004, LPe11004, LP1000ExDC, LP9802DC and LP9002DC HBAs.
Note LP21000 and LP21002 adapters require a full-height PCIe slot, which is available in a limited number of Sun servers such as v445, M5000 (with I/O expander), Ultra 25 and Ultra 45.
These unsupported sample script files can help you migrate from the Solaris lpfc driver to the Solaris SFS driver. You can customize these scripts and run them to automate the migration process.

Solaris Instructions for Migration of Emulex Host Bus Adapters to Leadville Stack

Prerequisites:

1. Solaris packages SUNWemlx, lpfc, and HBAnyware must be installed on the machine.
2. all candidate migration candidate adapters must have fcode version 1.50a4 or later

Note:
Scripts unable to migrate machines with Emulex adapter as boot device for that machine.

Migration Steps:

1. run ./start_emlxs_migration.sh script
2. after script has finished successfully, reboot system as requested
3. run ./finish_emlxs_migration.sh script
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Utilities
Operating Systems
Solaris 10 SPARC
Version Utilities
2.31p (SPARC)
Size Utilities
21.8Mb
File Name
solaris-4.0a33-1.02k-1a.tar
Information
SPARC Dynamic Reconfiguration is not supported on LPe12004, LPe11004, LP1000ExDC, LP9802DC and LP9002DC HBAs.
Note LP21000 and LP21002 adapters require a full-height PCIe slot, which is available in a limited number of Sun servers such as v445, M5000 (with I/O expander), Ultra 25 and Ultra 45.
HBAnyware version 4.0a33, emlxadm version 1.02k and emlxdrv version 1.00m for SPARC

Dependencies:

SUNWemlxs driver 2.31 or later (provided by Sun)
EMLXemlxu utility package 1.02k or later (included with the applications kit)

Java Runtime Environment

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

The HBAnyware, HBAnywareSSC and HbaCmd target OS version is Solaris 5.10.

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

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


HBAnyware is dependent on the SUNWemlxs driver package and the EMLXemlxu utilities package being installed.
Please ensure that these packages are installed before installing HBAnyware.
HBAnyware Installation Instructions
-----------------------------------
1. Run the pkgrm routine to remove any previous version of HBAnyware: pkgrm HBAnyware
2. Unzip the file: gunzip HBAnyware-4.0a33-i386.tar.gz
3. Untar the file: tar -xvf HBAnyware-4.0a33-i386.tar
4. Run the pkgadd utility: pkgadd -d .
5. When prompted by pkgadd, choose to install HBAnyware
6. When prompted by pkgadd, answer the HBAnyware installation option questions
Running the HBAnyware GUI
-------------------------
1. su to root
2. Run the script /opt/HBAnyware/hbanyware
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Boot Code Documentation
Operating Systems
Solaris 10 SPARC
Version Driver
2.40s (SPARC)
Size Driver
4.9Mb
File Name
bootcode.pdf
Information
Note SPARC Dynamic Reconfiguration is not supported on LPe12004, LPe11004, LP1000ExDC, LP9802DC and LP9002DC HBAs.
Note LP21000 and LP21002 adapters require a full-height PCIe slot, which is available in a limited number of Sun servers such as v445, M5000 (with I/O expander), Ultra 25 and Ultra 45.
Describes how to configure an HBA to boot from SAN Introduction..............................................................................................................1
Emulex Boot Code Files....................................................................................1
Boot from SAN.........................................................................................................2
Windows Server 2008 and Windows Server 2003.............................................2
Configure Boot from SAN on Windows Server 2008 and Windows Server 2003 (x86 and x64)..........................................................2
Configure Boot from SAN on Windows Server 2008 and Windows Server 2003 (Itanium)..................................................................3
New Installation of Windows 2008 UEFI- Aware Operating System
on a UEFI-based x64 Server.................................................................3
Direct a UEFI-Based Server to a Windows Server 2008 OS Image (Installed as UEFI-Aware) Already Installed on the SAN.......................4
The GUID Partition Table......................................................................4
Install Windows Server 2008 on an FC Boot Disk (x86, x64 and Itanium)...5
Install Windows Server 2003 on an FC Boot Disk (x86, and x64
and Itanium)................................................................................................6
Linux and VMware.............................................................................................7
Configure Boot from SAN on Linux or VMware (x86 and x64).....................7
Configure Boot from SAN on Linux (PowerPC)...........................................7
Configure Boot from SAN on Linux (Itanium)..............................................7
Solaris...............................................................................................................8
Configure Boot from SAN on Solaris SFS (x86 and x64)............................8
Determine LUNs to Select for Boot from SAN.......................................8
Configure Boot from SAN on Solaris SFS (SPARC)....................................8
Configure Boot from SAN on Solaris LPFC (SPARC)..................................9
Install Solaris from a Network Image..................................................10
Install Solaris by Migrating an Image from a Local SCSI Disk.............11
Install, Update and Enable Boot Code...................................................................14
BIOS Utility............................................................................................................15
Start the BIOS Utility.................................................................................15
Enable an Adapter to Boot from SAN........................................................17
Configure Boot Devices...................................................................................17
Configure Adapter Parameters........................................................................21
Change the Default AL_PA (Arbitrated Loop Physical Address)................22
Change the PLOGI Retry Timer................................................................23
Change Topology......................................................................................24
Enable or Disable the Spinup Delay..........................................................25
Set Auto Scan...........................................................................................26
Enable or Disable EDD 3.0.......................................................................27
Enable or Disable the Start Unit Command...............................................28
Enable or Disable the Environment Variable.............................................29
Enable or Disable Auto Boot Sector..........................................................30
Change Link Speed...................................................................................31
Reset to Default Values.............................................................................32
Use Multi-Path Boot from SAN..................................................................33
OpenBoot..............................................................................................................34
Attribute Commands.................................................................................34
Functional Commands..............................................................................35
EFIBoot.................................................................................................................37
Install the EFI Utility..................................................................................37
Start the EFI Utility....................................................................................38
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
FCA Utilities Manual
Operating Systems
Solaris 10 SPARC
Version Manual
2.40s (SPARC)
Size Manual
808Kb
File Name
sfs_utilities.pdf
Information
SPARC Dynamic Reconfiguration is not supported on LPe12004, LPe11004, LP1000ExDC, LP9802DC and LP9002DC HBAs.
Note LP21000 and LP21002 adapters require a full-height PCIe slot, which is available in a limited number of Sun servers such as v445, M5000 (with I/O expander), Ultra 25 and Ultra 45.
Instructions for using the FCA utilities

Introduction.............................................................................................................. 1
Fibre Channel Overview .................................................................................... 1
The Solaris Fibre Channel Stack ....................................................................... 1
Installing the Utilities................................................................................................ 3
Compatibility...................................................................................................... 3
Installing or Updating the Utilities Using the emlxu_install Script....................... 4
Removing the Utilities Using the emlxu_remove Script ..................................... 5
Installing the Utilities Package Manually............................................................ 6
Removing the Utilities Package Manually.......................................................... 7
Updating the Utilities Package Manually ........................................................... 7
Using the emlxadm Utility ........................................................................................ 8
Modes of Operation (emlxadm) ......................................................................... 8
Interactive Mode (emlxadm)........................................................................ 8
CLI Mode (emlxadm)................................................................................... 9
Command Descriptions (emlxadm) ................................................................. 11
Command Usage ...................................................................................... 14
Using the emlxdrv Utility ........................................................................................ 30
Modes of Operation (emlxdrv) ......................................................................... 30
Interactive Mode (emlxdrv)........................................................................ 30
CLI Mode (emlxdrv)................................................................................... 32
Command Descriptions (emlxdrv) ................................................................... 33
Command Usage ...................................................................................... 33
This document provides the information needed to use the Emulex® emlxadm and elmxdrv utility
programs. For system administrators, this document includes information about the installation and
removal of these utilities.
At the very least, system administrators should be familiar with Solaris and the Sun StorEdge SAN
Foundation Software (SFS) and should have access to standard system documentation. Anyone
working with this product should have some familiarity with the nature and use of Fibre Channel.
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
HBAnyware User Manual
Operating Systems
Solaris 10 SPARC
Version Manual
2.40s (SPARC)
Size Manual
4.6Mb
File Name
hbanyware.pdf
Information
SPARC Dynamic Reconfiguration is not supported on LPe12004, LPe11004, LP1000ExDC, LP9802DC and LP9002DC HBAs.
Note LP21000 and LP21002 adapters require a full-height PCIe slot, which is available in a limited number of Sun servers such as v445, M5000 (with I/O expander), Ultra 25 and Ultra 45.
HBAnyware Utility Version 4.1

Introduction.............................................................................................................. 1
Known Issues .................................................................................................... 1
Installing HBAnyware Components.......................................................................... 2
Installing the HBAnyware Utility......................................................................... 2
Installing the HBAnyware Utility with Web Launch............................................. 4
Installing the HBAnyware Utility Security Configurator ...................................... 5
Uninstalling the HBAnyware Security Configurator............................................ 6
Uninstalling HBAnyware Web Launch Only ....................................................... 7
Uninstalling the Utility Package ......................................................................... 7
Using the HBAnyware Components......................................................................... 8
Starting the HBAnyware Utility........................................................................... 8
Starting HBAnyware with Web Launch .............................................................. 8
Starting the HBAnyware Security Configurator .................................................. 8
Starting HBAnyware from the Command Line ................................................... 9
Examples of Modifications .................................................................... 9
The HBAnyware Utility Window Element Definitions ....................................... 10
The Menu Bar ........................................................................................... 11
The Toolbar ............................................................................................... 11
The Toolbar Buttons .................................................................................. 11
Sort Toolbar Buttons ........................................................................... 11
The Discovery-Tree................................................................................... 12
Discovery-Tree Icons .......................................................................... 12
Property Tabs............................................................................................ 13
Status Bar ................................................................................................. 13
Changing Management Mode ......................................................................... 13
Resetting HBAs ............................................................................................... 14
Discovering HBAs ........................................................................................... 14
Automatic Fibre Channel Discovery .......................................................... 14
Remote SAN Management Using TCP/IP Access Protocol....................... 15
Adding a Single Host .......................................................................... 15
Adding a Range of Hosts .................................................................... 16
Removing Hosts.................................................................................. 17
Configuring Discovery Settings ................................................................. 18
Sorting HBA Information.................................................................................. 19
Viewing Remote and Local HBAs.............................................................. 19
Viewing HBA Information................................................................................. 20
Viewing Discovery Information .................................................................. 20
Viewing Host Information .......................................................................... 21
The Host Information Tab.................................................................... 21
The Driver Parameters Tab................................................................. 22
Viewing General HBA Attributes ............................................................... 23
Viewing Detailed HBA Information ............................................................ 24
Viewing Fabric Information........................................................................ 26
Viewing Target Information........................................................................ 27
Viewing LUN Information........................................................................... 28
Masking and Unmasking LUNs (Windows, Solaris LPFC and
Solaris SFS)........................................................................................ 29
Viewing Port Statistics............................................................................... 31
Viewing Firmware Information ................................................................... 33
Viewing Target Mapping (Windows, Solaris LPFC and Solaris SFS)......... 34
Viewing Target Mapping (Linux) ................................................................ 35
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Driver Manual
Operating Systems
Solaris 10 SPARC
Version Manual
2.40s (SPARC)
Size Manual
1.3Mb
File Name
solarissfs.pdf
Information
SPARC Dynamic Reconfiguration is not supported on LPe12004, LPe11004, LP1000ExDC, LP9802DC and LP9002DC HBAs.
Note LP21000 and LP21002 adapters require a full-height PCIe slot, which is available in a limited number of Sun servers such as v445, M5000 (with I/O expander), Ultra 25 and Ultra 45.
Instructions for using the sample migration scripts, as well as instructions for migrating from the LPFC driver to the SFS driver

Introduction................................................................................................................... 1
Fibre Channel Overview .................................................................................... 1
The Solaris Fibre Channel Stack ....................................................................... 1
Compatibility...................................................................................................... 3
New Features in this Release............................................................................ 3
Known Issues .................................................................................................... 3
Installing the Solaris SFS FCA (emlxs) Driver ......................................................... 4
Downloading and Installing the Driver for Solaris 10 and OpenSolaris
(SPARC, x64 and x86) ...................................................................................... 4
Utilities..................................................................................................................... 4
The HBAnyware Utility ................................................................................ 4
The emlxadm Utility..................................................................................... 5
The emlxdrv Utility ...................................................................................... 5
Installing the FCA Utilities and the HBAnyware Utility ....................................... 5
Installing or Updating the FCA Utilities Using the emlxu_install Script ........ 6
Installing the HBAnyware Utility, Web Launch and Security Configurator.... 7
Installing the HBAnyware Utility .................................................................. 7
Installing the HBAnyware Utility with Web Launch ...................................... 8
Installing the HBAnyware Utility Security Configurator ................................ 9
Installing or Updating the Utilities Package Manually .................................. 9
Removing the Utilities Using the emlxu_remove Script ............................. 10
Removing the Utilities Package Manually ................................................. 11
Configuration and Migration......................................................................................... 12
Introduction............................................................................................................ 12
Changing Driver Properties Using the emlxs.conf File........................................... 12
Enabling NPIV Support on Solaris 10.............................................................. 12
Enabling NPIV Support on OpenSolaris .......................................................... 13
NPIV Configuration Limits ......................................................................... 13
NPIV and OS Virtualization ....................................................................... 13
Using VPorts with Logical Domains, Containers and xVM......................... 14
DHCHAP Authentication and Configuration ........................................................... 14
DHCHAP Authentication Driver Properties ...................................................... 15
Configuring Target Mode Support for OpenSolaris ................................................ 15
Emulex SFS FCA Driver Properties ....................................................................... 15
The Configuration File (emlxs.conf) .......................................................... 15
Migrating from the Solaris LPFC Driver to the Solaris emlxs Driver....................... 22
Operational Behaviors of the emlxs Driver ...................................................... 22
Use Cases....................................................................................................... 22
Sample Script File Details ............................................................................... 23
start_emlxs_migration.sh ......................................................................... 23
finish_emlxs_migration.sh......................................................................... 24
Migrating a Configuration without FC Boot ...................................................... 24
Migrating Automatically ............................................................................. 24
Prerequisites ............................................................................................. 24
Procedures................................................................................................ 25
Migrating a Configuration with FC Boot ........................................................... 27
Prerequisite............................................................................................... 27
Procedure ................................................................................................. 27
Solaris emlxs and Solaris LPFC Driver Properties Cross-Reference Table ..... 30
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Release Notes for HBAnyware
Operating Systems
Solaris 10 SPARC
Version Driver
2.40s (SPARC)
Size Driver
70Kb
File Name
solaris_release_notes.pdf
Information
SPARC Dynamic Reconfiguration is not supported on LPe12004, LPe11004, LP1000ExDC, LP9802DC and LP9002DC HBAs.
Note LP21000 and LP21002 adapters require a full-height PCIe slot, which is available in a limited number of Sun servers such as v445, M5000 (with I/O expander), Ultra 25 and Ultra 45.
New features, fixed issues and known issues in the HBAnyware utility

Release Notes
Date: October 2009
Product: HBAnyware® Utility and the SFS FCA Driver (Solaris Leadville Driver)
Version: 4.1
This document describes the new features, resolved issues and known issues associated with this utility 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 Technical Support representative.
New Features in HBAnyware Utility Version 4.1
1. Designed for adapter FCoE Initialization Protocol (FIP), subject to subsequent industry testing.
2. Virtual port and virtual machine mapping information is displayed.
New Resolved Issues in HBAnyware Utility Version 4.1
1. The HBAnyware utility no longer crashes or aborts when attempting to view a large LUN
configuration.
2. LUNs greater than 127 are now counted correctly. Previously, LUNs up to 255 could be
configured, but only LUNS 129 – 240 were displayed.
Known Issues in HBAnyware Utility Version 4.1
1. On LPe12000 adapters, volatile WWN changes may not be supported.
Workaround: Update firmware; see the Emulex Web site for more information.
Caution: Verify the version of OEM firmware to use based on OEM qualifications and support.
2. On LP21000 and LP21002 adapters, FIP mode may need to be disabled to bring a link up.
If you have upgraded to the new CEE firmware that supports FIP and connect the port to a switch with
firmware that does not support FIP, the port’s link will be down. If you plug a loopback plug into an
adapter port with FIP disabled, the link will be down.
Workaround: Disable FIP mode on the adapter port.
3. Not all adapters may appear in the discovery-tree.
Although the HBAnyware utility provides support for LightPulse adapters that are reprogrammed with
WWPNs outside the typical Emulex range, not all adapters appear in the discovery-tree.
Workaround: The HBAnyware utility must be deployed across all servers on the SAN, as well as any
other management console used for out-of-band management, so that all adapters appear in the
discovery-tree.
4. Multiport adapter models are represented in the HBAnyware utility discovery-tree as
multiple adapters with a single port icon.
For older mulitport HBA models, the HBAnyware utility displays each port under individual adapter icons
in the discovery-tree. Newer multiport HBA models (LP9802 or later) are represented by a single adapter
icon that branches out to multiple port icons.
Workaround: There is no workaround at this time.
5. NPIV setting is volatile if enabled through the Host Driver Parameters tab
If you enable the NPIV Driver Parameter through the Host Driver Parameters tab for a host with LP21000
or LP21002 adapters, this parameter will not be enabled after a reboot.
Workaround: Enable NPIV through the port driver parameters tab for each of the HBA ports. To enable
the NPIV parameter for LP21000 & LP21002 adapters:
1. From the discovery-tree, select a port.
2. Select the Driver Parameters tab.
3. Highlight enable-npiv.
4. Select Enabled.
5. Click Reset HBA Port to reset the HBA.
6. When prompted, click Yes to continue.
6. The Virtual Ports tab may report erroneous NPIV Information.
When the enable-NPIV driver parameter is disabled, the Virtual Ports tab may erroneously report, “The
fabric switch does not support virtual ports” whether the switch supports NPIV or not.
Workaround: To accurately determine if the switch supports NPIV, either:
Enable the enable-NPIV driver parameter using the HBAnyware utility. To enable the enable-NPIV
parameter:
1. Select your host from the discovery tree.
2. Select the Host Driver Parameters tab.
3. Highlight enable-npiv.
4. Select Enabled.
5. From the discovery-tree, select a port that is connected to the switch.
6. Click Reset HBA Port to reset the HBA.
7. When prompted, click Yes to continue.
When the enable-npiv or EnableNPIV parameter is enabled, the message, “The fabric switch does not
support virtual ports” appears only if the switch actually does not support NPIV.
Or
Refer to your switch documentation or manufacturer to determine if the switch supports NPIV.
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Release Notes for the Driver and FCA Utilities
Operating Systems
Solaris 10 SPARC
Version Driver
2.40s (SPARC)
Size Driver
32Kb
File Name
driver_release_notes.pdf
Information
Note SPARC Dynamic Reconfiguration is not supported on LPe12004, LPe11004, LP1000ExDC, LP9802DC and LP9002DC HBAs.
Note LP21000 and LP21002 adapters require a full-height PCIe slot, which is available in a limited number of Sun servers such as v445, M5000 (with I/O expander), Ultra 25 and Ultra 45.
New features, fixed issues and known issues in the driver and FCA utilities

Release Notes
Date: March 2009 Product: Driver for Linux Version: 8.2.8.14 This document describes the new features, resolved known issues and current known issues associated with this driver build release. For the latest product documentation, go to www.Emulex.com. If you have any questions or require additional information, contact an authorized Emulex Corporation technical support representative.
New Features Driver for Linux 8.2.8.14
1. Supports the LP21000 and LP21002 FCoE adapters. (10 Gb/s capable) 2. Supports the LPe1250, LPe1252, LPe12000 and LPe12002 adapters. (2, 4 and 8 Gb/s capable) 3. Supports the latest HBAnyware utility version 4.1 as part of the master kit. Refer to the HBAnyware Utility User Manual for more information. 4. Supports SuSE Linux Enterprise Server 11. (Intel x86, Intel Itanium2, Intel EM64T, AMD64, and PowerPC 64-bit architectures) 5. Adds interfaces via the sysfs file system to update speed and topology parameters without requiring link bounce. 6. Supports Power Management Suspend/Resume operations. 7.
Resolved Issues in Driver for Linux 8.2.8.14
Supports MSI-X interrupt handling.
Known Issues in Driver for Linux 8.2.8.14
There are no resolved issues in this driver version.
1. PCI Hot Plug may cause applications to malfunction Performing a PCI Hot Plug may cause the HBAnyware utilities or third party applications that use the Emulex libraries (i.e. HBAAPI) to behave unpredictably or malfunction. Workaround: 1. Stop all applications that are accessing LPFC's HBAAPI interface (HBAnyware utilities or third party applications) before performing PCI Hot Plug of an LPFC HBA. Use the following command to stop the HBAnyware application: #/usr/sbin/hbanyware/stop_hbanyware 2. Perform the PCI Hot Plug of the HBA. 3. Restart the application.
2. Deleting virtual ports or performing a PCI Hot Unplug may result in SCSI errors When you delete a virtual port via the sysfs interface or perform a PCI Hot Unplug of an Emulex HBA, the kernel may report one of the following errors: kernel: Synchronizing SCSI cache for disk kernel: FAILED or SCSI error: return code = 0x00010000. Workaround: These messages do not indicate a functional failure and can be ignored. 3. LILO is not Supported The LILO Boot Loader on i386 and x86_64 architectures is not supported for this driver stream. If the LILO boot loader is used, after the LPFC driver package is installed and upon reboot, an incorrect initial ramdisk is used. The system may not boot correctly. Workaround: Use the GRUB boot loader. This is the default boot loader for most of the Linux distributions. 4. Issue with the LPFC module order in the INITRD_MODULES list. On the SLES10 SP1 system, if another SCSI driver such as aic79xx, is loaded right after the LPFC driver through the initrd image, an interruption might occur in the SCSI mid-layer discovery process on the LUNs connected to LPFC’s Fibre Channel. This interruption can prevent the release of the SCSI discovery reference count and the LPFC driver cannot unload. Workaround: Do not add SCSI drivers right after the LPFC module in the INITRD_MODULES list. 5. The LPFC driver may not finish discovery when two initiator ports are swapped. This causes all devices accessible through one or both of these initiator ports to time out and all I/O to fail. Workaround: Do one of the following:
• When swapping cables replace each cable, one at a time, and allow for discovery to complete before replacing the next cable. To determine if discovery is complete read the "state" sysfs parameter.
• When swapping cables, allow devloss timeout to fire before replacing the cables. (This fails all outstanding I/O.)
6. Deleted virtual ports may appear to be mounted, but are inaccessible. While Emulex provides management utilities to enable you to delete virtual ports, the LPFC driver cannot detect whether devices accessed through a virtual port are in use. You can delete a virtual port even when devices accessible through the virtual port are mounted or when I/O is outstanding to the device. If file systems are mounted on a virtual port and that virtual port is deleted, the file systems still appear to be mounted but are not be accessible. Workaround: Before deleting virtual ports, prepare the system affected by unmounting all the devices accessible through the virtual ports, and verifying that there is no outstanding I/O. 7. 4 Gb/s HBAs in virtualized environments that use Direct I/O or SFPT do not Initialize. Default driver configuration fails to initialize 4 Gb/s HBAs in virtualized environments that use Direct I/O or SFPT(Storage Fixed Pass through) .This may result in a system hang or uninitialized LPFC HBA in Intel VT-d and AMD-V IOMMU systems.
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Sample Migration Scripts
Operating Systems
Solaris 10 SPARC
Version Driver
2.40s (SPARC)
Size Driver
103Kb
File Name
leadville_migrate_1.0a6.tar
Information
SPARC Dynamic Reconfiguration is not supported on LPe12004, LPe11004, LP1000ExDC, LP9802DC and LP9002DC HBAs.
Note LP21000 and LP21002 adapters require a full-height PCIe slot, which is available in a limited number of Sun servers such as v445, M5000 (with I/O expander), Ultra 25 and Ultra 45.
These unsupported sample script files can help you migrate from the Solaris lpfc driver to the Solaris SFS driver. You can customize these scripts and run them to automate the migration process.

Solaris Instructions for Migration of Emulex Host Bus Adapters to Leadville Stack

Prerequisites:

1. Solaris packages SUNWemlx, lpfc, and HBAnyware must be installed on the machine.
2. all candidate migration candidate adapters must have fcode version 1.50a4 or later

Note:
Scripts unable to migrate machines with Emulex adapter as boot device for that machine.

Migration Steps:

1. run ./start_emlxs_migration.sh script
2. after script has finished successfully, reboot system as requested
3. run ./finish_emlxs_migration.sh script
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Utilities
Operating Systems
Solaris 10 SPARC
Version Utilities
2.40s (SPARC)
Size Utilities
30.2Mb
File Name
solaris-4.1a37-1.03h-1a.tar
Information
SPARC Dynamic Reconfiguration is not supported on LPe12004, LPe11004, LP1000ExDC, LP9802DC and LP9002DC HBAs.
Note LP21000 and LP21002 adapters require a full-height PCIe slot, which is available in a limited number of Sun servers such as v445, M5000 (with I/O expander), Ultra 25 and Ultra 45.
HBAnyware version 4.1a37, emlxadm version 1.03h and emlxdrv version 1.00m for SPARC

HBAnyware 4.1a37 Solaris Installation Instructions

Dependencies:

SUNWemlxs driver 2.40 or later (provided by Sun)
EMLXemlxu utility package 1.03h or later (included with the applications kit)

Java Runtime Environment

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

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

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

The HBAnyware, HBAnywareSSC and HbaCmd target OS versions are Solaris 5.10 and 5.11.

HBAnyware is dependent on the SUNWemlxs driver package and the EMLXemlxu utilities package being installed.
Please ensure that these packages are installed before installing HBAnyware.
HBAnyware Installation Instructions
-----------------------------------
1. Run the pkgrm routine to remove any previous version of HBAnyware: pkgrm HBAnyware
2. Unzip the file: gunzip HBAnyware-4.1a37-i386.tar.gz
3. Untar the file: tar -xvf HBAnyware-4.1a37-i386.tar
4. Run the pkgadd utility: pkgadd -d .
5. When prompted by pkgadd, choose to install HBAnyware
6. When prompted by pkgadd, answer the HBAnyware installation option questions
Running the HBAnyware GUI
-------------------------
1. su to root
2. Run the script /opt/HBAnyware/hbanyware
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
FCA Utilities Manual
Operating Systems
Solaris 2.6, 7, 8, 9 and 10 (32-bit and 64-bit)
Version Manual
6.02f
Size Manual
609Kb
File Name
manual.pdf
Information
Installing and using the FCA utilities

Installation ...............................................................................................1
Driver Information .................................................................................................... 1
Supported Features........................................................................................... 1
New Features in this Release............................................................................ 1
Prerequisites ..................................................................................................... 2
For the lpfc Driver Kit .................................................................................. 2
Compatibility...................................................................................................... 2
Things to Know Before You Download .............................................................. 3
Known Issues .................................................................................................... 3
Installing the Driver Kit ............................................................................................ 3
Driver Kit Install Script Options.......................................................................... 4
Driver Kit Directory Structure ............................................................................. 4
Installing the Driver on Unsupported Linux Distributions.......................................... 5
Upgrading the Kernel or Applying a Distribution Service Pack or Update ................ 5
Installing the Driver Kit into an Upgraded Kernel ............................................... 5
Booting From a Non-Zero LUN Attached to an Emulex Adapter .............................. 6
Installing the HBAnyware Utility ............................................................................... 6
Uninstalling the Driver Kit .................................................................................. 7
Configuration ..........................................................................................8
Driver Configuration Methods Using modprobe and
/etc/modprobe.conf............................................................................................ 8
Temporary Configuration Method ................................................................ 8
Persistent Configuration Method ................................................................. 8
Temporary Driver Configuration by Read/Write to sysfs .................................... 9
Creating a New Ramdisk Image ...................................................................... 10
For Installed lpfc Driver Kits ...................................................................... 10
For Distribution In-Box lpfc Drivers............................................................ 10
Dynamically Adding LUNs and Targets............................................................ 10
Driver Parameters Reference Table ................................................................ 11
Using udev for Persistent Naming ................................................................... 15
Using udev to Discover Logical to Physical Mappings for sd Devices ....... 15
Configuring the System to Boot From SAN Using Persistent Names ........ 15
Using udev with st Devices ....................................................................... 16
Further Information About Persistent Names ............................................ 17
Working with Virtual Ports (vports)......................................................................... 18
Creating, Deleting and Displaying vports......................................................... 18
The mkvport.sh Script ............................................................................... 18
The rmvport.sh Script................................................................................ 19
The lsvport.sh Script ................................................................................. 19
The vport Sysfs Tree ....................................................................................... 19
Driver Version 8.2.8.14 sysfs Structure............................................................ 20
Vport sysfs Entries .................................................................................... 21
Vport Configuration Limits ............................................................................... 23
DHCHAP Authentication and Configuration ........................................................... 24
Authentication Configuration Parameters ........................................................ 25
Setting Remote and Local Passwords ............................................................. 25
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
FCA Utilities
Operating Systems
Solaris 2.6, 7, 8, 9 and 10 (32-bit and 64-bit)
Version Utilities
6.02f
Size Utilities
76Kb
File Name
emlxu_kit-1.00m-sparc.tar
Information
emlxadm version 1.00q and emlxdrv version 1.00j for SPARC; emlxdrv is needed for a fresh installation of Solaris 10 Update 1 (77 KB tar file)
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Manual
Operating Systems
Solaris 2.6, 7, 8, 9 and 10 (32-bit and 64-bit)
Version Manual
6.02f
Size Manual
2.7Mb
File Name
set.pdf
Information
Installation, Configuration and Troubleshooting (2,727 KB)
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Driver Kit
Operating Systems
Solaris 2.6, 7, 8, 9 and 10 (32-bit and 64-bit)
Version Driver
6.02f
Size Driver
12Mb
File Name
solaris-2.1a18-6.02f-1a.tar
Information
Solaris 2.6, 7, 8, 9 and 10 (32-bit and 64-bit)
Base driver, HBAnyware utility 2.1a18, HBAnyware Security Configurator 2.1a18 and lputil 2.0a9

This kit contains the following components:

lpfc-6.02f-sparc.tar - Emulex Fibre Channel Solaris Driver
EmlxApps300a39-Solaris.tar - Emulex Applications kit
readme.first.txt - this file

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

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

2) Once the driver has been successfully installed, then the applications
kit must be installed. Instructions for installing the applications kit
can be found in the README.txt file contained in the EmlxApps300a39-Solaris.tar package.
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
FCA Utilities Manual
Operating Systems
Solaris 2.6, 7, 8, 9 and 10 (32-bit and 64-bit)
Version Manual
6.02g
Size Manual
609Kb
File Name
manual.pdf
Information
Installing and using the FCA utilities

Installation ...............................................................................................1
Driver Information .................................................................................................... 1
Supported Features........................................................................................... 1
New Features in this Release............................................................................ 1
Prerequisites ..................................................................................................... 2
For the lpfc Driver Kit .................................................................................. 2
Compatibility...................................................................................................... 2
Things to Know Before You Download .............................................................. 3
Known Issues .................................................................................................... 3
Installing the Driver Kit ............................................................................................ 3
Driver Kit Install Script Options.......................................................................... 4
Driver Kit Directory Structure ............................................................................. 4
Installing the Driver on Unsupported Linux Distributions.......................................... 5
Upgrading the Kernel or Applying a Distribution Service Pack or Update ................ 5
Installing the Driver Kit into an Upgraded Kernel ............................................... 5
Booting From a Non-Zero LUN Attached to an Emulex Adapter .............................. 6
Installing the HBAnyware Utility ............................................................................... 6
Uninstalling the Driver Kit .................................................................................. 7
Configuration ..........................................................................................8
Driver Configuration Methods Using modprobe and
/etc/modprobe.conf............................................................................................ 8
Temporary Configuration Method ................................................................ 8
Persistent Configuration Method ................................................................. 8
Temporary Driver Configuration by Read/Write to sysfs .................................... 9
Creating a New Ramdisk Image ...................................................................... 10
For Installed lpfc Driver Kits ...................................................................... 10
For Distribution In-Box lpfc Drivers............................................................ 10
Dynamically Adding LUNs and Targets............................................................ 10
Driver Parameters Reference Table ................................................................ 11
Using udev for Persistent Naming ................................................................... 15
Using udev to Discover Logical to Physical Mappings for sd Devices ....... 15
Configuring the System to Boot From SAN Using Persistent Names ........ 15
Using udev with st Devices ....................................................................... 16
Further Information About Persistent Names ............................................ 17
Working with Virtual Ports (vports)......................................................................... 18
Creating, Deleting and Displaying vports......................................................... 18
The mkvport.sh Script ............................................................................... 18
The rmvport.sh Script................................................................................ 19
The lsvport.sh Script ................................................................................. 19
The vport Sysfs Tree ....................................................................................... 19
Driver Version 8.2.8.14 sysfs Structure............................................................ 20
Vport sysfs Entries .................................................................................... 21
Vport Configuration Limits ............................................................................... 23
DHCHAP Authentication and Configuration ........................................................... 24
Authentication Configuration Parameters ........................................................ 25
Setting Remote and Local Passwords ............................................................. 25
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
FCA Utilities
Operating Systems
Solaris 2.6, 7, 8, 9 and 10 (32-bit and 64-bit)
Version Utilities
6.02g
Size Utilities
76Kb
File Name
emlxu_kit-1.00m-sparc.tar
Information
emlxadm version 1.00q and emlxdrv version 1.00j for SPARC; emlxdrv is needed for a fresh installation of Solaris 10 Update 1 (77 KB tar file)
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Manual
Operating Systems
Solaris 2.6, 7, 8, 9 and 10 (32-bit and 64-bit)
Version Manual
6.02g
Size Manual
2.7Mb
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 LP9002S
Description
Driver Kit
Operating Systems
Solaris 2.6, 7, 8, 9 and 10 (32-bit and 64-bit)
Version Driver
6.02g
Size Driver
12Mb
File Name
solaris-2.1a18-6.02g-1a.tar
Information
Base driver, HBAnyware utility 2.1a18, HBAnyware Security Configurator 2.1a18 and lputil 2.0a9

HBAnyware 2.1a18 Solaris Installation Instructions

Dependencies:

lpfcdriver 6.02c, or later
hbaapi 2.0e

Java Runtime Environment

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

HBAnyware and hbacmd currently will not run under Solaris 6.

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

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


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

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

1. su to root
2. Run the script /usr/sbin/hbanyware/hbanyware
Helpful scripts

/usr/sbin/hbanyware/stop_hbanyware - This script will stop all HBAnyware daemons and GUIs.
Run this if you need to unload the driver.
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
FCA Utilities Manual
Operating Systems
Solaris 2.6, 7, 8, 9 and 10 (32-bit and 64-bit)
Version Manual
6.02h
Size Manual
1Mb
File Name
manual.pdf
Information
Installing and using the FCA utilities

Installation ...............................................................................................1
Driver Information .................................................................................................... 1
Supported Features........................................................................................... 1
New Features in this Release............................................................................ 1
Prerequisites ..................................................................................................... 2
For the lpfc Driver Kit .................................................................................. 2
Compatibility...................................................................................................... 2
Things to Know Before You Download .............................................................. 3
Known Issues .................................................................................................... 3
Installing the Driver Kit ............................................................................................ 3
Driver Kit Install Script Options.......................................................................... 4
Driver Kit Directory Structure ............................................................................. 4
Installing the Driver on Unsupported Linux Distributions.......................................... 5
Upgrading the Kernel or Applying a Distribution Service Pack or Update ................ 5
Installing the Driver Kit into an Upgraded Kernel ............................................... 5
Booting From a Non-Zero LUN Attached to an Emulex Adapter .............................. 6
Installing the HBAnyware Utility ............................................................................... 6
Uninstalling the Driver Kit .................................................................................. 7
Configuration ..........................................................................................8
Driver Configuration Methods Using modprobe and
/etc/modprobe.conf............................................................................................ 8
Temporary Configuration Method ................................................................ 8
Persistent Configuration Method ................................................................. 8
Temporary Driver Configuration by Read/Write to sysfs .................................... 9
Creating a New Ramdisk Image ...................................................................... 10
For Installed lpfc Driver Kits ...................................................................... 10
For Distribution In-Box lpfc Drivers............................................................ 10
Dynamically Adding LUNs and Targets............................................................ 10
Driver Parameters Reference Table ................................................................ 11
Using udev for Persistent Naming ................................................................... 15
Using udev to Discover Logical to Physical Mappings for sd Devices ....... 15
Configuring the System to Boot From SAN Using Persistent Names ........ 15
Using udev with st Devices ....................................................................... 16
Further Information About Persistent Names ............................................ 17
Working with Virtual Ports (vports)......................................................................... 18
Creating, Deleting and Displaying vports......................................................... 18
The mkvport.sh Script ............................................................................... 18
The rmvport.sh Script................................................................................ 19
The lsvport.sh Script ................................................................................. 19
The vport Sysfs Tree ....................................................................................... 19
Driver Version 8.2.8.14 sysfs Structure............................................................ 20
Vport sysfs Entries .................................................................................... 21
Vport Configuration Limits ............................................................................... 23
DHCHAP Authentication and Configuration ........................................................... 24
Authentication Configuration Parameters ........................................................ 25
Setting Remote and Local Passwords ............................................................. 25
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
FCA Utilities
Operating Systems
Solaris 2.6, 7, 8, 9 and 10 (32-bit and 64-bit)
Version Utilities
6.02h
Size Utilities
76Kb
File Name
emlxu_kit-1.00n-sparc.tar
Information
emlxadm version 1.00r and emlxdrv version 1.00k for SPARC; emlxdrv is needed for a fresh installation of Solaris 10 Update 1 (75.5 KB tar file)
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Manual
Operating Systems
Solaris 2.6, 7, 8, 9 and 10 (32-bit and 64-bit)
Version Manual
6.02h
Size Manual
2.7Mb
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 LP9002S
Description
Driver Kit
Operating Systems
Solaris 2.6, 7, 8, 9 and 10 (32-bit and 64-bit)
Version Driver
6.02h
Size Driver
12Mb
File Name
solaris-2.1a18-6.02h-1a.tar
Information
Base driver, HBAnyware utility 2.1a18, HBAnyware Security Configurator 2.1a18 and lputil 2.0a9

HBAnyware 2.1a18 Solaris Installation Instructions

Dependencies:

lpfcdriver 6.02c, or later
hbaapi 2.0e

Java Runtime Environment

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

HBAnyware and hbacmd currently will not run under Solaris 6.

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

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


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

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

1. su to root
2. Run the script /usr/sbin/hbanyware/hbanyware
Helpful scripts

/usr/sbin/hbanyware/stop_hbanyware - This script will stop all HBAnyware daemons and GUIs.
Run this if you need to unload the driver.
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Boot Code Documentation
Operating Systems
Solaris 8
Version Driver
1.20gx7 (SPARC)
Size Driver
4.9Mb
File Name
bootcode.pdf
Information
Note Instructions for using the utilities and the sample migration scripts, as well as inustructions for migrating from the LPFC driver to the SFS driver, are provided in the Solaris SFS Driver User Manual. See the Manual link below.
Describes how to configure an HBA to boot from SAN Introduction..............................................................................................................1
Emulex Boot Code Files....................................................................................1
Boot from SAN.........................................................................................................2
Windows Server 2008 and Windows Server 2003.............................................2
Configure Boot from SAN on Windows Server 2008 and Windows Server 2003 (x86 and x64)..........................................................2
Configure Boot from SAN on Windows Server 2008 and Windows Server 2003 (Itanium)..................................................................3
New Installation of Windows 2008 UEFI- Aware Operating System
on a UEFI-based x64 Server.................................................................3
Direct a UEFI-Based Server to a Windows Server 2008 OS Image (Installed as UEFI-Aware) Already Installed on the SAN.......................4
The GUID Partition Table......................................................................4
Install Windows Server 2008 on an FC Boot Disk (x86, x64 and Itanium)...5
Install Windows Server 2003 on an FC Boot Disk (x86, and x64
and Itanium)................................................................................................6
Linux and VMware.............................................................................................7
Configure Boot from SAN on Linux or VMware (x86 and x64).....................7
Configure Boot from SAN on Linux (PowerPC)...........................................7
Configure Boot from SAN on Linux (Itanium)..............................................7
Solaris...............................................................................................................8
Configure Boot from SAN on Solaris SFS (x86 and x64)............................8
Determine LUNs to Select for Boot from SAN.......................................8
Configure Boot from SAN on Solaris SFS (SPARC)....................................8
Configure Boot from SAN on Solaris LPFC (SPARC)..................................9
Install Solaris from a Network Image..................................................10
Install Solaris by Migrating an Image from a Local SCSI Disk.............11
Install, Update and Enable Boot Code...................................................................14
BIOS Utility............................................................................................................15
Start the BIOS Utility.................................................................................15
Enable an Adapter to Boot from SAN........................................................17
Configure Boot Devices...................................................................................17
Configure Adapter Parameters........................................................................21
Change the Default AL_PA (Arbitrated Loop Physical Address)................22
Change the PLOGI Retry Timer................................................................23
Change Topology......................................................................................24
Enable or Disable the Spinup Delay..........................................................25
Set Auto Scan...........................................................................................26
Enable or Disable EDD 3.0.......................................................................27
Enable or Disable the Start Unit Command...............................................28
Enable or Disable the Environment Variable.............................................29
Enable or Disable Auto Boot Sector..........................................................30
Change Link Speed...................................................................................31
Reset to Default Values.............................................................................32
Use Multi-Path Boot from SAN..................................................................33
OpenBoot..............................................................................................................34
Attribute Commands.................................................................................34
Functional Commands..............................................................................35
EFIBoot.................................................................................................................37
Install the EFI Utility..................................................................................37
Start the EFI Utility....................................................................................38
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Manual
Operating Systems
Solaris 8
Version Manual
1.20gx7 (SPARC)
Size Manual
3.7Mb
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 LP9002S
Description
Sample Migration Scripts
Operating Systems
Solaris 8
Version Driver
1.20gx7 (SPARC)
Size Driver
103Kb
File Name
leadville_migrate_1.0a6.tar
Information
These unsupported sample script files can help you migrate from the Solaris lpfc driver to the Solaris SFS driver. You can customize these scripts and run them to automate the migration process.

Solaris Instructions for Migration of Emulex Host Bus Adapters to Leadville Stack

Prerequisites:

1. Solaris packages SUNWemlx, lpfc, and HBAnyware must be installed on the machine.
2. all candidate migration candidate adapters must have fcode version 1.50a4 or later

Note:
Scripts unable to migrate machines with Emulex adapter as boot device for that machine.

Migration Steps:

1. run ./start_emlxs_migration.sh script
2. after script has finished successfully, reboot system as requested
3. run ./finish_emlxs_migration.sh script
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Utilities
Operating Systems
Solaris 8
Version Utilities
1.20gx7 (SPARC)
Size Utilities
31Mb
File Name
solaris-3.2a15-1.01c-1a.tar
Information
HBAnyware version 3.2a15, emlxadm version 1.01c and emlxdrv version 1.00k for SPARC

HBAnyware 3.2a15 Solaris Installation Instructions

Dependencies:

SUNWemlxs driver 1.20f or later for Solaris 8 and 9 (provided by Sun)
SUNWemlxs driver 2.20f or later for Solaris 10 and later (provided by Sun)
EMLXemlxu utility package 1.01c or later (included with the applications kit)

Java Runtime Environment

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

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

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

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


HBAnyware is dependant on the SUNWemlxs driver package and the EMLXemlxu utilities package being installed.
Please ensure that these packages are installed before installing HBAnyware.

HBAnyware Installation Instructions

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

1. su to root
2. Run the script /usr/sbin/hbanyware/hbanyware
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
FCA Utilities Manual
Operating Systems
Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Manual
6.10gx2
Size Manual
1Mb
File Name
manual.pdf
Information
Emulex recommends installing driver version 6.10gx2, which adds a critical fix to the previously posted 6.10g driver. Driver functionality and behavior are otherwise identical.
Installing and using the FCA utilities

Installation ...............................................................................................1
Driver Information .................................................................................................... 1
Supported Features........................................................................................... 1
New Features in this Release............................................................................ 1
Prerequisites ..................................................................................................... 2
For the lpfc Driver Kit .................................................................................. 2
Compatibility...................................................................................................... 2
Things to Know Before You Download .............................................................. 3
Known Issues .................................................................................................... 3
Installing the Driver Kit ............................................................................................ 3
Driver Kit Install Script Options.......................................................................... 4
Driver Kit Directory Structure ............................................................................. 4
Installing the Driver on Unsupported Linux Distributions.......................................... 5
Upgrading the Kernel or Applying a Distribution Service Pack or Update ................ 5
Installing the Driver Kit into an Upgraded Kernel ............................................... 5
Booting From a Non-Zero LUN Attached to an Emulex Adapter .............................. 6
Installing the HBAnyware Utility ............................................................................... 6
Uninstalling the Driver Kit .................................................................................. 7
Configuration ..........................................................................................8
Driver Configuration Methods Using modprobe and
/etc/modprobe.conf............................................................................................ 8
Temporary Configuration Method ................................................................ 8
Persistent Configuration Method ................................................................. 8
Temporary Driver Configuration by Read/Write to sysfs .................................... 9
Creating a New Ramdisk Image ...................................................................... 10
For Installed lpfc Driver Kits ...................................................................... 10
For Distribution In-Box lpfc Drivers............................................................ 10
Dynamically Adding LUNs and Targets............................................................ 10
Driver Parameters Reference Table ................................................................ 11
Using udev for Persistent Naming ................................................................... 15
Using udev to Discover Logical to Physical Mappings for sd Devices ....... 15
Configuring the System to Boot From SAN Using Persistent Names ........ 15
Using udev with st Devices ....................................................................... 16
Further Information About Persistent Names ............................................ 17
Working with Virtual Ports (vports)......................................................................... 18
Creating, Deleting and Displaying vports......................................................... 18
The mkvport.sh Script ............................................................................... 18
The rmvport.sh Script................................................................................ 19
The lsvport.sh Script ................................................................................. 19
The vport Sysfs Tree ....................................................................................... 19
Driver Version 8.2.8.14 sysfs Structure............................................................ 20
Vport sysfs Entries .................................................................................... 21
Vport Configuration Limits ............................................................................... 23
DHCHAP Authentication and Configuration ........................................................... 24
Authentication Configuration Parameters ........................................................ 25
Setting Remote and Local Passwords ............................................................. 25
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
FCA Utilities
Operating Systems
Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Utilities
6.10gx2
Size Utilities
76Kb
File Name
emlxu_kit-1.00n-sparc.tar
Information
Emulex recommends installing driver version 6.10gx2, which adds a critical fix to the previously posted 6.10g driver. Driver functionality and behavior are otherwise identical.
emlxadm version 1.00r and emlxdrv version 1.00k for SPARC; emlxdrv is needed for a fresh installation of Solaris 10 Update 1 (75.5 KB tar file)
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Manual
Operating Systems
Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Manual
6.10gx2
Size Manual
3.7Mb
File Name
manual.pdf
Information
Emulex recommends installing driver version 6.10gx2, which adds a critical fix to the previously posted 6.10g driver. Driver functionality and behavior are otherwise identical.
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 LP9002S
Description
Driver Kit
Operating Systems
Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Driver
6.10gx2
Size Driver
20Mb
File Name
solaris-3.0a17-6.10gx2-1a.tar
Information
Emulex recommends installing driver version 6.10gx2, which adds a critical fix to the previously posted 6.10g driver. Driver functionality and behavior are otherwise identical.
Base driver, HBAnyware utility 3.0a17 and lputil 2.0a13

HBAnyware 3.0a17 Solaris Installation Instructions

Dependencies:

lpfcdriver 6.10b, or later
hbaapi 2.0f

Java Runtime Environment

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

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

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

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


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

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

1. su to root
2. Run the script /usr/sbin/hbanyware/hbanyware
Helpful scripts

/usr/sbin/hbanyware/stop_hbanyware - This script will stop all HBAnyware daemons and GUIs.
Run this if you need to unload the driver.
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
FCA Utilities
Operating Systems
Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Utilities
6.11cx2
Size Utilities
212Kb
File Name
emlxu_kit-1.01a-sparc.tar
Information
emlxadm version 1.01a and emlxdrv version 1.00k for SPARC; emlxdrv is needed for a fresh installation of Solaris 10 Update 1 (75.5 KB tar file)
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Manual
Operating Systems
Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Manual
6.11cx2
Size Manual
4.6Mb
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 LP9002S
Description
Driver Kit
Operating Systems
Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Driver
6.11cx2
Size Driver
24.1Mb
File Name
solaris-3.1a12-6.11cx2-1a.tar
Information
Base driver, HBAnyware utility 3.1a12 and lputil 2.0a13

HBAnyware 3.1a12 Solaris Installation Instructions

Dependencies:

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

Java Runtime Environment

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

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

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

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


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

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

1. su to root
2. Run the script /usr/sbin/hbanyware/hbanyware
Helpful scripts

/usr/sbin/hbanyware/stop_hbanyware - This script will stop all HBAnyware daemons and GUIs.
Run this if you need to unload the driver.
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
FCA Utilities
Operating Systems
Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Utilities
6.20j
Size Utilities
212Kb
File Name
emlxu_kit-1.01a-sparc.tar
Information
This driver version requires patch #112438 for
Solaris 8 operation.
Starting with this Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
emlxadm version 1.01a and emlxdrv version 1.00k for SPARC; emlxdrv is needed for a fresh installation of Solaris 10 Update 1 (75.5 KB tar file)
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
lputil Manual lputil Utility User Manual
Operating Systems
Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Manual
6.20j
Size Manual
329Kb
File Name
lputil.pdf
Information
This driver version requires patch #112438 for
Solaris 8 operation.
Starting with this Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.

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

Introduction
The LightPulse® diagnostic utility (lputil) for Linux and Solaris is a console application that enables you
to manage local Emulex® host bus adapters (HBAs).
Use lputil to do any of the following:
• Discover HBAs
• View HBA information
• Reset HBAs
• Update firmware or boot code on the local HBA
• Enable or disable the boot code on the HBA
• Download PCI Configuration
• Set Up Persistent Binding (Solaris only)
• Use the Command Line Interface (CLI)
Prerequisites
Before using lputil, ensure the following prerequisites are met:
• The Emulex driver is installed.
• The lputil utility is installed.
• If you are updating firmware, the firmware file is downloaded to a local drive. Firmware versions
differ between HBA versions. Make sure you have downloaded the appropriate firmware for your
HBA.
• I/O activity on the bus is quieted.
• Any software that relies on the HBA to be available is stopped or paused.
Installing lputil
To install lputil:
1. Download the lputil.tar file from the Emulex Web site to a directory on a local drive on the server.
2. Untar the contents of the lputil.tar file.
3. Run the lputil installation script.
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
HBAnyware Manual Utility User Manual
Operating Systems
Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Manual
6.20j
Size Manual
3.1Mb
File Name
hbanyware.pdf
Information
This driver version requires patch #112438 for
Solaris 8 operation.
Starting with this Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.

Introduction.............................................................................................................. 1
Known Issues .................................................................................................... 1
Installing HBAnyware Components.......................................................................... 2
Installing the HBAnyware Utility......................................................................... 2
Installing the HBAnyware Utility with Web Launch............................................. 4
Installing the HBAnyware Utility Security Configurator ...................................... 5
Uninstalling the HBAnyware Security Configurator............................................ 6
Uninstalling HBAnyware Web Launch Only ....................................................... 7
Uninstalling the Utility Package ......................................................................... 7
Using the HBAnyware Components......................................................................... 8
Starting the HBAnyware Utility........................................................................... 8
Starting HBAnyware with Web Launch .............................................................. 8
Starting the HBAnyware Security Configurator .................................................. 8
Starting HBAnyware from the Command Line ................................................... 9
Examples of Modifications .................................................................... 9
The HBAnyware Utility Window Element Definitions ....................................... 10
The Menu Bar ........................................................................................... 11
The Toolbar ............................................................................................... 11
The Toolbar Buttons .................................................................................. 11
Sort Toolbar Buttons ........................................................................... 11
The Discovery-Tree................................................................................... 12
Discovery-Tree Icons .......................................................................... 12
Property Tabs............................................................................................ 13
Status Bar ................................................................................................. 13
Changing Management Mode ......................................................................... 13
Resetting HBAs ............................................................................................... 14
Discovering HBAs ........................................................................................... 14
Automatic Fibre Channel Discovery .......................................................... 14
Remote SAN Management Using TCP/IP Access Protocol....................... 15
Adding a Single Host .......................................................................... 15
Adding a Range of Hosts .................................................................... 16
Removing Hosts.................................................................................. 17
Configuring Discovery Settings ................................................................. 18
Sorting HBA Information.................................................................................. 19
Viewing Remote and Local HBAs.............................................................. 19
Viewing HBA Information................................................................................. 20
Viewing Discovery Information .................................................................. 20
Viewing Host Information .......................................................................... 21
The Host Information Tab.................................................................... 21
The Driver Parameters Tab................................................................. 22
Viewing General HBA Attributes ............................................................... 23
Viewing Detailed HBA Information ............................................................ 24
Viewing Fabric Information........................................................................ 26
Viewing Target Information........................................................................ 27
Viewing LUN Information........................................................................... 28
Masking and Unmasking LUNs (Windows, Solaris LPFC and
Solaris SFS)........................................................................................ 29
Viewing Port Statistics............................................................................... 31
Viewing Firmware Information ................................................................... 33
Viewing Target Mapping (Windows, Solaris LPFC and Solaris SFS)......... 34
Viewing Target Mapping (Linux) ................................................................ 35
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Driver Manual LPFC Driver for Solaris User Manual
Operating Systems
Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Manual
6.20j
Size Manual
1.6Mb
File Name
manual.pdf
Information
This driver version requires patch #112438 for
Solaris 8 operation.
Starting with this Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.

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 LP9002S
Description
Solaris 10 Update 1 behavior change -- must read before downloading driver
Operating Systems
Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Driver
6.20j
Size Driver
25Kb
File Name
lpfc_100_rbyd.pdf
Information
Solaris 10 Updates and the lpfc
Driver
The behavior of the Solaris operating system changes beginning with Solaris 10 Update 1 (also referred
to as Solaris 10 1/06 release). Starting with this version, a bare-metal installation of the operating system
automatically discovers all SFS-recognized HBAs (Sun-branded, Emulex, or EMC-branded) and binds
them to the “emlxs” SFS driver. A subsequent installation of lpfc will not discover and bind these HBAs;
you must use the emlxdrv utility to unbind the HBAs from the SFS driver as described in this document.

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

Prerequisites:
• SPARC platform
• Solaris 10 Update 1 or later installed on a local drive
• Sun released patch 120222-06 or later installed
• Emulex® FCA utility version 1.00m (which includes emlxdrv 1.00j for SPARC) or later installed
(see the Emulex FCA Utilities Reference Manual for installation instructions)
• Emulex lpfc driver not yet installed
To unbind the HBAs from the SFS driver, do the following:
1. Start the emlxdrv utility as described in the Emulex FCA Utilities Reference Manual.
2. Type the following command at the emlxdrv prompt:
clear_all
This unbinds from emlxs all HBAs that are recognized by both emlxs and lpfc drivers.
3. Exit the emlxdrv utility by typing the following:
q
Install the lpfc driver as instructed in the documentation that accompanies the driver.
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Driver Kit
Operating Systems
Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Driver
6.20j
Size Driver
21.5Mb
File Name
solaris-3.3a19-6.20j-1b.tar
Information
This driver version requires patch #112438 for
Solaris 8 operation.
Starting with this Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
Base driver, HBAnyware utility 3.3a22 and lputil 2.0a13 (21.5 MB tar file)
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
FCA Utilities Manual
Operating Systems
Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Manual
6.21f
Size Manual
863Kb
File Name
sfs_utilities.pdf
Information
This driver version requires patch #112438 for
Solaris 8 operation.
Starting with Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
Instructions for using emlxdrv

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

This document provides the information needed to use the Emulex® emlxadm and elmxdrv utility
programs. For system administrators, this document includes information about the installation and
removal of these utilities.
At the very least, system administrators should be familiar with Solaris and the Sun StorEdge SAN
Foundation Software (SFS) and should have access to standard system documentation. Anyone
working with this product should have some familiarity with the nature and use of Fibre Channel.
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
FCA Utilities
Operating Systems
Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Utilities
6.21f
Size Utilities
212Kb
File Name
emlxu_kit-1.01a-sparc.tar
Information
This driver version requires patch #112438 for
Solaris 8 operation.
Starting with Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
emlxadm version 1.01a and emlxdrv version 1.00k for SPARC; emlxdrv is needed for a fresh installation of Solaris 10 Update 1 (75.5 KB tar file)
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
HBAnyware Manual
Operating Systems
Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Manual
6.21f
Size Manual
3.5Mb
File Name
hbanyware.pdf
Information
This driver version requires patch #112438 for
Solaris 8 operation.
Starting with Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
HBAnyware Utility User Manual

Introduction.............................................................................................................. 1
Known Issues .................................................................................................... 1
Installing HBAnyware Components.......................................................................... 2
Installing the HBAnyware Utility......................................................................... 2
Installing the HBAnyware Utility with Web Launch............................................. 4
Installing the HBAnyware Utility Security Configurator ...................................... 5
Uninstalling the HBAnyware Security Configurator............................................ 6
Uninstalling HBAnyware Web Launch Only ....................................................... 7
Uninstalling the Utility Package ......................................................................... 7
Using the HBAnyware Components......................................................................... 8
Starting the HBAnyware Utility........................................................................... 8
Starting HBAnyware with Web Launch .............................................................. 8
Starting the HBAnyware Security Configurator .................................................. 8
Starting HBAnyware from the Command Line ................................................... 9
Examples of Modifications .................................................................... 9
The HBAnyware Utility Window Element Definitions ....................................... 10
The Menu Bar ........................................................................................... 11
The Toolbar ............................................................................................... 11
The Toolbar Buttons .................................................................................. 11
Sort Toolbar Buttons ........................................................................... 11
The Discovery-Tree................................................................................... 12
Discovery-Tree Icons .......................................................................... 12
Property Tabs............................................................................................ 13
Status Bar ................................................................................................. 13
Changing Management Mode ......................................................................... 13
Resetting HBAs ............................................................................................... 14
Discovering HBAs ........................................................................................... 14
Automatic Fibre Channel Discovery .......................................................... 14
Remote SAN Management Using TCP/IP Access Protocol....................... 15
Adding a Single Host .......................................................................... 15
Adding a Range of Hosts .................................................................... 16
Removing Hosts.................................................................................. 17
Configuring Discovery Settings ................................................................. 18
Sorting HBA Information.................................................................................. 19
Viewing Remote and Local HBAs.............................................................. 19
Viewing HBA Information................................................................................. 20
Viewing Discovery Information .................................................................. 20
Viewing Host Information .......................................................................... 21
The Host Information Tab.................................................................... 21
The Driver Parameters Tab................................................................. 22
Viewing General HBA Attributes ............................................................... 23
Viewing Detailed HBA Information ............................................................ 24
Viewing Fabric Information........................................................................ 26
Viewing Target Information........................................................................ 27
Viewing LUN Information........................................................................... 28
Masking and Unmasking LUNs (Windows, Solaris LPFC and
Solaris SFS)........................................................................................ 29
Viewing Port Statistics............................................................................... 31
Viewing Firmware Information ................................................................... 33
Viewing Target Mapping (Windows, Solaris LPFC and Solaris SFS)......... 34
Viewing Target Mapping (Linux) ................................................................ 35
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Driver Manual
Operating Systems
Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Manual
6.21f
Size Manual
1.5Mb
File Name
manual.pdf
Information
This driver version requires patch #112438 for
Solaris 8 operation.
Starting with Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
LPFC Driver for Solaris User Manual (1.58 MB)

Installation ...............................................................................................1
Driver Information .................................................................................................... 1
Supported Features........................................................................................... 1
New Features in this Release............................................................................ 1
Prerequisites ..................................................................................................... 2
For the lpfc Driver Kit .................................................................................. 2
Compatibility...................................................................................................... 2
Things to Know Before You Download .............................................................. 3
Known Issues .................................................................................................... 3
Installing the Driver Kit ............................................................................................ 3
Driver Kit Install Script Options.......................................................................... 4
Driver Kit Directory Structure ............................................................................. 4
Installing the Driver on Unsupported Linux Distributions.......................................... 5
Upgrading the Kernel or Applying a Distribution Service Pack or Update ................ 5
Installing the Driver Kit into an Upgraded Kernel ............................................... 5
Booting From a Non-Zero LUN Attached to an Emulex Adapter .............................. 6
Installing the HBAnyware Utility ............................................................................... 6
Uninstalling the Driver Kit .................................................................................. 7
Configuration ..........................................................................................8
Driver Configuration Methods Using modprobe and
/etc/modprobe.conf............................................................................................ 8
Temporary Configuration Method ................................................................ 8
Persistent Configuration Method ................................................................. 8
Temporary Driver Configuration by Read/Write to sysfs .................................... 9
Creating a New Ramdisk Image ...................................................................... 10
For Installed lpfc Driver Kits ...................................................................... 10
For Distribution In-Box lpfc Drivers............................................................ 10
Dynamically Adding LUNs and Targets............................................................ 10
Driver Parameters Reference Table ................................................................ 11
Using udev for Persistent Naming ................................................................... 15
Using udev to Discover Logical to Physical Mappings for sd Devices ....... 15
Configuring the System to Boot From SAN Using Persistent Names ........ 15
Using udev with st Devices ....................................................................... 16
Further Information About Persistent Names ............................................ 17
Working with Virtual Ports (vports)......................................................................... 18
Creating, Deleting and Displaying vports......................................................... 18
The mkvport.sh Script ............................................................................... 18
The rmvport.sh Script................................................................................ 19
The lsvport.sh Script ................................................................................. 19
The vport Sysfs Tree ....................................................................................... 19
Driver Version 8.2.8.14 sysfs Structure............................................................ 20
Vport sysfs Entries .................................................................................... 21
Vport Configuration Limits ............................................................................... 23
DHCHAP Authentication and Configuration ........................................................... 24
Authentication Configuration Parameters ........................................................ 25
Setting Remote and Local Passwords ............................................................. 25
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Driver Kit
Operating Systems
Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Driver
6.21f
Size Driver
21.5Mb
File Name
solaris-3.4a15-6.21f-1a.tar
Information
This driver version requires patch #112438 for
Solaris 8 operation.
Starting with Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
Base driver, HBAnyware utility 3.4a15, emlxdrv utility 1.00l; emlxdrv is needed for a fresh installation of Solaris 10 Update 1

HBAnyware 3.4a15 Solaris Installation Instructions

Dependencies:

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

Java Runtime Environment

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

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

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

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


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

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

1. su to root
2. Run the script /opt/emulex/hbanyware/hbanyware
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Boot Code Documentation
Operating Systems
Solaris 9
Version Driver
1.20gx8 (SPARC)
Size Driver
4.9Mb
File Name
bootcode.pdf
Information
Note Instructions for using the utilities and the sample migration scripts, as well as inustructions for migrating from the LPFC driver to the SFS driver, are provided in the Solaris SFS Driver User Manual. See the Manual link below.
Describes how to configure an HBA to boot from SAN Introduction..............................................................................................................1
Emulex Boot Code Files....................................................................................1
Boot from SAN.........................................................................................................2
Windows Server 2008 and Windows Server 2003.............................................2
Configure Boot from SAN on Windows Server 2008 and Windows Server 2003 (x86 and x64)..........................................................2
Configure Boot from SAN on Windows Server 2008 and Windows Server 2003 (Itanium)..................................................................3
New Installation of Windows 2008 UEFI- Aware Operating System
on a UEFI-based x64 Server.................................................................3
Direct a UEFI-Based Server to a Windows Server 2008 OS Image (Installed as UEFI-Aware) Already Installed on the SAN.......................4
The GUID Partition Table......................................................................4
Install Windows Server 2008 on an FC Boot Disk (x86, x64 and Itanium)...5
Install Windows Server 2003 on an FC Boot Disk (x86, and x64
and Itanium)................................................................................................6
Linux and VMware.............................................................................................7
Configure Boot from SAN on Linux or VMware (x86 and x64).....................7
Configure Boot from SAN on Linux (PowerPC)...........................................7
Configure Boot from SAN on Linux (Itanium)..............................................7
Solaris...............................................................................................................8
Configure Boot from SAN on Solaris SFS (x86 and x64)............................8
Determine LUNs to Select for Boot from SAN.......................................8
Configure Boot from SAN on Solaris SFS (SPARC)....................................8
Configure Boot from SAN on Solaris LPFC (SPARC)..................................9
Install Solaris from a Network Image..................................................10
Install Solaris by Migrating an Image from a Local SCSI Disk.............11
Install, Update and Enable Boot Code...................................................................14
BIOS Utility............................................................................................................15
Start the BIOS Utility.................................................................................15
Enable an Adapter to Boot from SAN........................................................17
Configure Boot Devices...................................................................................17
Configure Adapter Parameters........................................................................21
Change the Default AL_PA (Arbitrated Loop Physical Address)................22
Change the PLOGI Retry Timer................................................................23
Change Topology......................................................................................24
Enable or Disable the Spinup Delay..........................................................25
Set Auto Scan...........................................................................................26
Enable or Disable EDD 3.0.......................................................................27
Enable or Disable the Start Unit Command...............................................28
Enable or Disable the Environment Variable.............................................29
Enable or Disable Auto Boot Sector..........................................................30
Change Link Speed...................................................................................31
Reset to Default Values.............................................................................32
Use Multi-Path Boot from SAN..................................................................33
OpenBoot..............................................................................................................34
Attribute Commands.................................................................................34
Functional Commands..............................................................................35
EFIBoot.................................................................................................................37
Install the EFI Utility..................................................................................37
Start the EFI Utility....................................................................................38
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Manual
Operating Systems
Solaris 9
Version Manual
1.20gx8 (SPARC)
Size Manual
3.7Mb
File Name
manual.pdf
Information
Note Instructions for using the utilities and the sample migration scripts, as well as inustructions for migrating from the LPFC driver to the SFS driver, are provided in the Solaris SFS Driver User Manual. See the Manual link below.
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 LP9002S
Description
Sample Migration Scripts
Operating Systems
Solaris 9
Version Driver
1.20gx8 (SPARC)
Size Driver
103Kb
File Name
leadville_migrate_1.0a6.tar
Information
These unsupported sample script files can help you migrate from the Solaris lpfc driver to the Solaris SFS driver. You can customize these scripts and run them to automate the migration process.

Solaris Instructions for Migration of Emulex Host Bus Adapters to Leadville Stack

Prerequisites:

1. Solaris packages SUNWemlx, lpfc, and HBAnyware must be installed on the machine.
2. all candidate migration candidate adapters must have fcode version 1.50a4 or later

Note:
Scripts unable to migrate machines with Emulex adapter as boot device for that machine.

Migration Steps:

1. run ./start_emlxs_migration.sh script
2. after script has finished successfully, reboot system as requested
3. run ./finish_emlxs_migration.sh script
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Utilities
Operating Systems
Solaris 9
Version Utilities
1.20gx8 (SPARC)
Size Utilities
31Mb
File Name
solaris-3.2a15-1.01c-1a.tar
Information
HBAnyware version 3.2a15, emlxadm version 1.01c and emlxdrv version 1.00k for SPARC

HBAnyware 3.2a15 Solaris Installation Instructions

Dependencies:

SUNWemlxs driver 1.20f or later for Solaris 8 and 9 (provided by Sun)
SUNWemlxs driver 2.20f or later for Solaris 10 and later (provided by Sun)
EMLXemlxu utility package 1.01c or later (included with the applications kit)

Java Runtime Environment

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

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

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

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


HBAnyware is dependant on the SUNWemlxs driver package and the EMLXemlxu utilities package being installed.
Please ensure that these packages are installed before installing HBAnyware.

HBAnyware Installation Instructions

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

1. su to root
2. Run the script /usr/sbin/hbanyware/hbanyware
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
FCA Utilities Manual
Operating Systems
SPARC Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Manual
6.21g
Size Manual
863Kb
File Name
sfs_utilities.pdf
Information
This driver version requires patch #112438 for
Solaris 8 operation.
Starting with Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
Instructions for using emlxdrv

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

This document provides the information needed to use the Emulex® emlxadm and elmxdrv utility
programs. For system administrators, this document includes information about the installation and
removal of these utilities.
At the very least, system administrators should be familiar with Solaris and the Sun StorEdge SAN
Foundation Software (SFS) and should have access to standard system documentation. Anyone
working with this product should have some familiarity with the nature and use of Fibre Channel.
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
HBAnyware Manual
Operating Systems
SPARC Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Manual
6.21g
Size Manual
3.5Mb
File Name
hbanyware.pdf
Information
This driver version requires patch #112438 for
Solaris 8 operation.
Starting with Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
HBAnyware Utility User Manual

Introduction.............................................................................................................. 1
Known Issues .................................................................................................... 1
Installing HBAnyware Components.......................................................................... 2
Installing the HBAnyware Utility......................................................................... 2
Installing the HBAnyware Utility with Web Launch............................................. 4
Installing the HBAnyware Utility Security Configurator ...................................... 5
Uninstalling the HBAnyware Security Configurator............................................ 6
Uninstalling HBAnyware Web Launch Only ....................................................... 7
Uninstalling the Utility Package ......................................................................... 7
Using the HBAnyware Components......................................................................... 8
Starting the HBAnyware Utility........................................................................... 8
Starting HBAnyware with Web Launch .............................................................. 8
Starting the HBAnyware Security Configurator .................................................. 8
Starting HBAnyware from the Command Line ................................................... 9
Examples of Modifications .................................................................... 9
The HBAnyware Utility Window Element Definitions ....................................... 10
The Menu Bar ........................................................................................... 11
The Toolbar ............................................................................................... 11
The Toolbar Buttons .................................................................................. 11
Sort Toolbar Buttons ........................................................................... 11
The Discovery-Tree................................................................................... 12
Discovery-Tree Icons .......................................................................... 12
Property Tabs............................................................................................ 13
Status Bar ................................................................................................. 13
Changing Management Mode ......................................................................... 13
Resetting HBAs ............................................................................................... 14
Discovering HBAs ........................................................................................... 14
Automatic Fibre Channel Discovery .......................................................... 14
Remote SAN Management Using TCP/IP Access Protocol....................... 15
Adding a Single Host .......................................................................... 15
Adding a Range of Hosts .................................................................... 16
Removing Hosts.................................................................................. 17
Configuring Discovery Settings ................................................................. 18
Sorting HBA Information.................................................................................. 19
Viewing Remote and Local HBAs.............................................................. 19
Viewing HBA Information................................................................................. 20
Viewing Discovery Information .................................................................. 20
Viewing Host Information .......................................................................... 21
The Host Information Tab.................................................................... 21
The Driver Parameters Tab................................................................. 22
Viewing General HBA Attributes ............................................................... 23
Viewing Detailed HBA Information ............................................................ 24
Viewing Fabric Information........................................................................ 26
Viewing Target Information........................................................................ 27
Viewing LUN Information........................................................................... 28
Masking and Unmasking LUNs (Windows, Solaris LPFC and
Solaris SFS)........................................................................................ 29
Viewing Port Statistics............................................................................... 31
Viewing Firmware Information ................................................................... 33
Viewing Target Mapping (Windows, Solaris LPFC and Solaris SFS)......... 34
Viewing Target Mapping (Linux) ................................................................ 35
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Driver Manual
Operating Systems
SPARC Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Manual
6.21g
Size Manual
1.6Mb
File Name
manual.pdf
Information
This driver version requires patch #112438 for
Solaris 8 operation.
Starting with Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
LPFC Driver for Solaris User Manual

Installation ...............................................................................................1
Driver Information .................................................................................................... 1
Supported Features........................................................................................... 1
New Features in this Release............................................................................ 1
Prerequisites ..................................................................................................... 2
For the lpfc Driver Kit .................................................................................. 2
Compatibility...................................................................................................... 2
Things to Know Before You Download .............................................................. 3
Known Issues .................................................................................................... 3
Installing the Driver Kit ............................................................................................ 3
Driver Kit Install Script Options.......................................................................... 4
Driver Kit Directory Structure ............................................................................. 4
Installing the Driver on Unsupported Linux Distributions.......................................... 5
Upgrading the Kernel or Applying a Distribution Service Pack or Update ................ 5
Installing the Driver Kit into an Upgraded Kernel ............................................... 5
Booting From a Non-Zero LUN Attached to an Emulex Adapter .............................. 6
Installing the HBAnyware Utility ............................................................................... 6
Uninstalling the Driver Kit .................................................................................. 7
Configuration ..........................................................................................8
Driver Configuration Methods Using modprobe and
/etc/modprobe.conf............................................................................................ 8
Temporary Configuration Method ................................................................ 8
Persistent Configuration Method ................................................................. 8
Temporary Driver Configuration by Read/Write to sysfs .................................... 9
Creating a New Ramdisk Image ...................................................................... 10
For Installed lpfc Driver Kits ...................................................................... 10
For Distribution In-Box lpfc Drivers............................................................ 10
Dynamically Adding LUNs and Targets............................................................ 10
Driver Parameters Reference Table ................................................................ 11
Using udev for Persistent Naming ................................................................... 15
Using udev to Discover Logical to Physical Mappings for sd Devices ....... 15
Configuring the System to Boot From SAN Using Persistent Names ........ 15
Using udev with st Devices ....................................................................... 16
Further Information About Persistent Names ............................................ 17
Working with Virtual Ports (vports)......................................................................... 18
Creating, Deleting and Displaying vports......................................................... 18
The mkvport.sh Script ............................................................................... 18
The rmvport.sh Script................................................................................ 19
The lsvport.sh Script ................................................................................. 19
The vport Sysfs Tree ....................................................................................... 19
Driver Version 8.2.8.14 sysfs Structure............................................................ 20
Vport sysfs Entries .................................................................................... 21
Vport Configuration Limits ............................................................................... 23
DHCHAP Authentication and Configuration ........................................................... 24
Authentication Configuration Parameters ........................................................ 25
Setting Remote and Local Passwords ............................................................. 25
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Driver Kit
Operating Systems
SPARC Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Driver
6.21g
Size Driver
21.5Mb
File Name
solaris-3.4a15-6.21g-1a.tar
Information
This driver version requires patch #112438 for
Solaris 8 operation.
Starting with Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
Base driver, HBAnyware utility 3.4a15, emlxdrv utility 1.00l; emlxdrv is needed for a fresh installation of Solaris 10 Update 1 (21.5 MB tar file)
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
FCA Utilities Manual
Operating Systems
SPARC Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Manual
6.30g (Legacy)
Size Manual
876Kb
File Name
sfs_utilities.pdf
Information
This driver is posted as is, with no new version planned.
This driver version requires patch #112438 for Solaris 8 operation.
Starting with Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
Instructions for using the FCA utilities

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

This document provides the information needed to use the Emulex® emlxadm and elmxdrv utility
programs. For system administrators, this document includes information about the installation and
removal of these utilities.
At the very least, system administrators should be familiar with Solaris and the Sun StorEdge SAN
Foundation Software (SFS) and should have access to standard system documentation. Anyone
working with this product should have some familiarity with the nature and use of Fibre Channel.
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
HBAnyware User Manual
Operating Systems
SPARC Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Manual
6.30g (Legacy)
Size Manual
5.3Mb
File Name
hbanyware.pdf
Information
This driver is posted as is, with no new version planned.
This driver version requires patch #112438 for Solaris 8 operation.
Starting with Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
HBAnyware Utility Version 4.0

Introduction.............................................................................................................. 1
Known Issues .................................................................................................... 1
Installing HBAnyware Components.......................................................................... 2
Installing the HBAnyware Utility......................................................................... 2
Installing the HBAnyware Utility with Web Launch............................................. 4
Installing the HBAnyware Utility Security Configurator ...................................... 5
Uninstalling the HBAnyware Security Configurator............................................ 6
Uninstalling HBAnyware Web Launch Only ....................................................... 7
Uninstalling the Utility Package ......................................................................... 7
Using the HBAnyware Components......................................................................... 8
Starting the HBAnyware Utility........................................................................... 8
Starting HBAnyware with Web Launch .............................................................. 8
Starting the HBAnyware Security Configurator .................................................. 8
Starting HBAnyware from the Command Line ................................................... 9
Examples of Modifications .................................................................... 9
The HBAnyware Utility Window Element Definitions ....................................... 10
The Menu Bar ........................................................................................... 11
The Toolbar ............................................................................................... 11
The Toolbar Buttons .................................................................................. 11
Sort Toolbar Buttons ........................................................................... 11
The Discovery-Tree................................................................................... 12
Discovery-Tree Icons .......................................................................... 12
Property Tabs............................................................................................ 13
Status Bar ................................................................................................. 13
Changing Management Mode ......................................................................... 13
Resetting HBAs ............................................................................................... 14
Discovering HBAs ........................................................................................... 14
Automatic Fibre Channel Discovery .......................................................... 14
Remote SAN Management Using TCP/IP Access Protocol....................... 15
Adding a Single Host .......................................................................... 15
Adding a Range of Hosts .................................................................... 16
Removing Hosts.................................................................................. 17
Configuring Discovery Settings ................................................................. 18
Sorting HBA Information.................................................................................. 19
Viewing Remote and Local HBAs.............................................................. 19
Viewing HBA Information................................................................................. 20
Viewing Discovery Information .................................................................. 20
Viewing Host Information .......................................................................... 21
The Host Information Tab.................................................................... 21
The Driver Parameters Tab................................................................. 22
Viewing General HBA Attributes ............................................................... 23
Viewing Detailed HBA Information ............................................................ 24
Viewing Fabric Information........................................................................ 26
Viewing Target Information........................................................................ 27
Viewing LUN Information........................................................................... 28
Masking and Unmasking LUNs (Windows, Solaris LPFC and
Solaris SFS)........................................................................................ 29
Viewing Port Statistics............................................................................... 31
Viewing Firmware Information ................................................................... 33
Viewing Target Mapping (Windows, Solaris LPFC and Solaris SFS)......... 34
Viewing Target Mapping (Linux) ................................................................ 35
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Driver Manual
Operating Systems
SPARC Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Manual
6.30g (Legacy)
Size Manual
1.6Mb
File Name
manual.pdf
Information
Note This driver is posted as is, with no new version planned.
This driver version requires patch #112438 for Solaris 8 operation.
Starting with Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
LPFC Driver for Solaris User Manual

Installation ...............................................................................................1
Driver Information .................................................................................................... 1
Supported Features........................................................................................... 1
New Features in this Release............................................................................ 1
Prerequisites ..................................................................................................... 2
For the lpfc Driver Kit .................................................................................. 2
Compatibility...................................................................................................... 2
Things to Know Before You Download .............................................................. 3
Known Issues .................................................................................................... 3
Installing the Driver Kit ............................................................................................ 3
Driver Kit Install Script Options.......................................................................... 4
Driver Kit Directory Structure ............................................................................. 4
Installing the Driver on Unsupported Linux Distributions.......................................... 5
Upgrading the Kernel or Applying a Distribution Service Pack or Update ................ 5
Installing the Driver Kit into an Upgraded Kernel ............................................... 5
Booting From a Non-Zero LUN Attached to an Emulex Adapter .............................. 6
Installing the HBAnyware Utility ............................................................................... 6
Uninstalling the Driver Kit .................................................................................. 7
Configuration ..........................................................................................8
Driver Configuration Methods Using modprobe and
/etc/modprobe.conf............................................................................................ 8
Temporary Configuration Method ................................................................ 8
Persistent Configuration Method ................................................................. 8
Temporary Driver Configuration by Read/Write to sysfs .................................... 9
Creating a New Ramdisk Image ...................................................................... 10
For Installed lpfc Driver Kits ...................................................................... 10
For Distribution In-Box lpfc Drivers............................................................ 10
Dynamically Adding LUNs and Targets............................................................ 10
Driver Parameters Reference Table ................................................................ 11
Using udev for Persistent Naming ................................................................... 15
Using udev to Discover Logical to Physical Mappings for sd Devices ....... 15
Configuring the System to Boot From SAN Using Persistent Names ........ 15
Using udev with st Devices ....................................................................... 16
Further Information About Persistent Names ............................................ 17
Working with Virtual Ports (vports)......................................................................... 18
Creating, Deleting and Displaying vports......................................................... 18
The mkvport.sh Script ............................................................................... 18
The rmvport.sh Script................................................................................ 19
The lsvport.sh Script ................................................................................. 19
The vport Sysfs Tree ....................................................................................... 19
Driver Version 8.2.8.14 sysfs Structure............................................................ 20
Vport sysfs Entries .................................................................................... 21
Vport Configuration Limits ............................................................................... 23
DHCHAP Authentication and Configuration ........................................................... 24
Authentication Configuration Parameters ........................................................ 25
Setting Remote and Local Passwords ............................................................. 25
Company
Emulex
Categories
Networks Cards
Model
Emulex LP9002S
Description
Driver Kit
Operating Systems
SPARC Solaris 8, 9 and 10 (32-bit and 64-bit)
Version Driver
6.30g (Legacy)
Size Driver
25.5Mb
File Name
solaris-4.0a37-6.30g-1b.tar
Information
This driver is posted as is, with no new version planned.
This driver version requires patch #112438 for Solaris 8 operation.
Starting with Solaris driver version 6.20, the driver no longer uses the sd.conf and st.conf files to limit the storage presented to the OS. If your environment uses these files to perform LUN or target masking, refer to the driver manual for important configuration information.
Base driver, HBAnyware utility 4.0a37, emlxdrv utility 1.00m; emlxdrv is needed for a fresh installation of Solaris 10 Update 1

HBAnyware 4.0a37 Solaris Installation Instructions

Dependencies:

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

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

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

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


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

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

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