HP Reliable Transaction Router________________ Installation Guide Order Number: AA-Q88DH-TE June 2005 This guide describes how to install HP Reliable Transaction Router for all operating systems on which RTR is supported. Revision/Update Information: This manual super- sedes the Reliable Transaction Router Installation Guide, Version 4.2. Software Version: HP Reliable Transaction Router Version 5.0 Hewlett-Packard Company Palo Alto, California __________________________________________________________ © Copyright 2003, 2005 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP 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. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. Microsoft and Windows are U.S. registered trademarks of Microsoft Corporation. Intel and Itanium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. UNIX is a registered trademark of The Open Group. Java is a US trademark of Sun Microsystems, Inc. This document was prepared using DECdocument, Version 3.3-1B. ________________________________________________________________ Contents Preface.................................................. vii 1 Quick Installation 1.1 Installing RTR for Linux..................... 1-1 1.1.1 Disk and Time Requirements............... 1-2 1.1.2 Installation Procedure................... 1-2 1.2 Installing RTR for OpenVMS................... 1-2 1.2.1 Disk and Time Requirements............... 1-2 1.2.2 Installation Procedure................... 1-3 1.2.2.1 Sample OpenVMS Installation............ 1-4 1.3 Installing RTR for Windows Systems........... 1-6 1.3.1 Disk and Time Requirements............... 1-6 1.3.2 Installation Procedure................... 1-6 2 Upgrade Process 2.1 Rolling Upgrade Restrictions................. 2-1 3 Full Installation on Linux Frontend 3.1 Prepare for Installation..................... 3-1 3.1.1 Check Software Distribution Kit.......... 3-1 3.1.2 Check Login Privileges................... 3-1 3.1.3 Check Required Hardware.................. 3-2 3.1.4 Check Required Software ................. 3-2 3.1.5 Check Required Disk Space................ 3-2 3.1.6 Check System Parameters.................. 3-2 3.1.6.1 Check Memory-Mapped I/O Requirements... 3-2 3.1.6.2 Check Virtual Memory Requirements...... 3-2 3.2 Install RTR.................................. 3-2 3.3 Complete RTR Setup........................... 3-4 iii 3.3.1 Check Network Availability............... 3-4 3.3.2 Check Installed Files.................... 3-4 3.3.3 Enable RTR Remote Commands............... 3-5 3.3.4 Display Documentation.................... 3-5 3.3.5 Run RTR.................................. 3-6 3.3.5.1 Configure RTR Facilities and Partitions............................. 3-6 3.3.6 Install and Run Applications............. 3-6 4 Full Installation on OpenVMS 4.1 Prepare for Installation..................... 4-1 4.1.1 Check Software Distribution Kit.......... 4-2 4.1.2 Check Login Privileges................... 4-2 4.1.3 Check Required Hardware.................. 4-2 4.1.4 Check Required Software.................. 4-2 4.1.5 Check Required Disk Space................ 4-3 4.1.6 Check System Parameters.................. 4-4 4.1.6.1 Size Global Pages and Sections Appropriately.......................... 4-4 4.1.6.2 Size Virtual Memory Appropriately...... 4-5 4.2 Install RTR.................................. 4-5 4.2.1 Installation Example..................... 4-6 4.2.2 Read Release Notes....................... 4-8 4.3 Complete RTR Setup .......................... 4-8 4.3.1 Edit System Files........................ 4-9 4.3.1.1 Establishing Protocol Preference....... 4-9 4.3.2 Verify User Account Requirements......... 4-11 4.3.2.1 Check User Account Quotas.............. 4-11 4.3.2.2 Check User Account Privileges.......... 4-11 4.3.2.3 Check System Manager Account Privileges............................. 4-12 4.3.3 Check Installed Files ................... 4-12 4.3.4 Enable RTR Remote Commands............... 4-12 4.3.5 Display CONOLD Documentation............. 4-12 4.3.6 Run RTR.................................. 4-13 4.3.6.1 Configure RTR Facilities and Partitions............................. 4-13 4.3.7 Install and Run Applications............. 4-13 iv 5 Full Installation on Windows 5.1 Prepare for Installation..................... 5-1 5.1.1 Check Software Distribution Kit.......... 5-1 5.1.2 Check Login Privileges................... 5-2 5.1.3 Check Required Hardware.................. 5-2 5.1.4 Check Required Software ................. 5-2 5.1.5 Check Required Disk Space................ 5-2 5.1.6 Check System Parameters.................. 5-2 5.1.6.1 Check Memory-Mapped I/O Requirements... 5-2 5.1.6.2 Check Virtual Memory Requirements...... 5-3 5.2 Install RTR.................................. 5-3 5.2.1 Read the Readme File..................... 5-5 5.3 Complete RTR Setup........................... 5-5 5.3.1 Check Network Availability............... 5-5 5.3.2 Check Installed Files.................... 5-5 5.3.3 Enable RTR Remote Commands............... 5-6 5.3.4 Display Documentation.................... 5-6 5.3.5 Run RTR.................................. 5-6 5.3.5.1 Configure RTR Facilities and Partitions............................. 5-7 5.3.6 Install and Run Applications............. 5-7 A Recovering from Errors A.1 Problems During Product Installation ........ A-1 A.2 Problems After Installation ................. A-2 B Uninstalling RTR B.1 Uninstalling on Linux........................ B-1 B.2 Uninstalling on OpenVMS...................... B-1 B.3 Uninstalling on Windows Systems.............. B-2 Index v Figures 1 RTR Reading Path......................... xii Tables 1 RTR Documents............................ viii 2 Conventions Used in this Guide .......... xi 4-1 Required Software........................ 4-2 4-2 Disk Space Requirements for OpenVMS...... 4-4 4-3 System Parameter Values Used by the RTR Installation............................. 4-5 4-4 RTR Protocol Preference.................. 4-9 4-5 Preferred Protocol Values................ 4-10 4-6 User Account Quotas for Using Reliable Transaction Router....................... 4-11 vi ________________________________________________________________ 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 some other reason. Structure of this Document This guide contains the following chapters and appendixes: o Chapter 1 gives brief installation instructions for RTR on Linux, OpenVMS, and Windows. For a complete list of versions for each supported operating system, refer to the relevant HP Software Product Description (SPD). The brief installation instructions include sample installation output. o Chapter 2 includes instructions on how to perform an upgrade to RTR. o Chapter 3 describes a full installation for LINUX, including: - Preparing for installation - Installing RTR and reading the Release Notes - Completing RTR setup o Chapter 4 describes a full installation for OpenVMS, including: - Preparing for installation vii - Installing RTR and reading the Release Notes - Completing RTR setup o Chapter 5 describes a full installation for Windows, including: - Preparing for installation - Installing RTR and reading the Readme - Completing RTR setup o Appendix A provides information on recovering from errors. o Appendix B provides instructions on how to remove (uninstall) RTR from your system. Related Documentation Table 1 describes RTR documents and groups them by audience. Table_1_RTR_Documents_____________________________________ Document_________________Content__________________________ For all users: HP Reliable Transaction Describes new features, Router Release Notes[1] corrections, restrictions, and known problems for RTR. HP Reliable Transaction Provides an overview of RTR Router Getting Started technology and solutions, and includes the glossary that defines all RTR terms. HP Reliable Transaction Describes product features. Router Software Product Description For the system manager: [1]Distributed_on_software_kit.___________________________ (continued on next page) viii Table_1_(Cont.)_RTR_Documents_____________________________ Document_________________Content__________________________ HP Reliable Transaction Describes how to install RTR on Router Installation all supported platforms. Guide HP Reliable Transaction Describes how to configure, Router System Manager's manage, and monitor RTR. Manual For the application programmer: HP Reliable Transaction Describes how to design Router Application application programs for use Design Guide with RTR, with both C++ and C interfaces. HP Reliable Transaction Provides an overview of the Router JRTR Getting object-oriented JRTR Toolkit Started [2] including installation, configuration and Java program- ming concepts, with links to additional online documentation. HP Reliable Transaction Describes the object-oriented Router C++ Foundation C++ interface that can be used Classes to implement RTR object-oriented applications. HP Reliable Transaction Explains how to design and code Router C Application RTR applications using the C Programmer's Reference programming language and the RTR Manual C API. Contains full descriptions of the basic RTR API calls. [2]In_downloadable_kit.___________________________________ __________________________________________________________ You can find additional information about RTR, including the Software Product Descriptions, on the RTR website found through http://www.hp.com links to middleware products or at http://www.hp.com/go/rtr . ix Reader's Comments HP welcomes your comments on this manual. Please send comments to either of the following addresses: Internet rtrdoc@hp.com Postal Hewlett-Packard Company Mail RTR Documentation Group, ZKO3-4/Y17 110 Spit Brook Rd. Nashua, NH 03062-2698 Conventions Table 2 describes the conventions used in this guide. x Table_2_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. In examples, a boxed symbol indicates that you must press the named key on the keyboard. Ctrl/C This symbol indicates that you must press the Ctrl key while you simultaneously press another key (in this case, C). user input In interactive examples, this typeface indicates input entered by the user. filesystem In text, this typeface indicates the exact name of a command, routine, partition, pathname, directory, or file. This typeface is also used in interactive examples and other screen displays. UPPERCASE The UNIX operating system differentiates lowercase between lowercase and uppercase characters. Examples, syntax descriptions, function definitions, and literal strings that appear in text must be typed exactly as shown. Commands typed to the RTR CLI are not case sensitive unless enclosed in quotation marks. [y] In a prompt, square brackets indicate that the enclosed item is the default response. For example, [y] means the default response _______________is_Yes.____________________________________ xi Reading Path The reading path to follow when using the Reliable Transaction Router information set is shown in Figure 1. xii 1 ________________________________________________________________ Quick Installation This chapter gives brief instructions for installing Reliable Transaction Router on the following platforms: o Linux o OpenVMS o Windows 2000, Windows 2003, Windows XP _____________User-Changed Monitor Files _____________ For non-Linux platforms, if you have changed any RTR monitor (*.mon) files, you must rename them or they will be overwritten during installation. To avoid this, always work from renamed copies of RTR monitor files when making local modifications. For the Linux platform, see Chapter 3. _____________________________________________________ 1.1 Installing RTR for Linux Your Reliable Transaction Router for Linux Frontend kit is supplied on CD-ROM. After installation, the Release Notes file is located in the /usr/share/doc directory; you are advised to read the Release Notes file before using RTR. _____________User-Changed Monitor Files _____________ If you have changed any RTR monitor (*.mon) files, they will automatically be renamed when using rpm to uninstall. For more information, see Chapter 3, Full Installation on Linux Frontend. _____________________________________________________ Quick Installation 1-1 Quick Installation 1.1 Installing RTR for Linux 1.1.1 Disk and Time Requirements The installation of the RTR base product requires about 22 MB (megabytes) of disk space. The installation procedure takes about two minutes to complete. 1.1.2 Installation Procedure 1. If RTR is already installed on your system, see Section B.1, Uninstalling on Linux, for information on uninstalling RTR and removing related processes. 2. To install on Linux, log in as the root user. 3. Insert the RTR CD-ROM into the drive. If Red Hat does not automatically mount your CD-ROM, you will need to mount it before proceeding to the next step. 4. CD to your CD-ROM drive. 5. The Reliable Transaction Router for Linux Frontend installs in the standard way on Red Hat systems. You may use gnorpm on Red Hat Workstation for a graphical install, or, on the command line with Red Hat 9, use rpm -i packagename.rpm as the root user. If you previously installed an RTR Linux kit, you will need to uninstall the old one before installing the new one. 1.2 Installing RTR for OpenVMS Your Reliable Transaction Router for OpenVMS kit is supplied on CD-ROM. After installation, the Release Notes are located in the directory SYS$COMMON:[SYSHLP]; you are advised to read the Release Notes before using RTR. 1.2.1 Disk and Time Requirements The installation of the RTR base product requires about 53000 blocks during installation, and about 36000 blocks after installation is done. The installation takes less than five minutes to complete. For more detailed instructions, see Chapter 4. 1-2 Quick Installation Quick Installation 1.2 Installing RTR for OpenVMS 1.2.2 Installation Procedure 1. If RTR is already installed on your system, see Section B.2, Uninstalling on OpenVMS, for information on uninstalling RTR and removing related processes. ___________Retaining the RTR V2 Help File ___________ If you plan to keep the RTR V2 help file in addition to the help file for the current release, see Chapter 4 for instructions. _____________________________________________________ _____________User-Changed Monitor Files _____________ If you have changed any RTR monitor (*.mon) files, you must rename them or they will be over-written during installation. To avoid this, always work from renamed copies of RTR monitor files when making local modifications. _____________________________________________________ 2. Log in to the System Manager's account. 3. Define the logical name for the location of the software kit, for example: $ DEFINE PCSI$SOURCE DISK1:[KITS] ____________ Installing on an ODS-5 Disk ____________ RTR can be installed on an ODS-5 disk. _____________________________________________________ 4. Check disk space and system parameters GBLPAGES and GBLSECTIONS. 5. Check OpenVMS version number. $ SHOW CLUSTER Quick Installation 1-3 Quick Installation 1.2 Installing RTR for OpenVMS ________ Minimum Required Version of OpenVMS ________ The minimum VMS version on which you can install RTR Version 5.0 is OpenVMS 7.3-2. If you attempt to install RTR Version 5.0 on an earlier version of OpenVMS, you will receive an error message of the following form: This system does not meet the RTR minimum required VMS version. The minimum required version is V7.3-2. Terminating is strongly recommended. Do you want to terminate? [YES] If you see this error message, end your attempted RTR installation and upgrade your OpenVMS system to version 7.3-2. _____________________________________________________ 6. Start the installation with the following command: $ PRODUCT INSTALL RTR 1.2.2.1 Sample OpenVMS Installation This sample installation includes running the IVP. $ product install rtr The following product has been selected: DEC AXPVMS RTR V5.0-zzz Layered Product Do you want to continue? [YES] y 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 V5.0-zzz: Reliable Transaction Router for OpenVMS © Copyright 2005 Hewlett-Packard Development Company, L.P. Do you want the defaults for all options? [YES] n 1-4 Quick Installation Quick Installation 1.2 Installing RTR for OpenVMS Have all RTR processes on the system been stopped? [YES] y Run installation verification procedure [NO] y DECnet users: Have you read the Release Note regarding minimum version? [YES] y Do you want the V2 programming kit Installed? [NO] yes Do you want to review the options? [NO] y DEC AXPVMS RTR V50-zzz: Reliable Transaction Router for OpenVMS Have all RTR processes on the system been stopped?: YES Run installation verification procedure: YES DECnet users: Have you read the Release Note regarding minimum version?: YES Do you want the V2 programming kit Installed ?: YES Are you satisified with these options? [YES] Execution phase starting ... The following product will be installed to destination: DEC AXPVMS RTR V5.0-zzz Portion done: 0% ...10% ...20% ...30% ...40% ...50% ...60% ...70% ...80% ...90% ...100% The following product has been installed: DEC AXPVMS RTR V5.0-zzz Layered Product %PCSI-I-IVPEXECUTE, executing test procedure for DEC AXPVMS RTR V5.0-zzz ... %PCSI-I-IVPSUCCESS, test procedure completed successfully DEC AXPVMS RTR V5.0-zzz: Reliable Transaction Router for OpenVMS Insert the following lines in SYS$MANAGER:SYSTARTUP_VMS.COM: @sys$startup:rtr$startup.com Insert the following lines in SYS$MANAGER:SYSHUTDWN.COM: @sys$manager:rtr$shutdown Quick Installation 1-5 Quick Installation 1.2 Installing RTR for OpenVMS See the Release Notes and documentation for use of the optional rtr$startup.com P1 parameter. 1 $ 1 For information on the optional preferred protocol (P1) parameter, see Section 4.3.1.1. For additional information, see Chapter 4. 1.3 Installing RTR for Windows Systems Your Reliable Transaction Router for Windows 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. For supported Windows systems, see the Reliable Transaction Router Software Product Description (SPD) for Windows. _____________User-Changed Monitor Files _____________ If you have changed any RTR monitor (*.mon) files, you must rename them or they will be over-written during installation. To avoid this, always work from renamed copies of RTR monitor files when making local modifications. _____________________________________________________ 1.3.1 Disk and Time Requirements The installation of the RTR base product requires about 22 MB (megabytes) of disk space. The installation procedure takes about two minutes to complete. 1.3.2 Installation Procedure 1. If RTR is already installed on your system, see Section B.3, Uninstalling on Windows Systems, for information on uninstalling RTR and removing related processes. 2. To install on Windows, log in as the Administrator or with administrator privileges. 3. Insert the RTR CD-ROM into the drive. 4. From Windows Explorer, choose the drive letter of your CD-ROM and open the directory RTRV50. 1-6 Quick Installation Quick Installation 1.3 Installing RTR for Windows Systems 5. Double click on SETUP.EXE to start the InstallShield that takes you through the setup process. Quick Installation 1-7 2 ________________________________________________________________ Upgrade Process To upgrade RTR, use the following process: 1. Shut down RTR 2. Upgrade to new version 3. Run the IVP (optional) 4. Start RTR 2.1 Rolling Upgrade Restrictions Take note of the following restrictions if upgrading an RTR environment from RTR V3.2 to Version 5.0. _________________ Migrating from V2 _________________ See Chapter 4 for how to retain the V2 help file when migrating to a later version of RTR. Refer to the Reliable Transaction Router Migration Guide for information on performing this migration. _____________________________________________________ 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 Version 5.0, then the router that will be used for recovery must also be running RTR Version 5.0. This generally means that any RTR router nodes should be upgraded to RTR Version 5.0 before any RTR backend nodes. There is no restriction in the order that RTR backends should be upgraded to Version 5.0. The order in which RTR nodes should be upgraded for a rolling upgrade from V3.2 to Version 5.0 is as follows: 1. Frontend-only nodes can be upgraded at any time Upgrade Process 2-1 Upgrade Process 2.1 Rolling Upgrade Restrictions 2. Router-only and mixed frontend/router nodes 3. Mixed router/backend nodes 4. Router-only nodes 5. Backend-only nodes 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. RTR can be restarted on each node one by one after resetting the default recovery protocol, maintaining continuous application availability. 2-2 Upgrade Process 3 ________________________________________________________________ Full Installation on Linux Frontend This chapter describes how to install HP Reliable Transaction Router on Linux Frontend systems. It includes steps for: o Preparing for installation o Installing RTR o Completing RTR setup 3.1 Prepare for Installation Before you start the installation, review the hardware and software requirements described in the following sections. _____________User-Changed Monitor Files _____________ On the Linux platform, if you have changed any RTR monitor (*.mon) files, any customized monitor files are renamed during uninstall with the extension .rpmsave. Except for such customized monitor files, uninstalling RTR removes the RTR monitor files. _____________________________________________________ 3.1.1 Check Software Distribution Kit Reliable Transaction Router is distributed on CD-ROM. Use the Bill of Materials (BOM) received with your kit to verify the contents of your software distribution kit. 3.1.2 Check Login Privileges You must be logged in as the root user to install RTR on Linux. For more information on RTR privileges, see the HP Reliable Transaction Router System Manager's Manual section on RTR Privileges. Full Installation on Linux Frontend 3-1 Full Installation on Linux Frontend 3.1 Prepare for Installation 3.1.3 Check Required Hardware o For client functionality, any Intel32 system that runs Redhat Enterprise Linux WS Version 3.0. 3.1.4 Check Required Software Required software for each system to be used with RTR: o Redhat Enterprise Linux WS Version 3.0 o TCP/IP support as provided by the operating system o At least one Reliable Transaction Router Backend li- cense for a supported operating system for development and application deployment 3.1.5 Check Required Disk Space The installation of the RTR base product requires about 22 megabytes of disk space. The installation procedure takes about two minutes to complete. 3.1.6 Check System Parameters RTR has basic memory requirements. This section references setup instructions for the relevant system parameters. 3.1.6.1 Check Memory-Mapped I/O Requirements For information on how to size memory-mapped I/O appropriately, refer to HP Reliable Transaction Router System Manager's Manual, RTR Shared Memory Sizing. 3.1.6.2 Check Virtual Memory Requirements The basic memory requirement for an unconfigured RTRACP is 5.6 MB. Additional memory may be required. 3.2 Install RTR 1. If you are installing on Linux, ensure that you are logged in as the root user. 2. If RTR is already installed on your system, see Section B.1, Uninstalling on Linux, for information on uninstalling RTR and removing related processes. 3. Insert the RTR CD-ROM into the drive. 3-2 Full Installation on Linux Frontend Full Installation on Linux Frontend 3.2 Install RTR If Redhat does not automatically mount your CD-ROM, you will need to mount it before proceeding to the next step. 4. CD to the CDROM drive. 5. The HP Reliable Transaction Router for Linux Frontend installs in the standard way on Redhat systems: o use gnorpm for a graphical install on Redhat Workstation systems o use rpm -i packagename.rpm on the command line with Redhat 9 as the root user. 6. If you previously installed an RTR Linux kit, you will need to uninstall the old one before installing the new one. For example, the following shows the installation display: # rpm -i rtr_frontend-x_y-zzz.i386.rpm RTR for Linux Front End is licensed per processor, with one license required for each processor in the system. If more processors or systems are added, then additional RTR licenses must be purchased. # To verify your installation, run the IVP: # cd /opt/rtr/examples/IVP # ./rtr_ivp_osf.sh Starting Reliable Transaction Router V5.0 for Linux Installation Verification Procedure keeping any existing log file settings (RTR_DBG not set) starting RTR . . . %RTR-S-RTRSTART, RTR started on node bznbzn creating a journal, if not already created . . . %RTR-S-JOURNALINI, journal has been created on device /dev/hda3 creating test facility . . . %RTR-S-FACCREATED, facility rtr_ivp_facility created stopping RTR. %RTR-S-RTRSTOP, RTR stopped on node bznbzn Full Installation on Linux Frontend 3-3 Full Installation on Linux Frontend 3.2 Install RTR [OPTIONAL] attempting to compile and link rtr test applications . . . If this system is not configured with an application development environment, or the platform does not support threads, then some messages about application compilation not succeeding are normal. multithreaded server rtr application compiled single-threaded client rtr application compiled applications rtrreq and rtrsrv available starting rtr and creating default facility %RTR-I-NOLOGSET, logging not set %RTR-S-RTRSTART, RTR started on node bznbzn %RTR-S-FACCREATED, facility RTR$DEFAULT_FACILITY created starting an rtr server application running an rtr client application, should complete in a few seconds stopping rtr %RTR-S-RTRSTOP, RTR stopped on node bznbzn Reliable Transaction Router Vx.y for Linux Installation Verification Procedure successful # 3.3 Complete RTR Setup Give the RTR root directory and all its subdirectories "Full Control" access for all RTR users. You may then restrict access on individual files to read only. (All RTR users require write access to the RTR journal directory.) 3.3.1 Check Network Availability RTR cannot start until after the network has started. To check network status, use the command: /etc/init.d/network status. To start your network, execute the command /etc/init.d/network start. 3.3.2 Check Installed Files Navigate to the directory where you installed RTR. The default is /var/opt/rtr. To see a list of the files installed, enter the following command: # rpm -q -l rtr_frontend 3-4 Full Installation on Linux Frontend Full Installation on Linux Frontend 3.3 Complete RTR Setup To see what has been installed, check the display from the following command: # rpm -q -i rtr_frontend Name : rtr_frontend Relocations: /opt/rtr Version : x.y Vendor: Hewlett-Packard Company Release : zzz Build Date: Wed 14 Dec 2004 01:27:4T Install date: Wed 14 Dec 2004 02:13:13 PM EDT Build Host: hostnm Group : Development/Middleware Source RPM: rtr_frontend-x_y-zzz.nom Size : 22029958 License: Per Processor License fd Packager : HP RTR Engineering URL : http://www.hp.com/go/rtr Summary : HP Reliable Transaction Router Description : Reliable Transaction Router(TM) (RTR) is an open client/server software fault tolerant middleware for continuous high performance distributed transaction processing. # (The Source RPM value may be higher than shown.) 3.3.3 Enable RTR Remote Commands While this is not required to use RTR for Linux Frontend, to make it possible to execute RTR commands on remote systems, you must use the remote shell (RSH). See the documentation on remote shell on your Linux system. The RSH service runs commands on remote computers running the RSH service. This command is available only if the TCP/IP protocol has been installed. You can also execute remote commands with /NODE qualifiers on certain RTR commands, and in conjunction with the RTR SET ENVIRONMENT command. For more information on executing RTR commands remotely, refer to the HP Reliable Transaction Router System Manager's Manual. 3.3.4 Display Documentation Softcopy documentation for Reliable Transaction Router is available on the RTR Software Kit in distilled PostScript (.pdf) file format. You can display .pdf files with Acrobat Reader, a free reader of electronic files from Adobe Systems. Full Installation on Linux Frontend 3-5 Full Installation on Linux Frontend 3.3 Complete RTR Setup Release Notes are placed in the /usr/share/doc directory with the .pdf files. 3.3.5 Run RTR You must be in the rtroper group to run RTR. For more information on RTR privileges, see the HP Reliable Transaction Router System Manager's Manual section on RTR Privileges. To run RTR, follow these steps: o To run RTR, enter the following command at the system prompt: # rtr RTR> o To start RTR, enter Start RTR at the RTR> prompt. 3.3.5.1 Configure RTR Facilities and Partitions For information on configuring RTR facilities and setting up partitions, refer to the HP Reliable Transaction Router Getting Started and the HP Reliable Transaction Router System Manager's Manual. 3.3.6 Install and Run Applications Once applications that use RTR have been designed and tested, they can be deployed on the systems configured for use with RTR. For information on designing applications, refer to the HP Reliable Transaction Router Application Design Guide; for information on deployment and monitor- ing, refer to the HP Reliable Transaction Router System Manager's Manual. 3-6 Full Installation on Linux Frontend 4 ________________________________________________________________ Full Installation on OpenVMS This chapter describes how to install Reliable Transaction Router on OpenVMS Alpha systems. It includes steps for: o Preparing for installation o Installing RTR o Completing RTR setup 4.1 Prepare for Installation Before you start the installation, complete the prepara- tion tasks outlined in this section. _____________User-Changed Monitor Files _____________ For all non-Linux platforms, if you have changed any RTR monitor (*.mon) files, you must rename them or they will be overwritten during installation. To avoid this, always work from renamed copies of RTR monitor files when making local modifications. _____________________________________________________ ____________RTR V2 Command-line API Help ____________ To retain RTR V2 help when installing later versions of RTR, before uninstalling RTR make a copy of the RTR V2 help file that is on SYS$COMMON:[SYSHLP]RTRHLP.HLB. Rename it, for example, RTRHLPV2.HLB. After completing installation of the later version of RTR with its current help file, copy the old RTRHLPV2.HLB file back. You can then access the old file from the DCL command line with the DCL command HELP @RTRHLPV2. _____________________________________________________ Full Installation on OpenVMS 4-1 Full Installation on OpenVMS 4.1 Prepare for Installation 4.1.1 Check Software Distribution Kit Reliable Transaction Router is distributed on CD-ROM. Use the Bill of Materials (BOM) received with your kit to verify the contents of your software distribution kit. 4.1.2 Check Login Privileges You must have RTR$OPERATOR privileges to install and run RTR. For more information on RTR privileges, see the HP Reliable Transaction Router System Manager's Manual section on RTR Privileges. 4.1.3 Check Required Hardware To install RTR, you need the following minimum hardware: o Software distribution device such as a CD-ROM o Terminal You can use a character-cell or video terminal or a workstation when installing RTR. o An AlphaServer or Itanium that runs OpenVMS See the HP Reliable Transaction Router Software Product Description for additional hardware requirements. 4.1.4 Check Required Software Table 4-1 provides information on the software that must be installed on your system before installing Reliable Transaction Router. The table also includes information about optional software that you can use with Reliable Transaction Router. See the Reliable Transaction Router Software Product Description (SPD) for the list of prerequisite and optional software and their required versions. Table_4-1_Required_Software_______________________________ Prerequisite_Products_____________Purpose_________________ OpenVMS I64 Version 8.2 minimum System Software (continued on next page) 4-2 Full Installation on OpenVMS Full Installation on OpenVMS 4.1 Prepare for Installation Table_4-1_(Cont.)_Required_Software_______________________ Prerequisite_Products_____________Purpose_________________ or OpenVMS Alpha Version 7.3-2 System Software minimum One of the following must be present on your system to use RTR: __________________________________________________________ Networking_Products_______________Purpose_________________ TCP/IP Services for OpenVMS Network Transport (version depends on the platform and version of OpenVMS. Refer to the relevant SPD.) DECnet or DECnet-Plus (version Network Transport depends on the platform and version of OpenVMS. Refer to the relevant_SPD.)____________________________________________ The Installation Verification Procedure (IVP) will complete successfully only if at least one of the supported network protocols (DECnet or TCP/IP) is installed. For OpenVMS Alpha, there is no requirement that you must register a software license for RTR for OpenVMS. However, for OpenVMS I64, a license is required to run RTR. For further details, refer to the RTR for OpenVMS SPD. 4.1.5 Check Required Disk Space Reliable Transaction Router's requirements for free disk storage space are different during installation and after installation. Table 4-2 summarizes the storage requirements. Full Installation on OpenVMS 4-3 Full Installation on OpenVMS 4.1 Prepare for Installation Table_4-2_Disk_Space_Requirements_for_OpenVMS_____________ Blocks During Blocks After Kit___________________Installation____Installation________ Reliable Transaction 53000 36000 Router_for_OpenVMS________________________________________ To determine the number of free disk blocks on the current system disk, enter the following command at the DCL prompt: $ SHOW DEVICE SYS$SYSDEVICE 4.1.6 Check System Parameters Installing Reliable Transaction Router for OpenVMS may mean that you have to increase the values for some system parameters. For more details, see the HP Reliable Transaction Router System Manager's Manual. ________________ Value of CHANNELCNT ________________ In rare instances and only as directed by HP, you may need to change the value of CHANNELCNT, which is typically set at 256. CHANNELCNT specifies the number of permanent I/O channels available to the system. For details on how to set this, see the HP Reliable Transaction Router System Manager's Manual. _____________________________________________________ 4.1.6.1 Size Global Pages and Sections Appropriately Size global pages and global sections appropriately. (Refer to the section on RTR Shared Memory Sizing in the HP Reliable Transaction Router System Manager's Manual for information on sizing.) Table 4-3 lists the minimum free amount of global pages and global sections required for the installation. 4-4 Full Installation on OpenVMS Full Installation on OpenVMS 4.1 Prepare for Installation Table 4-3 System Parameter Values Used by the RTR __________Installation____________________________________ System_Parameter___________Required_Amount________________ GBLPAGES 4000 GBLSECTIONS________________4______________________________ 4.1.6.2 Size Virtual Memory Appropriately RTR has basic memory requirements. For information on how much virtual memory to allocate, refer to the section on RTR ACP Virtual Memory Sizing in the HP Reliable Transaction Router System Manager's Manual. 4.2 Install RTR If RTR is already installed on your system, see Section B.2, Uninstalling on OpenVMS, for information on uninstalling RTR and removing related processes. Log on to the System Manager's account to do the installation. The Reliable Transaction Router installation procedure uses the POLYCENTER Software Installation Utility (PCSI). For details on using PCSI, refer to the OpenVMS System Manager's Manual, Section "Installing with the POLYCENTER Software Installation Utility." The logical name PCSI$SOURCE is used to define the location of the software kits you want to install. For example, if the Reliable Transaction Router software is located in DISK1:[KITS], enter the following at the DCL prompt (or include the line in the system manager's login command file): $ DEFINE PCSI$SOURCE DISK1:[KITS] ____________ Installing on an ODS-5 Disk ____________ RTR can be installed on an ODS-5 disk. _____________________________________________________ Full Installation on OpenVMS 4-5 Full Installation on OpenVMS 4.2 Install RTR 4.2.1 Installation Example The installation prompts you with questions. Enter your response to each question and press the key. Defaults are shown in square brackets, for example, [YES]. ________ Minimum Required Version of OpenVMS ________ The minimum VMS version on which you can install RTR Version 5.0 is OpenVMS 7.3-2. If you attempt to install RTR Version 5.0 on an earlier version of OpenVMS, you will receive an error message of the following form: This system does not meet the RTR minimum required VMS version. The minimum required version is V7.3-2. Terminating is strongly recommended. Do you want to terminate? [YES] If you see this error message, end your attempted RTR installation and upgrade your OpenVMS system to version 7.3-2. _____________________________________________________ To start the installation, enter the command: $ PRODUCT INSTALL RTR A display similar to the following appears: The following product has been selected: DEC AXPVMS RTR Vx.y-zzz 1 Layered Product Do you want to continue? [YES] 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 Vx.y-zzz: Reliable Transaction Router for OpenVMS © Copyright 2005 Hewlett-Packard Development Company, L.P. Do you want the defaults for all options? [YES] no 4-6 Full Installation on OpenVMS Full Installation on OpenVMS 4.2 Install RTR Have all RTR processes on the system been stopped? [YES] yes 2 Run installation verification procedure [NO] yes 3 DECnet users:Have you read the Release Note regarding minimum version? [YES] yes Do you want the V2 programming kit installed? [NO] yes 4 Do you want to review the options? [NO] yes DEC AXPVMS RTR Vx.y-zzz: Reliable Transaction Router for OpenVMS Have all RTR processes on the system been stopped?: YES Run installation verification procedure: YES DECnet users: Have you read the Release Note regarding minimum version?: YES Do you want the V2 programming kit Installed ?: YES Are you satisfied with these options? [yes] Execution phase starting ... The following product will be installed to destination: DEC AXPVMS RTR Vx.y-zzz 5 Portion done: 0% ...10% ...20% ...30% ...40% ...50% ...60% ...70% ...80% ...90% ...100% The following product has been installed: DEC AXPVMS RTR Vx.y-zzz Layered Product %PCSI-I-IVPEXECUTE, executing test procedure for DEC AXPVMS RTR Vx.y-zzz ...6 %PCSI-I-IVPSUCCESS, test procedure completed successfully DEC AXPVMS RTR Vx.y-zzz: Reliable Transaction Router for OpenVMS Insert the following lines in SYS$MANAGER:SYSTARTUP_VMS.COM: 7 @sys$startup:rtr$startup.com Insert the following lines in SYS$MANAGER:SYSHUTDWN.COM: @sys$manager:rtr$shutdown Full Installation on OpenVMS 4-7 Full Installation on OpenVMS 4.2 Install RTR See the Release Notes and documentation for use of the optional rtr$startup P1 parameter. 8 $ 1 Kit name, version and number. 2 All RTR processes must be stopped before a successful installation. 3 Optional request to run IVP after installation. 4 Answer yes if you need definition files required for programming to the V2 API. Otherwise, answer no. 5 The destination defaults to the logical defined for SYS$COMMON. 6 Indicates that the installation verification procedure (IVP) has started. 7 Add the indicated lines for automatic startup and shutdown of RTR. 8 See Section 4.3.1.1 for information on use of the optional P1 parameter. 4.2.2 Read Release Notes To access the Reliable Transaction Router Release Notes, type the command: $ PRODUCT EXTRACT RELEASE_NOTES RTR /file=rtr_relnotes.txt You should read the Release Notes before using Reliable Transaction Router. 4.3 Complete RTR Setup After completing the installation, you can: o Edit system files o Verify user account requirements 4-8 Full Installation on OpenVMS Full Installation on OpenVMS 4.3 Complete RTR Setup 4.3.1 Edit 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. You must position this new command line after the lines that invoke the network startup command procedures. Add the command line that stops Reliable Transaction Router to the system shutdown file, SYS$MANAGER:SYSHUTDWN.COM. 4.3.1.1 Establishing Protocol Preference In RTR$STARTUP.COM, the symbol RTR_PREF_PROT defines the preferred network protocol. There are four choices: RTR_DNA_FIRST (DECnet first) RTR_DNA_ONLY (DECnet only) RTR_TCP_FIRST (TCP first) RTR_TCP_ONLY (TCP only) By default, protocol preference depends on whether DECnet has been installed as follows: Table_4-4_RTR_Protocol_Preference_________________________ If SYS$NODE is defined (DECnet installed), the If SYS$NODE is not defined, the default_is:________________default_is:____________________ RTR_DNA_FIRST______________RTR_TCP_ONLY___________________ This default behavior is the same as in previous versions of RTR and is backwards compatible with previous versions of RTR. Previously the RTR system manager could override this de- fault behavior by removing the comment character (!) from the appropriate DEFINE statement in RTR$STARTUP.COM. This is no longer valid or supported. To override the default Full Installation on OpenVMS 4-9 Full Installation on OpenVMS 4.3 Complete RTR Setup behavior, add the following line to SYS$MANAGER:SYSTARTUP_ VMS.COM: @sys$startup:rtr$startup.com preferred_protocol (P1) Set the optional preferred protocol to one of the values in Table 4-5. Table_4-5_Preferred_Protocol_Values_______________________ To use the following protocol:_____________Set_the_value_as:___________________ DECnet first RTR_DNA_FIRST DECnet only RTR_DNA_ONLY TCP/IP first RTR_TCP_FIRST TCP/IP_only___________RTR_TCP_ONLY________________________ For example, the following line in SYS$SYSMANAGER:SYSTARTUP_ VMS.COM sets the preferred protocol as TCP/IP first: @sys$startup:rtr$startup.com RTR_TCP_FIRST Setting the prefered protocol eliminates the need to change the RTR$STARTUP.COM file on every system after each RTR upgrade or install. In addition, RTR$SHUTDOWN.COM internally detects the preferred protocol and shuts down RTR accordingly. In the unlikely event that RTR$SHUTDOWN.COM does not correctly detect the preferred protocol, the RTR system manager can explictly pass the value by adding the following line to SYS$MANAGER:SYSHUTDWN.COM: @sys$startup:rtr$shutdown.com preferred_protocol where the optional preferred protocol is taken from Table 4-5. For example, the following command would ensure that RTR detects the preferred protocol: @sys$startup:rtr$shutdown.com RTR_TCP_FIRST 4-10 Full Installation on OpenVMS Full Installation on OpenVMS 4.3 Complete RTR Setup 4.3.2 Verify User Account Requirements To work with Reliable Transaction Router, user accounts on your system must have certain quotas and privileges. The next two sections contain information on these requirements. If current settings are less than those required, increase them to the amounts required. 4.3.2.1 Check User Account Quotas Table 4-6 summarizes the required user account quotas. Table 4-6 User Account Quotas for Using Reliable __________Transaction_Router______________________________ Account_Quota____Value____________________________________ ASTLM At least 2000 BIOLM At least 2000 BYTLM At least 500000 [1] DIOLM At least 2000 TQELM At least 2000 [1]At_least_80000_for_accounts_running_RTR_applications.__ At least 500000 for accounts running the RTR ACP. These may need to be increased to accommodate large numbers of application programs and/or users. The formula to use is: 32K + 32K * n where n equals the number of application processes plus the number of users in the ACP's group. __________________________________________________________ 4.3.2.2 Check User Account Privileges To use the features of Reliable Transaction Router, each account must have the following privileges: o NETMBX o TMPMBX o SYSLCK Full Installation on OpenVMS 4-11 Full Installation on OpenVMS 4.3 Complete RTR Setup In addition, the Rights Identifier RTR$INFO is required. ___________________On Identifiers ___________________ A fresh installation of RTR adds RTR$INFO and RTR$OPERATOR identifiers to those on your system (they are removed during an uninstall). _____________________________________________________ 4.3.2.3 Check System Manager Account Privileges 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. 4.3.3 Check Installed Files To see the files installed on your system by the installation process, use the following command: $ PRODUCT LIST RTR/SOURCE=[pcsi kit location] 4.3.4 Enable RTR Remote Commands To make it possible to execute RTR commands on remote systems, enable the capability with the SYSMAN Utility. See the documentation for SYSMAN in the OpenVMS docu- mentation set for information on this utility. You can also execute remote commands with /NODE qualifiers on certain RTR commands, and in conjunction with the RTR SET ENVIRONMENT command. For more information on executing RTR commands remotely, refer to the HP Reliable Transaction Router System Manager's Manual. 4.3.5 Display CONOLD Documentation Documentation for Reliable Transaction Router is available on the OpenVMS Online Documentation Library CD-ROM in hypertext (.html) file format. You can display the hypertext files on your workstation or PC using any HTML browser such as Internet Explorer or Netscape. 4-12 Full Installation on OpenVMS Full Installation on OpenVMS 4.3 Complete RTR Setup 4.3.6 Run RTR To run RTR, enter the following command at the OpenVMS system prompt: $ run SYS$COMMON:[SYSEXE]RTR RTR> or $ RTR RTR> You can then enter commands at the RTR prompt to configure RTR facilities and partitions, and run applications that use RTR. 4.3.6.1 Configure RTR Facilities and Partitions For information on configuring RTR facilities and setting up partitions, refer to the HP Reliable Transaction Router Getting Started and the HP Reliable Transaction Router System Manager's Manual. 4.3.7 Install and Run Applications Once applications that use RTR have been designed and tested, they can be deployed on the systems configured for use with RTR. For information on designing RTR applications, refer to the HP Reliable Transaction Router Application Design Guide; for information on deployment and use, refer to the HP Reliable Transaction Router System Manager's Manual. Full Installation on OpenVMS 4-13 5 ________________________________________________________________ Full Installation on Windows This chapter describes how to install Reliable Transaction Router on Windows systems. It includes steps for: o Preparing for installation o Installing RTR o Completing RTR setup 5.1 Prepare for Installation Before you start the installation, review the hardware and software requirements described in the following sections. _____________User-Changed Monitor Files _____________ For non-Linux platforms, if you have changed any RTR monitor (*.mon) files, you must rename them or they will be overwritten during installation. To avoid this, always work from renamed copies of RTR monitor files when making local modifications. For the Linux platform, see Chapter 3. _____________________________________________________ 5.1.1 Check Software Distribution Kit Reliable Transaction Router is distributed on CD-ROM. Use the Bill of Materials (BOM) received with your kit to verify the contents of your software distribution kit. Full Installation on Windows 5-1 Full Installation on Windows 5.1 Prepare for Installation 5.1.2 Check Login Privileges You must have RTROperator and RTRInfo privileges to run RTR, and Windows Administrator privileges to install RTR. For more information on privileges, see the HP Reliable Transaction Router System Manager's Manual section on RTR Privileges. 5.1.3 Check Required Hardware o For client/server/router functionality, any Intel system that runs Windows 2000, Windows 2003 or Windows XP. o For client functionality, any Intel system that runs Windows 2000, Windows 2003, or Windows XP. 5.1.4 Check Required Software The following list contains the required version of Windows for each system to be used with RTR: o Windows 2000, Service Pack 1 o Windows 2003 o Windows XP o All systems must include TCP/IP support 5.1.5 Check Required Disk Space The installation of the RTR base product requires about 19 megabytes of disk space. The installation procedure takes about two minutes to complete. 5.1.6 Check System Parameters RTR has basic memory requirements. This section references setup instructions for the relevant system parameters. 5.1.6.1 Check Memory-Mapped I/O Requirements For information on how to size memory-mapped I/O appropriately, refer to HP Reliable Transaction Router System Manager's Manual, RTR Shared Memory Sizing. 5-2 Full Installation on Windows Full Installation on Windows 5.1 Prepare for Installation 5.1.6.2 Check Virtual Memory Requirements The basic memory requirement for an unconfigured RTRACP is 5.6MB. Additional memory may be required. For additional information, refer to the HP Reliable Transaction Router System Manager's Manual, RTRACP Virtual Memory Sizing for All Systems. 5.2 Install RTR 1. If you are installing on Windows 2000, Windows 2003, or Windows XP, ensure that you are logged in as the Administrator, or have administrator privileges. 2. If RTR is already installed on your system, see Section B.3, Uninstalling on Windows Systems, for information on uninstalling RTR and removing related processes. 3. Insert the RTR CD-ROM into the drive. 4. Exit all Windows programs to run Setup. 5. From the Start button, invoke Windows Explorer to view files. 6. Choose the drive letter of your CDROM and open the directory I386. Double click on the file SETUP.EXE. This starts the InstallShield that takes you through the setup process. 7. The InstallShield wizard steps you through the installation. Click on the Next button to continue installation or on the Cancel button to stop it. 8. Select the Typical, Compact or Custom installation as shown in Figure 5-1, Setup Type Screen. o The typical installation provides the most common options. This choice is recommended for most users. o The Compact installation installs only those parts of RTR that are needed for administration of remote systems. You cannot run RTR or RTR applications on the machine where you do the Compact installation. You will have access to a web browser from which you can administer remote systems running RTR. Full Installation on Windows 5-3 Full Installation on Windows 5.2 Install RTR o If you select the Custom installation, you can choose to install only certain parts of RTR, as shown in Figure 5-2. All Custom installations must include Program Files and the RTR Administrator. Other selections are optional. ____________________________________________________ Select this choice:__________To_install_________________________ RTR as a A backend or router Service Object-Oriented The C++ API API Examples Working examples for RTR (C API code), RTRADG (C API code described in the HP Reliable Transaction Router Application Design Guide), _________________or_ABCBook_(C++_API_code)._________ 9. Accept the terms of the License Agreement. If you reject the terms, installation is stopped. 10. Follow the screen instructions to enter the name of the directory where you want to install RTR. The default is: C:\Program Files\HP\RTR HP recommends that you install RTR on a local hard disk (NTFS or FAT). RTR as a Service runs only on Windows 2000, Windows 2003 or Windows XP; the InstallShield does not register the service but RTR provides batch procedures to do so in the target directory. To use the batch procedures for RTR as a Service, follow this sequence: Start -> Programs -> HP -> RTR -> Service -> Register 11. Setup adds a program icon to the Program Folder you select and installs files in the appropriate location. 5-4 Full Installation on Windows Full Installation on Windows 5.2 Install RTR 12. The InstallShield completes the installation, displaying a progress graphic until installation is complete. 13. Click on Finish to complete the installation of RTR. 5.2.1 Read the Readme File The Readme file provides information about RTR that could not be included in the printed documentation. The Readme file is located in the directory where you installed RTR. You should read the Readme before you use RTR. You can also open the RTR Readme from the Start menu as follows: Start -> Programs -> HP -> RTR -> Readme 5.3 Complete RTR Setup If you install RTR on an NTFS drive, you will need to give RTR users access to the RTR directories. Use Windows Explorer and select the RTR root directory. Pull down the Security menu and choose File permissions. Give the RTR root directory and all its subdirectories "Full Control" access for all RTR users. You may then restrict access on individual files to read only. (All RTR users require write access to the RTR journal directory.) ________________________Note ________________________ The Windows registry is modified slightly as a result of a RTR installation. _____________________________________________________ 5.3.1 Check Network Availability RTR cannot start if the network is not available. Check that the network has started before starting RTR. 5.3.2 Check Installed Files Navigate to the directory where you installed RTR. To see a list of the files installed, use Windows Explorer or enter the following command: Tree/F Full Installation on Windows 5-5 Full Installation on Windows 5.3 Complete RTR Setup 5.3.3 Enable RTR Remote Commands To make it possible to execute RTR commands on remote systems, you must use the remote shell (RSH). See the documentation on remote shell on your Windows system. The RSH service runs commands on remote computers running the RSH service. This command is available only if the TCP/IP protocol has been installed. You can also execute remote commands with /NODE qualifiers on certain RTR commands, and in conjunction with the RTR SET ENVIRONMENT command. For more information on executing RTR commands remotely, refer to the HP Reliable Transaction Router System Manager's Manual. 5.3.4 Display Documentation Softcopy documentation for Reliable Transaction Router is available on the RTR Software Kit in distilled PostScript (.pdf) file format. You can display .pdf files with Acrobat Reader, a free reader of electronic files from Adobe Systems. 5.3.5 Run RTR To run RTR on Windows you must have RTROperator or RTRInfo privileges, which must be set by the Administrator. For more information on RTR Privileges, see the HP Reliable Transaction Router System Manager's Manual section on RTR Privileges. To run RTR, follow these steps: o Click on Start -> Programs -> HP -> RTR -> Reliable Transaction Router This brings up a DOS-style RTR command window. To start RTR, enter Start RTR at the RTR> prompt. o Click on Start -> Programs -> HP -> RTR -> Web Browser Interface This brings up the browser-based RTR screens with which you monitor and manage RTR. 5-6 Full Installation on Windows Full Installation on Windows 5.3 Complete RTR Setup 5.3.5.1 Configure RTR Facilities and Partitions For information on configuring RTR facilities and setting up partitions, refer to the HP Reliable Transaction Router Getting Started and the HP Reliable Transaction Router System Manager's Manual. 5.3.6 Install and Run Applications Once applications that use RTR have been designed and tested, they can be deployed on the systems configured for use with RTR. For information on designing applications, refer to the HP Reliable Transaction Router Application Design Guide; for information on deployment and monitor- ing, refer to the HP Reliable Transaction Router System Manager's Manual. Full Installation on Windows 5-7 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, publication date, 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. Errors can occur during the installation if any of the following conditions exist: o The operating system version is incorrect. o The prerequisite software version is incorrect. o There is insufficient disk space. o The system parameter values for successful installation are insufficient. For descriptions of error messages generated by these conditions, see the operating system documentation on system messages, recovery procedures, and software installation. For information on system software requirements, see the software and disk space requirements for your operating system. Recovering from Errors A-1 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 HP by telephoning the HP 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. The CSC will need the following information: o The name and version number of the operating system you are using o The Reliable Transaction Router version number you are using o The hardware system you are using (such as a model number) o A brief description of the problem (one sentence if possible) o Whether or not the problem is critical o Any other information that is helpful, such as the specific commands you used to run the software, the error messages displayed, and source listings of the relevant software module or lines of code If the problem is related to Reliable Transaction Router documentation, send comments electronically to the following internet address: rtrdoc@hp.com. If you are reporting a specific documentation error, be sure to include the manual title, date from title page, section and page numbers where the error occurred. A-2 Recovering from Errors B ________________________________________________________________ Uninstalling RTR Remove commands do not remove all RTR files from your disks. This is particularly important when you are upgrading from one version of RTR to another. You must eliminate all RTR files from your system, but do not discard any customized monitor files in /rtr or a journal containing recoverable transactions in /rtrjnl. Copy these to another directory before completing the uninstall instructions. If /rtrjnl or /rtr is a symbolic link to another directory, first remove the target directory and all files contained in it, and then remove the symbolic link. B.1 Uninstalling on Linux The command to uninstall a Linux package is the following: rpm -e rtr_frontend When executing this command, the system displays the following: uninstalling RTR_FRONTEND... # To list all installed packages, issue the command rpm -qa. B.2 Uninstalling on OpenVMS Complete the following steps to uninstall RTR from your system. o Stop all RTR processes on the system: $ RTR STOP RTR $ RTR DISCONNECT SERVER/DAEMON Uninstalling RTR B-1 Uninstalling RTR B.2 Uninstalling on OpenVMS o Check for any surviving processes such as rtrd and applications programmed to handle RTR_STS_NOACP, and terminate any such processes until there are none left. Note that all the RTR ACP and comserver processes must be terminated before rtrd, otherwise they will create a new rtrd. The rtrd process can now be terminated with the STOP command or by issuing the following command: $ RTR DISC SERVER/DAEMON o 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. Processes can be terminated with the STOP command, or by a program that uses $FORCEX. 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. o Remove RTR from your system. $ PRODUCT REMOVE RTR B.3 Uninstalling on Windows Systems You must perform the following actions before uninstalling RTR on a Windows system: o If you installed RTR as a service, you must unregister RTR as a service. Do this with the following menu selections from the Program menu: Programs -> HP -> RTR -> Service -> Unregister o Delete all *.LCK files located in the directory used for the previous installation, and the RTRenvps file (shared memory). o Stop all RTR processes on the system: RTR STOP RTR RTR DISCONNECT SERVER/DAEMON B-2 Uninstalling RTR Uninstalling RTR B.3 Uninstalling on Windows Systems You can also use the Shutdown command, which executes Shutdown.bat. Programs-> HP -> RTR -> Utilities ->Shutdown o Check for any surviving processes such as rtrd and applications programmed to handle RTR_STS_NOACP, and terminate any such processes until there are none left. Note that all the RTR ACP and comserver processes must be terminated before rtrd, otherwise they will create a new rtrd. To verify that no RTR-related processes are still running on a node or cluster member, check for the existence of the rtrdll.dll file. The rtrdll.dll file cannot be deleted if it is in use. o To uninstall RTR, follow this menu selection process: Control Panel -> Add/Remove Programs -> HP Reliable Transaction Router -> Remove o 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. o Remove previous versions of RTR from the disk: DEL /S/Q C:\RTR Uninstalling RTR B-3 ________________________________________________________________ Index A__________________________ G__________________________ Account quotas, 4-11 GBLPAGES, 1-3 ASTLM GBLSECTIONS, 1-3 OpenVMS, 4-11 B H__________________________ ___________________________ Help Batch procedures OpenVMS, 1-2 Windows, 5-4 BIOLM I OpenVMS, 4-11 ___________________________ BYTLM I/O channels OpenVMS, 4-11 OpenVMS, 4-4 IVP C__________________________ OpenVMS, 1-4 CHANNELCNT, 4-4 L Channels ___________________________ OpenVMS, 4-4 Logical name OpenVMS, 1-3 D__________________________ DIOLM M__________________________ OpenVMS, 4-11 Memory sizing Disk space OpenVMS, 4-5 OpenVMS, 1-2 Windows, 5-2 Monitor files, 1-1 F__________________________ Files N__________________________ monitor, 1-1 Network startup Linux, 3-5 OpenVMS, 4-9 Windows, 5-5 Index-1 O__________________________ R__________________________ OpenVMS Readme astlm, 4-11 Windows, 5-5 biolm, 4-11 Release Notes bytlm, 4-11 OpenVMS, 1-2 channels, 4-4 diolm, 4-11 S__________________________ global pages, 1-3 SYS$COMMON:[SYSHLP], 1-2 global sections, 1-3 help, 1-2 T IVP, 1-4 ___________________________ logical, 1-3 TQELM memory sizing, 4-5 OpenVMS, 4-11 quotas, 4-11 Release Notes, 1-2 U__________________________ tqelm, 4-11 User Account quotas, 4-11 P__________________________ V Privileges ___________________________ Linux, 3-1, 3-6 VMS Installation, 4-1 OpenVMS, 4-2 W Windows, 5-2, 5-6 ___________________________ Windows Q__________________________ batch procedures, 5-4 Quotas Readme, 5-5 OpenVMS, 4-11 sizing memory, 5-2 Index-2