                                     C                      Reliable_Transaction_Router___________________ '                      Installation Guide   .                      Order Number: AA-Q88DF-TE          A                      This guide describes how to install Reliable D                      Transaction Router for all operating systems on,                      which RTR is supported.            D                      Revision/Update Information: This manual super-D                                                   sedes the ReliableD                                                   Transaction RouterD                                                   Installation GuideA                                                   for RTR Version C                                                   3.2, and has been E                                                   completely revised.   F                      Software Version:            Reliable TransactionD                                                   Router Version 4.0    0                      Compaq Computer Corporation#                      Houston, Texas                  E            __________________________________________________________             January, 2001  >            COMPAQ COMPUTER CORPORATION SHALL NOT BE LIABLE FOR?            TECHNICAL OR EDITORIAL ERRORS OR OMISSIONS CONTAINED >            HEREIN, NOR FOR INCIDENTAL OR CONSEQUENTIAL DAMAGESE            RESULTING FROM THE FURNISHING, PERFORMANCE, OR USE OF THIS D            MATERIAL. THIS INFORMATION IS PROVIDED "AS IS" AND COMPAQB            COMPUTER CORPORATION DISCLAIMS ANY WARRANTIES, EXPRESS,C            IMPLIED OR STATUTORY AND EXPRESSLY DISCLAIMS THE IMPLIED @            WARRANTIES OF MERCHANTABILITY, FITNESS FOR PARTICULAR8            PURPOSE, GOOD TITLE AND AGAINST INFRINGEMENT.  =            This publication contains information protected by D            copyright. No part of this publication may be photocopiedB            or reproduced in any form without prior written consent,            from Compaq Computer Corporation.  -             1991 Compaq Computer Corporation   D            The software described in this guide is furnished under aD            license agreement or nondisclosue agreement. The softwareE            may be used or copied only in accordance with the terms of             the agreement.   B            Compaq and the Compaq logo are registered in the United.            States Patent and Trademark Office.  @            Compaq Internet Personal Tunnel, DEC, DECdtm, DECnet,B            DIGITAL, OpenVMS, Tru64 UNIX, and VAX are trademarks ofD            Compaq Information Technologies Group, L.P. in the United)            States and/or other countries.   B            Microsoft, Microsoft SQL Server, Internet Explorer, MS-@            DOS, Visual C++, Windows, Windows 95, Windows 98, and@            Windows NT are trademarks or registered trademarks ofB            Microsoft Corporation in the United States and/or other            countries. B            Intel is a trademark of Intel Corporation in the United)            States and/or other countries. B            UNIX is a registered trademark of The Open Group in the0            United States and/or other countries.  E            All other product names mentioned herein may be trademarks B            or registered trademarks of their respective companies.  A            This document was prepared using VAX DOCUMENT, Version             2.1.                                C    ________________________________________________________________   C                                                            Contents     C    Preface..................................................    vii         1  Quick Installation  C          1.1   Installing RTR for OpenVMS...................    1-1 C          1.1.1     Installation Procedure...................    1-1 C          1.1.2     Sample OpenVMS Installation..............    1-2 C          1.2   Installing RTR for Windows Systems...........    1-3 C          1.2.1     Installation Procedure...................    1-3 C          1.3   Installing RTR for Compaq Tru64 UNIX.........    1-4 C          1.3.1     Installation Procedure...................    1-4 C          1.3.2     Sample Compaq Tru64 UNIX Installation....    1-5 C          1.3.3     Sample IVP Output........................    1-7 C          1.4   Installing RTR for SunOS.....................    1-8 C          1.4.1     Installation Procedure...................    1-8 C          1.4.2     Running the IVP..........................   1-10 C          1.4.3     Sample SunOS Installation................   1-10       2  Upgrade Process   C          2.1   Rolling Upgrade Restrictions.................    2-1 C          2.2   Uninstalling RTR.............................    2-2 C          2.2.1     Uninstalling on OpenVMS..................    2-2 C          2.2.2     Uninstalling on Windows Systems..........    2-3 C          2.2.3     Uninstalling on Compaq Tru64 UNIX........    2-4 C          2.2.4     Uninstalling on Sun......................    2-5               C                                                                 iii                  $      3  Full Installation on OpenVMS  E            3.1   Preparing for Installation...................    3-1 E            3.1.1     Accessing Release Notes..................    3-1 E            3.1.2     Prerequisite and Optional Software.......    3-1 E            3.1.3     Required Disk Space......................    3-2 E            3.1.4     System Parameters........................    3-3 E            3.2   Installation Procedure.......................    3-3 E            3.2.1     Installing RTR...........................    3-4 E            3.3   After Installing RTR ........................    3-5 E            3.3.1     Editing System Files.....................    3-5 E            3.3.2     User Account Requirements................    3-6 E            3.3.2.1     Quotas.................................    3-6 E            3.3.2.2     Privileges.............................    3-6 E            3.4   Files Installed on OpenVMS...................    3-7   '      4  Full Installation on Windows NT   E            4.1   Preparing for Installation...................    4-1 E            4.1.1     Accessing the Readme file................    4-1 E            4.1.2     Hardware Requirements....................    4-1 E            4.1.3     Software Requirements....................    4-2 E            4.2   Installation Procedure.......................    4-2 E            4.3   After Installing.............................    4-4 E            4.4   Files Installed on Microsoft Windows NT......    4-4   .      5  Full Installation on Compaq Tru64 UNIX  9            5.1   Preparing for RTR Installation on Compaq E                  Tru64 UNIX ..................................    5-1 E            5.1.1     Checking the Software Distribution Kit...    5-1 E            5.1.2     Reading the Online Release Notes.........    5-1 E            5.1.3     Registering Your Software License .......    5-2 E            5.1.4     Checking Installation Requirements.......    5-2 E            5.1.4.1     Checking Login Privileges..............    5-3 E            5.1.4.2     Checking Hardware Requirements.........    5-3 E            5.1.4.3     Checking Software Requirements.........    5-3 E            5.1.4.4     Determining Which Subsets to Load......    5-4 E            5.1.4.5     Determining Disk Space Requirements....    5-4 E            5.1.4.5.1    Checking Current Disk Space...........    5-5 6            5.1.4.5.2    Increasing Disk Space by UsingE                         Alternative Disks ....................    5-6 E            5.1.5     Installing from Media or Using RIS.......    5-6           iv                  H               5.1.6     Backing Up Your System Disk..............    5-7H               5.1.7     Stopping the Installation................    5-7H               5.2   Installing RTR on Compaq Tru64 UNIX .........    5-7H               5.2.1     Distribution Media.......................    5-7@               5.2.1.1     Using CD-ROM Consolidated DistributionH                           Media..................................    5-7H               5.2.1.2     Using a RIS Distribution Area .........    5-8<               5.2.2     Responding to Installation ProcedureH                         Prompts..................................    5-9H               5.2.2.1     Selecting Subsets......................    5-9?               5.2.2.2     Monitoring Displays During the Subset H                           Loading Process........................   5-10H               5.3   After Installation on Compaq Tru64 UNIX .....   5-11=               5.3.1     Running the Installation Verification H                         Procedure ...............................   5-11H               5.3.2     Deleting RTR from Your System............   5-12H               5.3.3     Displaying Documentation from CD-ROM.....   5-12H               5.3.4     Enabling Remote RTR Commands.............   5-12H               5.4   Files Installed on Compaq Tru64 UNIX.........   5-13    !         A  Recovering from Errors   H               A.1   Problems During Product Installation ........    A-1H               A.2   Problems After Installation .................    A-2           Figures   H               1         RTR Reading Path.........................   xiii           Tables  H               1         Conventions Used in this Guide ..........     xi  H               3-1       Prerequisite and Optional Software.......    3-2  H               3-2       Disk Space Requirements..................    3-3  ?               3-3       System Parameter Values Used by the RTR H                         Installation.............................    3-3  >               3-4       User Account Quotas for Using ReliableH                         Transaction Router.......................    3-6  H               5-1       RTR Subset Size (Kilobytes Required).....    5-4  H                                                                        v                           H         ________________________________________________________________  H                                                                  Preface      E               This guide explains how to install Reliable Transaction H               Router (RTR) on supported platforms. If you are installingG               RTR on only one platform, you need only read the sections *               that apply to that platform.  F               Keep this guide with your distribution kit. You may needG               it to install maintenance updates or to reinstall RTR for                any other reason.   "         Structure of this Document  H               This guide contains the following chapters and appendixes:  D               o  Chapter 1 gives brief installation instructions forG                  RTR on OpenVMS VAX, OpenVMS Alpha, Windows NT, Windows C                  2000, Windows ME (client only), Windows 95 (client H                  only), Windows 98 (client only), Compaq Tru64 UNIX, and                  SunOS.   E               o  Chapter 2 includes instructions on how to remove RTR :                  from your system before doing an upgrade.  H               o  Chapter 3 describes a full installation for OpenVMS VAX.                  and OpenVMS Alpha, including:  .                  -  Preparing for installation  *                  -  Installation procedure  +                  -  Running RTR and the IVP   (                  -  After Installing RTR  H               o  Chapter 4 describes a full installation for Windows NT,                  including:   6                  -  Hardware and software requirements  H                                                                      vii                 '               -  Installation procedure   !               -  After Installing   @            o  Chapter 5 describes a full installation for CompaqE               Tru64 UNIX, as an example of UNIX installation details,                including:  +               -  Preparing for Installation   '               -  Installation procedure   =               -  After installation procedures, including the B                  Installation Verification Procedure (IVP), how toD                  remove RTR from your system, and description of the8                  files you need to run RTR applications.  C            o  Appendix A contains information about recovering from                errors.         Associated Documents   ?            In addition to this guide, the RTR documentation set "            includes the following:  A            o  Reliable Transaction Router System Manager's Manual   9            o  Reliable Transaction Router Migration Guide   9            o  Reliable Transaction Router Getting Started   7            o  Reliable Transaction Router Commands Card   B            o  Reliable Transaction Router Application Design Guide  D            o  Reliable Transaction Router C Application Programmer's               Reference Manual  @            o  Reliable Transaction Router C++ Foundation Classes  ?            o  A letter titled Reliable Transaction Router Cover                Letter  D            o  Reliable Transaction Router Release Notes are providedA               in electronic form in the software kit in the files D               RTR_RELNOTES.PS and RTR_RELNOTES.TXT. You are strongly@               advised to read the Release Notes before using the               product.  	      viii                  C               o  All product documentation is also provided in HTML B                  format on the online documentation CDROM. You canE                  use any browser such as Netscape Navigator, Netscape G                  Communicator, or Microsoft Internet Explorer to access 6                  the online form of the documentation.                                                                                H                                                                       ix                       Conventions  @            Table 1 describes the conventions used in this guide.                                                                                          x                 H               Table_1_Conventions_Used_in_this_Guide____________________  H               Convention_____Meaning____________________________________  G               #              A number sign (#) is the default superuser $                              prompt.  C               %              A percent sign (%) is the default user :                              prompt for many UNIX systems.  B               $              A dollar sign ($) is the default user8                              prompt for OpenVMS systems.  B               <Return>       In examples, a boxed symbol indicatesE                              that you must press the named key on the &                              keyboard.  F               Ctrl/C         This symbol indicates that you must pressH                              the Ctrl key while you simultaneously press;                              another key (in this case, C).   C               user input     In interactive examples, this typeface A                              indicates input entered by the user.   G               filesystem     In text, this typeface indicates the exact C                              name of a command, routine, partition, H                              pathname, directory, or file. This typefaceE                              is also used in interactive examples and 3                              other screen displays.   E               UPPERCASE      The UNIX operating system differentiates H               lowercase      between lowercase and uppercase characters.D                              Examples, syntax descriptions, functionB                              definitions, and literal strings thatD                              appear in text must be typed exactly asE                              shown. Commands typed to the RTR CLI are B                              not case sensitive unless enclosed in-                              quotation marks.   G               setld(8)       Cross-references to online reference pages C                              include the appropriate section number8B                              in parentheses. For example, setld(8)E                              indicates that you can find the materialtE                              on the setld command in Section 8 of the A                              reference pages (UNIX systems only).e  G               [y]            In a prompt, square brackets indicate that G                              the enclosed item is the default response. H                              For example, [y] means the default responseH               _______________is_Yes.____________________________________  H                                                                       xi                       Reading Pathr  =            The reading path to follow when using the ReliableiC            Transaction Router information set is shown in Figure 1.o                                                                                        xii u  n                                                                                                      H                                                                     xiii B  I                  H                                                                        1H         ________________________________________________________________  H                                                       Quick Installation      B               This chapter gives brief instructions for installingE               Reliable Transaction Router on the following platforms:X                 o  OpenVMS  B               o  Windows 2000, Windows NT, Windows 98, Windows 95,                  Windows MEE  C               o  Compaq Tru64 UNIX (formerly known as DIGITAL UNIX)r                 o  Sun Solaris  &         1.1 Installing RTR for OpenVMS  A               Your Reliable Transaction Router for OpenVMS kit iswG               supplied on CD-ROM. After installation, the Release Notes G               are located in the directory SYS$COMMON:[SYSHLP]; you are A               advised to read the Release Notes before using RTR.   E               The installation of the RTR base product requires aboutlF               50000 blocks during installation, and about 36000 blocks@               after installation is done. The installation takesC               less than five minutes to complete. For more detailednG               instructions, see Chapter 3, Full Installation on OpenVMSu               .a  $         1.1.1 Installation Procedure  @               1. If RTR is already installed on your system, seeH                  Section 2.2.1, Uninstalling on OpenVMS, for informationD                  on uninstalling RTR and removing related processes.  8               2. Log on to the System Manager's account.    H                                                   Quick Installation 1-1 r  h            Quick Installation #      1.1 Installing RTR for OpenVMSC  =            3. Define the logical name for the location of thes(               software kit, for example:  /               $ DEFINE PCSI$SOURCE DISK1:[KITS]t  A            4. Check disk space and system parameters GBLPAGES andi               GBLSECTIONS.  @            5. Start the installation with the following command:  #               $ PRODUCT INSTALL RTRa  &      1.1.2 Sample OpenVMS Installation               $ product install rtr  3            The following product has been selected:_S                DEC AXPVMS RTR V4.0-0                    Layered Product [Installed]n  )            Do you want to continue? [YES].  +            Configuration phase starting ...u  U            You will be asked to choose options, if any, for each selected product and P            for any products that may be installed to satisfy software dependency            requirements.  U            DEC AXPVMS RTR V4.0-0: Reliable Transaction Router for OpenVMS [Installed].  7              Copyright 1996 Compaq Computer Corporation.  =            Do you want the defaults for all options? [YES] nou  E              Have all RTR processes on the system been stopped? [YES].=              Run installation verification procedure [NO] yesI  Y              DECnet users:Have you read the Release Note regarding minimum version? [YES]-  C              Do you want the V2 programming kit installed? [NO] yes   2            Do you want to review the options? [NO]  '            Execution phase starting ...g  3            The following product will be installed:4C                DEC AXPVMS RTR V4.0-0                Layered Productr  L            Portion done: 0%...10%...20%...30%...40%...50%...80%...90%...100%  4            The following product has been installed:C                DEC AXPVMS RTR V4.0-0                Layered Product.        1-2 Quick Installation2    U      H                                                       Quick InstallationH                                           1.1 Installing RTR for OpenVMS  L               DEC AXPVMS RTR V4.0-0: Reliable Transaction Router for OpenVMS  F                   Insert the following lines in SYS$MANAGER:SYSTARTUP_         VMS.COM:2                       @sys$startup:rtr$startup.comJ                   Insert the following lines in SYS$MANAGER:SYSHUTDWN.COM:/                       @sys$manager:rtr$shutdowne  J               For additional information, see Chapter 3, Full Installation               on OpenVMS .  .         1.2 Installing RTR for Windows Systems  F               Your Reliable Transaction Router for Windows NT, Windows@               2000, Windows 95, Windows 98, or Windows ME kit isD               supplied on CD-ROM. After installation the Readme fileF               is located in the directory where you installed RTR; youC               are advised to read the Readme file before using RTR.o  E               The installation of the RTR base product requires about.F               five megabytes of disk space. The installation procedure2               takes about two minutes to complete.  $         1.2.1 Installation Procedure  @               1. If RTR is already installed on your system, seeD                  Section 2.2.2, Uninstalling on Windows Systems, forE                  information on uninstalling RTR and removing related                   processes.   E               2. If you are installing on Windows NT or Windows 2000,eC                  log in as the Administrator, or with administrator                   privileges.  6               3. Insert the RTR CD-ROM into the drive.  G               4. From Windows Explorer, choose the drive letter of yourd4                  CD-ROM and open the directory I386.  J               5. Double click on SETUP.EXE to start the InstallShield[[R]]:                  that takes you through the setup process.        H                                                   Quick Installation 1-3                 Quick Installationl-      1.3 Installing RTR for Compaq Tru64 UNIX5  -      1.3 Installing RTR for Compaq Tru64 UNIX.  A            Your Reliable Transaction Router for Compaq Tru64 UNIX.D            kit is supplied on CD-ROM. After installation the ReleaseB            Notes are located in the directory /usr/opt/RTR400/hlp;A            you are advised to read the Release Notes before usinge            RTR.-  @            The installation requires about 60KB on the partition=            given in response to the RTRbase directory prompt.n@            The installation procedure takes about two minutes to            complete.  !      1.3.1 Installation Procedures  /            1. Login as user root or su to root.v  E            2. Use the setld utility to check if you have a version ofm$               RTR already installed:  #               # setld -i | grep RTR   =            3. If RTR is already installed on your system, see C               Section 2.2.3, Uninstalling on Compaq Tru64 UNIX, for5B               information on uninstalling RTR and removing related               processes.  C            4. Install from the directory (disk or CD-ROM) where the *               kit is located, for example:  *               # setld -l /cdrom/rtr4xx/kit  D               Where "xx" is the version number, for example, rtr400.  =            5. Answer "1" and "y" to the questions from setld.p  B            6. To run the IVP (Installation Verification Procedure)(               use the following command:  C               ________________________Note ________________________   @               Do not run the IVP program on a production system,:               as it may alter the RTR journal or interruptA               processing of transactions. You will be prompted toIA               abort the IVP before it can do any damage. Considerr>               your situation carefully before running the IVP.  C               _____________________________________________________s        1-4 Quick Installation     .      H                                                       Quick InstallationH                                 1.3 Installing RTR for Compaq Tru64 UNIX  &                  # setld -v RTRBASE4xx  G                  Where "xx" is the kit number, for example, RTRBASE400.b  B                  Note that the Installation Verification Procedure?                  requires a working C language compiler to run.i  3         1.3.2 Sample Compaq Tru64 UNIX Installation.                   # setld -l .  <                 Copyright 1994  Compaq Computer Corporation.  V                 Confidential computer software. Valid license from Compaq required forR                 possession, use or copying. Consistent with FAR 12.211 and 12.212,R                 Commercial Computer Software, Computer Software, Computer SoftwareV                 Documentation, and Technical Data for Commercial Items are licensed toO                 the U.S. Government under vendor's standard commercial license.r  S                 Compaq, the Compaq logo, and the Digital logo are registered in theq1                 U.S. Patent and Trademark Office.   4               The subsets listed below are optional:  W                    There may be more optional subsets than can be presented on a single W                    screen. If this is the case, you can choose subsets screen by screen V                    or all at once on the last screen. All of the choices you make willW                    be collected for your confirmation before any subsets are installed. 2                    1) RTR API & Management Utility  =               Or you may choose one of the following options:u  &                    2) ALL of the above;                    3) CANCEL selections and redisplay menuso9                    4) EXIT without installing any subsetsf  B               Estimated free diskspace(MB) in root:67.7 usr:1669.2  D               Enter your choices or press RETURN to redisplay menus.  /               Choices (for example, 1 2 4-6): 1M  @               You are installing the following optional subsets:  2                       RTR API & Management Utility  B               Estimated free diskspace(MB) in root:67.7 usr:1649.2  '               Is this correct? (y/n): yaN               Checking file system space required to install selected subsets:  H                                                   Quick Installation 1-5 n  l            Quick Installation -      1.3 Installing RTR for Compaq Tru64 UNIX   (            File system space checked OK.  '            1 subsets will be installed.   $            Loading subset 1 of 1 ...  C              Reliable Transaction Router V4.0 for Compaq Tru64 UNIXC  B              Installation started at Mon Nov 27 15:33:03 EST 2000.  V              Installation proceeds automatically, and should complete in approximately              1 minute.  '            RTR API & Management Utility #               Copying from . (disk)t               Verifying   1            1 of 1 subsets installed successfully.   B            Configuring "RTR API & Management Utility" (RTRBASE400)  ,              reusing existing /rtr directory  8            # Copyright 1994 Compaq Computer Corporation.            #S            # Confidential computer software. Valid license from Compaq required forrO            # possession, use or copying. Consistent with FAR 12.211 and 12.212,oO            # Commercial Computer Software, Computer Software, Computer Software S            # Documentation, and Technical Data for Commercial Items are licensed tonL            # the U.S. Government under vendor's standard commercial license.            #P            # Compaq, the Compaq logo, and the Digital logo are registered in the.            # U.S. Patent and Trademark Office.C              Reliable Transaction Router V4.0 for Compaq Tru64 UNIXT  D              Installation completed at Mon Nov 27 15:33:12 EST 2000.  T              You can run the Installation Verification Procedure using this command:1                               setld -v RTRBASE400o  E              Release Notes are available in: /usr/opt/RTR400/hlp/rtr_       relnotes.*             1-6 Quick Installation            H                                                       Quick InstallationH                                 1.3 Installing RTR for Compaq Tru64 UNIX           1.3.3 Sample IVP Outpute  #               # setld -v RTRBASE400n7               RTR API & Management Utility (RTRBASE400)   ;                 Copyright 1994 Compaq Computer Corporation.   V                 Confidential computer software. Valid license from Compaq required forR                 possession, use or copying. Consistent with FAR 12.211 and 12.212,R                 Commercial Computer Software, Computer Software, Computer SoftwareV                 Documentation, and Technical Data for Commercial Items are licensed toO                 the U.S. Government under vendor's standard commercial license.e  S                 Compaq, the Compaq logo, and the Digital logo are registered in the 1                 U.S. Patent and Trademark Office.   T                 Starting     Reliable Transaction Router V4.0  for Compaq Tru64 UNIX3                 Installation Verification Proceduren8               WARNING: This is not a first time install.L               WARNING: Please ensure that you have terminated *all* existingL               WARNING: rtr processes and rtr applications before continuing.  K               Rtr will find and reuse any existing rtr journal files in the N               top level rtrjnl directory on each suitable filesystem, and willT               reuse any existing shared memory segment associated with /rtr/RTRENVPSJ               Normally this is intended and should not cause any problems.  P               WARNING: Any existing journal will be used and modified, otherwiseO               WARNING: a new journal will be created on the default filesystem. K               WARNING: Facilities RTR_IVP_FACILITY and RTR will be created.k[               WARNING: Result may be affected by size and contents of any existing journal.lW               WARNING: The sample client and server do not necessarily complete if theytY               WARNING: encounter previously journalled transactions for their facilities.   4               Would you like to abort the IVP? (y/n)               n                 IVP continuing ...  H                 keeping any existing log file settings (RTR_DBG not set)"                 starting RTR . . .A                 creating a journal, if not already created  . . . ,                 creating test facility . . .                 stopping RTR.   U                 [OPTIONAL] attempting to compile and link rtr test applications . . .r  H                                                   Quick Installation 1-7 e  a            Quick Installation -      1.3 Installing RTR for Compaq Tru64 UNIX   M              If this system is not configured with an application development M              environment, or the platform does not support threads, then some N              messages about application compilation not succeeding are normal.  :              multithreaded server rtr application compiled<              single-threaded client rtr application compiled5              applications rtrreq and rtrsrv available 7              starting rtr and creating default facility +            %RTR-I-NOLOGSET, logging not setsE            %RTR-S-RTRSTART, RTR started on node nodea in group "root"eD            %RTR-S-RTRSTOP, RTR stopped on node nodea in group "root"  :              Copyright  1994 Compaq Computer Corporation.  H                  Reliable Transaction Router V4.0  for Compaq Tru64 UNIX  ;              Installation Verification Procedure successfula  !      1.4 Installing RTR for SunOS   E            Your Reliable Transaction Router for SunOS kit is supplied >            on CD-ROM. After installation the Release Notes are@            located in the directory /opt/rtr/RTR400/hlp; you are>            advised to read the Release Notes before using RTR.  C            The installation requires about 2950 KB on the partition A            given in response to the package base directory promptaE            (usually /opt). The installation procedure takes about two             minutes to complete.   B            Note that the Installation Verification Procedure (IVP)9            requires a working C language compiler to run.   !      1.4.1 Installation Procedure   C               ________________________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.t  B               Both librtr_r.so and librtr.so are provided for both@               SunOS 5.5 and 5.6, in case there is a need to linkB               your application with the threaded version, but only        1-8 Quick Installations ,  n      H                                                       Quick InstallationH                                             1.4 Installing RTR for SunOS  B                 on SunOS 5.6 will RTR itself use librtr_r.so, thus8                 enabling asynchronous I/O (aio) support.  E                 _____________________________________________________   2               1. Login as user root or su to root.  G               2. Use the pkginfo utility to check if you have a version *                  of RTR already installed:  !                  # pkginfo -l rtrl  @               3. If RTR is already installed on your system, seeD                  Section 2.2.4, Uninstalling on Sun, for informationD                  on uninstalling RTR and removing related processes.  G               4. Insert the CD-ROM and mount the volume at a convenient 3                  mount point (for example, /cdrom).I  G               5. Install RTR from the CD-ROM directory where the kit is2&                  located, for example:  $                  # cd /cdrom/rtr_kit                  # pkgadd -d .  G                  o  You can accept the defaults for most questions from '                     the pkgadd utility.   E                  o  When asked for the "base directory", answer /opt.I  G                  o  Ignore any warning about free blocks and answer "y" 6                     to the attached continue question.  ?                  o  When asked "Do you want to install these as ?                     setuid/setgid files [y,n,?,q]", answer "y".   H                  o  When asked "This package contains scripts which willE                     be executed with super-user permission during the F                     process of installing this package. Do you want toE                     continue with the installation of <rtr> [y,n,?]",                      answer "y".   2               6. RTR is now installed in /opt/rtr.  H               Section 1.4.3 shows an example installation of RTR for the               SunOS.  H                                                   Quick Installation 1-9 t  h            Quick Installations!      1.4 Installing RTR for SunOSi        1.4.2 Running the IVP  C            The Installation Verification Procedure (IVP) requires a .            working C language compiler to run.  C               ________________________Note ________________________n  @               Do not run the IVP program on a production system,:               as it may alter the RTR journal or interruptA               processing of transactions. You will be prompted to A               abort the IVP before it can do any damage. Considert>               your situation carefully before running the IVP.  C               _____________________________________________________   ?            You may run the IVP separately from the installation @            procedure. If you are not using the C shell, start it?            by typing /usr/bin/csh and run the IVP by typing the.            following:-               # setenv BASEDIR /opt  &            and then executing the file@            pkg/rtr/reloc/rtr/RTRxxx/examples/rtr/rtr_ivp_osf.sh.  $      1.4.3 Sample SunOS Installation  0            The following packages are available:  3              1  rtr     Reliable Transaction RouterR#                         (sun4u) 400X  C            Select package(s) you wish to process (or all to process 6            all packages). (default: all) [?,??,q]: allG            Processing package instance <rtr> from </usr/home/smith/kit> &            Reliable Transaction Router            (sun4u) 400&            Compaq Computer Corporation6            Using </opt> as the package base directory.-            ## Processing package information. ,            ## Processing system information.0            ## Verifying disk space requirements.E            ## Checking for conflicts with packages already installed. 2            ## Checking for setuid/setgid programs.        1-10 Quick Installation n  l      H                                                       Quick InstallationH                                             1.4 Installing RTR for SunOS  R               This package contains scripts which will be executed with super-userG               permission during the process of installing this package. N               Do you want to continue with the installation of <rtr> [y,n,?] y=               Installing Reliable Transaction Router as <rtr>r(               ## Installing part 1 of 1.%               /opt/rtr/RTR400/bin/rtrr'               /opt/rtr/RTR400/bin/rtr_rl,               /opt/rtr/RTR400/bin/rtr_remote*               /opt/rtr/RTR400/bin/rtr_rqif1               /opt/rtr/RTR400/bin/rtr_snapshot.sh :               /opt/rtr/RTR400/examples/ABCBook/ABCBook.cpp8               /opt/rtr/RTR400/examples/ABCBook/ABCBook.h?               /opt/rtr/RTR400/examples/ABCBook/ABCCHandlers.cpp =               /opt/rtr/RTR400/examples/ABCBook/ABCCHandlers.h-:               /opt/rtr/RTR400/examples/ABCBook/ABCCommon.h>               /opt/rtr/RTR400/examples/ABCBook/ABCMagazine.cpp<               /opt/rtr/RTR400/examples/ABCBook/ABCMagazine.h;               /opt/rtr/RTR400/examples/ABCBook/ABCOrder.cppn9               /opt/rtr/RTR400/examples/ABCBook/ABCOrder.haD               /opt/rtr/RTR400/examples/ABCBook/ABCOrderProcessor.cppB               /opt/rtr/RTR400/examples/ABCBook/ABCOrderProcessor.h@               /opt/rtr/RTR400/examples/ABCBook/ABCOrderTaker.cpp>               /opt/rtr/RTR400/examples/ABCBook/ABCOrderTaker.hC               /opt/rtr/RTR400/examples/ABCBook/ABCSClassFactory.cppeA               /opt/rtr/RTR400/examples/ABCBook/ABCSClassFactory.ho?               /opt/rtr/RTR400/examples/ABCBook/ABCSHandlers.cppn=               /opt/rtr/RTR400/examples/ABCBook/ABCSHandlers.ho:               /opt/rtr/RTR400/examples/ABCBook/SAMPLE1.COM:               /opt/rtr/RTR400/examples/ABCBook/Sample1.cpp:               /opt/rtr/RTR400/examples/ABCBook/Sample1.dsp:               /opt/rtr/RTR400/examples/ABCBook/Sample1.dsw8               /opt/rtr/RTR400/examples/ABCBook/Sample1.h9               /opt/rtr/RTR400/examples/ABCBook/Sample1.mkyB               /opt/rtr/RTR400/examples/ABCBook/readme_abcbook.html9               /opt/rtr/RTR400/examples/rtr/rtr_ivp_osf.sh 3               /opt/rtr/RTR400/examples/rtr/rtrreq.c 3               /opt/rtr/RTR400/examples/rtr/rtrsrv.c :               /opt/rtr/RTR400/examples/rtradg/adg_client.c:               /opt/rtr/RTR400/examples/rtradg/adg_header.h:               /opt/rtr/RTR400/examples/rtradg/adg_server.c:               /opt/rtr/RTR400/examples/rtradg/adg_shared.c/               /opt/rtr/RTR400/hlp/copyright.txtf-               /opt/rtr/RTR400/hlp/license.txtw    H                                                  Quick Installation 1-11 _               Quick InstallationI!      1.4 Installing RTR for SunOS   &            /opt/rtr/RTR400/hlp/rtr.hlb.            /opt/rtr/RTR400/hlp/rtr_relnotes.ps/            /opt/rtr/RTR400/hlp/rtr_relnotes.txt $            /opt/rtr/RTR400/lib/rtr.h'            /opt/rtr/RTR400/lib/rtr_v2.ha'            /opt/rtr/RTR400/lib/rtrapi.h *            /opt/rtr/RTR400/mon/accfail.mon*            /opt/rtr/RTR400/mon/acp2app.mon)            /opt/rtr/RTR400/mon/active.mon *            /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.mono+            /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.mont(            /opt/rtr/RTR400/mon/event.mon+            /opt/rtr/RTR400/mon/facility.monr/            /opt/rtr/RTR400/mon/fastrecovery.mong,            /opt/rtr/RTR400/mon/flostalls.mon'            /opt/rtr/RTR400/mon/flow.mon +            /opt/rtr/RTR400/mon/frontend.mon (            /opt/rtr/RTR400/mon/group.mon&            /opt/rtr/RTR400/mon/ipc.mon*            /opt/rtr/RTR400/mon/ipcrate.mon)            /opt/rtr/RTR400/mon/jcalls.mon *            /opt/rtr/RTR400/mon/jnlhtml.mon*            /opt/rtr/RTR400/mon/journal.mon'            /opt/rtr/RTR400/mon/link.mon +            /opt/rtr/RTR400/mon/netbytes.mone*            /opt/rtr/RTR400/mon/netstat.mon'            /opt/rtr/RTR400/mon/ortr.monn)            /opt/rtr/RTR400/mon/partit.mon.)            /opt/rtr/RTR400/mon/queues.mons)            /opt/rtr/RTR400/mon/quorum.monl&            /opt/rtr/RTR400/mon/rdm.mon+            /opt/rtr/RTR400/mon/recovery.mon *            /opt/rtr/RTR400/mon/rejects.mon          1-12 Quick Installation           H                                                       Quick InstallationH                                             1.4 Installing RTR for SunOS  -               /opt/rtr/RTR400/mon/rejhist.mon .               /opt/rtr/RTR400/mon/response.mon)               /opt/rtr/RTR400/mon/rfb.mond.               /opt/rtr/RTR400/mon/rolequor.mon-               /opt/rtr/RTR400/mon/routers.moni-               /opt/rtr/RTR400/mon/routing.monp+               /opt/rtr/RTR400/mon/rscbe.mont)               /opt/rtr/RTR400/mon/rtr.mon ,               /opt/rtr/RTR400/mon/stalls.mon.               /opt/rtr/RTR400/mon/stccalls.mon,               /opt/rtr/RTR400/mon/system.mon)               /opt/rtr/RTR400/mon/tps.moni+               /opt/rtr/RTR400/mon/tpslo.monc-               /opt/rtr/RTR400/mon/traffic.mon +               /opt/rtr/RTR400/mon/trans.mon .               /opt/rtr/RTR400/mon/upstream.mon-               /opt/rtr/RTR400/mon/v2calls.mon (               /opt/rtr/RTR400/mon/xa.mon-               /opt/rtr/RTR400/shlib/librtr.soL/               /opt/rtr/RTR400/shlib/librtr_r.so 3               /opt/rtr/RTR400/shlib/librtrapicpp.so 5               /opt/rtr/RTR400/shlib/librtrapicpp_r.soT4               /opt/rtr/RTR400/wbi/graphics/blank.jpg;               /opt/rtr/RTR400/wbi/graphics/closedfolder.gifn2               /opt/rtr/RTR400/wbi/graphics/doc.gif7               /opt/rtr/RTR400/wbi/graphics/lastnode.gifn3               /opt/rtr/RTR400/wbi/graphics/link.gify3               /opt/rtr/RTR400/wbi/graphics/node.gifi9               /opt/rtr/RTR400/wbi/graphics/openfolder.gifr7               /opt/rtr/RTR400/wbi/graphics/vertline.gifp4               /opt/rtr/RTR400/wbi/images/backend.gif8               /opt/rtr/RTR400/wbi/images/backgrndbur.gif3               /opt/rtr/RTR400/wbi/images/banner.gifh6               /opt/rtr/RTR400/wbi/images/cmpnylogo.gifB               /opt/rtr/RTR400/wbi/images/configuration_example.gifF               /opt/rtr/RTR400/wbi/images/ext_configuration_example.gif4               /opt/rtr/RTR400/wbi/images/f-4orig.gif4               /opt/rtr/RTR400/wbi/images/f-6orig.gif9               /opt/rtr/RTR400/wbi/images/fail_backend.gift<               /opt/rtr/RTR400/wbi/images/fournode_shadow.gif8               /opt/rtr/RTR400/wbi/images/ie_animated.gif6               /opt/rtr/RTR400/wbi/images/newredbar.gif3               /opt/rtr/RTR400/wbi/images/noprog.gifa    H                                                  Quick Installation 1-13    l            Quick Installation !      1.4 Installing RTR for SunOSs  A            /opt/rtr/RTR400/wbi/images/partition_states_shadow.gifl2            /opt/rtr/RTR400/wbi/images/progress.gifA            /opt/rtr/RTR400/wbi/images/requester_states_shadow.gif 0            /opt/rtr/RTR400/wbi/images/rtrscr.gif1            /opt/rtr/RTR400/wbi/images/rtrscrn.gif 7            /opt/rtr/RTR400/wbi/images/security_html.gift>            /opt/rtr/RTR400/wbi/images/server_states_shadow.gif8            /opt/rtr/RTR400/wbi/images/zko-gs001-99ai.gif8            /opt/rtr/RTR400/wbi/images/zko-gs003-99ai.gif8            /opt/rtr/RTR400/wbi/images/zko-gs005-99ai.gif8            /opt/rtr/RTR400/wbi/images/zko-gs006-99ai.gif8            /opt/rtr/RTR400/wbi/images/zko-gs007-99ai.gif8            /opt/rtr/RTR400/wbi/images/zko-gs009-99ai.gif8            /opt/rtr/RTR400/wbi/images/zko-gs015-99ai.gif1            /opt/rtr/RTR400/wbi/rtr_accept_node.js 3            /opt/rtr/RTR400/wbi/rtr_command_displ.jsl2            /opt/rtr/RTR400/wbi/rtr_command_form.js0            /opt/rtr/RTR400/wbi/rtr_create_fac.js0            /opt/rtr/RTR400/wbi/rtr_create_jou.js0            /opt/rtr/RTR400/wbi/rtr_create_par.js1            /opt/rtr/RTR400/wbi/rtr_create_tree.jsn5            /opt/rtr/RTR400/wbi/rtr_create_tree_sub.js 0            /opt/rtr/RTR400/wbi/rtr_delete_fac.js0            /opt/rtr/RTR400/wbi/rtr_delete_par.js0            /opt/rtr/RTR400/wbi/rtr_extend_fac.js2            /opt/rtr/RTR400/wbi/rtr_left_frame.html/            /opt/rtr/RTR400/wbi/rtr_log_displ.jsa,            /opt/rtr/RTR400/wbi/rtr_main.html0            /opt/rtr/RTR400/wbi/rtr_modify_jou.js-            /opt/rtr/RTR400/wbi/rtr_monitor.jst-            /opt/rtr/RTR400/wbi/rtr_set_btx.jsm-            /opt/rtr/RTR400/wbi/rtr_set_fac.jsa-            /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 0            /opt/rtr/RTR400/wbi/smm_contents.html4            /opt/rtr/RTR400/wbi/smm_contents_001.html4            /opt/rtr/RTR400/wbi/smm_contents_002.html-            /opt/rtr/RTR400/wbi/smm_index.htmlt1            /opt/rtr/RTR400/wbi/smm_index_001.html %            [ verifying class <none> ]           1-14 Quick Installation o  n      H                                                       Quick InstallationH                                             1.4 Installing RTR for SunOS  .               ## Executing postinstall script.;               # Copyright 1994 Compaq Computer Corporation.                # V               # Confidential computer software. Valid license from Compaq required forP               possession, use or copying. Consistent with FAR 12.211 and 12.212,P               Commercial Computer Software, Computer Software, Computer SoftwareT               Documentation, and Technical Data for Commercial Items are licensed toL               the U.S. Government under vendors standard commercial license.               #cS               # Compaq, the Compaq logo, and the Digital logo are registered in the /               U.S. Patent and Trademark Office.dC               This kit will only run on Sun Solaris 2.5 and higher.dE               Installation should complete in approximately 1 minute.lO               Solaris 2.6 or higher: selecting multithreaded rtr to exploit aioT9               Copyright 1994 Compaq Computer Corporation.-T               Confidential computer software. Valid license from Compaq required forP               possession, use or copying. Consistent with FAR 12.211 and 12.212,P               Commercial Computer Software, Computer Software, Computer SoftwareX               Documentation, and Technical Data for Commercial Items are licensed to theH               U.S. Government under vendors standard commercial license.  Q               Compaq, the Compaq logo, and the Digital logo are registered in the /               U.S. Patent and Trademark Office.s  F               Starting     Reliable Transaction Router V4.0  for SunOS1               Installation Verification Procedure 8               WARNING: This is not a first time install.L               WARNING: Please ensure that you have terminated *all* existingL               WARNING: rtr processes and rtr applications before continuing.U               Rtr will find and reuse any existing rtr journal files in the top level N               rtrjnl directory on each suitable filesystem, and will reuse anyJ               existing shared memory segment associated with /rtr/RTRENVPSJ               Normally this is intended and should not cause any problems.  P               WARNING: Any existing journal will be used and modified, otherwiseO               WARNING: a new journal will be created on the default filesystem.iK               WARNING: Facilities RTR_IVP_FACILITY and RTR will be created.d  [               WARNING: Result may be affected by size and contents of any existing journal. W               WARNING: The sample client and server do not necessarily complete if they Y               WARNING: encounter previously journalled transactions for their facilities.o  R               NOTE: The following question is ignored in a non-interactive installL               NOTE:unless NONABI_SCRIPTS=TRUE, see man pkgadd for details...  4               Would you like to abort the IVP? (y/n)  H                                                  Quick Installation 1-15 d  n            Quick Installationp!      1.4 Installing RTR for SunOSI              IVP aborted  0            Installation of <rtr> was successful.  0            The following packages are available:  3              1  rtr     Reliable Transaction Router.#                         (sun4u) 400M  C            Select package(s) you wish to process (or all to processo'            all packages). (default:all)I  A            script done on Wed Dec 13 16:43:06 2000 all packages). %            (default: all) [?,??,q]: q                                                                     1-16 Quick Installation t  d                  H                                                                        2H         ________________________________________________________________  H                                                          Upgrade Process      8               To upgrade RTR, use the following process:                 1. Shutdown RTRt                 2. Uninstall RTR                 3. Install RTR  '               4. Run the IVP (optional)"                 5. Start RTR  (         2.1 Rolling Upgrade Restrictions  E               Take note of the following restrictions if upgrading ans4               RTR environment from RTR V3.2 to V4.0.  A               The RTR recovery protocol consists of messages sent D               from one backend, via a router, to the target backend.D               If either of the RTR backends is upgraded to RTR V4.0,F               then the router that will be used for recovery must alsoD               be running RTR V4.0. This generally means that any RTRH               router nodes should be upgraded to RTR V4.0 before any RTRF               backend nodes. There is no restriction in the order that6               RTR backends should be upgraded to V4.0.  C               The order in which RTR nodes should be upgraded for a >               rolling upgrade from V3.2 to V4.0 is as follows:  @               1. Frontend-only nodes can be upgraded at any time  <               2. Router-only and mixed frontend/router nodes  +               3. Mixed router/backend nodesC  "               4. Router-only nodes  #               5. Backend-only nodes   H                                                      Upgrade Process 2-1    u            Upgrade Process%      2.1 Rolling Upgrade Restrictionse  A            For more complex configurations, where a node may havegC            combinations of facilities with different backend/router B            groupings, use the command SET NODE/RECOVERY=V32 to set@            the recovery protocol to the V3.2 algorithm. Once RTRD            has been upgraded on all nodes, the recovery protocol canB            be reset to its default value (V4.0), and RTR restarted@            at a convenient time on each node. This need not be aE            simultaneous restart on all nodes. RTR can be restarted on D            each node one by one after resetting the default recoveryC            protocol, so that continuous application availability isl            maintained.        2.2 Uninstalling RTR   @            Remove commands do not remove all RTR files from your=            disks. This is particularly important when you arenA            upgrading from one version of RTR to another. You mustiA            eliminate all RTR files from your system, but must notsD            discard any customized monitor files in /rtr or a journal?            containing recoverable transactions in /rtrjnl. Copy E            these to another directory before completing the uninstall             instructions.  ;            If /rtrjnl or /rtr is a symbolic link to another E            directory, first remove the target directory and all files >            contained in it, and then remove the symbolic link.  "      2.2.1 Uninstalling on OpenVMS  B            Complete the following steps to uninstall RTR from your            system.  3            o  Stop all RTR processes on the system:t                 $ RTR STOP RTR%               $ RTR DISCONNECT SERVERr  @            o  Check for any surviving processes such as rtrd andB               applications programmed to handle RTR_STS_NOACP, andE               terminate any such processes until there are none left.kD               Note that all the RTR ACP and comserver processes mustE               be terminated before rtrd, otherwise they will create a                new rtrd./          2-2 Upgrade Process           H                                                          Upgrade ProcessH                                                     2.2 Uninstalling RTR  E                  The rtrd process can now be terminated with the STOPk=                  command or by issuing the following command:A  )                  $ RTR DISC SERVER/DAEMONm  F               o  Terminate all application processes linked to RTR. IfE                  you are running in a cluster configuration, you mustCF                  remove RTR application processes from all the clusterC                  members that use the disk where RTR was installed.a  F                  Processes can be terminated with the STOP command, or0                  by a program that uses $FORCEX.  B                  To verify that no RTR-related processes are stillB                  running on a node or cluster member, use the SHOWD                  DEVICE/FILES command to make sure that there are noB                  remaining SYS$SHARE:LIBRTR*.EXE shareable images.  -               o  Remove RTR from your system.d  %                  $ PRODUCT REMOVE RTRs  -         2.2.2 Uninstalling on Windows Systems/  H               You must perform the following actions before uninstalling&               RTR on a Windows system:  D               o  If RTR has previously been registered as a service,H                  unregister RTR as a service. Do this with the following7                  menu selections from the Program menu:e  4                  Compaq -> RTR -> Unregister Service  E               o  Delete all *.LCK files located in the directory used E                  for the previous installation, and the RTRenvps fileo!                  (shared memory).   6               o  Stop all RTR processes on the system:                     RTR STOP RTR'                   RTR DISCONNECT SERVER   A                  If you are uninstalling RTR Version 4.0, use the                    /DAEMON option:  .                   RTR DISCONNECT SERVER/DAEMON  F                  You can also use the Shutdown command, which executes                  Shutdown.bat.  5                  Programs-> Compaq -> RTR -> Shutdownr  H                                                      Upgrade Process 2-3 0  n            Upgrade Process      2.2 Uninstalling RTR   @            o  Check for any surviving processes such as rtrd andB               applications programmed to handle RTR_STS_NOACP, andE               terminate any such processes until there are none left.mD               Note that all the RTR ACP and comserver processes mustE               be terminated before rtrd, otherwise they will create aa               new rtrd./  >               The rtrd process can now be terminated with this               command:  &               $ RTR DISC SERVER/DAEMON  ?               To verify that no RTR-related processes are still @               running on a node or cluster member, check for theC               existence of the rtrdll.dll file. The rtrdll.dll files0               cannot be deleted if it is in use.  E            o  To uninstall RTR, perform one of the following options:n  4               Programs -> Compaq -> RTR -> Uninstall                 or  >               Control Panel -> Add/Remove Programs -> Reliable.               Transaction Router -> Add/Remove  C            o  Terminate all application processes linked to RTR. IfnB               you are running in a cluster configuration, you mustC               remove RTR application processes from all the clustern@               members that use the disk where RTR was installed.  <            o  Remove previous versions of RTR from the disk:                 DEL /S/Q C:\RTRn  ,      2.2.3 Uninstalling on Compaq Tru64 UNIX  B            Complete the following steps to uninstall RTR from your            system.  3            o  Stop all RTR processes on the system:                  # rtr stop rtr%               # rtr disconnect server   @            o  Check for any surviving processes such as rtrd andB               applications programmed to handle RTR_STS_NOACP, andE               terminate any such processes until there are none left.oD               Note that all the RTR ACP and comserver processes mustE               be terminated before rtrd, otherwise they will create a/               new rtrd.         2-4 Upgrade Process           H                                                          Upgrade ProcessH                                                     2.2 Uninstalling RTR  E                  The rtrd process can now be terminated with the KILL =                  command or by issuing the following command:r  )                  $ RTR DISC SERVER/DAEMONr  B                  To verify that no RTR-related processes are stillC                  running on a node or cluster member, use the fuserrB                  or lsof command to make sure that the threaded orG                  unthreaded librtr*.so shared libraries are not in use.   F               o  Terminate all application processes linked to RTR. IfE                  you are running in a cluster configuration, you musteF                  remove RTR application processes from all the clusterC                  members that use the disk where RTR was installed.t  ?               o  Uninstall all previous versions that you find:b  &                  # setld -d RTRBASE4xx  2                  where "xx" is the version number.  B               o  Remove all RTR files with the following commands:  F                 ________________________Note  ________________________  B                 The last directory is user configurable, so verify?                 its location before executing the last command.   E                 _____________________________________________________r                    rm -rf /rtr                  rm -rf /rtrjnl $                  rm -rf /usr/opt/rtr  !         2.2.4 Uninstalling on Sunm  E               Complete the following steps to uninstall RTR from youri               system.r  6               o  Stop all RTR processes on the system:                    # rtr stop rtrd(                  # rtr disconnect server  C               o  Check for any surviving processes such as rtrd andaE                  applications programmed to handle RTR_STS_NOACP, andoH                  terminate any such processes until there are none left.G                  Note that all the RTR ACP and comserver processes must.H                  be terminated before rtrd, otherwise they will create a                  new rtrd.  H                                                      Upgrade Process 2-5                 Upgrade Process      2.2 Uninstalling RTRp  B               The rtrd process can now be terminated with the KILL:               command or by issuing the following command:  &               $ RTR DISC SERVER/DAEMON  C            o  Terminate all application processes linked to RTR. If/B               you are running in a cluster configuration, you mustC               remove RTR application processes from all the cluster-@               members that use the disk where RTR was installed.  ?               To verify that no RTR-related processes are still @               running on a node or cluster member, use the fuser?               or lsof command to make sure that the threaded orwD               unthreaded librtr*.so shared libraries are not in use.  <            o  Uninstall all previous versions that you find:                 # pkgrm rtrt  ?            o  Remove all RTR files with the following commands:   C               ________________________Note ________________________T  @               The last directory is user configurable, so verify=               its location before executing the last command.   C               _____________________________________________________4                 rm -rf /rtr                rm -rf /rtrjnl               rm -rf /opt/rtr/                                  2-6 Upgrade Process w  r                  H                                                                        3H         ________________________________________________________________  G                                            Full Installation on OpenVMSr      H               This chapter describes how to install Reliable TransactionF               Router on OpenVMS for both OpenVMS VAX and OpenVMS Alpha               systems.  F               A step-by-step description of the installation procedure               is given.p  &         3.1 Preparing for Installation  F               Before you start the installation, complete the prepara-2               tion tasks outlined in this section.  %         3.1.1 Accessing Release Notes   F               To access the Reliable Transaction Router Release Notes,               type the command:n  H               $ PRODUCT EXTRACT RELEASE_NOTES RTR /file=rtr_relnotes.txt  E               You should read the Release Notes before using Reliable !               Transaction Router.i  0         3.1.2 Prerequisite and Optional Software  F               Table 3-1 provides information on the software that mustD               be installed on your system before installing ReliableE               Transaction Router. The table also includes informationsD               about optional software that you can use with ReliableH               Transaction Router. The Software Product Description (SPD)C               contains a complete list of prerequisite and optional :               software and their required version numbers.        H                                        Full Installation on OpenVMS  3-1 e  i      !      Full Installation on OpenVMS #      3.1 Preparing for Installationi  E            Table_3-1_Prerequisite_and_Optional_Software______________r  E            Prerequisite_Products______Purpose________________________s  5            OpenVMS VAX Version        System Software             6.2,7.1,7.2,7.3  
            or.  5            OpenVMS Alpha Version      System Softwarer            6.2,7.1,7.2,7.3  E            __________________________________________________________eE            Optional_Products__________Purpose________________________c  7            Compaq TCP/IP Services     Network Transport,#            for OpenVMS (Version 4.2i            or higher).  7            DECnet (Version 6.2 or     Network Transport !            higher) or DECnet-Plus             (Version 6.3 ECO5 oraE            higher)___________________________________________________t  =            The Installation Verification Procedure (IVP) wille<            complete successfully only if at least one of the<            supported network protocols (DECnet or TCP/IP) is            installed.   D            There is no longer a requirement that you must register a            software license.        3.1.3 Required Disk Space  >            Reliable Transaction Router's requirements for free?            disk storage space are different during installationpC            and after installation. Table 3-2 summarizes the storagea            requirements.              %      3-2 Full Installation on OpenVMS     a      G                                            Full Installation on OpenVMSlH                                           3.1 Preparing for Installation  H               Table_3-2_Disk_Space_Requirements_________________________  F                                     Blocks During         Blocks AfterH               Kit___________________Installation__________Installation__  ?               Reliable Transaction  50000                 36000c                Router for OpenVMS               VAXS  ?               Reliable Transaction  50000                 36000e                Router for OpenVMSH               Alpha_____________________________________________________  H               To determine the number of free disk blocks on the currentA               system disk, enter the following command at the DCLu               prompt:l  )               $ SHOW DEVICE SYS$SYSDEVICE            3.1.4 System Parametersu  D               Installing Reliable Transaction Router for OpenVMS mayB               mean that you have to increase some system parameterG               values. Table 3-3 lists the minimum free amount of globallF               pages and global sections required for the installation.  ?               Table 3-3 System Parameter Values Used by the RTRaH               __________Installation____________________________________  H               System_Parameter___________Required_Amount________________  -               GBLPAGES                   4000   H               GBLSECTIONS________________4______________________________  "         3.2 Installation Procedure  L               If RTR is already installed on your system, see Section 2.2.1,F               Uninstalling on OpenVMS, for information on uninstalling1               RTR and removing related processes.p  >               Log on to the System Manager's account to do the               installation.     H                                        Full Installation on OpenVMS  3-3 e  p      !      Full Installation on OpenVMS       3.2 Installation Procedureo  A            The Reliable Transaction Router installation procedureeD            uses the POLYCENTER Software Installation Utility (PCSI).A            For details on using PCSI, refer to the OpenVMS SystemTD            Manager's Manual, Section "Installing with the POLYCENTER*            Software Installation Utility."  =            The logical name PCSI$SOURCE is used to define the A            location of the software kits you want to install. For B            example, if the Reliable Transaction Router software isB            located in DISK1:[KITS], enter the following at the DCLD            prompt (or include the line in the system manager's login            command file):f  ,            $ DEFINE PCSI$SOURCE DISK1:[KITS]        3.2.1 Installing RTR   B            The installation prompts you with questions. Enter your@            response to each question and press the <Return> key.E            Defaults are shown in square brackets, for example, [YES].R  8            To start the installation, enter the command:               $ PRODUCT INSTALL RTR  6            A display similar to the following appears:  3            The following product has been selected:=O                DEC AXPVMS RTR V4.0-0                Layered Product [Installed]   )            Do you want to continue? [YES]c  +            Configuration phase starting ...d  U            You will be asked to choose options, if any, for each selected product andsP            for any products that may be installed to satisfy software dependency            requirements.  U            DEC AXPVMS RTR V4.0-0: Reliable Transaction Router for OpenVMS [Installed]   7              Copyright 1996 Compaq Computer Corporation   =            Do you want the defaults for all options? [YES] noe  E              Have all RTR processes on the system been stopped? [YES]t=              Run installation verification procedure [NO] yes   Y              DECnet users:Have you read the Release Note regarding minimum version? [YES]   %      3-4 Full Installation on OpenVMS  /         G                                            Full Installation on OpenVMS H                                               3.2 Installation Procedure  F                 Do you want the V2 programming kit installed? [NO] yes  5               Do you want to review the options? [NO]e  *               Execution phase starting ...  6               The following product will be installed:F                   DEC AXPVMS RTR V4.0-0                Layered Product  N               Portion done: 0%...10%...20%...30%...40%...50%...80%...90%...10%  7               The following product has been installed: G                   DEC AXPVMS RTR V4.0-0                 Layered Productc  L               DEC AXPVMS RTR V4.0-0: Reliable Transaction Router for OpenVMS  N                   Insert the following lines in SYS$MANAGER:SYSTARTUP_VMS.COM:2                       @sys$startup:rtr$startup.comJ                   Insert the following lines in SYS$MANAGER:SYSHUTDWN.COM:/                       @sys$manager:rtr$shutdown             3.3 After Installing RTR  9               After completing the installation, you can:a  %               o  Access Release Notes   "               o  Edit system files  1               o  Verify user account requirementst  "         3.3.1 Editing System Files  D               You must edit the system startup and shutdown files toC               provide for automatic startup and the installation ofnD               Reliable Transaction Router images when your system is               rebooted.m  C               Add the command line that starts Reliable TransactionuG               Router to the system startup file, SYS$MANAGER:SYSTARTUP_aE               VMS.COM. Reliable Transaction Router cannot start until C               after the network has started. You must position this F               new command line after the lines that invoke the network)               startup command procedures.   B               Add the command line that stops Reliable TransactionL               Router to the system shutdown file, SYS$MANAGER:SYSHUTDWN.COM.  H                                        Full Installation on OpenVMS  3-5 V  T      !      Full Installation on OpenVMSw      3.3 After Installing RTR   $      3.3.2 User Account Requirements  B            To work with Reliable Transaction Router, user accountsB            on your system must have certain quotas and privileges.=            The next two sections contain information on these             requirements.        3.3.2.1 Quotas   A            Table 3-4 summarizes the required user account quotas.   ;            Table 3-4 User Account Quotas for Using ReliableeE            __________Transaction_Router______________________________l  E            Account_Quota____Value____________________________________r  )            ASTLM            At least 2000T  )            BIOLM            At least 2000S  /            BYTLM            At least 150000 [1]R  )            DIOLM            At least 2000A  )            TQELM            At least 2000EE            [1]At_least_80000_for_accounts_running_RTR_applications.__a  A            At least 150000 for accounts running the RTR ACP. This C            may need to be increased to accommodate large numbers of D            application programs and/or users. The formula to use is:A            32K + 32K * n where n equals the number of applicationnA            processes plus the number of users in the ACP's group.pE            __________________________________________________________h        3.3.2.2 Privilegesn  C            To use the features of Reliable Transaction Router, eachs6            account must have the following privileges:              o  NETMBX              o  TMPMBX              o  SYSLCK  C            In addition, the Rights Identifier RTR$INFO is required.   C            The RTR System Manager (that is, the account that startsnD            up RTR and creates facilities) must also have either OPER@            privilege or have the Rights Identifier RTR$OPERATOR.  %      3-6 Full Installation on OpenVMS            G                                            Full Installation on OpenVMSnH                                           3.4 Files Installed on OpenVMS  &         3.4 Files Installed on OpenVMS  >               To see the files installed on your system by the>               installation process, use the following command:  ;               $ PRODUCT LIST RTR/SOURCE=[pcsi kit location]                                                                               H                                        Full Installation on OpenVMS  3-7 d                     H                                                                        4H         ________________________________________________________________  H                                          Full Installation on Windows NT      F               This chapter describes a full installation on Windows NTH               to run RTR as a server. For information on Windows 2000 orF               on installing RTR for client applications on Windows 95,9               Windows 98, or Windows ME, see Section 1.2.   E               The installation of the RTR base product requires about F               five megabytes of disk space. The installation procedure2               takes about two minutes to complete.  &         4.1 Preparing for Installation  D               Before you start the installation, review the hardwareB               and software requirements described in the following               sections.   '         4.1.1 Accessing the Readme fileT  E               The Readme file provides information for RTR that couldmF               not be included in the printed documentation. The ReadmeG               file is located in the directory where you installed RTR;sA               you should read the Readme file before you use RTR.   #         4.1.2 Hardware Requirementsf  G               o  For full-function functionality, any Intel system thatr=                  runs Windows 2000 or Windows NT Version 4.0.r  B               o  For frontend functionality, any Intel system thatC                  runs Windows 2000, Windows NT Version 4.0, Windows /                  95, Windows 98, or Windows ME.u          H                                      Full Installation on Windows NT 4-1           $      Full Installation on Windows NT#      4.1 Preparing for Installation          4.1.3 Software Requirements  >            o  Windows NT Version 4.0, Windows 2000, Windows MEA               (client only), Windows 98 (client only), or Windows_               95 (client only)._              o  TCP/IP  E            o  For Windows 2000, Microsoft Windows 2000 Service Pack 1o               is required.  D            o  For Windows NT, Microsoft Windows NT Service Pack 3 isC               required as a minimum. Service Pack 4 is recommended.   E            o  For Windows 98, Second Edition or Customer Service Packt0               plus the Y2K Update is recommendd.  C            o  For Windows 95, Service Release 2 plus the Y2K Update                is recommended.e        4.2 Installation Procedure   B            1. If you are installing on Windows 2000 or Windows NT,D               ensure that you are logged in as the Administrator, or,               have administrator privileges.  =            2. If RTR is already installed on your system, seenA               Section 2.2.2, Uninstalling on Windows Systems, forPB               information on uninstalling RTR and removing related               processes.  /            3. Insert the RTR CD into the drive.   5            4. Exit all Windows programs to run Setup.s  D            5. From the Start button, invoke Windows Explorer to view               files.  @            6. Choose the drive letter of your CDROM and open theA               directory I386. Double click on the file SETUP.EXE.RB               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.  (      4-2 Full Installation on Windows NT           H                                          Full Installation on Windows NTH                                               4.2 Installation Procedure  B               8. Accept the terms of the License Agreement. If you;                  reject the terms, installation is stopped.   H               9. Follow the screen instructions to enter the name of theH                  directory where you want to install RTR. The default is  ,                  C:\Program Files\Compaq\Rtr  G                  Compaq recommends that you install RTR on a local hard $                  disk (NTFS or FAT).  F              10. Choose the Setup Type: Typical, Compact, or Custom by7                  selecting a radio button. Choices are:/  B                  o  Typical: RTR is installed with the most common8                     options. Recommended for most users.  G                  o  Compact: RTR is installed with the minimum required_C                     options. Selecting compact installs RTR with no "                     example files.  G                  o  Custom: Choose the options to install (for advancedsF                     users only). Choose this to install an add-on such2                     as RTR as a Service (NT only).  E                  If you select Custom, the components screen appears.vA                  Choose components to install. The screen displayoC                  indicates how much disk space is required for eachi                  component.t  F                 ________________________Note  ________________________  C                 RTR as a Service runs only on Windows NT or Windowsc=                 2000; the InstallShield does not register thef?                 service but RTR provides batch procedures to do +                 so in the target directory.r  E                 _____________________________________________________   D              11. Setup adds a program icon to the Program Folder youH                  select, and installs files in the appropriate location.  >              12. The InstallShield completes the installation,D                  displaying a progress graphic until installation is                  complete.  E              13. Click on Finish to complete the installation of RTR.c  H                                      Full Installation on Windows NT 4-3 q  e      $      Full Installation on Windows NT      4.3 After Installing         4.3 After Installing   @            If you install RTR on an NTFS drive, you will need toD            give RTR users access to the RTR directories. Use WindowsD            Explorer and select the RTR root directory. Pull down theB            Security menu and choose File permissions. Give the RTRC            root directory and all its subdirectories "Full Control" A            access for all RTR users. You may then restrict access7C            on individual files to read only. (All RTR users require_6            write access to the RTR journal directory.)  C               ________________________Note ________________________   A               The Windows registry will be modified slightly as ao+               result of a RTR installation.o  C               _____________________________________________________   0      4.4 Files Installed on Microsoft Windows NT  =            Navigate to the directory where you installed RTR.a  D            To see a list of the files installed, enter the following            command:               Tree/F                                       (      4-4 Full Installation on Windows NT                       H                                                                        5H         ________________________________________________________________  H                                   Full Installation on Compaq Tru64 UNIX      H               This chapter provides descriptions of all steps in doing a*               full installation including:  +               o  Preparing for installation                  o  Installing   +               o  Verifying the installation   ?         5.1 Preparing for RTR Installation on Compaq Tru64 UNIXa  F               Before you start the installation, complete the prepara-2               tion tasks outlined in this section.  4         5.1.1 Checking the Software Distribution Kit  D               RTR software is distributed on CD-ROM. Use the Bill ofH               Materials (BOM) to check the contents of your RTR software               distribution kit.   .         5.1.2 Reading the Online Release Notes  @               The Release Notes provide information for RTR thatA               could not be included in the printed documentation.dE               After installation the Release Notes are located in theyH               directory /usr/opt/RTR400/hlp; you are advised to read the-               Release Notes before using RTR.   H               To read the release notes, navigate to the directory where?               RTR is installed and issue the following command:t  #               more rtr_relnotes.txt       H                               Full Installation on Compaq Tru64 UNIX 5-1 a         +      Full Installation on Compaq Tru64 UNIX <      5.1 Preparing for RTR Installation on Compaq Tru64 UNIX  ,      5.1.3 Registering Your Software License  C            RTR includes support for the License Management Facility_F            (LMF). You must register your License Product AuthorizationC            Key (License PAK) in the License Database (LDB) in order_C            to use RTR on a newly licensed node. The License PAK may C            be shipped along with the kit if you ordered the license E            and media together; otherwise, it is shipped separately to 2            a location based on your license order.  C            If you are installing RTR as an update on a node already E            licensed for this software, you have already completed then1            License PAK registration requirements.   B            If you are installing prerequisite or optional software@            along with RTR, review the PAK status and install theD            PAKs for any prerequisite or optional software before you            install RTR.   <            To register a license under the Compaq Tru64 UNIX7            operating system, first log in as superuser.w  C            At the superuser prompt, edit an empty PAK template withsC            the lmf register command as follows, and include all then+            information on your License PAK:e              #  lmf register  A            After you register your license, use the following lmftE            reset command to copy the license details from the Licenses.            Database (LDB) to the kernel cache:              #  lmf reset:  C            For complete information on using the License ManagementmE            Facility, see the Guide to Software License Management andn%            the lmf(8) reference page.   -      5.1.4 Checking Installation Requirementsl  B            This section discusses requirements for installing RTR.  =            Installing RTR, including running the InstallationlB            Verification Procedure (IVP), takes approximately 10 toA            15 minutes, depending on your type of media and system             configuration.d  /      5-2 Full Installation on Compaq Tru64 UNIX            H                                   Full Installation on Compaq Tru64 UNIXG                 5.1 Preparing for RTR Installation on Compaq Tru64 UNIXt  )         5.1.4.1 Checking Login Privilegese  C               You must have superuser privileges to install the RTR                software.e  .         5.1.4.2 Checking Hardware Requirements  >               To install RTR, you need the following hardware:  H               o  Software distribution device (if installing from media)  @                  Locate the CD-ROM drive for the CD-ROM softwareH                  distribution media. The CD booklet or the documentationH                  for the CD-ROM drive you are using explains how to load"                  the CD-ROM media.                 o  Terminal   >                  You can use a hardcopy or video terminal or aE                  workstation to communicate with the operating systemyH                  and respond to prompts from the installation procedure.  @               See the RTR Software Product Description (SPD) for/               additional hardware requirements.c  .         5.1.4.3 Checking Software Requirements  H               RTR requires that the following Compaq Tru64 UNIX softwareC               subset be loaded on the system where you install RTR:   /               o  OSFBASE-the Base System subset   /               One of the following is required:                  o  DECnetE  7               o  Compaq DECnet-Plus for Tru64 UNIX V4.0S                 o  TCP/IPt  B               The following Compaq Tru64 UNIX software subsets are;               optional on the system where you install RTR:t  G               o  OSFCLINET200-Basic Networking Services (TCP/IP) subsets  G               o  DNABASE110-DECnet/OSI Base Components subset, together                   withi  B               o  DNANETMAN110-DECnet/OSI Network Management subset  E               To check whether these subsets are loaded, follow theser               steps:  A               1. Log in to the system where you will install RTR.m  H                               Full Installation on Compaq Tru64 UNIX 5-3           +      Full Installation on Compaq Tru64 UNIXn<      5.1 Preparing for RTR Installation on Compaq Tru64 UNIX  *            2. Enter the following command:  .               # setld -i | egrep 'OSFBASE|DNA'  D            If your path is not set as /usr/sbin/, you must enter the1            full path of the command. For example:   5            % /usr/sbin/setld -i | egrep 'OSFBASE|DNA'i  @            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 (theW@            second column in a row is blank), the subset or patchA            is not loaded. In this case, you must load the missing A            Compaq Tru64 UNIX software before installing RTR. (FornD            information on how to load the operating system software,:            see the Guide to Installing Compaq Tru64 UNIX.)  .      5.1.4.4 Determining Which Subsets to Load  #            RTR has only one subset:q              -  rtrbase400  0               RTR runtime and system management.  0      5.1.4.5 Determining Disk Space Requirements  B            Table 5-1 lists the disk space requirements for loadingC            the RTR software subset. These requirements apply to the_@            disks where you load the RTR subset. The requirementsC            are listed by directory for convenience if you are doing E            installations on systems where these directories are mount 0            points for different disk partitions.  E            Table_5-1_RTR_Subset_Size_(Kilobytes_Required)____________T  "                             SubsetE            Subset_Title_____Name________/usr/opt/___/rtr_____________   8            RTR              rtrbase400  57020       1050  E            Total:_______________________58070________________________K  C            Using these disk space requirements, calculate the totalsB            values for the subsets you will load in each directory.@            You will also require disk space for the RTR journal,%            which defaults to /rtrjnl.   /      5-4 Full Installation on Compaq Tru64 UNIX     a      H                                   Full Installation on Compaq Tru64 UNIXG                 5.1 Preparing for RTR Installation on Compaq Tru64 UNIXI  E               Compare the space required for the subset with the freeaG               space currently on the disks where RTR files will reside.   B               5.1.4.5.1 Checking Current Disk Space   To check theD               current amount of free space for a directory path, logB               in to the system where you will install RTR. You canD               check which directories are mounted and where they are:               by viewing the /etc/fstab file. For example:                 # more /etc/fstabi&               /dev/rd0a:/:rw:1:1:ufs::)               /dev/rd0g:/usr:rw:1:2:ufs::nM               /usr/staff/r1/leslie@bigsys:/usr/staff/r1/leslie:rw:0:0:nfs:bg: 5               /usr/man@bigsys:/usr/man:ro:0:0:nfs:bg:   D               The display indicates that /usr (mounted to /dev/rd0g)G               is the only mount point that affects where RTR files will G               reside; the system has only one local disk drive, and the_H               /usr/lib and file system resides in the g partition of the!               disk on that drive.   A               To check the total space and the free space for theaF               directories where RTR will reside, enter the df command.F               Given the previous display of the /etc/fstab file, whichF               shows that only /usr is a mount point, you need to checkC               free space only in the /usr file system. For example:q                 # df /usr 7               Filesystem   Total    kbytes   kbytes   % F               node         kbytes   used     free     used  Mounted on@               /dev/rd0g     122598   54447   55892    49%   /usr  H               This display shows that there are 55,892 Kbytes free. ThisH               free space must accommodate the subset requirements listedA               in Table 5-1, RTR Subset Size (Kilobytes Required).n  C               On systems where /usr/lib and /usr/man are mounted tomG               different devices from /usr, enter the following command:e  %               #  df /usr/lib /usr/manh  D               In this case, you compare space required for RTR filesG               in /usr/lib to the free space displayed in the first linenG               of the df output list, and compare the space required fornF               RTR files in /usr/man to the free space displayed in the'               second line of that list.   H                               Full Installation on Compaq Tru64 UNIX 5-5 E         +      Full Installation on Compaq Tru64 UNIX <      5.1 Preparing for RTR Installation on Compaq Tru64 UNIX  ?            5.1.4.5.2 Increasing Disk Space by Using Alternative4>            Disks    The RTR installation procedure creates the?            following directory and loads files into subordinates            directories:d              /usr/opt/RTR400  E            If the /usr/opt/RTR400 directory in the previous path doess<            not exist, the installation procedure creates it.  ?            If the RTR400 directory does exist, the installation             procedure uses it.   D            If you find that there is insufficient disk space for theB            RTR subsets and you know that you have additional spaceC            on alternative disks or disk partitions for your system,e=            perform the following steps before installing RTR:   "            1. Log in as superuser.  3            2. Create the directory /usr/lib/RTR400.o  D            3. Specify in the /etc/fstab file that one or more of theD               newly created directories are mount points to new disk9               partitions where there is additional space.   E            4. Enter the mount -a command so that the new mount pointso               take effect.  -      5.1.5 Installing from Media or Using RIS   ?            Someone from your site must perform at least one RTRx?            installation from the distribution medium. Your siteS@            system manager can then decide whether or not to makeE            a RTR distribution kit available online so that subsequent ?            installations of RTR can use the Remote Installation C            Service (RIS). For information on extracting RTR subsets ?            to a RIS distribution area, see the Guide to Sharing ,            Software on a Local Area Network.  B            If you expect to use RTR subsets from the RIS area of aE            remote system for installation on your local system, firstn>            check with your site system manager to ensure that:  5            o  A RTR network kit is available for use.   8            o  Your system is registered as a RIS client.  /      5-6 Full Installation on Compaq Tru64 UNIXe t  f      H                                   Full Installation on Compaq Tru64 UNIXG                 5.1 Preparing for RTR Installation on Compaq Tru64 UNIX   A               If RTR subsets are available to you on a RIS server <               system, you must know the name of that system.  ?               For more information on installing RTR from a RIS 5               distribution area, see Section 5.2.1.2.   )         5.1.6 Backing Up Your System Disk   A               Compaq recommends that you back up your system disk C               before installing any software. For information about D               backing up your system disk, see the Tru64 UNIX system               documentation.  '         5.1.7 Stopping the Installationi  C               To stop the installation procedure at any time, presslC               Ctrl/C. You must then delete files created up to this D               point interactively. The directories and files createdE               during the RTR installation are listed in the following $               file (on your CD-ROM):  0               /rtr40/kit/instctrl/rtrbase400.inv  /         5.2 Installing RTR on Compaq Tru64 UNIX   B               Before you start the installation, read Section 5.1,C               Preparing for RTR Installation on Compaq Tru64 UNIX ._  A               You can install RTR locally (using CD-ROM media) ornF               from a server area. If you encounter any failures during+               installation, see Appendix A.v            5.2.1 Distribution Media  D               You can obtain Reliable Transaction Router software on"               CD-ROM or using RIS.  <         5.2.1.1 Using CD-ROM Consolidated Distribution Media  F               This procedure loads RTR files on to a disk belonging toH               the system where you perform the installation. When RTR isG               run, its executable images are mapped into memory on yourl               system.   B               Follow these steps to install RTR from CD-ROM media:  ?               1. Mount the media on the appropriate disk drive.l  H                               Full Installation on Compaq Tru64 UNIX 5-7 w  T      +      Full Installation on Compaq Tru64 UNIXa,      5.2 Installing RTR on Compaq Tru64 UNIX  A            2. Log in as superuser (login name root) to the system )               where you will install RTR.p  E            3. Make sure you are at the root (/) directory by enteringt$               the following command:                     # cd /  E            4. Use the setld utility to check if you have a version ofo$               RTR already installed:  #               # setld -i | grep RTRs  =            5. If RTR is already installed on your system, seeoC               Section 2.2.3 for information on uninstalling RTR and_)               removing related processes.   A            6. Specify the /CD-ROM directory to be the mount point D               for the distribution file system on the drive. If your8               drive is rz0, enter the following command:  /                   # mount -dr /dev/rz0c /CD-ROM   C            7. Enter a setld command that requests the load functionoC               (-l) and identifies the directory in the mounted file 3               system where RTR subsets are located.   >               For example, if the directory location for theseD               subsets is /CDROM/rtr400, enter the following command:  .                   # setld -l /CDROM/rtr400/kit  C            The installation procedure now displays the names of RTRlB            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 anD            /etc/ris RIS distribution area on a remote system, follow            these steps:   A            1. Log in as superuser (login name root) to the systemr)               where you will install RTR.i  E            2. Make sure you are at the root directory (/) by entering $               the following command:                 #cd /   /      5-8 Full Installation on Compaq Tru64 UNIXe    y      H                                   Full Installation on Compaq Tru64 UNIXG                                 5.2 Installing RTR on Compaq Tru64 UNIXo  F               3. Enter a setld command that requests the load functionD                  (-l option) and identifies the system where the RTRE                  subsets are located. For example, if you are loadingdH                  RTR subsets from a RIS distribution area on node orion,%                  enter the following:   !                  #setld -l orion:   C               Remote Installation Services now displays a menu thateF               lists all the software subsets available to you and asks:               you to specify the subsets you want to load.    :         5.2.2 Responding to Installation Procedure Prompts  F               This section explains the installation procedure prompts               and displays.p  !         5.2.2.1 Selecting Subsetst  B               You must specify which RTR subsets you want to load.  F                 ________________________Note  ________________________  C                 If you are installing from a RIS distribution area, @                 the number of subsets can vary depending on whatC                 products are available in the RIS area and how manyy"                 subsets they have.  E                 _____________________________________________________   4               The subsets listed below are optional:  X                     There may be more optional subsets than can be presented on a singleX                     screen. If this is the case, you can choose subsets screen by screenW                     or all at once on the last screen. All of the choices you make willlX                     be collected for your confirmation before any subsets are installed.  3                     1) RTR API & Management Utilityt  =               Or you may choose one of the following options:t  &                    2) ALL of the above;                    3) CANCEL selections and redisplay menus 9                    4) EXIT without installing any subsetsm  D               Enter your choices or press RETURN to redisplay menus.  -               Choices (for example, 1 2 4-6):c  H                               Full Installation on Compaq Tru64 UNIX 5-9           +      Full Installation on Compaq Tru64 UNIXn,      5.2 Installing RTR on Compaq Tru64 UNIX  =            If you specify more than one number at the prompt,n:            separate each number with a space, not a comma.  E            Next, the script lets you verify your choice. For example,uA            if you enter 1 in response to the previous prompt, youg*            will see the following display:  =            You are installing the following optional subsets:   /                    RTR API & Management Utility   "            Is this correct? (y/n):  A            If the displayed subsets are not the ones you intended A            to choose, enter n. In this case, the subset selection E            menu is again displayed and you can correct your choice of             optional subsets.  B            If the displayed subsets are the ones you want to load,            enter y.   B      5.2.2.2 Monitoring Displays During the Subset Loading Process  E            The installation procedure loads and verifies the selected             RTR subset.  E            The following example shows a display where the RTR subsetD'            is being loaded from CD-ROM:   E                Reliable Transaction Router V4.0 for Compaq Tru64 UNIX   A              Installation started at Mon Nov 27 15:51:23 EST 2000   T              Installation proceeds automatically, and will complete in approximately              1 minute.  '            RTR API & Management Utilityi#               Copying from . (disk)s               Verifyinga  3            1 of 1 subset(s) installed successfully.   B            Configuring "RTR API & Management Utility" (RTRBASE400)              .            .            .E                Reliable Transaction Router V4.0 for Compaq Tru64 UNIXT  C              Installation completed at Mon Nov 27 15:51:23 EST 2000   0      5-10 Full Installation on Compaq Tru64 UNIX           H                                   Full Installation on Compaq Tru64 UNIXG                                 5.2 Installing RTR on Compaq Tru64 UNIX   D               When you see the "Verifying" message during the subsetE               installation, the installation procedure is checking to C               see that the files are copied correctly; it is not anO@               Installation Verification Procedure (IVP) message.  G               During the installation, if you get errors from the setld B               utility, see the Diagnostics section of the setld(8)E               reference page for an explanation of the errors and thee*               appropriate actions to take.  E               Section 5.3 explains how to run the IVP after installa- G               tion, and how to delete old RTR subsets before installing #               a new version of RTR.p  3         5.3 After Installation on Compaq Tru64 UNIX   A               This section explains what you need to do after the E               installation on Compaq Tru64 UNIX to make RTR ready fort               use.  =         5.3.1 Running the Installation Verification ProcedureF  @               After installing RTR, you can run the InstallationG               Verification Procedure (IVP) independently to verify that F               the software is available on your system. You might alsoH               want to run the IVP after a system failure to be sure that#               users can access RTR.p  E               Note that the Installation Verification Procedure (IVP)t<               requires a working C language compiler to run.  ?               The RTR IVP verifies the installation as follows:T                 o  Starts RTRn  '               o  Creates an RTR journalr  (               o  Creates an RTR facility                 o  Stops RTR  A               o  Compiles and links the example client and server                   programst  G               To run the IVP after an installation, enter the following5               command:  #               # setld -v RTRBASE320s  6               For a sample RTR IVP, see Section 1.3.3.  H                              Full Installation on Compaq Tru64 UNIX 5-11 y  l      +      Full Installation on Compaq Tru64 UNIXe0      5.3 After Installation on Compaq Tru64 UNIX  U            If the verification process fails, look in the /var/adm/smlogs/fverify.logp=            file for information to help diagnose the problem.R  (      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:_  4            1. Log in as superuser (login name root).  E            2. Make sure you are at the root directory (/) by enteringv$               the following command:                     # cd /  <            3. Enter the following form of the setld command:  +                   # setld -i | grep RTRBASE   D            4. Look for the word "installed" in the listing produced,A               and then delete the installed subsets. For example:   #               # setld -d RTRBASE320o  /      5.3.3 Displaying Documentation from CD-ROM   ;            The Reliable Transaction Router documentation isrD            provided on the Compaq Tru64 UNIX Layered Products OnlineE            Documentation CD-ROM in hypertext (.html) file format. You D            can display the hypertext files on your workstation usingB            any HTML browser such as Netscape or Internet Explorer.  '      5.3.4 Enabling Remote RTR Commandsa  @            RTR supports the use of remote commands (described inA            Chapter 1 of the System Manager's Manual). To use thiss=            feature on Compaq Tru64 UNIX, check your operatinguD            system documentation for how to ensure access to a TCP/IP            environment.u  B            You may, for example, need to create an .rhosts file inC            the home directory of the RTR user on the target node oraA            nodes, among other things. This file would contain theoE            hostname (and, optionally, the username) of the node wheretC            the remote commands will be issued. For more informationeA            on the .rhosts file, see the rhosts(4) reference page.   0      5-12 Full Installation on Compaq Tru64 UNIX e  r      H                                   Full Installation on Compaq Tru64 UNIXH                                 5.4 Files Installed on Compaq Tru64 UNIX  0         5.4 Files Installed on Compaq Tru64 UNIX  H               To see the list of files installed on your system, use the                following command:  #               % setld i subset_names                                                                              H                              Full Installation on Compaq Tru64 UNIX 5-13 2  y                  H                                                                        AH         ________________________________________________________________  G                                                  Recovering from Errors       F               This appendix provides information to help you deal withF               problems that might occur during product installation or               product use.  F               If you find an error in the documentation, send an emailF               message to the internet address on the last page of thisB               appendix. Include the manual title, section and page/               numbers where the error occurred.   0         A.1 Problems During Product Installation  A               If errors occur during the installation, the systemuC               displays failure messages. For example, if the CompaqXD               Tru64 UNIX installation fails due to insufficient disk3               space, the following message appears:e  =               There is not enough space for subset RTRBASE400o?               Reliable Transaction Router for Compaq Tru64 UNIX .               (RTRBASE400) will not be loaded.  D               Errors can occur during the installation if any of the)               following conditions exist:d  ;               o  The operating system version is incorrect.e  @               o  The prerequisite software version is incorrect.  2               o  There is insufficient disk space.  H               o  The system parameter values for successful installation"                  are insufficient.  C               For descriptions of error messages generated by thesea@               conditions, see the operating system documentationC               on system messages, recovery procedures, and softwaref>               installation. For information on system softwareH               requirements, see the software and disk space requirements(               for your operating system.  H                                              Recovering from Errors  A-1 n  r            Recovering from Errors $      A.2 Problems After Installation  $      A.2 Problems After Installation  =            U.S. customers who encounter a problem while usingaA            Reliable Transaction Router can report it to Compaq bybB            telephoning the Compaq Customer Support Center (CSC) atE            1-800-354-9000. (Customers with service contracts can also 4            use an electronic means such as DSNlink.)  D            Customers without a service contract can arrange for per-            call support.  7            The CSC will need the following information:R  E            o  The name version number of the operating system you aret               using   D            o  The Reliable Transaction Router version number you are               usinga  @            o  The hardware system you are using (such as a model               number)l  A            o  A brief description of the problem (one sentence if                possible)a  4            o  Whether or not the problem is critical  @            o  Any other information that is helpful, such as theA               specific commands you used to run the software, thetB               error messages displayed, and source listings of the7               relevant software module or lines of code   C            If the problem is related to Reliable Transaction Routeru=            documentation, send comments electronically to the &            following internet address:            rtrdoc@compaq.com.   B            If you are reporting a specific documentation error, beE            sure to include the manual title, section and page numbersi$            where the error occurred.                A-2 Recovering from Errorsi