ECO NUMBER: VMS721_FIBRE_SCSI-V0400 ----------- PRODUCT: OpenVMS Alpha Operating System -------- UPDATED PRODUCT: OpenVMS Alpha Operating System 7.2-1 ---------------- APPRX BLCK SIZE: 4640 ---------------- COVER LETTER 1 KIT NAME: VMS721_FIBRE_SCSI-V0400. 2 KITS SUPERSEDED BY THIS KIT: VMS721_FIBRE_SCSI-V0300. 3 KIT DEPENDENCIES: 3.1 The following remedial kit(s) must be installed BEFORE installation of this, or any required kit: o VMS721_PCSI-V0100. o VMS721_UPDATE-V0100. o VMS721_SYS-V0900. 3.2 In order to receive all the corrections listed in this kit, the following remedial kits should also be installed: None. 4 KIT DESCRIPTION: 4.1 Version(s) of OpenVMS to which this kit may be applied: OpenVMS Alpha V7.2-1. 4.2 Files patched or replaced: o [SYS$LDR]SYS$PKADRIVER.EXE (new image) o [SYSLIB]FC$SDA.EXE (new image) o [SYSLIB]SMI$OBJSHR.EXE (new image) o [SYS$LDR]SYS$DKDRIVER.EXE (new image) o [SYS$LDR]SYS$FGEDRIVER.EXE (new image) o [SYS$LDR]SYS$GKDRIVER.EXE (new image) -- COVER LETTER -- Page 2 20 February 2001 o [SYS$LDR]SYS$MKDRIVER.EXE (new image) o [SYS$LDR]SYS$PGADRIVER.EXE (new image) o [SYS$LDR]SYS$PKCDRIVER.EXE (new image) o [SYS$LDR]SYS$PKEDRIVER.EXE (new image) o [SYS$LDR]SYS$PKJDRIVER.EXE (new image) o [SYS$LDR]SYS$PKQDRIVER.EXE (new image) o [SYS$LDR]SYS$PKSDRIVER.EXE (new image) o [SYS$LDR]SYS$PKTDRIVER.EXE (new image) o [SYS$LDR]SYS$PKWDRIVER.EXE (new image) o [SYS$LDR]SYS$PKZDRIVER.EXE (new image) o [SYSMSG]SYSMSG.EXE (new image) o [SYS$LDR]FC$GLOBALS.STB (new file) o [SYSEXE]SYS$CONFIG.DAT (new file) 5 PROBLEMS ADDRESSED IN VMS721_FIBRE_SCSI-V0400 KIT o The DEC-AXPVMS-VMS721_FIBRE_SCSI-V0300--4.PCSI kit did not include the SYS$PKADRIVER.EXE image. This image was shipped with the superseded kit, DEC-AXPVMS-VMS721_FIBRE_SCSI-V0200--4.PCSI and should have been carried forward and included in the DEC-AXPVMS-VMS721_FIBRE_SCSI-V0300--4.PCSI kit. Images Affected: - [SYS$LDR]SYS$PKADRIVER.EXE 6 PROBLEMS ADDRESSED IN VMS721_FIBRE_SCSI-V0300 KIT o PKQ_WATCHDOG would lose timed out I/Os, which would cause SHADDETINCON or SHADBOOTFAIL bugchecks or cause other system hangs. Images Affected: -- COVER LETTER -- Page 3 20 February 2001 - [SYS$LDR]SYS$PKQDRIVER.EXE o A system can crash with an INCONSTATE bug check in SYS$FGEDRIVER. See crashdump summary below: Crashdump Summary Information: ------------------------------ Bugcheck Type: INVEXCEPTN, Exception while above ASTDEL Current Process: NULL Current Image: Failing PC: FFFFFFFF.803E3560 SYS$FGEDRIVER+03560 Failing PS: 08000000.00000804 Module: SYS$FGEDRIVER (Link Date/Time: 3-SEP-2000 01:20:59.17) Offset: 00003560 Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE o A system could crash with an INCONSTATE bugcheck during an adapter reset. Crashdump Summary Information: ------------------------------ Bugcheck Type: INCONSTATE, Inconsistent I/O data base Current Image: CTM_HIGH_IO_ALPHA_32.EXE Failing PC: FFFFFFFF.9B184B8C SYS$FGEDRIVER+0AB8C Failing PS: 38000000.00000804 Module: SYS$FGEDRIVER (Link Date/Time: 19-AUG-2000 02:12:10.74) Offset: 0000AB8C Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE o A system could crash with an INVEXCEPTN at @FG$MAILBOX_ATTENTION_C+000A0. Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE o A system could crash with an INCONSTATE bug check in SYS$FGEDRIVER while performing FibreChannel I/O. Crashdump Summary Information: ------------------------------ Bugcheck Type: INCONSTATE, Inconsistent I/O data base -- COVER LETTER -- Page 4 20 February 2001 Current Process: NULL Current Image: Failing PC: FFFFFFFF.9B1187DC SYS$FGEDRIVER+087DC Failing PS: 38000000.00000804 Module: SYS$FGEDRIVER Link Date/Time: 19-AUG-2000 02:12:10.74) Offset: 000087DC Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE o Enable OpenVMS to recognize the ESL9198DLX (LVD) tape library. In PK$NEGOIATE, which is called by PK$INIT_STDT, the connection parameters were not being properly set, even though PK$SEND_COMMAND used these parameters. Images Affected: - [SYS$LDR]PKWDRIVER.EXE o Access to disks can be lost during a DRM failover. Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE o A system could crash with an INVEXCEPTN bugcheck in @SYS$DKDRIVER+B534 just after issuing a MOUNT command to a FibreChannel disk volume that has a 'Persistent reserved' set. Crashdump Summary Information: ------------------------------ Bugcheck Type: INVEXCEPTN, Exception while above ASTDEL Current Process: NULL Current Image: Failing PC: FFFFFFFF.9999B534 SYS$DKDRIVER+0B534 Failing PS: 38000000.00000804 Module: SYS$DKDRIVER (Link Date/Time: 19-AUG-2000 01:53:24.81) Offset: 0000B534 Images Affected: - [SYS$LDR]SYS$DKDRIVER.EXE - [SYS$LDR]SYS$MKDRIVER.EXE o Multipath failovers may cause "INVEXCEPTN, Exception while above ASTDEL" system crashes. -- COVER LETTER -- Page 5 20 February 2001 Images Affected: - [SYS$LDR]SYS$DKDRIVER.EXE - [SYS$LDR]SYS$MKDRIVER.EXE o The system can crash with an INCONSTATE bugcheck in SYS$PGADRIVER, if there is a change in the Fabric, such as pulling a cable on the switch. Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE o A hang can occur during boot in STACONFIG after reporting a driver is offline due to "Insufficient Non-paged Pool for INIT." Images Affected: - [SYS$LDR]SYS$PKQDRIVER.EXE o A system can crash with an INVEXCEPTN bugcheck during error processing. Images Affected: - [SYS$LDR]SYS$DKDRIVER.EXE 7 PROBLEMS ADDRESSED IN VMS721_FIBRE_SCSI-V0200 KIT o The image generation for the SMI$OBJSHR.EXE image was incorrect. This led to the new image not being installed on the system. Images Affected: - [SYSLIB]SMI$OBJSHR.EXE 8 PROBLEMS ADDRESSED IN VMS721_FIBRE_SCSI-V0100 KIT o An error is not returned when an illegal density is specified. Add the TLZ10 to the SCSI device table to ensure that accurate density checking is performed. -- COVER LETTER -- Page 6 20 February 2001 Images Affected: - [SYS$LDR]SYS$MKDRIVER.EXE o When sending an inquiry command to a device on the SCSI bus, if the phase transition timeout value is greater than 300 seconds, the SCSI class driver returns an SS$_BADPARAM error condition and aborts the IO. Images Affected: - [SYSLDR]SYS$DKDRIVER.EXE - [SYSLDR]SYS$GKDRIVER.EXE - [SYSLDR]SYS$MKDRIVER.EXE o A "canceled" write can still be done, possibly corrupting data. Images Affected: - [SYS$LDR]SYS$DKDRIVER.EXE - [SYS$LDR]SYS$PKCDRIVER.EXE - [SYS$LDR]SYS$PKEDRIVER.EXE - [SYS$LDR]SYS$PKJDRIVER.EXE - [SYS$LDR]SYS$PKQDRIVER.EXE - [SYS$LDR]SYS$PKSDRIVER.EXE - [SYS$LDR]SYS$PKTDRIVER.EXE - [SYS$LDR]SYS$PKWDRIVER.EXE - [SYS$LDR]SYS$PKZDRIVER.EXE o The FibreChannel driver executes INCONSTATE bugchecks. Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE - [SYS$LDR]FC$GLOBALS.STB - [SYSLIB]FC$SDA.EXE o During the boot sequence, if ELS requests come in after SYS$PGADRIVER has initiated the connect ULP$CONNECT sequence to the lower layer, but before the connect sequence has completed, -- COVER LETTER -- Page 7 20 February 2001 an ACCVIO system crash may occur. Images Affected: - [SYS$LDR]SYS$PGADRIVER.EXE o An INCONSTATE bugcheck occurs while booting. Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE o INCONSTATE or INVEXCEPTN bug checks can occur at boot time. Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE o The SCSI port goes offline with a fatal CNTRLR error. Images Affected: - [SYS$LDR]SYS$PKQDRIVER.EXE o Multiple errors occur when running the SYS$PKQDRIVER in the HSOF distribution media. Re-installing a SYS$PKQDRIVER older version of HSOF eliminates the problem(s). Images Affected: - [SYS$LDR]PKQDRIVER.EXE o An unnecessary mount verification when HSZ Unit Attention informational messages are received Images Affected: - [SYS$LDR]SYS$DKDRIVER.EXE o Excessive disk error counts. Images Affected: - [SYS$LDR]SYS$DKDRIVER.EXE o The following problems are being corrected: -- COVER LETTER -- Page 8 20 February 2001 o The erase page can be corrupted, causing an INCONSTATE crash. o Multiple alignment faults. o System can crash when running low on map registers. Images Affected: - [SYS$LDR]SYS$PKQDRIVER.EXE o During a boot, if the connection limit on the FibreChannel storage unit is reached, e.g., HSG80 has a limit of 64 entries, the driver configuration will fail without any error message. If the system is trying to boot from a FibreChannel disk on one of these storage devices, the whole system will hang during the boot. Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE - [SYSMSG]SYSMSG.EXE o he system may crash whenever MSCP multipath failover is used. Images Affected: - [SYS$LDR]DKDRIVER.EXE - [SYS$LDR]MKDRIVER.EXE 9 PROBLEMS ADDRESSED IN VMS721_FIBRECHAN-V0300 KIT ! o A system may hang during boot time while trying to INIT the FibreChannel adapter. Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE o Enable larger I/O transfer capacity for SYS$PGADRIVER. Images Affected: -- COVER LETTER -- Page 9 20 February 2001 - [SYS$LDR]SYS$PKADRIVER.EXE o On a large cluster that has many FibreChannel Adapters, a system may hang at boot time when the FibreChannel driver is being initialized. Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE o A system may crash on bootup with an INCONSTATE bugcheck at SYS$FGEDRIVER+0829C. Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE o A cascaded fibre switch cable pull hangs the server node in a non-functional state. If the system disk is accessed through the hung link, the system itself will eventually hang. Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE - [SYS$LDR]SYS$PKADRIVER.EXE - [SYS$LDR]FC$GLOBALS.STB - [SYSLIB]FC$SDA.EXE o An INCONSTATE crash could occur at SYS$FGEDRIVER+8400 and/or at SYS$PKADRIVER+0A208. Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE - [SYS$LDR]SYS$PKADRIVER.EXE - [SYS$LDR]FC$GLOBALS.STB - [SYSLIB]FC$SDA.EXE o A disk could hang on a Fibrechannel adapter. The FibreChannel units are hung because the link through which they are accessed is stuck in a non-functional state. If the system disk is accessed through the stuck link, the system itself will eventually hang -- COVER LETTER -- Page 10 20 February 2001 Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE - [SYS$LDR]SYS$PKADRIVER.EXE - [SYS$LDR]FC$GLOBALS.STB - [SYSLIB]FC$SDA.EXE o An INVEXCEPTN can occur at SYS$FGEDRIVER+0722. Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE - [SYS$LDR]SYS$PKADRIVER.EXE - [SYS$LDR]FC$GLOBALS.STB - [SYSLIB]FC$SDA.EXE o A rapid portDisable/portEnable of a fiber switch cascade causes looping PLOGIs from HSG80. This is only seen when there is some disruption to the FibreChannel link or when a stream of portDisable/portEnable commands is issued to the Brocade switch. Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE - [SYS$LDR]SYS$PKADRIVER.EXE - [SYS$LDR]FC$GLOBALS.STB - [SYSLIB]FC$SDA.EXE o A system crash occurs in SYS$FGEDRIVER at FG$FREE_UCTX. Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE - [SYS$LDR]SYS$PKADRIVER.EXE - [SYS$LDR]FC$GLOBALS.STB - [SYSLIB]FC$SDA.EXE -- COVER LETTER -- Page 11 20 February 2001 o A CPUSPINWAIT crash can occur in SYSTEM_SYNCHRONIZATION_MIN. Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE - [SYS$LDR]SYS$PKADRIVER.EXE - [SYS$LDR]FC$GLOBALS.STB - [SYSLIB]FC$SDA.EXE o Requests hang leaving no room in the request ring to issue an abort IOCB. Images Affected: - [SYS$LDR]SYS$PKADRIVER.EXE - [SYS$LDR]SYS$FGEDRIVER.EXE - [SYS$LDR]FC$GLOBALS.STB - [SYSEXE]FC$SDA.EXE o An Emulex adapter delivered interrupts for a response ring which had not been configured. This caused the driver to reference a non-existent structure indexed by ring number and resulted in an INVEXCEPTN/ACCVIO crash. Images Affected: - [SYS$LDR]SYS$PKADRIVER.EXE - [SYS$LDR]SYS$FGEDRIVER.EXE - [SYS$LDR]FC$GLOBALS.STB - [SYSEXE]FC$SDA.EXE o Batch jobs hang when doing I/O to disk operations behind HSG80 cards. Images Affected: - [SYS$LDR]SYS$PKADRIVER.EXE - [SYS$LDR]SYS$FGEDRIVER.EXE - [SYS$LDR]FC$GLOBALS.STB -- COVER LETTER -- Page 12 20 February 2001 - [SYSEXE]FC$SDA.EXE o The HSG60 card and follow-on devices were not supported. As a result, INVALID INQUIRY errors were logged. This fix adds the necessary support. Images Affected: - [SYS$LDR]SYS$DKDRIVER.EXE o Add support for the Emulex LP9000 adapter, the next generation of the Emulex FibreChannel adapter. This adapter is 100% backward compatible with the LP8000. Images Affected: - [SYS]SYS$CONFIG.DAT 10 PROBLEMS ADDRESSED IN VMS721_FIBRECHAN-V0200 KIT o This change updates the configuration file to allow the LP8000 version of the KGPSA adapter to be recognized by OpenVMS. Currently, only the LP7000 is recognized. Images Affected: - [SYSEXE]SYS$CONFIG.DAT o OpenVMS hangs if a system is booted with a loopback connector in place on an Emulex LP7000 or LP8000 adapter. Images Affected: - [SYS$LDR]SYS$PGADRIVER.EXE - [SYS$LDR]SYS$FGEDRIVER.EXE o It is possible for data corruption to occur when removing a cable or disabling a port between switches in a fabric with cascaded switches. Because the link that is disrupted has a fabric-wide scope, it is impossible to predict which hosts or devices might see the corruption. The pattern of corruption seen has usually been misplaced data, meaning that a portion of the data for a given I/O request has appeared in the correct buffer, but at the wrong offset in that buffer. -- COVER LETTER -- Page 13 20 February 2001 Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE - [SYS$LDR]SYS$PGADRIVER.EXE - [SYS$LDR]FC$GLOBALS.STB - [SYSLIB]FC$SDA.EXE o When removing a cable or disabling a port between switches in a fabric with cascaded switches, it is possible to hang a system that is doing I/O to a device in the fabric. It is actually individual I/O requests that get hung, the result of the link not transitioning to the UP state correctly. This can show up as the loss of one or more paths to a multi-path device, depending on how many links/paths are affected. In the worst case, all paths to a FibreChannel system disk will be lost, resulting in a system hang. Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE - [SYS$LDR]SYS$PGADRIVER.EXE - [SYS$LDR]FC$GLOBALS.STB - [SYSLIB]FC$SDA.EXE o A system can hang during FibreChannel configuration when a KGPSA is connected to a Pleiades-II switch. Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE - [SYS$LDR]SYS$PGADRIVER.EXE - [SYS$LDR]FC$GLOBALS.STB - [SYSLIB]FC$SDA.EXE o On a Turbolaser system, when doing large I/O transfers. (for instance running Backup or doing a shadow set copy) under a heavy I/O load, excessive Medium Offline and Mount Verify messages are seen. Mount Verification is performed often enough to have a serious impact on performance. Images Affected: -- COVER LETTER -- Page 14 20 February 2001 - [SYS$LDR]SYS$FGEDRIVER.EXE - [SYS$LDR]SYS$PGADRIVER.EXE - [SYS$LDR]FC$GLOBALS.STB - [SYSLIB]FC$SDA.EXE o It is possible to cause a DOUBLEDEALO crash on a system when removing a cable (or disabling a port) between switches in a fabric with cascaded switches. This crash can occur even if the system is idle at the time. The crash will only happen if a particular LP7000 or LP8000 sees more than 10 other ports on the fabric. The number of ports an adapter sees can be determined as follows: - There is always one NULL port - There are 2 ports on the switch to which the adapter is directly connected - There is one port for each multi-bus HSG80 port connected to the same fabric (not necessarily the same switch) - There is one port for each other FibreChannel adapter connected to the same fabric, even if these other adapters are in the same system. Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE - [SYS$LDR]SYS$PGADRIVER.EXE - [SYS$LDR]FC$GLOBALS.STB - [SYSLIB]FC$SDA.EXE o An invalid exception system crash during boot can occur on a system with an adapter which has failed initialization. Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE - [SYS$LDR]SYS$PGADRIVER.EXE - [SYS$LDR]FC$GLOBALS.STB - [SYSLIB]FC$SDA.EXE -- COVER LETTER -- Page 15 20 February 2001 11 PROBLEMS ADDRESSED IN VMS721_FIBRECHAN-V0100 KIT o A system may hang after removing a FibreChannel switch unit or disabling a FibreChannel switch port. o A system hang (single-CPU system) or a CPUSPINTWAIT crash (SMP) can occur when running a heavy I/O load to FibreChannel devices. o An INCONSTATE crash can occur after a FibreChannel link disruption, such as rebooting or power cycling the FibreChannel switch. o INCONSTATE bugcheck or corruption can occur, most often on Turbolaser, but potentially on any FibreChannel transfer which requires the use of map registers. o Machine check crashes can occur while running FibreChannel hardware. o Under heavy load, FC disks enter mount verification, then exit mount verification after a short delay. This can reduce performance, and disrupt the desired path selection. o An INVEXCPTN bugcheck may abort a mailbox FCCD, if a mailbox command happens to be active when an adapter or ring error occurs. Images Affected: - [SYS$LDR]SYS$FGEDRIVER.EXE 12 PROBLEMS ADDRESSED IN VMS721_SCSI-V0100 KIT o The system may crash with either a CPUSPINWAIT TIMEOUT bugcheck or CLUEXI. Images Affected: - [SYS$LDR]SYS$PKADRIVER.EXE 13 KIT INSTALLATION RATING: The following kit installation rating, based upon current CLD information, is provided to serve as a guide to which customers should apply this remedial kit. (Reference attached Disclaimer of Warranty and Limitation of Liability Statement) -- COVER LETTER -- Page 16 20 February 2001 INSTALLATION RATING: 1 : To be installed by all customers. 14 INSTALLATION INSTRUCTIONS: Install this kit with the POLYCENTER Software installation utility by logging into the SYSTEM account, and typing the following at the DCL prompt: PRODUCT INSTALL VMS721_FIBRE_SCSI /SOURCE=[location of Kit] The kit location may be a tape drive, CD, or a disk directory that contains the kit. Additional help on installing PCSI kits can be found by typing HELP PRODUCT INSTALL at the system prompt This kit requires a system reboot. Compaq strongly recommends that a reboot is performed immediately after kit installation to avoid system instability If you have other nodes in your OpenVMS cluster, they must also be rebooted in order to make use of the new image(s). If it is not possible or convenient to reboot the entire cluster at this time, a rolling re-boot may be performed. Copyright 2001 Compaq Computer Corporation This software is proprietary to and embodies the confidential technology of Compaq Computer Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Compaq or an authorized sublicensor. DISCLAIMER OF WARRANTY AND LIMITATION OF LIABILITY THIS PATCH IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND. ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR PARTICULAR PURPOSE, OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED TO THE EXTENT PERMITTED BY APPLICABLE LAW. IN NO EVENT WILL COMPAQ BE LIABLE FOR ANY LOST REVENUE OR PROFIT, OR FOR SPECIAL, INDIRECT, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, WITH RESPECT TO ANY PATCH MADE AVAILABLE HERE OR TO THE USE OF SUCH PATCH.