Reliable Transaction Router Version 4.1 ECO3 for OpenVMS Vax Cover Letter PRODUCT: Reliable Transaction Router Version 4.1 ECO3 for OpenVMS Vax ---------------------- APPROX BLK SIZE: 16,464 ---------------------- Problem Description ------------------- This ECO includes all corrections from RTR V4.1 ECO1. For a detailed description of the corrections, please see the RTR V4.1 ECO1 Release Notes. The following changes and corrections have been made in RTR V4.1 ECO3 for all platforms. o 14-5-304 Journal file locked by isolated RTR backend This release contains code to resolve a problem where an RTR backend, that becomes isolated from the network, can block access to its journal by other cluster members, thereby defeating RTR standby takeover. In V4.1 ECO3, this feature must be explicitly enabled through the following environment variable definition: Variable: RTR_JNL_RETAIN_MODE Value: 1 This implementation resolves the journal access conflict by shutting down RTR on the isolated node. A more complete implementation allowing for recovery from the isolation condition will be made available with a subsequent release. The following changes and corrections have been made in RTR V4.1, ECO3 for the OpenVMS platform. o 14-3-442 Extraneous TCP related RTR daemon process when running only DECnet Introduction When installing RTR the following installation output appears, (for "V4.x", x is replaced with the minor version number): DEC AXPVMS RTR V4.x: Reliable Transaction Router for OpenVMS Insert the following line in SYS$MANAGER:SYSTARTUP_VMS.COM: @sys$startup:rtr$startup.com Insert the following line in SYS$MANAGER:SYSHUTDWN.COM: @sys$manager:rtr$shutdown ________________________ Note ________________________ The following section describes P1 usage. ______________________________________________________ P1 Usage Within RTR$STARTUP.COM, the symbol RTR_PREF_PROT is used to define the preferred network protocol. The four choices are: - RTR_DNA_FIRST (DECnet first) - RTR_DNA_ONLY (DECnet only) - RTR_TCP_FIRST (TCP/IP first) - RTR_TCP_ONLY (TCP/IP only) By default the link protocol preference is: RTR_DNA_FIRST if SYS$NODE is defined (indicating DECnet is installed) RTR_TCP_ONLY if SYS$NODE is undefined (indicated DECnet is not installed) ________________________ Note ________________________ This default behavior remains unchanged and is backward compatible with previous versions of RTR. ______________________________________________________ Formerly, the RTR system manager was allowed to override the default behavior by removing the comment character (!) from the appropriate DEFINE statement within RTR$STARTUP.COM. This is no longer valid, available or supported. To override the default behavior, insert the following line in SYS$MANAGER:SYSTART_VMS.COM: @sys$startup:rtr$startup.com P1 Optional parameter P1 is one of the following values: - RTR_DNA_FIRST (DECnet first) - RTR_DNA_ONLY (DECnet only) - RTR_TCP_FIRST (TCP/IP first) - RTR_TCP_ONLY (TCP/IP only) Example: @sys$startup:rtr$startup.com RTR_TCP_FIRST Advantages 1. Previously, overriding the default behavior by modifying RTR$STARTUP.COM required the RTR system manager to change the RTR$STARTUP.COM file on each system after every RTR upgrade or install. (This was necessary because each install/upgrade created a new, unmodified copy of RTR$STARTUP.COM). Using the P1 parameter option eliminates this overhead as the required value passed into RTR$STARTUP.COM within SYS$MANAGER:SYSTARTUP_VMS.COM is left unchanged by an RTR install or upgrade. 2. RTR$SHUTDOWN.COM logic is designed to internally detect which P1 value was passed into RTR$STARTUP.COM and shuts RTR down accordingly. 3. In the unlikely circumstances where RTR$SHUTDOWN.COM cannot properly detect the preferred protocol preference value of RTR_PREF_PROT (passed to P1 during RTR startup) the RTR system manager can explicitly pass this value to RTR$SHUTDOWN.COM to ensure proper RTR shutdown as follows: Insert the following line in SYS$MANAGER:SYSHUTDOWN.COM: @sys$startup:rtr$shutdown.com P1 Optional parameter P1 is one of the following values: - RTR_DNA_FIRST (DECnet first) - RTR_DNA_ONLY (DECnet only) - RTR_TCP_FIRST (TCP/IP first) - RTR_TCP_ONLY (TCP/IP only) Example: @sys$startup:rtr$shutdown.com RTR_TCP_FIRST ________________________ Note ________________________ This behavior is not expected and would occur only if the symbol RTR_PREF_PROT and/or the system logical "SYS$NODE" were externally modified in a way not expected under normal and usual operating conditions. This Option is provided as a workaround to an unexpected and unlikely scenario in order to keep RTR startup and shutdown operations robust and predictable. ______________________________________________________ Bug Fix Under certain circumstances, running RTR$SHUTDOWN.COM to shut down RTR created an extraneous TCP-related RTR daemon process when running only DECnet. This behavior has been corrected along with the P1 parameter modifications. Known Problems with Workarounds ------------------------------- There are no known problems with workarounds that are specific to this platform. Installation Overview --------------------- The Reliable Transaction Router Version 4.1 ECO3 installation procedure is the same as the installation procedure for RTR Version 4.1. Refer to the Installation Guide for further information. © 2002 Compaq Information Technologies Group, L.P. Compaq, the Compaq logo, Alpha, OpenVMS, VAX, VMS, and Tru64 are trademarks of Compaq Information Technologies Group, L.P., in the U.S. and/or other countries. Microsoft, Microsoft SQL Server, Internet Explorer, MS- DOS, Visual C++, Windows, Windows 98, Windows NT, and Windows 2000 are trademarks of Microsoft Corporation in the U.S. and/or other countries. Intel is a trademark of Intel Corporation in the U.S. and/or other countries. UNIX is a trademark of The Open Group in the U.S. and/or other countries. InstallShield is a trademark of InstallShield Software Corporation in the U.S. and/or other countries. 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 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.