FibrChanl-01 (fcd) Fibre Channel Mass Storage Driver

FibrChanl-01 (fcd) Fibre Channel Mass
Storage Driver for HP-UX 11i v2 release
notes
Version Number B.11.23.1009
HP Part Number: 5900-0901
Published: September 2010
Edition: 8.0
Legal Notices
© Copyright 2010 Hewlett-Packard Development Company, L.P.
Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial
Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under
vendor’s standard commercial license.
The information contained herein 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 here should be construed as constituting an additional warranty. HP
shall not be liable for technical or editorial errors or omissions contained herein.
Table of Contents
FibrChanl-01 (fcd) Fibre Channel Mass Storage Driver for HP-UX 11i v2 Overview...........................5
New and Changed Features in This Release..........................................................................................5
Defect Fixes.............................................................................................................................................5
Driver Versions.......................................................................................................................................8
Known Problems and Limitations..........................................................................................................9
Compatibility and Installation Requirements......................................................................................11
Operating System and Version Compatibility................................................................................11
Requirements for Boot Support: AD193A/AD194A, 403619–B21, AD300A, AB378A, AB378B,
AB379A, AB379B. A6826A. A9782A, A9784A, AB465A............................................................11
Hardware Requirements.................................................................................................................12
Related Information..............................................................................................................................12
Software Availability in Native Languages..........................................................................................12
Table of Contents
3
List of Tables
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
4
HP-UX 11i v2 September 2010 Application Release (AR1009)Fixes...............................................5
HP-UX 11i v2 March 2010 (WEB1003)Fixes....................................................................................5
HP-UX 11i v2 November 2009 Fixes...............................................................................................5
HP-UX 11i v2 September 2009 Fixes...............................................................................................5
HP-UX 11i v2 March 2009 Fixes......................................................................................................5
HP-UX 11i v2 November 2008 Fixes...............................................................................................6
HP-UX 11i v2 September 2008 Fixes...............................................................................................6
HP-UX 11i v2 July 2008 Fixes..........................................................................................................6
HP-UX 11i v2 December 2007 Fixes................................................................................................6
HP-UX 11i v2 September 2007 Fixes...............................................................................................6
HP-UX 11i v2 April 2007 Fixes........................................................................................................6
HP-UX 11i v2 December 2006 Fixes................................................................................................7
HP-UX 11i v2 September 2006 Fixes...............................................................................................7
HP-UX 11i v2 June 2006 Fixes.........................................................................................................7
HP-UX 11i v2 December 2005 Fixes................................................................................................7
HP-UX 11i v2 March 2005 Fixes......................................................................................................7
HP-UX 11i v2 September 2004 Fixes...............................................................................................8
FibrChanl-01 (fcd) Driver Version History.....................................................................................9
Recommended Firmware Versions (March 2010 or later)...........................................................11
List of Tables
This document provides information about the B.11.23.1009 release of the FibrChanl-01 (fcd)
Fibre Channel Mass Storage Driver for HP-UX 11i v2.
FibrChanl-01 (fcd) Fibre Channel Mass Storage Driver for HP-UX 11i v2
Overview
This release of the FibrChanl-01 (fcd) Fibre Channel Mass Storage Driver for HP-UX 11i v2
(version B.11.23.1009) provides fixes for defects listed in Table 1.
New and Changed Features in This Release
There are no new features with this release.
Defect Fixes
This section lists the defects fixed in the FibrChanl-01 (fcd) Fibre Channel Mass Storage Driver
for HP-UX 11i v2. Each table describes the defects fixed for a release. To view the entire details
of each defect fix, refer to the HP IT Resource Center at: http://forums1.itrc.hp.com/service/forums/
home.do
Table 1 HP-UX 11i v2 September 2010 Application Release (AR1009)Fixes
Defect ID
QXCR1001021143
Description
The fcmsutil fails to update the ROM firmware for the 4Gb Qlogic card if the ROM
firmware version is 5 or greater. This issue is fixed.
Table 2 HP-UX 11i v2 March 2010 (WEB1003)Fixes
Defect ID
Description
QXCR1000989456
On a single-cpu vpar configuration when you execute the command fcmsutil
ns_query_port, the system throws a safety timer panic.
QXCR1000998430
Under certain circumstances the current FCD driver logic computes and writes the checksum
incorrectly. As a result, the FCD driver can potentially corrupt the card's NVRAM content.
The NVRAM content is corrupted if the OS Boot Mode is set to the default mode, that is,
the Windows/Linux/Other mode.
Table 3 HP-UX 11i v2 November 2009 Fixes
Defect ID
QXCR1000981981
Description
On HP-UX 11i v2, FibrChannel-01 bundle version 11.23.06 and later, the SNIA
HBA_GetFcpTargetMapping() API call made on a huge storage configuration takes a
long time to respond.
Table 4 HP-UX 11i v2 September 2009 Fixes
Defect ID
QXCR1000902169
Description
SNIA to support HBA_GetEventBuffer()
Table 5 HP-UX 11i v2 March 2009 Fixes
Defect ID
QXCR1000788939
Description
The command /usr/sbin/ioscan -fnC disk displays NO_HW state for a LUN when
a volume group is activated on that LUN.
FibrChanl-01 (fcd) Fibre Channel Mass Storage Driver for HP-UX 11i v2 Overview
5
Table 6 HP-UX 11i v2 November 2008 Fixes
Defect ID
QXCR1000862281
Description
The call to SNIA API HBA_GetFcpTargetMapping()from within an application creates
defunct processes i.e. processes do not get terminated when application terminates. This
has been fixed in 11i v2, in SNIA vendor library for FCD driver.
Table 7 HP-UX 11i v2 September 2008 Fixes
Defect ID
Description
QXCR1000824321
SNIA HBA Library API HBA_GetFcpTargetMapping() is taking longer time to obtain
the FCP target mapping details if the hosts have many LUN's in NO_HW state. Fix has been
done to ignore the LUN's in NO_HW state from further processing.
QXCR1000818755
The sfp option is missing in fcddiag command. The sfp option which displays diagnostics
information from the card optical transceiver is added to /opt/fcms/bin/fcddiag
command.
Table 8 HP-UX 11i v2 July 2008 Fixes
Defect ID
QXCR1000824321
Description
SNIA HBA Library API HBA_GetFcpTargetMapping() is taking longer time to obtain
the FCP target mapping details if the hosts have many LUN's in NO_HW state. Fix has been
done to ignore the LUN's in NO_HW state from further processing.
Table 9 HP-UX 11i v2 December 2007 Fixes
Defect ID
Description
CR: JAGag48556
fcd driver fails HBA initialization, when WEL bit is set in the NVRAM status register.
CR: JAGag41528
Fixed an out-of-bounds array reference in the fcd SNIA library that caused core dumps.
Fixed an infinite loop condition in the fcd SNIA library.
Table 10 HP-UX 11i v2 September 2007 Fixes
Defect ID
Description
SR: 8606487612
Fixed fcmsutil to accept the multiboot image with embedded firmware for flashing.
SR: 8606483960
Panic due to cdio list getting corrupted
Table 11 HP-UX 11i v2 April 2007 Fixes
Defect ID
6
Description
SR: 8606468464
Fixed a problem where the system hung with an STK 9940B tape drive, when connected to
a 4 Gb card.
SR: 8606467276
Fixed a problem by removing an unwanted diagnostics message for initiator ports, Device
disappeared from Name Server GPN_FT.
SR: 8606472417
Fixed a problem where a path failover was seen with a split cable disconnection from switch
Rx.
SR: 8606475031
Fixed an ioscan hang which occured when a switch assigned the same domain and area
(part of Nport ID) to the HBA and a target device.
SR: 8606463837
Fixed a problem where fcddiag and fcdlist were saving results in /tmp, instead of in /opt/
fcms/debug (for root users only).
Table 12 HP-UX 11i v2 December 2006 Fixes
Defect ID
Description
SR: 8606456492
Fixed a problem which caused unexpected data to be displayed when the fcmsutil
read_cr option is used with 2 Gb fibre channel HBAs.
SR: 8606449173
Fixed a problem in which firmware reports a fatal error was detected on 4 Gb fibre channel
HBAs.
SR: 8606454863
Fixed a problem in which the fcd driver reports a “Mailbox 0x69 Timeout.”
SR: 8606450588
Fixed a problem in which firmware sometimes fails to bring the link up after a cable
disconnect / reconnect with 2 Gb fibre channel HBAs.
Table 13 HP-UX 11i v2 September 2006 Fixes
Defect ID
Description
SR: 8606439680
Resolved a problem that could cause a system panic when attempting an online update of
the fibre channel controller's firmware or EFI driver.
SR: 8606451612
Resolved a problem that could cause a 4Gb link to come up in public loop mode rather than
fabric mode.
SR: 8606447218
Resolved a problem that could cause a dump failure if there is a delay in obtaining the state
of the controller port.
Table 14 HP-UX 11i v2 June 2006 Fixes
Defect ID
SR: 8606440419
Description
Resolved a problem that could cause a system panic during system boot.
Table 15 HP-UX 11i v2 December 2005 Fixes
Defect ID
Description
SR: 8606413902
After installation of PHKL_30257 MO library drives in a 10-drive optical jukebox in SCC
mode are not visible any more. By changing to indexed mapping 8 devices are visible, not
all 10 drives.
SR: 8606414341
A fix was applied to work around an ISP2312 controller issue with PCI-X memory writes
when these memory writes are intermixed with partial split completions for PCI-X memory
reads.
SR: 8606414166
Concurrent BDRs issued to the same device when both BDRs failed, the application that
issued the commands hangs instead of timing out. Single BDRs repeatedly timed out due
to a timer reset issue. Both of these have been corrected by changing the way that a failed
BDR request is retried.
SR: 8606414869
A turbulent link may result in I/O hang in the fibre channel controller firmware which
triggers an I/O timeout fatal error processing in the fibre channel driver. The fibre channel
controller firmware was modified to notify the driver once when multiple unsuccessful LIP
(Loop Initialization Primitive) sequences occur. This would help the driver to flow control
the I/Os and also to abort any I/Os that are already posted to the controller firmware, if the
LIP storm persists for over 10 seconds.
Table 16 HP-UX 11i v2 March 2005 Fixes
Defect ID
Description
SR: 8606388386
DMA related changes are needed in the driver for non- HP platform support
SR: 8606388337
Data corruption with A6826A and AB465A on rx1620
SR: 8606377181
The fcd driver can now report when an unrecoverable hardware error occurs
Defect Fixes
7
Table 16 HP-UX 11i v2 March 2005 Fixes (continued)
Defect ID
Description
SR: 8606380621
Calling HBA_SendCTPassThru() with a large ReqBufferSize may cause a panic
SR: 8606381090
HBA_GetFcpTargetMapping() can affect normal access to tape
SR: 8606390263
VxVM interoperability issue with the fcd driver, due to first open time of 30 sec. or more
SR: 8606381439
Enhancement Request of fcmsutil(1M) for the A6826A PCI-X Dual Port Fibre Channel
adapter
SR: 8606382677
Uncompressed Full Dump Save Failure
SR: 8606389639
FC10 may not be detected on boot-up ioscan
SR: 8606384254
Superdome running 11.23PI with 1 TB memory could not do a full dump
SR: 8606390267
vgexport/vgimport commands hang - timeout function is needed
SR: 8606392115
“CLAIMED” message and ioscan description string should indicate HBA product number
SR: 8606391884
Incorrect information in the fcdlist man page
SR: 8606392547
set_int_delay command does not display any message when command is successful
SR: 8606392748
fcmsutil: does not check to discover if too many parameters have been given
SR: 8606395620
The vgcfgbackup command hangs with the fcd driver
SR: 8606395543
A6826A HBA is not coming online when connected to an 8 port Brocade switch
SR: 8606369480
The fcd driver is not seeing devices through the Cisco MDS 9000 family of switches
SR: 8606394349
SAN configuration changes might lead to boot failure from devices seen by the fcd driver.
Table 17 HP-UX 11i v2 September 2004 Fixes
Defect ID
Description
SR: 8606346794
SNIA HBA API GetPortStatistics() returns HBA_STATUS_ERROR
SR: 8606348536
Under heavy IO load ioscan display LUNs behind certain devices as NO_HW
SR: 8606351283
HP-UX Start-up status no longer fits on standard 80x24 console
SR: 8606356804
Miscellaneous Fixes in IO path
SR: 8606353003
Online Adapter ROM update command hangs
SR: 8606364880
File descriptor leak in SNIA API for TargetMapping and PersistentBinding
SR: 8606358270
SNIA HBA API functions may return HBA_STATUS_ERROR_UNAVAILABLE for correctly
installed HBAs; SNIA HBA API function HBA_SendCTPassThru() may hang
SR: 8606360197
Ioscan problems with FCP array using Peripheral Device Addressing lun addressing method.
SR: 8606368844
VxVM DMP interoperability problem
SR: 8606369477
FCP-2 error recovery doesn't occur following a short cable break
Driver Versions
The driver versions for each release of the FibrChanl-01 (fcd) driver:
8
Table 18 FibrChanl-01 (fcd) Driver Version History
Release
Revision
September 2010
B.11.23.1009
March 2010
B.11.23.1003.01
November 2009
B.11.23.0911
September 2009
B.11.23.0909
March 2009
B.11.23.0903
November 2008
B.11.23.0811
September 2008
B.11.23.0809
July 2008
B.11.23.0807
March 2008
B.11.23.0803
December 2007
B.11.23.08.02
September 2007
B.11.23.08.01
April 2007
B.11.23.08
December 2006
B.11.23.07
September 2006
B.11.23.06
June 2006
B.11.23.05 (64-bit)
December 2005
B.11.23.04.01 (64-bit)
March 2005
B.11.23.03 (64-bit)
September 2004
B.11.23.02 (64-bit)
Known Problems and Limitations
This section provides a list of known problems and limitations as known to HP at time of
publication. If workarounds are available, they are included.
•
EFI SEARCH Causes Boot to Fail on rx7640, rx8640, and sx2000 Superdome Server Systems
Running the SEARCH command at the EFI shell on rx7640, rx8640, and HP Integrity
Superdome/SX2000 server systems can cause the system to fail to boot through a Fibre
Channel HBA. rx7640 systems have a built-in SEARCH of slot 7. Affected 2Gb Fibre Channel
HBAs are: A6826A, A9782A, A9784A, and AB465A with EFI driver version 1.47 or earlier.
Affected 4Gb Fibre Channel HBAs are: AB378A and AB379A with EFI driver version 1.01.
The boot will fail with a message similar to the following:
Load of HP-UX
Primary Boot: 1.0.1/1/0/4/0.8.0.255.0.6.0 failed: Not Found
Corrective Action: A fix in the 2Gb/4Gb drivers has been released. The following steps will
resolve the issue:
1.
2.
3.
4.
5.
Go to www.hp.com
Click Software & Driver Downloads.
In the white text box, type the name of the I/O card, such as A6826A.
Click the >> button.
Click the Cross Operating System button.
Known Problems and Limitations
9
6.
•
Look for EFI 1.49 or later for adapters A6826A, A9782A, A9784A, and AB465A. Look
for EFI 1.05 or later for adapters AB378A and AB379A.
Configuring an Alternate Path on the Same 2–Port HBA as the Primary Path
On midrange and high end Integrity servers, if the primary and alternate boot devices are
on the same Fibre Channel HBA port, an attempt to manually boot from the alternate device
will fail.
For example, if your primary and alternate paths are set as follows:
Primary bootpath:
0/0/10/1/0/4/0.8.0.255.0.7.0
Alternate bootpath:
0/0/10/1/0/4/0.8.0.255.0.0.0
This will set the primary and alternate bootpaths, but you will only be able to boot from the
primary path.
Corrective Action:The issue can be resolved by following one of the following scenarios:
1.
2.
3.
•
From the EFI shell: Manually issue the EFI shell command reconnect —r, before
attempting to boot from the alternate path.
Online: Use the HP-UX setboot command to swap the primary and alternate boot
devices.
Hardware configuration: Reconfigure by moving the alternate boot device to a different
HBA.
Using ioscan with krm Not Running
When ioscan is run with the —fn or —Fn option, and the kernel resource monitor (krm) is
not running, there could be stale krm device files in the system, which would correspond
to different devices, including fcd, in ioscan output. This issue has no impact on the
functionality of the Fibre Channel port; however, ioscan output may be confusing. This
issue can impact any card accessible with ioscan, and is not specific to the cards supported
by the fcd driver.
Corrective Action:The ioscan output can be returned to normal by either deleting the stale
krm device files, or by starting krm, which will recreate the device files.
•
Increased Boot Time with Unconnected fcd HBA Ports
System boot time will be increased if there are unconnected fcd HBA ports (i.e., HBA ports
controlled by the fcd driver).
This happens because an ioscan is performed as a part of the boot process for HP-UX .
When an ioscan is performed for the first time for an fcd HBA port, the fcd driver waits
for 21 seconds before declaring the port offline.
This is only an issue during boot, because at boot time the HBA ports are scanned
sequentially. After boot, the HBA ports are scanned in parallel, using kernel threads.
The delay observed during boot will be around N*21 seconds, where N is the number of
unconnected fcd HBA ports.
Corrective Action:Two workarounds are available for this issue:
1.
2.
•
Attach loop back hoods to all of the unconnected HBA ports. The loop back hoods will
cause the unconnected HBA ports to come online in a private loop topology.
Install the product bundle, mtIOScan, that enables boot time kernel threads. This will
reduce the overall boot delay due to unconnected ports to 21 seconds. This product can
be obtained from www.software.hp.com
swlist Does Not Indicate the Mezzanine HBAs
swlist does not indicate the Mezzanine HBAs, and cannot be added onto because of string
size limitation.
10
Corrective Action: Refer to Hardware Requirements later in this document for more
information.
Compatibility and Installation Requirements
This section describes the compatibility information and installation requirements for this release.
For specific installation instructions, refer to the installation guide specific to your FibreChannel
card.
Operating System and Version Compatibility
The following software (or later versions) must be installed before installing the FibrChanl-01
(fcd) driver, version B.11.23.1003.01 into a system:
•
•
•
•
•
•
•
FibrChanl-00 (td) version B.11.23.03 or later (for HP-UX 11i v2 Update 3)
Product number B6191AAE, OnlineDiag bundle version B.11.23.03.xx, release in September
2004 (HWE0409)
PHKL_33827 patch or later for HP-UX 11i v2 (needed for fcmsutil (1M) support for
options set_int_delay and get_int_delay)
PHKL_36143 patch (needed for fcmsutil(1M) support for option sfp supported by 4Gb
Fibre Channel HBAs)
PHKL_31500 patch or later (needed for HP-UX 11i v2)
PHKL_31226 patch (only needed if OLAR functionality is required; applies to all cards that
have a bridge, including A9782A, A9784A, and AB465A)
PHKL_34851 (needed for HP-UX 11i v2)
Driver bundles can be downloaded from the HP Software Depot at: http://www.software.hp.com
Patches are available from either: http://www.software.hp.com or http://itresourcecenter.hp.com
OnlineDiag is available at http://www.software.hp.com in the Enhancement releases and patch
bundles section, or on the HP-UX 11i v2 OE media (September 2004 and later). Installation
instructions are available at: http://docs.hp.com/hpux/onlinedocs/diag/st/st_inst.htm
Requirements for Boot Support: AD193A/AD194A, 403619–B21, AD300A, AB378A, AB378B,
AB379A, AB379B. A6826A. A9782A, A9784A, AB465A
To boot through the fibre channel ports on these adapters, HP recommends that you update the
EFI driver and onboard firmware to the latest version. The following table lists the recommended
EFI and firmware versions at the release of FibrChanl-01 (fcd) driver, version B.11.23.1003.01 or
later:
Table 19 Recommended Firmware Versions (March 2010 or later)
Fibre Channel Adapter
EFI Driver Version
Firmware Version
AD193A/AD194A
1.05 or later
4.00.70 or later
403619–B21
1.09 or later
4.00.90 or later
AD300A
1.05 or later
4.00.70 or later
AB378A
1.05 or later
4.00.70 or later
AB378B
1.05 or later
4.00.70 or later
AB379A
1.05 or later
4.00.70 or later
AB379B
1.05 or later
4.00.70 or later
A6826A
1.49 or later
3.03.154 or later
A9782A
1.49 or later
3.03.154 or later
Compatibility and Installation Requirements
11
Table 19 Recommended Firmware Versions (March 2010 or later) (continued)
Fibre Channel Adapter
EFI Driver Version
Firmware Version
A9784A
1.49 or later
3.03.154 or later
AB465A
1.49 or later
3.03.154 or later
For current recommended firmware versions, see the HP Fibre Channel (fcd and fclp) Host Bus
Adapter Support Matrix at http://docs.hp.com/en/netcom.html#Fibre%20Channel
NOTE:
vpd
Display EFI driver and ROM firmware versions using fcmsutil <fcd_device_file>
EFI/firmware bundles can be downloaded from www.hp.com, in the Software and Driver Downloads
section.
Hardware Requirements
This version of the FibrChanl-01 (fcd) Fibre Channel Mass Storage Driver for HP-UX 11i v2 runs
on HP Integrity and HP 9000 servers with the HP-UX 11i v2 (11.23) operating system. It supports
Fibre Channel hardware products such as:
•
•
•
•
•
•
•
•
•
•
•
AD193A/AD194A PCI-X 4Gb FC and 1000BT Combination Card
403619–B21 PCIe Dual Port 4Gb Fibre Channel Adapter
AD300A PCIe Dual Port 4Gb Fibre Channel Adapter
AB378B PCI-X Single Port 4Gb Fibre Channel Adapter
AB379B PCI-X Dual Port 4Gb Fibre Channel Adapter
AB378A PCI-X Single Port 4Gb Fibre Channel Adapter
AB379A PCI-X Dual Port 4Gb Fibre Channel Adapter
AB6826A PCI-X Dual Port 2 Gb/1 Gb Fibre Channel Adapter
A9782A PCI-X 2Gb Fibre Channel and 1000Base-SX (Fiber) Gigabit Ethernet Combination
Card
A9784A PCI-X 2Gb Fibre Channel and 1000Base-T (Copper) Gigabit Ethernet Combination
Card
AB465A PCI-X Dual Port 2Gb Fibre Channel and Dual Port 1000Base-T Gigabit Ethernet
Combination Card
Related Information
The latest documentation for the FibrChanl-01 (fcd) Fibre Channel Mass Storage Driver for HP-UX
11i v2 is available at http://www.hp.com/go/hpux-iocards-docs, under the I/O Cards and Networking
Software section in the Fibre Channel category. Available documents include:
•
•
•
•
Support Guide: includes an adapter overview, installation details, adapter configuration,
troubleshooting and maintenance information, additional features, and regulatory
information.
Installation Guide: includes software and hardware installation information for specific
HBAs.
Support Matrix: includes a matrix of Fibre Channel adapters, supported hardware platforms,
operating systems, driver bundle versions, and minimum PDC/firmware requirements.
White Paper: white papers can also be found in this section.
Software Availability in Native Languages
This product is available only in the English language.
12