 





















                    Reliable_Transaction_Router,_Version_3.1D___________
                    Installation Guide


                    Order Number: AA-Q88DD-TE


                    November 1997

                    This guide describes how to install Reliable
                    Transaction Router, Version 3.1D.

                    Reliable Transaction Router, Version 3.1D is fault
                    tolerant and transaction management middleware,
                    used to implement large, distributed, transaction
                    processing applications.






                    Revision/Update Information:  This is a revised
                                                  manual.

                    Software Version:             Reliable Transaction
                                                  Router, Version 3.1D

                    Digital Equipment Corporation
                    Maynard, Massachusetts
 






          ________________________________________________________________
          November, 1997

          The information in this document is subject to change
          without notice and should not be construed as a commitment
          by Digital Equipment Corporation. Digital Equipment
          Corporation assumes no responsibility for any errors that
          may appear in this document.

          The software described in this document is furnished under
          a license and may be used or copied only in accordance with
          the terms of such license.

          No responsibility is assumed for the use or reliability
          of software on equipment that is not supplied by Digital
          Equipment Corporation or its affiliated companies.

          Restricted Rights: Use, duplication, or disclosure by the
          U.S. Government is subject to restrictions as set forth in
          subparagraph (c)(1)(ii)  of the Rights in Technical Data
          and Computer Software clause at DFARS 252.227-7013.

          © Digital Equipment Corporation 1989, 1997. All Rights
          Reserved.

          The following are trademarks of Digital Equipment
          Corporation: Alpha, DEC, DECdtm, DECnet, Digital, DNA,
          OpenVMS, PATHWORKS, Reliable Transaction Router, VAX, VAX
          DOCUMENT, VAX Pascal, VAX RMS, VAX Volume Shadowing, VMS,
          VMScluster, and the DIGITAL Logo.

          The following are Registered Trademarks of Borland
          International, Inc.:  Turbo Pascal[R]

          The following is a Registered Trademark of Hewlett-Packard
          Company:  HP-UX[R]

          The following is a Trademarks of Intel Corporation:
          Intel[TM]

          The following is a Registered Trademark of International
          Business Machines Corporation:  IBM[R].

          The following are Trademarks of International Business
          Machines Corporation:  AIX[TM] and RISC System/6000[TM].

          The following are Registered Trademarks of Microsoft
          Corporation:  MS-DOS[R] MS[R] and Microsoft[R].

          The following are Trademarks of Microsoft Corporation:
          Windows[TM], Windows NT[TM], Visual Basic[TM] and Visual
          C++ [TM]

          The following are Registered Trademarks of Oracle
          Corporation:  ORACLE[R], SQL*Net[R] and SQL*Plus[R].

          The following are Trademarks of Oracle Corporation:
          ORACLE7[TM] and PL/SQL[TM].

          The following are Registered Trademarks of Sun
          Microsystems, Inc.:  SUN[R] and Solaris[R].

          The following are Trademarks of Sun Microsystems, Inc.:
          SPARCstation[TM] and SunOS[TM].

          UNIX is a registered trademark in the United States and
          other countries licensed exclusively through X/Open Company
          Ltd.

          This document was prepared using DECdocument, Version 3.2.
 














  _________________________________________________________________

                                                           Contents



  Preface...................................................      v

  1  Quick Installation

        1.1   Installing RTR for Windows NT and Windows
              95............................................    1-1
        1.1.1     RTR for Windows NT and Windows 95 Release
                  Notes.....................................    1-1
        1.1.2     Installing RTR for Windows NT and Windows
                  95 from CD-ROM. ..........................    1-1
        1.1.3     After Installing..........................    1-2
        1.2   Installing RTR for Digital UNIX...............    1-3
        1.3   Installing RTR for SunOS......................    1-3
        1.3.1     Installing the RTR Package................    1-4
        1.3.2     Running the IVP on RTR for SunOS..........    1-5
        1.4   Installing RTR for AIX........................    1-5
        1.4.1     Installation Procedure....................    1-5
        1.5   Installing RTR for HP-UX......................    1-8
        1.5.1     Installation Procedure....................    1-8

  2  Preparing for RTR Installation on Digital UNIX

        2.1   Checking the Software Distribution Kit........    2-1
        2.2   Reading the Online Release Notes..............    2-1
        2.3   Registering Your Software License ............    2-2
        2.4   Checking Installation Procedure
              Requirements..................................    2-2
        2.4.1     Checking Login Privileges.................    2-3
        2.4.2     Checking Hardware Requirements............    2-3
        2.4.3     Checking Software Requirements............    2-3
        2.4.4     Determining Which Subsets to Load.........    2-4



                                                                iii
 







          2.4.5     Determining Disk Space Requirements.......    2-4
          2.4.5.1     Checking Current Disk Space.............    2-5
          2.4.5.2     Increasing Disk Space by Using
                      Alternative Disks ......................    2-6
          2.5   Installing from Media or Using RIS............    2-6
          2.6   Backing Up Your System Disk...................    2-7
          2.7   Stopping the Installation.....................    2-7

    3  Installing RTR on Digital UNIX

          3.1   Using CD-ROM Consolidated Distribution
                Media.........................................    3-1
          3.2   Using a RIS Distribution Area ................    3-2
          3.3   Responding to Installation Procedure
                Prompts.......................................    3-2
          3.3.1     Selecting Subsets.........................    3-3
          3.3.2     Monitoring Displays During the Subset
                    Loading Process...........................    3-4

    4  After Installation on Digital UNIX

          4.1   Running the Installation Verification
                Procedure ....................................    4-1
          4.2   Deleting RTR from Your System.................    4-2
          4.3   Displaying Documentation from CD-ROM..........    4-2
          4.4   Enabling Remote RTR Commands..................    4-2

    A  Sample Listings

          A.1   Sample RTR for Digital UNIX Installation .....    A-1
          A.2   Sample RTR for Digital UNIX Installation
                Verification Procedure .......................    A-2
          A.3   Sample RTR for SunOS Installation ............    A-3

    B  Files Installed

          B.1   Symbolic Links Created........................    B-1
          B.2   Directories Created...........................    B-1
          B.3   Files Created in /rtr ........................    B-1
          B.4   Files Created in /usr/opt.....................    B-3





    iv
 







        C  Recovering from Errors

              C.1   Problems During Product Installation .........    C-1
              C.2   Problems After Installation ..................    C-2

        Tables

              1         Conventions Used in this Guide ...........    vii

              2-1       RTR Subset Size (Kilobytes Required)......    2-4



































                                                                        v
 












        _________________________________________________________________

                                                                  Preface



              This Guide explains how to install Reliable Transaction
              Router, Version 3.1D (RTR) on all supported platforms. If
              you are installing RTR on only one platform, you need only
              read the section(s) that apply to that platform.

              For platforms that have a relatively simple installation
              procedure, instructions are given only in Chapter 1,
              Quick Installation. For other platforms, more detailed
              instructions are given in later chapters.

              Keep this guide with your distribution kit. You will need
              it to install maintenance updates or to reinstall RTR for
              any other reason.

        Structure of This Document

              This guide contains the following chapters and appendixes:

              o  Chapter 1 gives brief installation instructions for RTR
                 on Windows NT and Windows 95, Digital UNIX, SunOS, AIX
                 and HP-UX.

              o  Chapter 2 describes the hardware and software
                 requirements for RTR installation on Digital UNIX.
                 Related procedures that you must complete before
                 installing RTR are also given.

              o  Chapter 3 describes how to install RTR on Digital UNIX.

              o  Chapter 4 describes the Installation Verification
                 Procedure (IVP) for RTR on Digital UNIX, how to remove
                 RTR from your system, and describes the files you need
                 to run RTR applications.

              o  Appendix A contains sample listings for an interactive
                 RTR installation and IVP on Digital UNIX.

                                                                        v
 







          o  Appendix C contains information about recovering from
             errors.

    Associated Documents

          In addition to this guide, the RTR documentation set
          includes the following:

          o  Reliable Transaction Router Version 3.1D, System
             Manager's Manual

          o  Reliable Transaction Router Version 3.1D, Application
             Programmer's Reference Manual

          o  A letter titled Reliable Transaction Router, Version
             3.1D - Cover Letter or Reliable Transaction Router,
             Version 3.1D - Read Before Installing

             Please read this letter; it contains important
             information about installing RTR that may not be
             included in this installation guide or in the release
             notes.

          o  Release Notes are provided in electronic form the
             software kit. You are strongly advised to read these
             Release Notes before using the product.

    Conventions

          Table 1 describes the conventions used in this guide.















    vi
 







              Table_1_Conventions_Used_in_this_Guide_____________________

              Convention_____Meaning_____________________________________

              #              A number sign (#) is the default superuser
                             prompt.

              %              A percent sign (%) is the default user
                             prompt.

              <Return>       In examples, a boxed symbol indicates
                             that you must press the named key on the
                             keyboard.

              Ctrl/C         This symbol indicates that you must press
                             the Ctrl key while you simultaneously press
                             another key (in this case, C).

              user input     In interactive examples, this typeface
                             indicates input entered by the user.

              filesystem     In text, this typeface indicates the exact
                             name of a command, routine, partition,
                             pathname, directory, or file. This typeface
                             is also used in interactive examples and
                             other screen displays.

              UPPERCASE      The DEC OSF/1 AXP operating system
              lowercase      differentiates between lowercase and
                             uppercase characters. Examples, syntax
                             descriptions, function definitions, and
                             literal strings that appear in text must be
                             typed exactly as shown. Commands typed to
                             the RTR CLI are not case sensitive unless
                             enclosed in quote marks

              setld(8)       Cross-references to online reference pages
                             include the appropriate section number in
                             parentheses. For example, setld(8) indicates
                             that you can find the material on the setld
                             command in Section 8 of the reference pages.

              [y]            In a prompt, square brackets indicate that
                             the enclosed item is the default response.
                             For example, [y] means the default response
              _______________is_Yes._____________________________________

                                                                      vii
 










                                                                        1
        _________________________________________________________________

                                                       Quick Installation


              This chapter gives brief instructions for installing RTR on
              all supported platforms.

        1.1 Installing RTR for Windows NT and Windows 95

              The installation of the RTR base product requires about 3
              megabytes of disk space. The installation procedure takes
              about two minutes to complete.

        1.1.1 RTR for Windows NT and Windows 95 Release Notes

              The release notes and README files provide information
              for RTR that could not be included in the printed
              documentation. The release notes are in the files:

              RELNOTES.TXT
              RELNOTES.PS  (PostScript)
              README.TXT

              on your CD-ROM or diskettes.

        1.1.2 Installing RTR for Windows NT and Windows 95 from CD-ROM.

              1. If you are installing on Windows NT, ensure that you are
                 logged in as the Administrator, or have administrator
                 privileges.

              2. If you have installed a previous version of RTR you
                 must:

                 1. Stop RTR and check that RTR is not in the startup
                    program group.

                 2. Delete the file RTRENVPS in the RTR root directory.

                 3. Logout of your Windows NT session and login
                    again. (This to ensure no background RTR tasks are
                    running.)

                                                   Quick Installation 1-1
 



    Quick Installation
    1.1 Installing RTR for Windows NT and Windows 95


          3. Insert the RTR CD into the drive.

          4. From the Start button choose Run and click on the
             Browse... button.

          5. Choose the drive letter of your CD-ROM and open the
             directory ALPHA or I386, depending on your processor
             type (Alpha or Intel). Select the file SETUP.EXE and
             click on the OK button. Then click on the OK button in
             the Run box.

          6. You are then given the option of installing either or
             both of Reliable Transaction Router (RTR) and ODBC Over
             RTR (OOR). Select whichever items you wish to install.

          7. Follow the instructions on the screen to enter the
             directory where you want to install RTR. The default
             is C:\RTR. It is recommended that you install RTR on a
             local hard disk (NTFS or FAT).

          8. When you are ready to begin the installation, click on
             the Setup button.

          9. Follow the instructions on the screen.

    1.1.3 After Installing

          If you installed RTR on an NTFS drive, you will need to
          give RTR users access to the RTR directories. Use the
          Windows NT file manager and select the RTR root directory.
          Pull down the Security menu and choose File permissions.
          Give the RTR root directory and all its subdirectories
          "Full Control" access for all RTR users. You may then
          restrict access on individual files to read only. (All RTR
          users require write access to the RTR journal directory.)

          The file MSVCRT40.DLL is also supplied on the CD-ROM. This
          file is copied to the SYSTEM32 directory in your Windows
          NT root directory if it is not present. (It may already be
          present if you have installed Microsoft products.)





    1-2 Quick Installation
 



                                                       Quick Installation
                                      1.2 Installing RTR for Digital UNIX


        1.2 Installing RTR for Digital UNIX

              1. Login as user root or su to root.

              2. Use the setld utility to check if you have a version of
                 RTR already installed:-

                 # setld -i | grep RTR

              3. If you have any previous version, make sure that it is
                 not running:-

                 # rtr stop rtr

              4. De-install all previous versions that you find:-

                 # setld -d RTRBASE3xx

                 Where "xx" is the version number.

              5. Install from the directory (disk or CD-ROM) where the
                 kit is located, for example:-

                 # setld -l /cdrom/rtr3xx/kit

                 Where "xx" is the version number.

              6. Answer "1" and "y" to the questions from setld.

              7. To run the IVP (Installation Verification Procedure) use
                 the following command:-

                 # setld -v RTRBASE3xx

                 Where "xx" is the version number.

                 Note that the Installation Verification Procedure (IVP)
                 requires a working C language compiler to run.

        1.3 Installing RTR for SunOS

              Your Reliable Transaction Router for SunOS kit is supplied
              on CD-ROM. The Release Notes are also on the CD; you are
              advised to read the Release Notes before using RTR.

              The installation requires about 2950KB on the partition
              given in response to the package base directory prompt
              (usually /opt). The installation procedure takes about two
              minutes to complete.

              Note that the Installation Verification Procedure (IVP)
              requires a working C language compiler to run.

                                                   Quick Installation 1-3
 



    Quick Installation
    1.3 Installing RTR for SunOS


    1.3.1 Installing the RTR Package


          1. Login as user root or su to root.

          2. First check whether RTR is already installed:

             # pkginfo -l rtr

          3. If it is, deinstall using the following command.

             # pkgrm rtr

          4. Insert the CD-ROM and mount the volume at a convenient
             mount point (for example, /cdrom).

          5. Install RTR from the CD-ROM directory where the kit is
             located, for example:

             # cd /cdrom/rtr_kit
             # pkgadd -d pkg

             o  You can accept the defaults for most questions from
                the pkgadd utility.

             o  When asked for the "base directory" answer /opt.

             o  Ignore any warning about free blocks and answer "y"
                to the attached continue question.

             o  When asked "Do you want to install these as setuid
                /setgid files [y,n,?,q]", answer "y".

             o  When asked "This package contains scripts which will
                be executed with super-user permission during the
                process of installing this package. Do you want to
                continue with the installation of <rtr> [y,n,?]",
                answer "y".

          6. RTR is now installed in /opt/rtr.

          Appendix A show an example installation of RTR for SunOS.



    1-4 Quick Installation
 



                                                       Quick Installation
                                             1.3 Installing RTR for SunOS


        1.3.2 Running the IVP on RTR for SunOS

              The Installation Verification Procedure (IVP) requires a
              working C language compiler to run. 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/RTRnnn
              /examples/rtr/rtr_ivp_osf.sh.

        1.4 Installing RTR for AIX

              Your Reliable Transaction Router for AIX kit is supplied
              on CD-ROM. The Release Notes are also on the CD; you are
              advised to read the Release Notes before using RTR.

              The installation requires about 3000KB free disk space.
              The installation procedure takes about two minutes to
              complete.

        1.4.1 Installation Procedure

              o  If you have any previous version of RTR, make sure that
                 it is not running:-

                 # rtr stop rtr

              o  Become root and invoke the SMIT system management
                 interface tool. You can either type the command smit
                 and navigate through the menus, or type the command with
                 a parameter to start SMIT at a particular menu.

              o  Type smit install_remove or navigate to Remove Software
                 Product and select any previously installed versions
                 of RTR; then remove them. (Check that the "Preview
                 Only" field is set to "No" otherwise the remove does
                 not execute.)

              o  Type smit install_latest or navigate to Install New
                 Software at Latest Level and then select the source
                 media (i.e. the CD) from the list. Select RTR.

                                                   Quick Installation 1-5
 



    Quick Installation
    1.4 Installing RTR for AIX


             After entering OK to the prompts, installation proceeds
             automatically. If successful, the output looks similar
             to the following example.










































    1-6 Quick Installation
 



                                                       Quick Installation
                                               1.4 Installing RTR for AIX


                 File:     RTR314.rte  3.14.149.0.all

                 +-----------------------------------------------------------------------------+
                                     Pre-installation Verification...
                 +-----------------------------------------------------------------------------+
                 installp:  Pre-installation verification may take several minutes.
                 Please wait...
                 Verifying selections...done
                 Verifying requisites...done
                 Results...

                 SUCCESSES
                 ---------
                   Filesets listed in this section passed pre-installation verification
                   and will be installed.

                   Selected Filesets
                   -----------------
                   RTR314.rte 3.14.149.0                        # Reliable Transaction Router

                   << End of Success Section >>

                 FILESET STATISTICS
                 ------------------
                     1  Selected to be installed, of which:
                         1  Passed pre-installation verification
                     ----
                     1  Total to be installed

                 +-----------------------------------------------------------------------------+
                                          Installing Software...
                 +-----------------------------------------------------------------------------+

                 installp:  APPLYING software for:
                         RTR314.rte 3.14.149.0

                 . . . . . << Copyright notice for RTR314 >> . . . . . . .

                   © Digital Equipment Corporation 1997. All rights reserved.

                   Restricted Rights: Use, duplication, or disclosure by the U.S. Government
                   is subject to restrictions as set forth in subparagraph (c) (1) (ii) of
                   DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227=14 Alt. III, as
                   applicable.

                   This software is proprietary to and embodies the confidential technology
                   of Digital Equipment Corporation. Possession, use, or copying of this
                   software and media is authorized only pursuant to a valid written license
                   from Digital or an authorized sublicensor.

                 . . . . . << End of copyright noticeiforIRTR314a>>.n.1.7.

                 Finished processing all filesets.  (Total time:  7 secs).

                 +-----------------------------------------------------------------------------+
                                      Post-installation Processing...
                 +-----------------------------------------------------------------------------+
                 +-----------------------------------------------------------------------------+
                                                 Summaries:
                 +-----------------------------------------------------------------------------+

                 Installation Summary
                 --------------------
                 Name                        Level           Part        Event       Result
                 -------------------------------------------------------------------------------
                 RTR314.rte                  3.14.149.0      USR         APPLY       SUCCESS
 



    Quick Installation
    1.5 Installing RTR for HP-UX


    1.5 Installing RTR for HP-UX

          Your Reliable Transaction Router for HP-UX kit is supplied
          on CD-ROM. The Release Notes are also on the CD; you
          are advised to read the Release Notes before using RTR.
          The installation requires about 3000KB free disk space.
          The installation procedure takes about two minutes to
          complete.

    1.5.1 Installation Procedure

          o  If you have any previous version of RTR, make sure that
             it is not running:-

             # rtr stop rtr

          o  Become root or superuser and mount the CD-ROM drive.
             (The following assumes that the mount point is /cdrom).
             Make sure you can see the installation package on the
             CD-ROM, for example:-

             # ls /cdrom
             HPpackRTR314.pkg

          o  Use the uname -a command to determine the system type:-

             # uname -a

              HP-UX phpeso B.10.20 A 9000/715 2006907610 two-user license

          o  Use the update command to install the kit; if it is a
             700 series system, use the -S700 otherwise, use -S800.
             For example:

              # update -S700 /cdrom/HPpackRTR314.pkg '*'

          o  Inspect the installation log for any errors
             (instructions for how to do this are printed by the
             update command).

          The following is a sample installation on a 700 series
          system.



    1-8 Quick Installation
 



                                                       Quick Installation
                                             1.5 Installing RTR for HP-UX


              # uname -a
              HP-UX phpeso B.10.20 A 9000/715 2006907610 two-user license

              # update -S700 -s /cdrom/V10/HPpackRTR314.pkg '*'
              Initializing...
              Reading information from the update media...
              Loading selected filesets.
              The program should proceed to completion without additional attention.
              Review the log file, /var/tmp/update.log, afterward by:
              1) typing "more /var/tmp/update.log";
              2) finding the correct date and time heading;
              3) looking for any messages that begin with ERROR or WARNING.
              Beginning to load fileset "RTR_314" (1 of 1).
              /var/adm/rupdate/system/RTR_314/customize
              /usr/users/RTR314/bin/rtr
              /usr/users/RTR314/shlib/librtr.sl
              /usr/users/RTR314/lib/rtr.h
              /usr/users/RTR314/examples/rtr/rtrreq.c
              /usr/users/RTR314/examples/rtr/rtrsrv.c
              /usr/users/RTR314/mon/accfail.mon
              /usr/users/RTR314/mon/acp2app.mon
              /usr/users/RTR314/mon/active.mon
              /usr/users/RTR314/mon/app2acp.mon
              /usr/users/RTR314/mon/calls.mon
              /usr/users/RTR314/mon/channel.mon
              /usr/users/RTR314/mon/congest.mon
              /usr/users/RTR314/mon/connect.mon
              /usr/users/RTR314/mon/connects.mon
              /usr/users/RTR314/mon/ddtm.mon
              /usr/users/RTR314/mon/dtx.mon
              /usr/users/RTR314/mon/dtxrec.mon
              /usr/users/RTR314/mon/facility.mon
              /usr/users/RTR314/mon/flow.mon
              /usr/users/RTR314/mon/frontend.mon
              /usr/users/RTR314/mon/group.mon
              /usr/users/RTR314/mon/inbytes.mon
              /usr/users/RTR314/mon/inmess.mon
              /usr/users/RTR314/mon/inpack.mon
              /usr/users/RTR314/mon/ipc.mon
              /usr/users/RTR314/mon/jcalls.mon
              /usr/users/RTR314/mon/journal.mon
              /usr/users/RTR314/mon/link.mon
              /usr/users/RTR314/mon/locks.mon
              /usr/users/RTR314/mon/outbytes.mon

                                                   Quick Installation 1-9
 



    Quick Installation
    1.5 Installing RTR for HP-UX


          /usr/users/RTR314/mon/outmess.mon
          /usr/users/RTR314/mon/outpack.mon
          /usr/users/RTR314/mon/partit.mon
          /usr/users/RTR314/mon/queues.mon
          /usr/users/RTR314/mon/quorum.mon
          /usr/users/RTR314/mon/rdm.mon
          /usr/users/RTR314/mon/recovery.mon
          /usr/users/RTR314/mon/rfb.mon
          /usr/users/RTR314/mon/rolequor.mon
          /usr/users/RTR314/mon/routers.mon
          /usr/users/RTR314/mon/routing.mon
          /usr/users/RTR314/mon/rscbe.mon
          /usr/users/RTR314/mon/rtr.mon
          /usr/users/RTR314/mon/stalls.mon
          /usr/users/RTR314/mon/tps.mon
          /usr/users/RTR314/mon/tpslo.mon
          /usr/users/RTR314/mon/traffic.mon
          /usr/users/RTR314/mon/trans.mon
          /usr/users/RTR314/mon/v2calls.mon
          /usr/users/RTR314/install/RTR314_HPpostInstallationScript.sh
          /usr/users/RTR314/install/RTR314_HPKitSpecification
          /var/adm/rupdate/system/RTR_314/CDFinfo
          /var/adm/rupdate/system/RTR_314/index
          Finished loading fileset "RTR_314".
          Beginning customize script for fileset "RTR_314" (1 of 1).
          Review the log file, /var/tmp/update.log, by:
          1) typing "more /var/tmp/update.log";
          2) finding the correct date and time heading;
          3) looking for any messages that begin with ERROR or WARNING.
















    1-10 Quick Installation
 










                                                                        2
        _________________________________________________________________

                          Preparing for RTR Installation on Digital UNIX


        2.1 Checking the Software Distribution Kit

              RTR software is distributed on CD-ROM as part Digital's
              Layered Products Consolidated Distribution. Use the Bill of
              Materials (BOM) to check the contents of your RTR software
              distribution kit.

              In addition to this guide, the software distribution kit
              includes the following:

              o  A CD-ROM optical disk for systems with optical disk
                 drives

              o  A CD-ROM booklet and CD-ROM read first letter

              If your software distribution kit is damaged or incomplete,
              contact your Digital representative.

        2.2 Reading the Online Release Notes

              RTR provides online release notes. Digital strongly
              recommends that you read the release notes before using
              the product. The release notes may contain information
              about changes to the application.

              The release notes for RTR are in the following file:

              rtr31x_relnotes.txt

              Where "x" is a digit representing a revision level.

              You can use the following command to read the release
              notes.

              more rtr31x_relnotes.txt

              Where "x" is a digit representing a revision level.

                      Preparing for RTR Installation on Digital UNIX  2-1
 



    Preparing for RTR Installation on Digital UNIX
    2.3 Registering Your Software License


    2.3 Registering Your Software License

          RTR includes support for the License Management Facility
          (LMF). You must register your License Product Authorization
          Key (License PAK) in the License Database (LDB) in order
          to use RTR on a newly licensed node. The License PAK may be
          shipped along with the kit if you ordered the license and
          media together; otherwise, it is shipped separately to a
          location based on your license order.

          If you are installing RTR as an update on a node already
          licensed for this software, you have already completed the
          License PAK registration requirements.

          If you are installing prerequisite or optional software
          along with RTR, review the PAK status and install the
          PAKs for any prerequisite or optional software before you
          install RTR.

          To register a license under the Digital UNIX operating
          system, first log in as superuser.

          At the superuser prompt, edit an empty PAK template with
          the lmf register command as follows, and include all the
          information on your License PAK:

          #  lmf register

          After you register your license, use the following lmf
          reset command to copy the license details from the License
          Database (LDB) to the kernel cache:

          #  lmf reset

          For complete information on using the License Management
          Facility, see the Guide to Software License Management and
          the lmf(8) reference page.

    2.4 Checking Installation Procedure Requirements

          This section discusses various requirements for installing
          RTR.

          Installing RTR, including running the Installation
          Verification Procedure (IVP), takes approximately 10 to
          15 minutes, depending on your type of media and system
          configuration.

    2-2 Preparing for RTR Installation on Digital UNIX
 



                          Preparing for RTR Installation on Digital UNIX
                         2.4 Checking Installation Procedure Requirements


        2.4.1 Checking Login Privileges

              You must have superuser privileges to install the RTR
              software and to register the license PAK.

        2.4.2 Checking Hardware Requirements

              To install RTR, you need the following hardware:

              o  Software distribution device (if installing from media)

                 Locate the CD-ROM drive for the CD-ROM software
                 distribution media. The CD booklet or the documentation
                 for the CD-ROM drive you are using explains how to load
                 the CD-ROM media.

              o  Terminal

                 You can use either a hardcopy or video terminal to
                 communicate with the operating system and respond to
                 prompts from the installation procedure.

              See the RTR Software Product Description (SPD) for
              additional hardware requirements.

        2.4.3 Checking Software Requirements

              RTR requires the Digital UNIX operating system Version 4.0
              or 3.2. Future RTR releases may require higher versions.
              See the Cover Letter (included on the CD-ROM) or the online
              release notes for information about the minimum version of
              the operating system required.

              RTR also requires that the following Digital UNIX software
              subset be loaded on the system where you install RTR:

              o  OSFBASE-the "Base System" subset

              The following Digital UNIX software subset are optional on
              the system where you install RTR:

              o  OSFCLINET200-Basic Networking Services (TCP/IP) subset

              o  DNABASE110-DECnet/OSI Base Components subset, together
                 with

              o  DNANETMAN110-DECnet/OSI Network Management subset

              To check whether these subsets are loaded, follow these
              steps:

              1. Log in to the system where you will install RTR.

                      Preparing for RTR Installation on Digital UNIX  2-3
 



    Preparing for RTR Installation on Digital UNIX
    2.4 Checking Installation Procedure Requirements


          2. Enter the following command:

             # setld -i | egrep 'OSFBASE|DNA'

          If you do not log in as superuser (login name root), you
          must enter the full path of the command. For example:

          % /usr/sbin/setld -i | grep OSFBASE

          Check the displayed rows for the name of the relevant
          subset and any related patches. The word "installed"
          appears in a row after the subset identifier when a subset
          is loaded. If the word "installed" does not appear (the
          second column in a row is blank), the subset or patch is
          not loaded. In this case, you must load the missing Digital
          UNIX software before installing RTR. (For information on
          how to load the operating system software, see the Guide to
          Installing Digital UNIX.)

    2.4.4 Determining Which Subsets to Load

          RTR has only one subset:-

          o  rtrbase314

             RTR runtime and system management.

    2.4.5 Determining Disk Space Requirements

          Table 2-1 lists the disk space requirements for loading the
          RTR software subset. These requirements apply to the disks
          where you load the RTR subset. The requirements are listed
          by directory for convenience if you are doing installations
          on systems where these directories are mount points for
          different disk partitions.

          Table_2-1_RTR_Subset_Size_(Kilobytes_Required)_____________

                           Subset
          Subset_Title_____Name________/usr/opt/___/rtr______________

          RTR              rtrbase314  57020       1050

          Total:_______________________58070_________________________

          Using these disk space requirements, calculate the total
          values for the subsets you will load in each directory.
          You will also require disk space for the RTR journal, which
          defaults to /rtr/rtrjnl.

    2-4 Preparing for RTR Installation on Digital UNIX
 



                          Preparing for RTR Installation on Digital UNIX
                         2.4 Checking Installation Procedure Requirements


              Compare the space required for the subset with the free
              space currently on the disks where RTR files will reside.

        2.4.5.1 Checking Current Disk Space

              To check the current amount of free space for a directory
              path, log in to the system where you will install RTR. You
              can check which directories are mounted and where they are
              by viewing the /etc/fstab file. For example:

              # more /etc/fstab
              /dev/rd0a:/:rw:1:1:ufs::
              /dev/rd0g:/usr:rw:1:2:ufs::
              /usr/staff/r1/leslie@bigsys:/usr/staff/r1/leslie:rw:0:0:nfs:bg:
              /usr/man@bigsys:/usr/man:ro:0:0:nfs:bg:

              The display indicates that /usr (mounted to /dev/rd0g)
              is the only mount point that affects where RTR files will
              reside; the system has only one local disk drive, and the
              /usr/lib and file system resides in the g partition of the
              disk on that drive.

              To check the total space and the free space for the
              directories where RTR will reside, enter the df command.
              Given the previous display of the /etc/fstab file, which
              shows that only /usr is a mount point, you need to check
              free space only in the /usr file system. For example:

              # df /usr
              Filesystem   Total    kbytes   kbytes   %
              node         kbytes   used     free     used  Mounted on
              /dev/rd0g     122598   54447   55892    49%   /usr

              This display shows that there are 55,892 Kbytes free. This
              free space must accommodate the subset requirements listed
              in Table 2-1.

              On systems where /usr/lib and /usr/man are mounted to
              different devices from /usr, enter the following command:

              #  df /usr/lib /usr/man

              In this case, you compare space required for RTR files in
              /usr/lib to the free space displayed in the first line of
              the df output list, and compare the space required for RTR
              files in /usr/man to the free space displayed in the second
              line of that list.

                      Preparing for RTR Installation on Digital UNIX  2-5
 



    Preparing for RTR Installation on Digital UNIX
    2.4 Checking Installation Procedure Requirements


    2.4.5.2 Increasing Disk Space by Using Alternative Disks

          The RTR installation procedure creates the following
          directory and loads files into subordinate directories:

          /usr/opt/RTR314

          If the /usr/opt/RTR314 directory node in the previous path
          does not exist, the installation procedure creates it.

          If the RTR314 node does exist, the installation procedure
          uses it.

          If you find that there is insufficient disk space for the
          RTR subsets and you know that you have additional space
          on alternative disks or disk partitions for your system,
          perform the following steps before installing RTR:

          1. Log in as superuser.

          2. Create the directory /usr/lib/RTR314.

          3. Specify in the /etc/fstab file that one or more of the
             newly created directories are mount points to new disk
             partitions where there is additional space.

          4. Enter the mount -a command so that the new mount points
             take effect.

    2.5 Installing from Media or Using RIS

          Someone from your site must perform at least one RTR
          installation from the distribution medium. Your site
          system manager can then decide whether or not to make a
          RTR distribution kit available online so that subsequent
          installations of RTR can use the Remote Installation
          Service (RIS). For information on extracting RTR subsets to
          a RIS distribution area, see the Guide to Sharing Software
          on a Local Area Network.

          If you expect to use RTR subsets from the RIS area of a
          remote system for installation on your local system, first
          check with your site system manager to ensure that:

          o  A RTR network kit is available for use.

          o  Your system is registered as a RIS client.

          If RTR subsets are available to you on a RIS server system,
          you must know the name of that system.

    2-6 Preparing for RTR Installation on Digital UNIX
 



                          Preparing for RTR Installation on Digital UNIX
                                   2.5 Installing from Media or Using RIS


              For more information on installing RTR from a RIS
              distribution area, see Section 3.2.

        2.6 Backing Up Your System Disk

              Digital recommends that you back up your system disk
              before installing any software. For information about
              backing up your system disk, see the DEC OSF/1 AXP system
              documentation.

        2.7 Stopping the Installation

              To stop the installation procedure at any time, press Ctrl
              /C. You must then delete files created up to this point
              interactively. The directories and files created during the
              RTR installation are listed in the following file (on your
              CD-ROM):

              /RTR314/kit/instctrl/rtrbase314.inv


























                      Preparing for RTR Installation on Digital UNIX  2-7
 










                                                                        3
        _________________________________________________________________

                                          Installing RTR on Digital UNIX


              This chapter describes how to install RTR on Digital UNIX.

              Before you start the installation, read Chapter 2.

              You can install RTR locally (using CD-ROM media) or from a
              server area.

              If you encounter any failures during installation, see
              Appendix C.

        3.1 Using CD-ROM Consolidated Distribution Media

              This procedure loads RTR files on to a disk belonging to
              the system where you perform the installation. When RTR is
              run, its executable images are mapped into memory on your
              system.

              Follow these steps to install RTR from CD-ROM media:

              1. Mount the media on the appropriate disk drive.

              2. Log in as superuser (login name root) to the system
                 where you will install RTR.

              3. Make sure you are at the root (/) directory by entering
                 the following command:

                     # cd /

              4. Specify the /cdrom directory to be the mount point for
                 the distribution file system on the drive. If your drive
                 is rz0, enter the following command:

                     # mount -dr /dev/rz0c /cdrom

              5. Enter a setld command that requests the load function
                 (-l) and identifies the directory in the mounted file
                 system where RTR subsets are located.

                                      Installing RTR on Digital UNIX  3-1
 



    Installing RTR on Digital UNIX
    3.1 Using CD-ROM Consolidated Distribution Media


             For example, if the directory location for these subsets
             is /cdrom/AXP/RTR314, enter the following command:

                 # setld -l /cdrom/AXP/RTR314

          The installation procedure now displays the names of RTR
          subsets and asks you to specify the subsets you want to
          load.

          See Section 3.3 to continue the installation.

    3.2 Using a RIS Distribution Area

          If you are installing RTR subsets that reside in an /etc
          /ris RIS distribution area on a remote system, follow these
          steps:

          1. Log in as superuser (login name root) to the system
             where you will install RTR.

          2. Make sure you are at the root directory (/) by entering
             the following command:

             #cd /

          3. Enter a setld command that requests the load function
             (-l option) and identifies the system where the RTR
             subsets are located. For example, if you are loading
             RTR subsets from a RIS distribution area on node orion,
             enter the following:

             #setld -l orion:

          Remote Installation Services now displays a menu that lists
          all the software subsets available to you and asks you to
          specify the subsets you want to load.

          See Section 3.3 to continue the installation.

    3.3 Responding to Installation Procedure Prompts

          This section explains the installation procedure prompts
          and displays.


    3-2 Installing RTR on Digital UNIX
 



                                          Installing RTR on Digital UNIX
                         3.3 Responding to Installation Procedure Prompts


        3.3.1 Selecting Subsets

              You must specify which RTR subsets you want to load.

                ________________________ Note ________________________

                If you are installing from a RIS distribution area,
                the number of subsets can vary depending on what
                products are available in the RIS area and how many
                subsets they have.

                ______________________________________________________

              *** Enter subset selections ***

              The following subsets are mandatory and will be installed automatically
              unless you choose to exit without installing any subsets:

                    * RTR API & Management Utility

              You may choose one of the following options:

                   1) ALL of the above
                   2) CANCEL selections and redisplay menus
                   3) EXIT without installing any subsets

              Enter your choices or press RETURN to redisplay menus.

              Choices (for example, 1 2 4-6):

              If you specify more than one number at the prompt, separate
              each number with a space, not a comma.

              Next, the script lets you verify your choice. For example,
              if you enter 1 in response to the previous prompt, you will
              see the following display:

              You are installing the following mandatory subsets:

                      RTR API & Management Utility

              You are installing the following optional subsets:

              Is this correct? (y/n):

              If the displayed subsets are not the ones you intended to
              choose, enter n. In this case, the subset selection menu is
              again displayed and you can correct your choice of optional
              subsets.

              If the displayed subsets are the ones you want to load,
              enter y.

                                      Installing RTR on Digital UNIX  3-3
 



    Installing RTR on Digital UNIX
    3.3 Responding to Installation Procedure Prompts


    3.3.2 Monitoring Displays During the Subset Loading Process

          The installation procedure loads and verifies the selected
          RTR subset.

          The following example shows a display where the RTR subset
          is being loaded from CD-ROM:

              Reliable Transaction Router V3.1D for Digital UNIX

            Installation started at Mon April 28 1997 17:21:41 MET 1996.

            Installation proceeds automatically, and will complete in approximately
            1 minute.

          RTR API & Management Utility
             Copying from . (disk)
             Verifying

          Configuring "RTR API & Management Utility" (RTRBASE314)

              Reliable Transaction Router V3.1D for Digital UNIX

            Installation completed at Mon April 28 1997 17:23:07 MET 1996.

          When you see the "Verifying" message during the subset
          installation, the installation procedure is checking to
          see that the files are copied correctly; it is not an
          Installation Verification Procedure (IVP) message.

          During the installation, if you get errors from the setld
          utility, see the Diagnostics section of the setld(8)
          reference page for an explanation of the errors and the
          appropriate actions to take.

          Chapter 4 explains how to run the IVP after installation,
          and how to delete old Reliable Transaction Router subsets
          before installing a new version of RTR.







    3-4 Installing RTR on Digital UNIX
 










                                                                        4
        _________________________________________________________________

                                      After Installation on Digital UNIX


              This chapter explains what you need to do after the
              installation on Digital UNIX to make RTR ready for use.

        4.1 Running the Installation Verification Procedure

              After installing RTR, you can run the Installation
              Verification Procedure (IVP) independently to verify that
              the software is available on your system. You might also
              want to run the IVP after a system failure to be sure that
              users can access RTR.

              Note that the Installation Verification Procedure (IVP)
              requires a working C language compiler to run.

              The RTR IVP verifies the installation as follows:

              o  Starts RTR and creates a facility

              o  Creates an RTR journal

              o  Creates an RTR facility

              o  Stops RTR

              o  Compiles and links the example client and server
                 programs

              To run the IVP after an installation, enter the following
              command:

              # setld -v RTRBASE314

              For a sample RTR IVP, see Appendix A.

              If the verification process fails, look in the /var/adm
              /smlogs/fverify.log file for information to help diagnose
              the problem.

                                  After Installation on Digital UNIX  4-1
 



    After Installation on Digital UNIX
    4.2 Deleting RTR from Your System


    4.2 Deleting RTR from Your System

          If you must remove a version of Reliable Transaction
          Router, Version 3.1D from your system, delete each subset
          that you previously installed.

          To delete subsets:

          1. Log in as superuser (login name root).

          2. Make sure you are at the root directory (/) by entering
             the following command:

                 # cd /

          3. Enter the following form of the setld command:

                 # setld -i | grep RTRBASE

          4. Look for the word "installed" in the listing produced,
             and then delete the installed subsets. For example:

             # setld -d RTRBASE314

    4.3 Displaying Documentation from CD-ROM

          The Reliable Transaction Router, Version 3.1D documentation
          is provided on the Digital UNIX Layered Products Online
          Documentation CD-ROM in Bookreader (.decw_book) file
          format. You can display the Bookreader files on your
          workstation using the DECwindows Bookreader application.
          For information on accessing and displaying these files,
          see the Digital UNIX Layered Products Disc User's Guide.

    4.4 Enabling Remote RTR Commands

          RTR supports the use of remote commands (described in
          Chapter 1 of the Reliable Transaction Router Version 3.1D,
          System Manager's Manual). In order to use this feature on
          Digital UNIX, you need to create an .rhosts file in the
          home directory of the RTR user on the target node or nodes.
          This file must contain the hostname (and, optionally, the
          username) of the node where the remote commands will be
          issued. For more information on the .rhosts file, see the
          rhosts(4) reference page.

    4-2 After Installation on Digital UNIX
 










                                                                        A
        _________________________________________________________________

                                                         Sample Listings


              This appendix provides sample listings for the following
              procedures:

              o  An installation of RTR on Digital UNIX using disk media.

              o  An Installation Verification Procedure (IVP) for RTR on
                 Digital UNIX.

              o  An installation of RTR on SunOS using disk media.

        A.1 Sample RTR for Digital UNIX Installation

        # setld -l /usr/users/mr_anders/rtrkit

          © Digital Equipment Corporation 1997. All rights reserved.

          Restricted Rights: Use, duplication, or disclosure by the U.S. Government
          is subject to restrictions as set forth in subparagraph (c) (1) (ii) of
          DFARS 252.227-7013, or in FAR 52.227-
        19, or in FAR 52.227=14 Alt. III, as
          applicable.

          This software is proprietary to and embodies the confidential technology
          of Digital Equipment Corporation. Possession, use, or copying of this
          software and media is authorized only pursuant to a valid written license
          from Digital or an authorized sublicensor.

        *** Enter subset selections ***

        The following subsets are mandatory and will be installed automatically
        unless you choose to exit without installing any subsets:

              * RTR API & Management Utility

        You may choose one of the following options:

             1) ALL of the above
             2) CANCEL selections and redisplay menus
             3) EXIT without installing any subsets

                                                     Sample Listings  A-1
 



    Sample Listings
    A.1 Sample RTR for Digital UNIX Installation


    Enter your choices or press RETURN to redisplay menus.

    Choices (for example, 1 2 4-6): 1

    You are installing the following mandatory subsets:

            RTR API & Management Utility

    You are installing the following optional subsets:

    Is this correct? (y/n): y

        Reliable Transaction Router V3.1D for Digital UNIX

      Installation started at Mon April 28 1997 17:21:41 MET 1996.

      Installation proceeds automatically, and will complete in approximately
      1 minute.

    RTR API & Management Utility
       Copying from . (disk)
       Verifying

    Configuring "RTR API & Management Utility" (RTRBASE314)

        Reliable Transaction Router V3.1D for Digital UNIX

      Installation completed at Mon April 28 1997 17:23:07 MET 1996.

    A.2 Sample RTR for Digital UNIX Installation Verification
        Procedure

    # setld -v RTRBASE314

    RTR API & Management Utility (RTRBASE314)

      © Digital Equipment Corporation 1997. All rights reserved.

        Reliable Transaction Router V3.1D for Digital UNIX

      Installation Verification Procedure

      starting RTR . . .
      adding a journal  . . .
      creating test facility . . .
      stopping RTR.
      linking test applications . . .

      Installation Verification Procedure completed successfully.

    A-2 Sample Listings
 



                                                         Sample Listings
                                   A.3 Sample RTR for SunOS Installation


        A.3 Sample RTR for SunOS Installation

        % ls
        pkg/
        # pkgadd -d pkg

        The following packages are available:
          1  rtr     Reliable Transaction Router
                     (sun4u) 314

        Select package(s) you wish to process (or 'all' to process
        all packages). (default: all) [?,??,q]:

        Processing package instance <rtr> from </rtrkit/pkg>

        Reliable Transaction Router
        (sun4u) 314
        DIGITAL

        Enter path to package base directory [?,q] /opt
        Using </opt> as the package base directory.
        ## Processing package information.
        ## Processing system information.
           67 package pathnames are already properly installed.
        ## Verifying disk space requirements.
        ## Checking for conflicts with packages already installed.
        ## Checking for setuid/setgid programs.

        The following files are being installed with setuid and/or setgid
        permissions:
        * /opt/rtr/RTR314/bin/rtr <setuid root setgid sys>
        * /opt/rtr/RTR314/binv54/rtr <setuid root setgid sys>

        * - overwriting a file which is also setuid/setgid.

        Do you want to install these as setuid/setgid files [y,n,?,q] y

        This package contains scripts which will be executed with super-
        user
        permission during the process of installing this package.

        Do you want to continue with the installation of <rtr> [y,n,?] y

        Installing Reliable Transaction Router as <rtr>

        ## Installing part 1 of 1.
        /opt/rtr/RTR314/examples/rtr/rtr_ivp_osf.sh
        [ verifying class <none> ]
        ## Executing postinstall script.

                                                     Sample Listings  A-3
 



    Sample Listings
    A.3 Sample RTR for SunOS Installation


      © Digital Equipment Corporation 1994, 1997. All rights reserved.

      Restricted Rights: Use, duplication, or disclosure by the U.S. Government
      is subject to restrictions as set forth in subparagraph (c) (1) (ii) of
      DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-
    14 Alt. III, as
      applicable.

      This software is proprietary to and embodies the confidential technology
      of Digital Equipment Corporation. Possession, use, or copying of this
      software and media is authorized only pursuant to a valid written license
      from Digital or an authorized sublicensor.

    This kit will only run on Sun Solaris 2.4 and above

      © Digital Equipment Corporation 1996, 1997. All rights reserved.

        Reliable Transaction Router V3.1D for SunOS

      Installation Verification Procedure

      starting RTR . . .
      adding a journal  . . .
      creating test facility . . .
      stopping RTR.

      Installation Verification Procedure completed successfully.

    Installation of <rtr> was successful.

    The following packages are available:
      1  rtr     Reliable Transaction Router
                 (sun4u) 314

    Select package(s) you wish to process (or 'all' to process
    all packages). (default: all) [?,??,q]: q









    A-4 Sample Listings
 










                                                                        B
        _________________________________________________________________

                                                          Files Installed


              This appendix lists the files, directories and symbolic
              links created by the installation on SunOS. The same files
              are installed on Digital UNIX, Windows NT and Windows 95
              systems.

        B.1 Symbolic Links Created


        /usr/bin/rtr -> ../../usr/opt/RTR314/bin/rtr
        /usr/bin/rtr_remote -> ../../usr/opt/RTR314/bin/rtr_remote
        /usr/shlib/librtr.so -> ../../usr/opt/RTR314/shlib/librtr.so
        /usr/shlib/librtr_r.so -> ../../usr/opt/RTR314/shlib/librtr_r.so

        B.2 Directories Created


              /rtr


        B.3 Files Created in /rtr
















                                                      Files Installed B-1
 



    Files Installed
    B.3 Files Created in /rtr


    -rw-r--r--   1 root     system    410812 Nov 18 16:02 rtr.hlp
    -rw-r--r--   1 root     system      1022 Nov 18 16:02 outpack.mon
    -rw-r--r--   1 root     system      1482 Nov 18 16:02 partit.mon
    -rw-r--r--   1 root     system      1211 Nov 18 16:02 queues.mon
    -rw-r--r--   1 root     system      2141 Nov 18 16:02 quorum.mon
    -rw-r--r--   1 root     system     15563 Nov 18 16:02 rdm.mon
    -rw-r--r--   1 root     system      1703 Nov 18 16:02 recovery.mon
    -rw-r--r--   1 root     system      3265 Nov 18 16:02 rfb.mon
    -rw-r--r--   1 root     system      2444 Nov 18 16:02 rolequor.mon
    -rw-r--r--   1 root     system      1796 Nov 18 16:02 routers.mon
    -rw-r--r--   1 root     system      1390 Nov 18 16:02 routing.mon
    -rw-r--r--   1 root     system     42145 Nov 18 16:02 rscbe.mon
    -rw-r--r--   1 root     system    430497 Nov 18 16:02 rtr.hlb
    -rw-r--r--   1 root     system      2726 Nov 18 16:02 rtr.mon
    -rw-r--r--   1 root     system      2806 Nov 18 16:02 stalls.mon
    -rw-r--r--   1 root     system      1759 Nov 18 16:02 tps.mon
    -rw-r--r--   1 root     system      1848 Nov 18 16:02 tpslo.mon
    -rw-r--r--   1 root     system      2844 Nov 18 16:02 traffic.mon
    -rw-r--r--   1 root     system      2014 Nov 18 16:02 trans.mon
    -rw-r--r--   1 root     system      5271 Nov 18 16:02 v2calls.mon
    -rw-r--r--   1 root     system      3477 Nov 18 16:02 accfail.mon
    -rw-r--r--   1 root     system      7354 Nov 18 16:02 acp2app.mon
    -rw-r--r--   1 root     system      1080 Nov 18 16:02 active.mon
    -rw-r--r--   1 root     system      3735 Nov 18 16:02 app2acp.mon
    -rw-r--r--   1 root     system     10125 Nov 18 16:02 calls.mon
    -rw-r--r--   1 root     system      1126 Nov 18 16:02 channel.mon
    -rw-r--r--   1 root     system       863 Nov 18 16:02 congest.mon
    -rw-r--r--   1 root     system      3864 Nov 18 16:02 connect.mon
    -rw-r--r--   1 root     system      2637 Nov 18 16:02 connects.mon
    -rw-r--r--   1 root     system      6629 Nov 18 16:02 ddtm.mon
    -rw-r--r--   1 root     system      4953 Nov 18 16:02 dtx.mon
    -rw-r--r--   1 root     system      4681 Nov 18 16:02 dtxrec.mon
    -rw-r--r--   1 root     system      5596 Nov 18 16:02 facility.mon
    -rw-r--r--   1 root     system      4224 Nov 18 16:02 flow.mon
    -rw-r--r--   1 root     system      1432 Nov 18 16:02 frontend.mon
    -rw-r--r--   1 root     system      2710 Nov 18 16:02 group.mon
    -rw-r--r--   1 root     system       999 Nov 18 16:02 inbytes.mon
    -rw-r--r--   1 root     system      1030 Nov 18 16:02 inmess.mon
    -rw-r--r--   1 root     system      1032 Nov 18 16:02 inpack.mon
    -rw-r--r--   1 root     system      2650 Nov 18 16:02 ipc.mon
    -rw-r--r--   1 root     system      6375 Nov 18 16:02 jcalls.mon
    -rw-r--r--   1 root     system      3301 Nov 18 16:02 journal.mon
    -rw-r--r--   1 root     system      3873 Nov 18 16:02 link.mon


    B-2 Files Installed
 



                                                          Files Installed
                                               B.3 Files Created in /rtr


        -rw-r--r--   1 root     system       595 Nov 18 16:02 locks.mon
        -rw-r--r--   1 root     system       989 Nov 18 16:02 outbytes.mon
        -rw-r--r--   1 root     system      1019 Nov 18 16:02 outmess.mon

        B.4 Files Created in /usr/opt




        drwxrwxr-x   2 bin      bin          512 Nov 18 16:01 bin
        drwxrwxr-x   2 bin      bin          512 Nov 18 16:01 binv32
        drwxr-xr-x   3 bin      bin          512 Nov 14 09:03 examples
        drwxrwxr-x   2 bin      bin          512 Nov 18 16:01 hlp
        drwxr-xr-x   3 bin      bin          512 Nov 18 16:01 lib
        drwxrwxr-x   2 bin      bin         1024 Nov 18 16:01 mon
        drwxrwxr-x   2 bin      bin          512 Nov 18 16:01 shlib
        drwxrwxr-x   2 bin      bin          512 Nov 18 16:02 shlibv32

        /usr/opt/RTR314/bin:
        -rwsr-sr-x   1 root     system    262144 Nov 18 17:17 rtr
        -rwxr-xr-x   1 bin      bin         1618 Nov 18 18:59 rtr_remote

        /usr/opt/RTR314/binv32:
        -rwsr-sr-x   1 root     system    270336 Nov 17 00:10 rtr

        /usr/opt/RTR314/examples:
        drwxrwxr-x   2 bin      bin          512 Nov 18 16:01 rtr

        /usr/opt/RTR314/examples/rtr:

        -r-xr-xr-x   1 bin      bin         5646 Nov 18 18:59 rtr_ivp_osf.sh
        -rw-r--r--   1 bin      bin        11736 Nov 18 17:00 rtrreq.c
        -rw-r--r--   1 bin      bin         8317 Nov 18 17:00 rtrsrv.c

        /usr/opt/RTR314/hlp:

        -rw-r--r--   1 bin      bin       430497 Nov 18 17:18 rtr.hlb
        -rw-r--r--   1 bin      bin       410812 Nov 18 17:16 rtr.hlp

        /usr/opt/RTR314/lib:

        drwxrwxr-x   2 bin      bin          512 Nov 14 09:04 doclib
        -rw-r--r--   1 bin      bin       560540 Nov 18 16:58 rtr.h

        /usr/opt/RTR314/lib/doclib:
        total 0

        /usr/opt/RTR314/mon:

                                                      Files Installed B-3
 



    Files Installed
    B.4 Files Created in /usr/opt


    -rw-r--r--   1 bin      bin         3477 Nov 18 17:21 accfail.mon
    -rw-r--r--   1 bin      bin         7354 Nov 18 17:21 acp2app.mon
    -rw-r--r--   1 bin      bin         1080 Nov 18 17:21 active.mon
    -rw-r--r--   1 bin      bin         3735 Nov 18 17:21 app2acp.mon
    -rw-r--r--   1 bin      bin        10125 Nov 18 17:21 calls.mon
    -rw-r--r--   1 bin      bin         1126 Nov 18 17:21 channel.mon
    -rw-r--r--   1 bin      bin          863 Nov 18 17:21 congest.mon
    -rw-r--r--   1 bin      bin         3864 Nov 18 17:21 connect.mon
    -rw-r--r--   1 bin      bin         2637 Nov 18 17:21 connects.mon
    -rw-r--r--   1 bin      bin         6629 Nov 18 17:21 ddtm.mon
    -rw-r--r--   1 bin      bin         4953 Nov 18 17:22 dtx.mon
    -rw-r--r--   1 bin      bin         4681 Nov 18 17:22 dtxrec.mon
    -rw-r--r--   1 bin      bin         5596 Nov 18 17:22 facility.mon
    -rw-r--r--   1 bin      bin         4224 Nov 18 17:22 flow.mon
    -rw-r--r--   1 bin      bin         1432 Nov 18 17:22 frontend.mon
    -rw-r--r--   1 bin      bin         2710 Nov 18 17:22 group.mon
    -rw-r--r--   1 bin      bin          999 Nov 18 17:22 inbytes.mon
    -rw-r--r--   1 bin      bin         1030 Nov 18 17:22 inmess.mon
    -rw-r--r--   1 bin      bin         1032 Nov 18 17:22 inpack.mon
    -rw-r--r--   1 bin      bin         2650 Nov 18 17:22 ipc.mon
    -rw-r--r--   1 bin      bin         6375 Nov 18 17:23 jcalls.mon
    -rw-r--r--   1 bin      bin         3301 Nov 18 17:23 journal.mon
    -rw-r--r--   1 bin      bin         3873 Nov 18 17:23 link.mon
    -rw-r--r--   1 bin      bin          595 Nov 18 17:23 locks.mon
    -rw-r--r--   1 bin      bin          989 Nov 18 17:23 outbytes.mon
    -rw-r--r--   1 bin      bin         1019 Nov 18 17:23 outmess.mon
    -rw-r--r--   1 bin      bin         1022 Nov 18 17:23 outpack.mon
    -rw-r--r--   1 bin      bin         1482 Nov 18 17:23 partit.mon
    -rw-r--r--   1 bin      bin         1211 Nov 18 17:23 queues.mon
    -rw-r--r--   1 bin      bin         2141 Nov 18 17:23 quorum.mon
    -rw-r--r--   1 bin      bin        15563 Nov 18 17:24 rdm.mon
    -rw-r--r--   1 bin      bin         1703 Nov 18 17:24 recovery.mon
    -rw-r--r--   1 bin      bin         3265 Nov 18 17:24 rfb.mon
    -rw-r--r--   1 bin      bin         2444 Nov 18 17:24 rolequor.mon
    -rw-r--r--   1 bin      bin         1796 Nov 18 17:24 routers.mon
    -rw-r--r--   1 bin      bin         1390 Nov 18 17:24 routing.mon
    -rw-r--r--   1 bin      bin        42145 Nov 18 17:24 rscbe.mon
    -rw-r--r--   1 bin      bin         2726 Nov 18 17:24 rtr.mon
    -rw-r--r--   1 bin      bin         2806 Nov 18 17:24 stalls.mon
    -rw-r--r--   1 bin      bin         1759 Nov 18 17:24 tps.mon
    -rw-r--r--   1 bin      bin         1848 Nov 18 17:24 tpslo.mon
    -rw-r--r--   1 bin      bin         2844 Nov 18 17:24 traffic.mon
    -rw-r--r--   1 bin      bin         2014 Nov 18 17:25 trans.mon


    B-4 Files Installed
 



                                                          Files Installed
                                            B.4 Files Created in /usr/opt


        -rw-r--r--   1 bin      bin         5271 Nov 18 17:25 v2calls.mon

        /usr/opt/RTR314/shlib:

        -rw-r-xr-x   1 bin      bin      6356992 Nov 18 18:58 librtr.so
        -rw-r-xr-x   1 bin      bin      6389760 Nov 18 18:52 librtr_r.so

        /usr/opt/RTR314/shlibv32:

        -rw-r-xr-x   1 bin      bin      7020544 Nov 17 00:07 librtr.so
        -rw-r-xr-x   1 bin      bin      7159808 Nov 18 17:20 librtr_r.so


































                                                      Files Installed B-5
 










                                                                        C
        _________________________________________________________________

                                                  Recovering from Errors


              This appendix provides information to help you deal with
              problems that might occur during product installation or
              product use.

              If you find an error in the documentation, fill out and
              submit one of the Reader's Comments forms at the back of
              the document that contains the error. Include the section
              and page number where the error occurred.

        C.1 Problems During Product Installation

              If errors occur during the installation, the system
              displays failure messages. For example, if the Digital
              UNIX installation fails due to insufficient disk space, the
              following message appears:

              There is not enough space for subset RTRBASE314
              Reliable Transaction Router for Digital UNIX
              (RTRBASE314) will not be loaded.

              Errors can occur during the installation if any of the
              following conditions exist:

              o  The operating system version is incorrect.

              o  The prerequisite software version is incorrect.

              o  There is insufficient disk space.

              o  The system parameter values for successful installation
                 are insufficient.

              For descriptions of error messages generated by these
              conditions, see the Digital UNIX documentation on system
              messages, recovery procedures, and software installation.
              For information on system software requirements, see
              Section 2.4.3.

                                              Recovering from Errors  C-1
 



    Recovering from Errors
    C.2 Problems After Installation


    C.2 Problems After Installation

          U.S. customers who encounter a problem while using Reliable
          Transaction Router, Version 3.1D can report it to Digital
          by telephoning the Digital Customer Support Center (CSC) at
          1-800-354-9000. (Customers with service contracts can also
          use an electronic means such as DSNlink.)

          Customers without a service contract can arrange for per-
          call support.

          The CSC will need the following information:

          o  The name and version number of the operating system you
             are using

          o  The Reliable Transaction Router, Version 3.1D and
             version number you are using

          o  The hardware system you are using (such as a model
             number)

          o  A brief description of the problem (one sentence if
             possible)

          o  Whether or not the problem is critical

          o  Any other information that is helpful, such as the
             specific commands you used to run the software, the
             error messages displayed, and source listings of the
             relevant software module or lines of code

          If the problem is related to Reliable Transaction Router,
          Version 3.1D documentation, you can do the following:

          o  Report the problem to the CSC (if you have a service
             contract and the problem is severe).

          o  Send comments electronically to the following Internet
             address:
             stephen.anders@digital.com.

          If you are reporting a specific error, be sure to include
          the section and page number where the error occurred.

    C-2 Recovering from Errors
