Professional Documents
Culture Documents
Contents
FibrChanl-01 (fcd) Fibre Channel Mass Storage Driver for HP-UX 1 v3 overview..............................3 1i New and changed features in this release...................................................................................3 New features......................................................................................................................3 Changed features................................................................................................................3 Known problems fixed in this version...........................................................................................3 Known problems and limitations.................................................................................................7 Compatibility and installation requirements................................................................................11 Operating system and version compatibility...........................................................................11 Requirements for Boot Support: 451871-B21, AH400A/AH401A, AD193A/AD194A, 403619B21, AD300A, AB378A, AB378B, AB379A, AB379B, A6826A. A9782A, A9784A, AB465A .....................................................................................................................11 Driver versions...................................................................................................................12 Hardware requirements......................................................................................................13 Related information.................................................................................................................13 Software availability in native languages...................................................................................13 Documentation feedback.........................................................................................................13
Contents
This document provides information about the B.1 1.31.1204 release of the FibrChanl-01 (fcd) Fibre Channel Mass Storage Driver for HP-UX 1 v3. 1i
FibrChanl-01 (fcd) Fibre Channel Mass Storage Driver for HP-UX 1 v3 1i overview
This release of the document for the FibrChanl-01 (fcd) Fibre Channel Mass Storage Driver for HP-UX 1 v3 (version B.1 1i 1.31.1204) documents version changes and defect fixes.
Changed features
The following feature is changed with the B.1 1.31.1204 version of the FibrChanl-01 (fcd) Fibre Channel Mass Storage Driver for HP-UX 1 v3: 1i None.
QXCR1000945642 This fixes the issue where fcd device special files are not created automatically in some rare cases after loading the fcd driver module dynamically. QXCR1001 198749 QXCR1001201543 This fixes the fcd driver init script for the issue of HPVM guest boot delays caused when there is high number of stale IO nodes present. This modifies the fcd driver init script to remove the limitation of maximum 256 fcd device specific files that can be created at boot time.
QXCR1001 196129
QXCR1001092583 This fixes the fcd driver to log an appropriate diagnostic message when a previously lost FC target device comes back online.
FibrChanl-01 (fcd) Fibre Channel Mass Storage Driver for HP-UX 1 v3 overview 1i
QXCR1001068587 fcmsutil output has been modified to display target symbolic port and node names as "None" when respective symbolic name values are not returned by the targets.
QXCR1001020559 SNIA: FC Instance Enumeration FCPortControllerCollection fails if port disabled. QXCR1001073517 QXCR1001051386 QXCR1001041080 SNIA: FC Provider dumps core during CHO test. This fixes the issue where the fcd driver does not restore the Symbolic Names to their default values when requested through scsimgr. This fixes a memory leak in the fcd driver after executing certain fcmsutil echo, test, and rls commands.
QXCR1001083355 This fixes a memory leak in the fcd driver after executing certain fcmsutil ns_query_ports commands. QXCR1001060235 This fixes the issue where the fcmsutil stat command is displaying the unneeded SBC hit counter statistic for the 2Gb Fibre Channel Adapter. QXCR1001083067 This fixes the issue where ioscan is displaying the wrong Part Number for the 4Gb Dual Port PCIe Mezzanine Fibre Channel Adapter.
QXCR1000984392 This fixes the issue where rmsf can hang when trying to delete the stale device special file on the FC port that is no longer available or waiting for a link-up. The rmsf hang can further cause subsequent hang in other commands (e.g. ioscan, olrad, network access). QXCR1000924185 This fixes the issue where the timer list in the driver is corrupted, resulting in a panic with Spinlock held too long!! QXCR1000815634 This fixes the issue where the fcmsutil utility returns the message Target port is in invalid state, when the user specifies the N_Port_ID as a parameter. QXCR1001030695 This fixes the issue where the fcd driver may panic with Bad News!, if the first open of the target failed because the link is down.
QXCR1000990675 This fixes the issue where FC-4 type devices that have disappeared from the Name Server are not logged in syslog. QXCR1001008433 This fixes the issue where FCP targets are intermittently not being seen during boot, especially on a large SAN configuration. QXCR1001012664 QXCR1001038471 This fixes the fcmsutil's flash failure issue, due to the fcd driver misinterpreting a TAG field in the Vital Product Data. SNIA does not provide speed for AH401A, so System Management Homepage (SMH) doesn't display speed for AH401A.
QXCR1000887704 This fixes an issue where the SNIA returns HBA_STATUS_ERROR for HBA_SendCTPassThru API call failure. QXCR100100701 1 This fixes a Serviceguard safety timer panic on a single-cpu vpar configuration, when the command fcmsutil_ns_query_port is executed.
QXCR1000994941 This fixes the issue in the fcd driver that can intermittently result in a mailbox timeout fatal error. QXCR1001000800 This fixes the significant drop in I/O performance encountered after installing FCD B.1 1.31.0903 and later versions.
QXCR1000979379 This fixes the issue where the fcd driver corrupts the card's NVRAM content, due to the current driver logic, which computes and writes the checksum incorrectly under certain circumstances. The NVRAM corruption issue occurs only if the OS Boot Mode is set to [Windows/Linux/Other], which is the default (i.e., manufacturing) setting. QXCR1000991234 The fcd driver may cause a system panic with a data TLB fault. This problem, due to a potential race condition, where the fcd driver receives an I/O completion interrupt from the card, while it is still processing fatal errors, has been fixed. QXCR1000934838 This fixes an issue where the fcd driver may panic during boot, when there is an 8 Gb Mezzanine HBA configured in a blade server. QXCR1000922032 This fixes the issue where SNIA does not report more than 500 luns per HBA.
QXCR1000976060 fcd panics during system dump to an EMC device. This issue, caused by sense data handling, has been fixed. QXCR1000966390 This fixes a system hang which occurred after CPU deletion. The hang was caused by interrupt migration handling in the fcd driver.
QXCR1000914828 This fixes an issue where the fcd startup script removed the volume group directory in /dev/fcd, followed by a number and vg name, such as /dev/fcd1dbvg03. QXCR1000844402 This fixes the issue where fcd converted an Illegal Request into SCTL_INCOMPLETE. The fix resolves the DS2405 open () performance issue, as well as the DS2405 firmware update failure issue.
QXCR1000876391 In HP-UX 1 v3, when you disable the legacy device-special files, the SNIA API 1i HBA_GetFcpTargetMapping() fails to report the remote targets correctly. This problem has been fixed in the SNIA vendor library for the fcd driver.
QXCR1000754446 Added Symbolic Name support. Symbolic Names are user friendly names assigned to SAN components, and registered with the name server of an FC switch. FC switches display the registered symbolic names, which can be used by users to correlate SAN components across multiple servers and storage. Display fcd controller symbolic port and node names from HP-UX: # /opt/fcms/bin/fcmsutil /dev/fcdl fcd controller symbolic port and node names are displayed as N_Port Symbolic Port Name and N_Port Symbolic Node Name.
5.
Under NVRAM Parameters section, press 1 to select Edit Adapter Settings option. 6. Press 7 to select the Connection Option. 7. Press 3 to select Loop Preferred, Otherwise Point to Point option. 8. Press 0 to go back to the previous menu. 9. Under Main Menu, press 1 to write the changes to the NVRAM. 1 10. Also under Main Menu, press 12 to quit and go back to the EFI shell. NOTE: The HP-UX 1 1iv3 AR1203 FibrChanl-01 (fcd) driver will display a warning message on detecting loop topology for HP 8Gb and 4Gb Dual Port Qlogic Mezzanine HBAs (part numbers 451871B21 and 403619B21). Refer to HP customer advisory c02985353 for details. Some PCIe I/O backplanes do not support PCIe2 (5.0 GT/s) cards on slots 3 and 4 PCIe I/O backplanes with product number AD295A #200 on rx3600, AD296A #200 on rx6600, and upgrade product number AD298A for both rx3600 and rx6600 Integrity servers, do not support PCIe2 (5.0 GT/s) cards on slots 3 and 4. PCIe2 cards will not be seen when seated in these slots. PCIe I/O backplanes with the product numbers AD295A #300, AD296A #300, and AD230A, do support PCIe2 cards on slots 3 and 4. PCIe2 cards will be seen, and will run in PCIe mode (2.5 GT/s) when seated in these slots. Both backplanes will be able to support PCIe2 cards running in PCIe mode on slots 5 and 6. To determine the installed backplane using the FRU ID: 1. Establish a telnet session with the iLO MP. 2. Logon to the iLO MP using the Admin password. 3. Type CM to enter the Command Menu. 4. Type DF to enter the Display FRU Information Menu. 5. Type S to display a list of specific FRUs. 6. Type 05 for the I/O Assembly FRU.
For AD295A #200, AD296A #200, and AD298A, the Product Name displays as: 10 Slot PCI-E IOBP For AD295A #300, AD296A #300, and AD230A, the Product Name displays as: 10 Slot PCI-E 1.1 IOBP
If a system is low on available contiguous memory, an online addition can fail The failure will be seen with messages similar to the following:
#sd10vp3 :/> olrad -A 8-0-1-5 Activity : Start of Post Add Target slot : 8-0-1-5 Addition of the card in progress... [ NOTE: Killing or otherwise aborting this olrad command may not cancel the Card Add operation. ] H/W Path Class Description ===================================================== 5/0/6/0/0/0 slot PCI Slot 5/0/6/0/0/0/0 fc PCIe SerialBus (10772532)
: ioscan failed! card not claimed : 8-0-1-5 : On line ADD failed !! Attention LED may be left in blinking state : 8-0-1-5
-------------------------------------------------------
vmunix: FCD: Allocate shared memory failed, error code = -1 vmunix: init of hardware not successful. id=10772532 and my_isc=2
Corrective action: Retry the operation at a time when the system has more free memory available. DLKM infrastructure must be installed A complete Dyamically Loadable Kernel Module (DLKM) infrastructure is required for FibrChanl-01 B.1 1.31.0803. This requires that the following kernel patches be installed:
PHKL_36387: MCA recovery/shutdown patch PHKL_36332: Cumulative GIO patch PHCO_36371: PCI OL* DLKM and Chassis Delete These patches and other required patches are delivered in the FEATURE11i patch bundle on the HP-UX 1 v3 (B.1 1i 1.31) OEUR media for September 2007. You may also check availability of the patch at the HP IT Resource Center site: http://itrc.hp.com
crashconf displays incorrect size for dump devices FibrChanl-01 now supports dump devices that are greater than 2TB in size. However, crashconf displays an incorrect size for dump devices that are greater than 4TB. Corrective action: Install patch PHCO_36550 to fix this problem. This patch is delivered in the HWEnable11i patch bundle on the HP-UX 1 v3 (B.1 1i 1.31) OEUR media for December 2007. You may also check availability of the patch at the HP IT Resource Center site: http:// itrc.hpc.om
Critical Resource Analysis (CRA) may unexpectedly fail Critical Resource Analysis (CRA) may unexpectedly fail during Online Replacement (OLR), Online Deletion (OLD), or during dynamic unload of the fcd driver module, causing a core dump. OLR occurs when performing a replacement operation with the olrad command, PCI attention button, or the System Management Homepage (SMH) on systems with this OLR feature. OLD occurs when performing a delete operation with the olrad command, or with the Systems Management Homepage (SMH) on systems with this OLD feature. A dynamic module unload can occur with kcmodule, swinstall, or swremove commands. If the CRA fails in this way during a swinstall or swremove operation, the system will automatically reboot to complete the requested operation. If the CRA fails during a kcmodule fcd=unused operation, the unload action will not occur until the system is manually rebooted. Corrective action: Install patch PHCO_36356 to fix this problem. This patch is delivered in the HWEnable11i patch bundle on the HP-UX 1 v3 (B.1 1i 1.31) OEUR media for December 2007. You may also check availability of the patch at the HP IT Resource Center site: http:// itresourcecenter.hp.com
Update to Software Distributor is required If the updated or patched Software Distributor is not in place, a necessary reboot might not be performed during installation of the I/O drivers with DLKM functionality, which includes the FibrChanl-01 product. Corrective action: On systems prior to the HP-UX 1 v3 December 2007 OEUR, you must 1i install Software Distributor patch PHCO_36530, or install the B.1 1.31.0709.308 or later revision of the Software Distributor product from http://docs.hp.com/en/SD
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
Known problems and limitations 9
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. Go to www.hp.com 2. Click Software & Driver Downloads. 3. In the white text box, type the name of the I/O card, such as A6826A. 4. Click the >> button. 5. Click the Cross Operating System button. 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 2Port 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. From the EFI shell: Manually issue the EFI shell command reconnect r, before attempting to boot from the alternate path. 2. Online: Use the HP-UX setboot command to swap the primary and alternate boot devices. 3. 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. swlist does not indicate the mezzanine HBAs swlist does not indicate the Mezzanine HBAs, and cannot be added onto because of string size limitation. Corrective action: Refer to Hardware Requirements later in this document for more information.
10
Requirements for Boot Support: 451871-B21, AH400A/AH401A, AD193A/AD194A, 403619B21, 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.1 1.31.1204: Table 17 Recommended firmware versions (September 201 1)
Fibre channel adapter 451871-B21 AH400A/AH401A AD193A/AD194A 403619-B21 403619-B21 (with VC-FC boot 2.15 or later 4.04.04 or later support in BL860c) AD300A AB378A AB378B AB379A AB379B EFI driver version 2.20 or later 2.20 or later 2.20 or later 2.20 or later 2.20 or later Firmware version 5.03.02 or later 5.03.02 or later 5.03.02 or later 5.03.02 or later 5.03.02 or later
2.20 or later 2.15 or later 2.20 or later 2.15 or later 2.20 or later
5.03.02 or later 4.04.04 or later 5.03.02 or later 4.04.04 or later 5.03.02 or later
1 1
For current recommended firmware versions, see the HP-UX Fibre Channel (fcd and fclp) Host Bus Adapter Support Matrix at http://www.hp.com/go/hpux-iocards-docs . 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.
Driver versions
The following table lists all the driver versions of the fcd driver on HP-UX 1 v3 with their associated 1i release names and dates. Table 18 Table of Driver Versions
Release Name Initial 1 1.31 Support Application Release 0709 Application Release 0803 Application Release 0809 Application Release 0903 Application Release 0909 Application Release 1003 Web Release 1003 Web Release 1005 Application Release 1009 Application Release 1 103 Web Release 1 105 Application Release 1 109 Application Release 1203 Web Release 1203 Web Release 1204 Driver Version B.1 1.31 B.1 1.31.0709 B.1 1.31.0803 B.1 1.31.0809 B.1 1.31.0903 B.1 1.31.0909 B.1 1.31.1003 B.1 1.31.1003.01 B.1 1.31.1005 B.1 1.31.1009 B.1 1.31.1 103 B.1 1.31.1 105 B.1 1.31.1 109.01 B.1 1.31.1203 B.1 1.31.1203.01 B.1 1.31.1204 Release Date February 2007 September 2007 March 2008 September 2008 March 2009 September 2009 March 2010 March 2010 May 2010 September 2010 March 201 1 May 201 1 September 201 1 March 2012 March 2012 April 2012
12
Hardware requirements
This version of the FibrChanl-01 (fcd) Fibre Channel Mass Storage Driver for HP-UX 1 v3 runs 1i on HP Integrity servers and HP PA servers with the HP-UX 1 v3 (1 1i 1.31) operating system. It supports Fibre Channel hardware products such as: 451871-B21 Dual Port PCIe 8 Gb Mezzanine Fibre Channel Adapter AH401A Dual Port PCIe 8Gb Fibre Channel Adapter AH400A Single Port PCIe 8Gb Fibre Channel Adapter AD193A/AD194A PCI-X 4Gb FC and 1000BT Combination Card 403619-B21 PCIe Dual Port Mezzanine 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 1 v3 is available at http://www.hp.com/go/hpux-iocards-docs, under the HP Fibre Channel 1i Host Bus Adapters section. 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.
Documentation feedback
HP is committed to providing documentation that meets your needs. To help us improve the documentation, send any errors, suggestions, or comments to Documentation Feedback (docsfeedback@hp.com). Include the document title and part number, version number, or the URL when submitting your feedback.
Related information
13