HP-UX and Windows OS Installation Guide For HP PCIe 8Gb and 4Gb 2 Port Fibre Channel Emulex Mezzanine HBA-c02013323
HP-UX and Windows OS Installation Guide For HP PCIe 8Gb and 4Gb 2 Port Fibre Channel Emulex Mezzanine HBA-c02013323
This document contains proprietary information, which is protected by copyright. No part of this document may be photocopied, reproduced,
or translated into another language without the prior written consent of Hewlett-Packard. The information is provided “as is” without warranty
of any kind and is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty
statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not
be liable for technical or editorial errors or omissions contained herein.
Microsoft, Windows®, and Windows XP® are U.S. registered trademarks of Microsoft Corporation.
Table of Contents
About this guide.................................................................................................................7
Intended audience..................................................................................................................................7
Related documentation...........................................................................................................................7
Document conventions and symbols......................................................................................................7
Subscribers choice...................................................................................................................................8
HP technical support..............................................................................................................................8
Subscription service...........................................................................................................................8
Helpful websites................................................................................................................................8
Supported Operating Systems................................................................................................................9
Supported Server Platforms...................................................................................................................9
4 Troubleshooting............................................................................................................23
Using the Event viewer.........................................................................................................................23
Viewing the Event log...........................................................................................................................23
Accessing the Windows miniport event log codes...............................................................................23
Index.................................................................................................................................25
Table of Contents 3
List of Tables
1 HP Model numbers and Product numbers for the FC Mezzanine Emulex HBA...........................7
2 Document conventions....................................................................................................................7
3 Supported Operating Systems........................................................................................................9
4 Supported Server Platforms............................................................................................................9
3-1 Hardware path field descriptions.................................................................................................20
4 List of Tables
List of Examples
3-1 Example of the “fcmsutil /dev/fclp2” command...........................................................................18
3-2 Example of Vital Product Data (VPD) after installation...............................................................19
3-3 Example of “ioscan” report of agile (new-style) hardware path after installation (HP-UX 11i
v3 only)..........................................................................................................................................19
3-4 Example of “ioscan” report of legacy hardware path after installation .......................................19
3-5 Legacy (pre-HP-UX 11i v3) hardware path for a direct fabric attach device................................20
3-6 Hardware path for a private loop device......................................................................................20
5
6
About this guide
This guide provides information about installing, configuring, and troubleshooting the following
dual channel host bus adapters.
Table 1 HP Model numbers and Product numbers for the FC Mezzanine Emulex HBA
HP Model Number HP Product Number Description
Intended audience
This guide is intended for technical support personnel.
Related documentation
In addition to this guide, see the release notes for HP StorageWorks Emulex host bus adapters for
Windows.
These and other HP documents can be found on the HP website:
http://www.docs.hp.com
Monospace, bold font Emphasis of file and directory names, system output, code, and text
typed at the command line
Intended audience 7
WARNING! Indicates that failure to follow directions could result in bodily harm or death.
CAUTION: Indicates that failure to follow directions could result in damage to equipment or
data.
Subscribers choice
HP strongly recommends that customers sign up online using the Subscriber's choice website:
http://www.hp.com/go/e-updates.
• Subscribing to this service provides you with e-mail updates on the latest product
enhancements, newest versions of drivers, and firmware documentation updates, as well
as instant access to numerous other product resources.
• After signing up, you can quickly locate your products by selecting Business support and
then Storage under Product Category.
HP technical support
Telephone numbers for worldwide technical support are listed on the HP support website:
http://www.hp.com/support/.
Collect the following information before calling:
• Technical support registration number (if applicable)
• Product serial numbers
• Product model names and numbers
• Applicable error messages
• Operating system type and revision level
• Detailed, specific questions
For continuous quality improvement, calls may be recorded or monitored.
Subscription service
HP strongly recommends that customers register online using the Subscriber's choice website:
http://www.hp.com/go/e-updates.
Subscribing to this service provides you with e-mail updates on the latest product enhancements,
newest driver versions, and firmware documentation updates as well as instant access to
numerous other product resources.
After subscribing, you can locate your products by selecting Business support and then Storage
under Product Category.
Helpful websites
For other product information, see the following HP websites:
• http://www.hp.com
• http://www.hp.com/go/storage
8
• http://www.hp.com/support/
• http://www.docs.hp.com
Prerequisites
Perform the following tasks before you install or update the driver for your Windows server:
• Obtain a copy of the latest release notes for your HP StorageWorks Emulex HBA from the
following website:
http://h18006.www1.hp.com/storage/saninfrastructure/hba.html.
• Be familiar with the operating system under which the HBA is to operate, and have access
to standard system documentation.
• Review any restrictions or mandatory hot fixes that apply to your configuration and operating
system.
Locating and downloading the Windows Smart Component driver kit from
the website
To locate and download the driver kit from the website:
1. See http://h18006.www1.hp.com/storage/saninfrastructure/hba.html.
2. Select your server type.
3. Using the HP model # as your guide, select your HBA.
4. In the support section, select the HBA's Software and Driver link.
5. Select Download drivers and software.
6. Select your HBA.
7. Select your operating system.
8. Select the Windows Smart Component driver kit and download it to your server.
Installing the Windows device driver using the HP Smart Component kit
To install the HBA Windows drivers:
1. Obtain the latest Smart Component for your configuration and copy it to your Windows
desktop.
2. Double-click the Smart Component executable to begin the installation, and then click Install.
3. Launch the Smart Component kit CPxxxx.exe.
4. Click Install to install the driver.
5. Click Reboot to complete the installation.
6. Click Extract to extract the contents of the Smart Component.
Prerequisites 13
14
3 Installing the HP-UX Operating System Components
The following sections describe the installation instructions for HP-UX operating systems.
Prerequisites
Before installing the adapter, follow these steps:
1. Verify compliance with supported configurations using the HP Fibre Channel Host Bus Adapter
Support Matrix at:
http://docs.hp.com/en/netcom.html#Fibre%20Channel.
2. Check the following conditions:
• Verify that the /usr/bin, /usr/sbin, and /sbin directories are in the
PATH
by entering the following command:
echo $PATH
• Verify that you have the following items:
— Grounding wrist strap
— Fibre Channel driver software media (included with the OS or application CD)
• Verify that you have the following cable items:
— Fiber optic cable terminated with a duplex LC connector
— Cable map (optional)
Install all driver software and dependency patches before you install the adapter. See the
FibrChanl-02 (fclp) Fibre Channel Mass Storage Driver Release Notes available at:
http://docs.hp.com/ for details.
Use the following procedure to load the driver from a DVD-ROM:
1. Log in to the system as root.
2. Insert the DVD into the DVD drive.
3. Mount the DVD using the following command:
mount /dev/dsk/<dvd_rom_dev_file> /<tmp_mnt>
4. Run swinstall to install the software. Enter the following command:
/usr/sbin/swinstall
The Software Selection window and the Specify Source window open.
5. In the Specify Source window, change the Source Host Name if necessary. Enter the
mount point of the drive in the Source Depot Path field and click OK to return to the
Software Selection Window.
Click Help to get more information.
6. Select the appropriate software bundle for your adapter.
7. Select Mark for Install from the Actions menu.
8. Select Install from the Actions menu. Installation begins and the Install Analysis window
opens.
9. Click OK in the Install Analysis window to confirm that you want to install the software.
The Install window opens.
View the Install window to read processing data while the software installs. When the
Status field indicates Ready, the Confirmation window opens.
10. Click OK. A second Confirmation window opens.
11. Click OK again. The Install window opens.
12. Click Done. The Note window opens.
13. Click OK in the Note window to reboot. The user interface disappears and the system reboots.
14. Once the system returns to a login, log in as root and open the following files to see any
error or warning messages that may have occurred during the installation:
/var/adm/sw/swagent.log
/var/adm/sw/swinstall.log
The third column represents the hardware path of the slot that the adapter is installed. This
path will be different for each installed adapter port.
3. Observe whether the ioscan output reports the following:
fc 0/4/0/0/0/1 UNCLAIMED UNKNOWN
If reported, HP-UX detected the adapter but the fclp driver is not recognized.
4. If the correct driver is installed and the adapter is not listed in the ioscan output, contact
HP for assistance.
Vendor ID is = 0x10df
Device ID is = 0xf100
PCI Sub-system Vendor ID is = 0x103c
PCI Sub-system ID is = 0x1719
Chip version = 3
Firmware Version = 1.10A5 SLI-3 (U3F1.10A5)
EFI Version = UU6.03A7
EFI Boot = ENABLED
Driver-Firmware Dump Available = NO
Driver-Firmware Dump Timestamp = N/A
Topology = PTTOPT_FABRIC
Link Speed = 4Gb
Local N_Port_id is = 0x010400
Previous N_Port_id is = None
N_Port Node World Wide Name = 0x20000000c983c65c
N_Port Port World Wide Name = 0x10000000c983c65c
Switch Port World Wide Name = 0x200400051e074d76
Switch Node World Wide Name = 0x100000051e074d76
Driver state = ONLINE
Hardware Path is = 0/4/0/0/0/0
Maximum Frame Size = 2048
Driver Version = @(#) FCLP: PCIe Fibre Channel driver (FibrChanl-02), B.11.31.0903,
Mar 16 2008, FCLP_IFC (3,2)
This card is capable of running at bus speeds up to PCIe x8 link width. The actual link width is
displayed as the PCI Mode.
Example 3-3 Example of “ioscan” report of agile (new-style) hardware path after installation (HP-UX
11i v3 only)
ioscan -fNH 0/4/0/0/0/0
Class I H/W Path Driver S/W State H/W Type Description
=====================================================================
fc 2 0/4/0/0/0/0 fclp CLAIMED INTERFACE HP 456972-B21 8Gb PCIe 2-port LPe1205 FC Mezzanine
Adapter
tgtpath 4 0/4/0/0/0/0.0x500508b300924e81 estp CLAIMED TGT_PATH fibre_channel
target served by fclp driver, target port id 0x11200
lunpath 54 0/4/0/0/0/0.0x500508b300924e81.0x0 eslpt CLAIMED LUN_PATH LUN path for
ctl5
tgtpath 3 0/4/0/0/0/0.0x500508b300925641 estp CLAIMED TGT_PATH fibre_channel
target served by fclp driver, target port id 0x11100
lunpath 28 0/4/0/0/0/0.0x500508b300925641.0x0 eslpt CLAIMED LUN_PATH LUN path for
ctl2
lunpath 30 0/4/0/0/0/0.0x500508b300925641.0x1000000000000 eslpt CLAIMED LUN_PATH LUN path for
disk30
lunpath 53 0/4/0/0/0/0.0x500508b300925641.0x2000000000000 eslpt CLAIMED LUN_PATH LUN path for
disk54
lunpath 52 0/4/0/0/0/0.0x500508b300925641.0x3000000000000 eslpt CLAIMED LUN_PATH LUN path for
disk53
lunpath 51 0/4/0/0/0/0.0x500508b300925641.0x4000000000000 eslpt CLAIMED LUN_PATH LUN path for
disk52
lunpath 50 0/4/0/0/0/0.0x500508b300925641.0x5000000000000 eslpt CLAIMED LUN_PATH LUN path for
disk51
Example 3-4 Example of “ioscan” report of legacy hardware path after installation
# ioscan -fnH 0/4/0/0/0/0
Class I H/W Path Driver S/W State H/W Type Description
===========================================================================
fc 2 0/4/0/0/0/0 fclp CLAIMED INTERFACE HP 456972-B21 8Gb PCIe 2-port LPe1205 FC
Mezzanine Adapter
/dev/fclp2
fcp 1 0/4/0/0/0/0.1 fclp_fcp CLAIMED INTERFACE FCP Domain
ext_bus 6 0/4/0/0/0/0.1.17.0.0 fclp_vbus CLAIMED INTERFACE FCP Array Interface
target 4 0/4/0/0/0/0.1.17.0.0.0 tgt CLAIMED DEVICE
ctl 7 0/4/0/0/0/0.1.17.0.0.0.0 sctl CLAIMED DEVICE HP MSA CONTROLLER
/dev/rscsi/c6t0d0
disk 55 0/4/0/0/0/0.1.17.0.0.0.1 sdisk CLAIMED DEVICE HP MSA VOLUME
/dev/dsk/c6t0d1 /dev/rdsk/c6t0d1
disk 56 0/4/0/0/0/0.1.17.0.0.0.2 sdisk CLAIMED DEVICE HP MSA VOLUME
/dev/dsk/c6t0d2 /dev/rdsk/c6t0d2
disk 57 0/4/0/0/0/0.1.17.0.0.0.3 sdisk CLAIMED DEVICE HP MSA VOLUME
/dev/dsk/c6t0d3 /dev/rdsk/c6t0d3
disk 58 0/4/0/0/0/0.1.17.0.0.0.4 sdisk CLAIMED DEVICE HP MSA VOLUME
/dev/dsk/c6t0d4 /dev/rdsk/c6t0d4
disk 59 0/4/0/0/0/0.1.17.0.0.0.5 sdisk CLAIMED DEVICE HP MSA VOLUME
/dev/dsk/c6t0d5 /dev/rdsk/c6t0d5
Verifying connectivity
Verifying connectivity 19
Once the HP Fibre Channel Mass Storage software and hardware are installed and running, use
the following steps to verify connectivity:
1. Check the state of all Fibre Channel hardware and interfaces. Enter the ioscan command
and verify the Hardware State and the hw Interface state are CLAIMED.
If the Fibre Channel device file has not been created, enter the following commands:
# insf -e
# ioscan -f
2. Verify that all devices you have attached to the Fibre Channel adapter are listed in the
ioscan output.
If all the attached devices are listed and appear as CLAIMED, the HP Fibre Channel Mass Storage
installation is verified.
If all the attached devices are not listed or appear as CLAIMED, see the Troubleshooting and
Maintenance chapter of the HP Fibre Channel Adapters Support Guide.
NOTE: With HP-UX 11i v3, there is a new option for displaying the hardware path format
called agile (new-style) display format.
In this new display format, there are two components in the hardware path: 1) the target port
worldwide name (for example, 0x500508b300925641); and 2) the LUN ID (for example,
0x1000000000000)
To display hardware path information in the agile (new-style) format, use the N option in the
command line; for example, ioscan -fNH /0/4/0/0/0/0 .
Example 3-5 Legacy (pre-HP-UX 11i v3) hardware path for a direct fabric attach device
Area Depends on the Fibre Channel Taken from the second byte of the 0
topology of the HBA. N_Port ID of the target device.
On some switches, the second
byte of the N_POrt encodes the
switch port to the connected
device. The encoding method
depends on the switch. See your
switch manual to interpret this
field.
Port Depends on the Fibre Channel For LUNs with Peripheral Device Addressing, the value of the field
topology of the HBA, the target is always 255.
device, and the LUN addressing
method used.
For other LUN methods, the value For other LUN methods, the value
of this field is the least significant of this field is the Loop ID of the
byte of the N_Port ID of the target target device.
device.
Bus Depends on the Fibre Channel For LUNs with Peripheral Device For LUNs with Peripheral Device
topology of the HBA, the target Addressing, the value of this field Addressing, the value of this field
device, and the LUN addressing is the upper 4 bits of the least is the upper 4 bits of the Loop ID
method used. significant byte of the N_Port ID of the target device.
of the target device.
For LUNs with Logical Unit Addressing, the value is the Bus Number
field of the LUN.
For LUNs with Volume Set Addressing (Flat Space Addressing), the
value are bits 7–13 of the LUN.
Target Depends on the Fibre Channel For Luns with Peripheral Device With Peripheral Device
topology and the LUN addressing Addressing, the value of this field Addressing, the value of this field
method used. is the lower 4 bits of the third byte is the lower 4 bits of the Loop ID
of the N_Port ID of the target of the target device.
device.
This field usually corresponds to
the Arbitrated Loop Physical
Address (AL_PA_ of the target
device.
For LUNs with Logical Unit Addressing, the value id the Target field
of the LUN.
For LUNs with Volume Set Addressing (Flat Space Addressing), the
value are bits 3–6 of the LUN.
LUN Addressing Method Value of LUN field in Fibre Channel hardware path.
Peripheral Device Addressing The Target or LUN field of the Logical Unit Number.
For more information about the fields in the Logical Unit Number, see the SCSI Architechture
Model — 3 (SAM-3) standards document.
NOTE: The Emulex Storport miniport driver records error events in the Windows System Event
log. The Storport and SCSIPORT minidrivers documentation describes the event log format and
how to interpret the information in the log. Use the documentation specific to the miniport driver
that you are running.
D
driver kit, 13
drivers
installing with Smart Component, 13
lpfc, 13
E
Event viewer
using, 23
H
HP
Subscriber's choice website, 8
HP technical support, 8
I
installation
drivers, 13
installing
Windows Smart component, 13
L
log codes, miniport driver, 23
lpfc driver
installation prerequisites, 13
P
prerequisites
Windows Smart component, 13
R
related documentation, 7
S
Smart Component, 13
style conventions, 8
Subscriber's choice, HP, 8
T
troubleshooting
miniport driver event logs, 23
Windows Event viewer, 23
W
websites
HP documentation, 7
HP Subscriber's choice, 8
Windows
driver installation, 13
Event viewer, 23
Windows miniport
event log codes, 23
25