How to install fiber channel card drivers

From Wiki-UX.info
Jump to: navigation, search

Abstract[edit]

This article presents the sources of current HP-UX 11i Fibre Channel drivers as well as well as the normal procedure to update those drivers on a HP-UX 11i / 11.0 Environment. The information was last using information available at March, 2010.


Support for Fiber Channel Host Bus adapters (HBAs) is provided in three software bundles.

  • FibrChanl00 - HP PCI Tachyon TL/TS/XL2 Fibre Channel Driver
  • FibrChanl-01 - HP-UX Fibre Channel driver for QLogic-based 2Gb, 4Gb, and 8Gb FC HBAs
  • FibrChanl-02 - HP-UX Fibre Channel driver for Emulex-based FC HBAs]
NOTE: FibrChanl-01 and FibrChanl-02 bundles depends on FibrChanl-00. Always update FibrChanl-00 to the latest version before updating FibrChanl-01 or FibrChanl-02. Is advisable to update your card(s) to the latest firmware. There are several know hardware/software interoperativy issues on old firmware releases of some HBA cards that are address on latest firmware releases.


FibrChanl-00[edit]

2 Gbps Fibre Channel Adapters:

  • A6795A PCI Tachyon XL2 Fibre Channel Adapter
  • A5158A PCI Tachlite Fibre Channel Adapter
  • A6684A HSC-eff Tachlite Fibre Channel Adapter
  • A6685A HSC Tachlite Fibre Channel Adapter

HP-UX 11.0[edit]

TD driver for Fibre Channel HBA(s) (A6795A, A5158A, A6684A, A6685A) B.11.00.10

HP-UX 11.11[edit]

TD driver for Fibre Channel HBA(s) (A6795A, A5158A, A6684A, A6685A) B.11.11.19

HP-UX 11.23[edit]

TD driver for Fibre Channel HBA(s) (A6795A, A5158A) B.11.23.1003

HP-UX 11.31[edit]

TD driver for Fibre Channel HBA(s) (A6795A, A5158A) B.11.31.1003

NOTE: The HP-UX 11i and HP-UX 11i v1 Fibre Channel driver supports both HSC-based and PCI-based HBAs. The HP-UX 11i v2 and HP-UX 11i v3 Fibre Channel drivers support only the PCI-based HBAs.


FibrChanl-01[edit]

4 Gbps Fibre Channel Adapters:

  • AB378A and AB378B: PCI-X Single Port 4Gb Fibre Channel Adapter.
  • AB379A and AB379B: PCI-X Dual Port 4Gb Fibre Channel Adapter.
  • AD193A: PCI-X 4Gb Fibre Channel and 1000Base-T Ethernet Combination Card.
  • AD194A: PCI-X Dual Port 4Gb Fibre Channel and 1000Base-T Ethernet.
  • AD300A (11i v2 and v3 only): PCIe Dual Port 4 Gb Fibre Channel Adapter.
  • 403619-B21 (11i v2 and v3 only): PCIe Dual Port 4 Gb Fibre Channel Mezzanine Adapter.

2 Gbps Fibre Channel Adapters:

  • A6826A: PCI-X Dual Port 2Gb Fibre Channel Adapter.
  • A9782A: PCI-X 2Gb Fibre Channel and 1000Base-SX (Fiber) Ethernet Combination Card.
  • A9784A: PCI-X 2Gb Fibre Channel and 1000Base-T Combination Card.
  • AB465A: PCI-X Dual Port 2Gb Fibre Channel and Dual Port 1000Base-T Ethernet Combination Card.

HP-UX 11.11[edit]

FCD driver for HP-UX 11i version 1 B.11.11.15

For Installation Requirements, check [http://docs.hp.com/en/J6374-90064/J6374-90064.pdf FibrChanl-01 (fcd) Fibre Channel Mass Storage Driver for HP-UX 11i v1 Release Notes. Patches mentioned on the previous document may already been superseeded. Always check the ITRC website for latest patch versions.

NOTE: The latest Fibrechanl-01 bundle for HP-UX 11i v1 Fibrchanl-11.11.14) and prior version Fibrchanl-11.11.13 are delivered as a patch of the prior bundle Fibrchanl-11.11.12. You need to download and install first bundle Fibrchanl-11.11.12 prior to update to 11.11.14 bundle.


HP-UX 11.23[edit]

FCD driver for 11i v2 0409 or later B.11.23.0903

HP-UX 11.31[edit]

FCD driver for 11i v3 PA/IA version B.11.31.0903

FibrChanl-02[edit]

The HP-UX FibrChanl-02 (fclp) software supports the following HP products:

8 Gbps Fibre Channel Adapters:

  • AH402A (11i v3 only): PCIe Single Port 8Gb Fibre Channel Adapter.
  • AH403A (11i v3 only): PCIe Dual Port 8Gb Fibre Channel Adapter.
  • 456972-B21 (11i v3 only): LPe1205 PCIe Dual Port 8Gb Fibre Channel Mezzanine Adapter.

4 Gbps Fibre Channel Adapters:

  • AD299A (11i v2 and v3): PCIe Single Port 4Gb Fibre Channel Adapter.
  • AD355A (11i v2 and v3): PCIe Dual Port 4Gb Fibre Channel Adapter.
  • AD221A (11i v3 only): PCIe 4Gb Fibre Channel and 1000Base-T Ethernet Combination Card.
  • AD222A (11i v3 only): PCIe Dual Port 4Gb Fibre Channel and Dual Port 1000Base-T Ethernet.
  • AD393A (11i v3 only): PCIe Dual Port 4Gb Fibre Channel and Dual Port 1000SX Ethernet.
  • 403621-B21 (11i v3 only): LPe1105 PCIe Dual Port 4Gb Fibre Channel Mezzanine Adapter.

Verify the current installed drivers[edit]

To verify the driver state of the current drivers use "swlist -l fileset -a state" command.

Example:

# swlist -l fileset -a state `swlist -l bundle  | grep Fibr | awk '{print $1}'`

# Initializing...
# Contacting target "hosts"...
#
# Target:  host:/
#

# FibrChanl-00
# FibrChanl-00.FC-TACHYON-TL
  FibrChanl-00.FC-TACHYON-TL.FC-TL-KRN  configured
  FibrChanl-00.FC-TACHYON-TL.FC-TL-RUN  configured
# FibrChanl-01
# FibrChanl-01.FC-FCD
  FibrChanl-01.FC-FCD.FC-FCD-KRN        configured
  FibrChanl-01.FC-FCD.FC-FCD-RUN        configured

To verify the current version of fiberchannel drivers, you need to check the software bundle that is installed as well as the version of the drives that is attached to the card. HP provied updated versions of the drivers on the standard patch bundles, and sometimes the version installed on the bundle don't match the current kernel state.

Example:

This is a common example on the Tachyon HP Fibre Channel Tachyon TL/TS/XL2 card, where the software bundle installed is 11.11.09 but the kernel release is 11.11.12.

# /usr/sbin/swlist -l fileset | grep -i fibr
# FC-TACHYON-TL                         B.11.11.09     PCI/HSC FibreChannel;Supptd  HW=A6684A,A6685A,A5158A,A6795A
 FC-TACHYON-TL.FC-TL-KRN               B.11.11.09     Fibre Channel Tachyon TL Kernel Library
 FC-TACHYON-TL.FC-TL-RUN               B.11.11.09     Fibre Channel Tachyon TL User Space files
...
# fcmsutil /dev/td3

                           Vendor ID is = 0x00103c
                           Device ID is = 0x001028
                 TL Chip Revision No is = 2.3
            PCI Sub-system Vendor ID is = 0x00103c
                   PCI Sub-system ID is = 0x000006
                               Topology = PTTOPT_FABRIC
                     Local N_Port_id is = 0x610413
            N_Port Node World Wide Name = 0x50060b000007df21
            N_Port Port World Wide Name = 0x50060b000007df20
                           Driver state = ONLINE
                       Hardware Path is = 0/8/0/0
                 Number of Assisted IOs = 119506830
        Number of Active Login Sessions = 4
                   Dino Present on Card = NO
                     Maximum Frame Size = 960
                         Driver Version = @(#) libtd.a HP Fibre Channel Tachyon TL/TS/XL2
Driver B.11.11.12 PATCH_11.11 (PHSS_31326) /ux/kern/kisu/TL/src/common/wsio/td_glue.c: Sep  5 2005, 10:14:40

This is due because the latest HWEnable bundle (December 2006) was installed. A quick look on the kernel (/stand/vmunix) can probe the situation.

# what /stand/vmunix | grep td | grep 11.11.12
         libtd.a HP Fibre Channel Tachyon TL/TS/XL2 Driver B.11.11.12
PATCH_11.11 PHSS_31326) /ux/kern/kisu/TL/src/common/wsio/td_glue.c: Sep  5 2005, 10:14:40
4

FibreChanl-01 bundle depends on FibreChanl-00[edit]

Here is an example on the FibreChanl-01 dependency error mentioned above:

======= 08/15/08 17:42:34 MDT BEGIN install AGENT SESSION (pid=29837) 
* Agent session started for user "root@denhpdv2.directv.com <mailto:root@denhpdv2.directv.com>".
(pid=29837) 
* Beginning Analysis Phase.
* Source:
denhpdv2.directv.com:/home/awalker/FibrChanl-01_B.11.11.15_HP-UX_B.11.11_64.depot

* Target: denhpdv2:/
* Target logfile: denhpdv2:/var/adm/sw/swagent.log
* Reading source for product information.
* Reading source for file information.
The prerequisite "FC-TACHYON-TL.FC-TL-KRN,r>=B.11.11.10" for
fileset "FC-FCD.FC-FCD-KRN,r=B.11.11.15" cannot be
successfully resolved.
ERROR: The dependencies for fileset "FC-FCD.FC-FCD-KRN,r=B.11.11.15"
cannot be resolved (see previous lines).
You must resolve the above dependencies before operating on
this fileset or change the "enforce_dependencies" option to
"false".
The prerequisite "FC-TACHYON-TL.FC-TL-RUN,r>=B.11.11.10" for
fileset "FC-FCD.FC-FCD-RUN,r=B.11.11.15" cannot be
successfully resolved.
ERROR: The dependencies for fileset "FC-FCD.FC-FCD-RUN,r=B.11.11.15"
cannot be resolved (see previous lines).
You must resolve the above dependencies before operating on
this fileset or change the "enforce_dependencies" option to
"false".
* Executing preDSA command.
NOTE: Could not install the bundle "FibrChanl-01,r=B.11.11.15"
because none of its filesets could be installed. 
* Summary of Analysis Phase:
ERROR: Exclude FC-FCD.FC-FCD-KRN,r=B.11.11.15
ERROR: Exclude FC-FCD.FC-FCD-RUN,r=B.11.11.15
ERROR: 2 of 2 filesets had Errors.
ERROR: The Analysis Phase had errors. See the above output for
details. 

======= 08/15/08 18:08:20 MDT END install AGENT SESSION (Canceled)
(pid=29837)

The missing or outdated fileset is part of the FibreChanl-00 bundle, as the following command shows:

# swlist -l fileset FibrChanl-00
# Initializing...
# Contacting target "jets"...
#
# Target:  jets:/
#

# FibrChanl-00                          B.11.11.12     PCI/HSC FibreChannel;Supptd HW=A6684A,A6685A,A5158A,A6795A
# FibrChanl-00.FC-TACHYON-TL            B.11.11.12     PCI/HSC FibreChannel;Supptd HW=A6684A,A6685A,A5158A,A6795A
  FibrChanl-00.FC-TACHYON-TL.FC-TL-KRN  B.11.11.12     Fibre Channel Tachyon TL Kernel Library
  FibrChanl-00.FC-TACHYON-TL.FC-TL-RUN  B.11.11.12     Fibre Channel Tachyon TL User Space files

Verify the current FC adapter firmware[edit]

Always keep your fiber channel cards updated to the latest firmware available. The fiber channel drivers interaction often have minimum firmware version requirements and many know issues can be prevented installing the latest firmware on the cards. Check the available documentation.

# fcmsutil /dev/fcd0 vpd
                V I T A L   P R O D U C T   D A T A
                ---------   -------------   -------

 Product Description    : "HP 2Gb Fibre Channel FC/GigE-TX Combo Adapter              "

 Part number            : "A9784-60002"

 Engineering Date Code  : "A-4550"

 Part Serial number     : "PRA0613ML6"

 Misc. Information      : "PW=25W;PCI 66MHZ;PCI-X 133MHZ"

 Mfd. Date              : "4616"

 Check Sum              : 0x72

 EFI version            : "001.47               <-- Integrity Firmware version

 ROM Firmware version   : "003.003.154          <-- PA-RISC Firmware version

 Asset Tag              : "NA"

Reference[edit]

Driver downloads:

  • FibrChanl00 - HP PCI Tachyon TL/TS/XL2 Fibre Channel Driver
  • FibrChanl-01 - HP-UX Fibre Channel driver for QLogic-based 2Gb, 4Gb, and 8Gb FC HBAs
  • FibrChanl-02 - HP-UX Fibre Channel driver for Emulex-based FC HBAs]

General Information:

Support matrixes:

Updating FC HBA firmware:

Author[edit]