Reliable Transaction Router Installation Guide Order Number: AA-Q88DF-TE This guide describes how to install Reliable Transaction Router for all operating systems on which RTR is supported. Revision/Update Information: This manual supersedes the Reliable Transaction Router Installation Guide for RTR Version 3.2, and has been completely revised. Software Version: Reliable Transaction Router Version 4.
January, 2001 COMPAQ COMPUTER CORPORATION SHALL NOT BE LIABLE FOR TECHNICAL OR EDITORIAL ERRORS OR OMISSIONS CONTAINED HEREIN, NOR FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES RESULTING FROM THE FURNISHING, PERFORMANCE, OR USE OF THIS MATERIAL. THIS INFORMATION IS PROVIDED "AS IS" AND COMPAQ COMPUTER CORPORATION DISCLAIMS ANY WARRANTIES, EXPRESS, IMPLIED OR STATUTORY AND EXPRESSLY DISCLAIMS THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR PARTICULAR PURPOSE, GOOD TITLE AND AGAINST INFRINGEMENT.
Contents Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii 1 Quick Installation 1.1 1.1.1 1.1.2 1.2 1.2.1 1.3 1.3.1 1.3.2 1.3.3 1.4 1.4.1 1.4.2 1.4.3 Installing RTR for OpenVMS . . . . . . . . . . . . . Installation Procedure . . . . . . . . . . . . . . . Sample OpenVMS Installation . . . . . . . . . Installing RTR for Windows Systems . . . . . . . Installation Procedure . . . . . . . . . . . . . . .
3 Full Installation on OpenVMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.1.7 Stopping the Installation . . . . . . . . . . . . . . . . . . . . . . 5.2 Installing RTR on Compaq Tru64 UNIX . . . . . . . . . . . . . 5.2.1 Distribution Media . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.2.1.1 Using CD-ROM Consolidated Distribution Media 5.2.1.2 Using a RIS Distribution Area . . . . . . . . . . . . . . 5.2.2 Responding to Installation Procedure Prompts . . . . . 5.2.2.1 Selecting Subsets . . . . . . . . . . . . . . . . . . . . . . . . . 5.2.2.
Preface This guide explains how to install Reliable Transaction Router (RTR) on supported platforms. If you are installing RTR on only one platform, you need only read the sections that apply to that platform. Keep this guide with your distribution kit. You may need it to install maintenance updates or to reinstall RTR for any other reason.
• Chapter 5 describes a full installation for Compaq Tru64 UNIX, as an example of UNIX installation details, including: Preparing for Installation Installation procedure After installation procedures, including the Installation Verification Procedure (IVP), how to remove RTR from your system, and description of the files you need to run RTR applications. • Appendix A contains information about recovering from errors.
Conventions Table 1 describes the conventions used in this guide. Table 1 Conventions Used in this Guide Convention Meaning # A number sign ( # ) is the default superuser prompt. % A percent sign ( % ) is the default user prompt for many UNIX systems. $ A dollar sign ( $ ) is the default user prompt for OpenVMS systems. Return In examples, a boxed symbol indicates that you must press the named key on the keyboard.
Figure 1 RTR Reading Path Cover letter SPD Release Notes Getting Started Application Programmer System Manager Application Design Guide Installation Guide If V2 to V3 System Manager's Manual Migration Guide If C++ C Application Programmer's Reference Manual C++ Foundation Classes Commands Card = Tutorial ZKO-GS015-99AI x
1 Quick Installation This chapter gives brief instructions for installing Reliable Transaction Router on the following platforms: • OpenVMS • Windows 2000, Windows NT, Windows 98, Windows 95, Windows ME • Compaq Tru64 UNIX (formerly known as DIGITAL UNIX) • Sun Solaris 1.1 Installing RTR for OpenVMS Your Reliable Transaction Router for OpenVMS kit is supplied on CDROM.
Quick Installation 1.1 Installing RTR for OpenVMS 5. Start the installation with the following command: $ PRODUCT INSTALL RTR 1.1.2 Sample OpenVMS Installation $ product install rtr The following product has been selected: DEC AXPVMS RTR V4.0-0 Layered Product [Installed] Do you want to continue? [YES] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements.
Quick Installation 1.2 Installing RTR for Windows Systems 1.2 Installing RTR for Windows Systems Your Reliable Transaction Router for Windows NT, Windows 2000, Windows 95, Windows 98, or Windows ME kit is supplied on CD-ROM. After installation the Readme file is located in the directory where you installed RTR; you are advised to read the Readme file before using RTR. The installation of the RTR base product requires about five megabytes of disk space.
Quick Installation 1.3 Installing RTR for Compaq Tru64 UNIX 3. If RTR is already installed on your system, see Section 2.2.3, Uninstalling on Compaq Tru64 UNIX, for information on uninstalling RTR and removing related processes. 4. Install from the directory (disk or CD-ROM) where the kit is located, for example: # setld -l /cdrom/rtr4xx/kit Where ‘‘xx’’ is the version number, for example, rtr400. 5. Answer ‘‘1’’ and ‘‘y’’ to the questions from setld. 6.
Quick Installation 1.3 Installing RTR for Compaq Tru64 UNIX There may be more optional subsets than can be presented on a single screen. If this is the case, you can choose subsets screen by screen or all at once on the last screen. All of the choices you make will be collected for your confirmation before any subsets are installed.
Quick Installation 1.3 Installing RTR for Compaq Tru64 UNIX # # # # # # # # # # Copyright 2001 Compaq Computer Corporation. 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, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor’s standard commercial license.
Quick Installation 1.3 Installing RTR for Compaq Tru64 UNIX Would you like to abort the IVP? (y/n) n IVP continuing ... keeping any existing log file settings (RTR_DBG not set) starting RTR . . . creating a journal, if not already created . . . creating test facility . . . stopping RTR. [OPTIONAL] attempting to compile and link rtr test applications . . .
Quick Installation 1.4 Installing RTR for SunOS 1.4.1 Installation Procedure Note There are both an rtr and rtr_r (the latter is installed only on SunOS 5.6/Solaris 2.6 systems); a soft link is established to the proper one from /usr/bin/rtr. Both librtr_r.so and librtr.so are provided for both SunOS 5.5 and 5.6, in case there is a need to link your application with the threaded version, but only on SunOS 5.6 will RTR itself use librtr_r.so, thus enabling asynchronous I/O (aio) support. 1.
Quick Installation 1.4 Installing RTR for SunOS Section 1.4.3 shows an example installation of RTR for the SunOS. 1.4.2 Running the IVP The Installation Verification Procedure (IVP) requires a working C language compiler to run. Note Do not run the IVP program on a production system, as it may alter the RTR journal or interrupt processing of transactions. You will be prompted to abort the IVP before it can do any damage. Consider your situation carefully before running the IVP.
Quick Installation 1.4 Installing RTR for SunOS This package contains scripts which will be executed with super-user permission during the process of installing this package. Do you want to continue with the installation of [y,n,?] y Installing Reliable Transaction Router as ## Installing part 1 of 1. /opt/rtr/RTR400/bin/rtr /opt/rtr/RTR400/bin/rtr_r /opt/rtr/RTR400/bin/rtr_remote /opt/rtr/RTR400/bin/rtr_rqif /opt/rtr/RTR400/bin/rtr_snapshot.sh /opt/rtr/RTR400/examples/ABCBook/ABCBook.
Quick Installation 1.4 Installing RTR for SunOS /opt/rtr/RTR400/mon/app2acp.mon /opt/rtr/RTR400/mon/appdelay.mon /opt/rtr/RTR400/mon/broadcast.mon /opt/rtr/RTR400/mon/calls.mon /opt/rtr/RTR400/mon/channel.mon /opt/rtr/RTR400/mon/congest.mon /opt/rtr/RTR400/mon/connects.mon /opt/rtr/RTR400/mon/ctccalls.mon /opt/rtr/RTR400/mon/ddtm.mon /opt/rtr/RTR400/mon/downstream.mon /opt/rtr/RTR400/mon/dtx.mon /opt/rtr/RTR400/mon/dtxrec.mon /opt/rtr/RTR400/mon/event.mon /opt/rtr/RTR400/mon/facility.
Quick Installation 1.4 Installing RTR for SunOS /opt/rtr/RTR400/shlib/librtr.so /opt/rtr/RTR400/shlib/librtr_r.so /opt/rtr/RTR400/shlib/librtrapicpp.so /opt/rtr/RTR400/shlib/librtrapicpp_r.so /opt/rtr/RTR400/wbi/graphics/blank.jpg /opt/rtr/RTR400/wbi/graphics/closedfolder.gif /opt/rtr/RTR400/wbi/graphics/doc.gif /opt/rtr/RTR400/wbi/graphics/lastnode.gif /opt/rtr/RTR400/wbi/graphics/link.gif /opt/rtr/RTR400/wbi/graphics/node.gif /opt/rtr/RTR400/wbi/graphics/openfolder.
Quick Installation 1.4 Installing RTR for SunOS /opt/rtr/RTR400/wbi/rtr_main.html /opt/rtr/RTR400/wbi/rtr_modify_jou.js /opt/rtr/RTR400/wbi/rtr_monitor.js /opt/rtr/RTR400/wbi/rtr_set_btx.js /opt/rtr/RTR400/wbi/rtr_set_fac.js /opt/rtr/RTR400/wbi/rtr_set_lnk.js /opt/rtr/RTR400/wbi/rtr_set_log.js /opt/rtr/RTR400/wbi/rtr_set_par.js /opt/rtr/RTR400/wbi/rtr_trim_fac.js /opt/rtr/RTR400/wbi/smm.html /opt/rtr/RTR400/wbi/smm_contents.html /opt/rtr/RTR400/wbi/smm_contents_001.html /opt/rtr/RTR400/wbi/smm_contents_002.
Quick Installation 1.4 Installing RTR for SunOS WARNING: Result may be affected by size and contents of any existing journal. WARNING: The sample client and server do not necessarily complete if they WARNING: encounter previously journalled transactions for their facilities. NOTE: The following question is ignored in a non-interactive install NOTE:unless NONABI_SCRIPTS=TRUE, see man pkgadd for details... Would you like to abort the IVP? (y/n) IVP aborted Installation of was successful.
2 Upgrade Process To upgrade RTR, use the following process: 1. Shutdown RTR 2. Uninstall RTR 3. Install RTR 4. Run the IVP (optional) 5. Start RTR 2.1 Rolling Upgrade Restrictions Take note of the following restrictions if upgrading an RTR environment from RTR V3.2 to V4.0. The RTR recovery protocol consists of messages sent from one backend, via a router, to the target backend. If either of the RTR backends is upgraded to RTR V4.
Upgrade Process 2.1 Rolling Upgrade Restrictions For more complex configurations, where a node may have combinations of facilities with different backend/router groupings, use the command SET NODE/RECOVERY=V32 to set the recovery protocol to the V3.2 algorithm. Once RTR has been upgraded on all nodes, the recovery protocol can be reset to its default value (V4.0), and RTR restarted at a convenient time on each node. This need not be a simultaneous restart on all nodes.
Upgrade Process 2.2 Uninstalling RTR To verify that no RTR-related processes are still running on a node or cluster member, use the SHOW DEVICE/FILES command to make sure that there are no remaining SYS$SHARE:LIBRTR*.EXE shareable images. • Remove RTR from your system. $ PRODUCT REMOVE RTR 2.2.2 Uninstalling on Windows Systems You must perform the following actions before uninstalling RTR on a Windows system: • If RTR has previously been registered as a service, unregister RTR as a service.
Upgrade Process 2.2 Uninstalling RTR Control Panel -> Add/Remove Programs -> Reliable Transaction Router -> Add/Remove • Terminate all application processes linked to RTR. If you are running in a cluster configuration, you must remove RTR application processes from all the cluster members that use the disk where RTR was installed. • Remove previous versions of RTR from the disk: DEL /S/Q C:\RTR 2.2.3 Uninstalling on Compaq Tru64 UNIX Complete the following steps to uninstall RTR from your system.
Upgrade Process 2.2 Uninstalling RTR Note The last directory is user configurable, so verify its location before executing the last command. rm -rf /rtr rm -rf /rtrjnl rm -rf /usr/opt/rtr 2.2.4 Uninstalling on Sun Complete the following steps to uninstall RTR from your system.
Upgrade Process 2.
3 Full Installation on OpenVMS This chapter describes how to install Reliable Transaction Router on OpenVMS for both OpenVMS VAX and OpenVMS Alpha systems. A step-by-step description of the installation procedure is given. 3.1 Preparing for Installation Before you start the installation, complete the preparation tasks outlined in this section. 3.1.1 Accessing Release Notes To access the Reliable Transaction Router Release Notes, type the command: $ PRODUCT EXTRACT RELEASE_NOTES RTR /file=rtr_relnotes.
Full Installation on OpenVMS 3.1 Preparing for Installation Table 3–1 (Cont.) Prerequisite and Optional Software Optional Products Purpose Compaq TCP/IP Services for OpenVMS (Version 4.2 or higher) Network Transport DECnet (Version 6.2 or higher) or DECnet-Plus (Version 6.3 ECO5 or higher) Network Transport The Installation Verification Procedure (IVP) will complete successfully only if at least one of the supported network protocols (DECnet or TCP/IP) is installed.
Full Installation on OpenVMS 3.1 Preparing for Installation 3.1.4 System Parameters Installing Reliable Transaction Router for OpenVMS may mean that you have to increase some system parameter values. Table 3–3 lists the minimum free amount of global pages and global sections required for the installation. Table 3–3 System Parameter Values Used by the RTR Installation System Parameter Required Amount GBLPAGES 4000 GBLSECTIONS 4 3.
Full Installation on OpenVMS 3.2 Installation Procedure A display similar to the following appears: The following product has been selected: DEC AXPVMS RTR V4.0-0 Layered Product [Installed] Do you want to continue? [YES] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC AXPVMS RTR V4.
Full Installation on OpenVMS 3.3 After Installing RTR 3.3.1 Editing System Files You must edit the system startup and shutdown files to provide for automatic startup and the installation of Reliable Transaction Router images when your system is rebooted. Add the command line that starts Reliable Transaction Router to the system startup file, SYS$MANAGER:SYSTARTUP_VMS.COM. Reliable Transaction Router cannot start until after the network has started.
Full Installation on OpenVMS 3.3 After Installing RTR • SYSLCK In addition, the Rights Identifier RTR$INFO is required. The RTR System Manager (that is, the account that starts up RTR and creates facilities) must also have either OPER privilege or have the Rights Identifier RTR$OPERATOR. 3.
4 Full Installation on Windows NT This chapter describes a full installation on Windows NT to run RTR as a server. For information on Windows 2000 or on installing RTR for client applications on Windows 95, Windows 98, or Windows ME, see Section 1.2. The installation of the RTR base product requires about five megabytes of disk space. The installation procedure takes about two minutes to complete. 4.
Full Installation on Windows NT 4.1 Preparing for Installation • For Windows 98, Second Edition or Customer Service Pack plus the Y2K Update is recommendd. • For Windows 95, Service Release 2 plus the Y2K Update is recommended. 4.2 Installation Procedure 1. If you are installing on Windows 2000 or Windows NT, ensure that you are logged in as the Administrator, or have administrator privileges. 2. If RTR is already installed on your system, see Section 2.2.
Full Installation on Windows NT 4.2 Installation Procedure If you select Custom, the components screen appears. Choose components to install. The screen display indicates how much disk space is required for each component. Note RTR as a Service runs only on Windows NT or Windows 2000; the InstallShield does not register the service but RTR provides batch procedures to do so in the target directory. 11.
5 Full Installation on Compaq Tru64 UNIX This chapter provides descriptions of all steps in doing a full installation including: • Preparing for installation • Installing • Verifying the installation 5.1 Preparing for RTR Installation on Compaq Tru64 UNIX Before you start the installation, complete the preparation tasks outlined in this section. 5.1.1 Checking the Software Distribution Kit RTR software is distributed on CD-ROM.
Full Installation on Compaq Tru64 UNIX 5.1 Preparing for RTR Installation on Compaq Tru64 UNIX 5.1.3 Registering Your Software License RTR includes support for the License Management Facility (LMF). You must register your License Product Authorization Key (License PAK) in the License Database (LDB) in order to use RTR on a newly licensed node.
Full Installation on Compaq Tru64 UNIX 5.1 Preparing for RTR Installation on Compaq Tru64 UNIX 5.1.4.2 Checking Hardware Requirements To install RTR, you need the following hardware: • Software distribution device (if installing from media) Locate the CD-ROM drive for the CD-ROM software distribution media. The CD booklet or the documentation for the CD-ROM drive you are using explains how to load the CD-ROM media.
Full Installation on Compaq Tru64 UNIX 5.1 Preparing for RTR Installation on Compaq Tru64 UNIX Check the displayed rows for the name of the relevant subset and any related patches. The word ‘‘installed’’ appears after the subset identifier when a subset is loaded. If the word ‘‘installed’’ does not appear (the second column in a row is blank), the subset or patch is not loaded. In this case, you must load the missing Compaq Tru64 UNIX software before installing RTR.
Full Installation on Compaq Tru64 UNIX 5.1 Preparing for RTR Installation on Compaq Tru64 UNIX The display indicates that /usr (mounted to /dev/rd0g) is the only mount point that affects where RTR files will reside; the system has only one local disk drive, and the /usr/lib and file system resides in the g partition of the disk on that drive. To check the total space and the free space for the directories where RTR will reside, enter the df command.
Full Installation on Compaq Tru64 UNIX 5.1 Preparing for RTR Installation on Compaq Tru64 UNIX 3. Specify in the /etc/fstab file that one or more of the newly created directories are mount points to new disk partitions where there is additional space. 4. Enter the mount -a command so that the new mount points take effect. 5.1.5 Installing from Media or Using RIS Someone from your site must perform at least one RTR installation from the distribution medium.
Full Installation on Compaq Tru64 UNIX 5.2 Installing RTR on Compaq Tru64 UNIX 5.2 Installing RTR on Compaq Tru64 UNIX Before you start the installation, read Section 5.1, Preparing for RTR Installation on Compaq Tru64 UNIX . You can install RTR locally (using CD-ROM media) or from a server area. If you encounter any failures during installation, see Appendix A. 5.2.1 Distribution Media You can obtain Reliable Transaction Router software on CD-ROM or using RIS. 5.2.1.
Full Installation on Compaq Tru64 UNIX 5.2 Installing RTR on Compaq Tru64 UNIX The installation procedure now displays the names of RTR subsets and asks you to specify the subsets you want to load. See Section 5.2.2 to continue the installation. 5.2.1.2 Using a RIS Distribution Area If you are installing RTR subsets that reside in an /etc/ris RIS distribution area on a remote system, follow these steps: 1. Log in as superuser (login name root) to the system where you will install RTR. 2.
Full Installation on Compaq Tru64 UNIX 5.2 Installing RTR on Compaq Tru64 UNIX 1) RTR API & Management Utility Or you may choose one of the following options: 2) ALL of the above 3) CANCEL selections and redisplay menus 4) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): If you specify more than one number at the prompt, separate each number with a space, not a comma. Next, the script lets you verify your choice.
Full Installation on Compaq Tru64 UNIX 5.2 Installing RTR on Compaq Tru64 UNIX Installation completed at Mon Nov 27 15:51:23 EST 2000 When you see the ‘‘Verifying’’ message during the subset installation, the installation procedure is checking to see that the files are copied correctly; it is not an Installation Verification Procedure (IVP) message.
Full Installation on Compaq Tru64 UNIX 5.3 After Installation on Compaq Tru64 UNIX 5.3.2 Deleting RTR from Your System If you must remove a version of Reliable Transaction Router from your system, delete each subset that you previously installed. To delete subsets: 1. Log in as superuser (login name root). 2. Make sure you are at the root directory (/) by entering the following command: # cd / 3. Enter the following form of the setld command: # setld -i | grep RTRBASE 4.
A Recovering from Errors This appendix provides information to help you deal with problems that might occur during product installation or product use. If you find an error in the documentation, send an email message to the internet address on the last page of this appendix. Include the manual title, section and page numbers where the error occurred. A.1 Problems During Product Installation If errors occur during the installation, the system displays failure messages.
Recovering from Errors A.2 Problems After Installation A.2 Problems After Installation U.S. customers who encounter a problem while using Reliable Transaction Router can report it to Compaq by telephoning the Compaq Customer Support Center (CSC) at 1-800-354-9000. (Customers with service contracts can also use an electronic means such as DSNlink.) Customers without a service contract can arrange for per-call support.