ECO NUMBER: VMS721_SHADOWING-V0700 PRODUCT: OpenVMS Alpha OPERATING SYSTEM V7.2-1 UPDATE PRODUCT: OpenVMS Alpha OPERATING SYSTEM V7.2-1 COVER LETTER 1 KIT NAME: VMS721_SHADOWING-V0700 2 KITS SUPERSEDED BY THIS KIT: VMS721_SHADOWING-V0600 3 KIT DEPENDENCIES: 3.1 The following remedial kit(s), or later, must be installed BEFORE installation of this, or any required kit: o VMS721_PCSI-V0100 o VMS721_UPDATE-V0100 3.2 In order to receive all the corrections listed in this kit, the following remedial kits, or later, should also be installed: VMS721_SYS-V1100 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 [SYSEXE]SHADOW_SERVER.EXE (new image) o [SYS$LDR]SYS$PLUS_SHDRIVER.EXE (new image) o [SYS$LDR]SYS$SHDRIVER.EXE (new image) -- COVER LETTER -- Page 2 18 January 2002 5 PROBLEMS ADDRESSED IN VMS721_SHADOWING-V0700 KIT o A system can experience many MountVerifcation messages occur with no apparent cause and no errors reported. There is no way to identify what is causing these messages Images Affected: - [SYS$LDR]SYS$SHDRIVER.EXE o In a multi-node cluster, some cluster members may hang when accessing a shadowset if: o The shadowset being accessed has multiple members. o All the shadowset members are local to one of the cluster nodes. o All the shadowset members are being MSCP-served by the local node to the other cluster members. o The local node goes down and remains down for at least MVTIMEOUT seconds. Images Affected: - [SYS$LDR]SYS$SHDRIVER.EXE o On multiple member shadow sets greater than 18 Gigabyte in size, if the port driver returns an SS$_DATACHECK for a IO$_WRITEPBLK, the wrong LBNs will be written by the shadowing driver. This could lead to data corruption. Images Affected: - [SYS$LDR]SYS$SHDRIVER.EXE o On a stand alone system, when a virtual unit aborts, the system could crash with an INVEXCEPTN bugcheck. Images Affected: - [SYS$LDR]SYS$SHDRIVER.EXE o OPCOM will frequently display a virtual unit device, or the member device string, without any other message. This can be seen during startup if you are using a shadowed system disk, or even during the dismount of the virtual unit or the dismount of members. -- COVER LETTER -- Page 3 18 January 2002 This has been corrected so that you now will receive a complete VMS message, such as: %SHADOW-I-VOLPROC, DSA719: shadow master has changed. Dump file WILL be written if system crashes. rather than just displaying: DSA719: Images Affected: - [SYS$LDR]SYS$SHDRIVER.EXE 6 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) INSTALLATION RATING: INSTALL_1 : To be installed by all customers. 7 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_SHADOWING /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. -- COVER LETTER -- Page 4 18 January 2002 7.1 Special Installation Instructions: 7.1.1 Volume Shadowing Drivers This kit can install one of two versions of Volume Shadowing: o Standard Volume Shadowing functionality as released with Version 7.2-1 that contains remedial bug fixes. o Enhanced Volume Shadowing functionality that contains remedial bug fixes as well as new Volume Shadowing functionality. This new functionality originally shipped with ECO kit VMS721_SHADOWING-V0300, which is now included in the current VMS721_UPDATE kit. Refer to the UPDATE kit Release Notes for more information on the new functionality included in the Shadowing driver. 7.1.2 Scripting of Answers to Installation Questions During installation, this kit will ask and require user response to several questions. If you wish to automate the installation of this kit and avoid having to provide responses to these questions, you must create a DCL command procedure that includes the following definitions and commands: - $ DEFINE/SYS NO_ASK$BACKUP TRUE - $ DEFINE/SYS NO_ASK$REBOOT TRUE - $ DEFINE/SYS USE_PLUS [TRUE,FALSE] Note: Defining the logical USE_PLUS as TRUE will install the enhanced functionality Volume Shadowing driver image. Defining the logical USE_PLUS as FALSE will install the standard Volume Shadowing driver. - Add the following qualifiers to the PRODUCT INSTALL command and add that command to the DCL procedure. /PROD=DEC/BASE=AXPVMS/VER=V7.0 - De-assign the logicals assigned For example, a sample command file to install the VMS721_SHADOWING-V0700 kit would be: $ $ DEFINE/SYS NO_ASK$BACKUP TRUE -- COVER LETTER -- Page 5 18 January 2002 $ DEFINE/SYS NO_ASK$REBOOT TRUE $ DEFINE/SYS USE_PLUS TRUE $! $ PROD INSTALL VMS721_SHADOWING/PROD=DEC/BASE=AXPVMS/VER=V7.0 $! $ DEASSIGN/SYS NO_ASK$BACKUP $ DEASSIGN/SYS NO_ASK$REBOOT $ DEASSIGN/SYS USE_PLUS $! $ exit Copyright (c) Compaq Computer Corporation, 2002 All Rights Reserved. Unpublished rights reserved under the copyright laws of the United States. COMPAQ, the Compaq logo, VAX, Alpha, VMS, and OpenVMS are registered in the U.S. Patent and Trademark Office. All other product names mentioned herein may be trademarks of their respective companies. Confidential computer software. Valid license from Compaq 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. Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is provided as is without warranty of any kind and is subject to change without notice. The warranties for Compaq products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty. 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.