To use the features of Reliable Transaction Router, each account must have the following privileges:

• NETMBX
• TMPMBX
• SYSLCK

In addition, the Rights Identifier RTR$INFO is required.

The RTR System Manager (that is, the account that starts up RTR and creates facilities) must also have either OPER privilege or have the Rights Identifier RTR$OPERATOR.

3.5 Files Installed on OpenVMS

This section lists the files added to your system by the installation on OpenVMS.

[vms$common]rtr.dir [sys$startup]rtr$startup.com [sysexe]rtr.exe [sysexe]rtr$remote.com [sysexe]rtr_start_acp.com [syslib]rtr.h [syslib]librtr.exe [sysmgr]rtr$snapshot.com [sysmgr]rtr$shutdown.com [systest]rtr$ivp.com [syshlp]rtr_relnotes.txt [syshlp]rtr_relnotes.ps [syshlp]rtr.hlb [syshlp]rtr_migration_guide.ps [rtr]ACCFAIL.mon [rtr]ACP2APP.mon [rtr]ACTIVE.mon [rtr]APP2ACP.mon [rtr]BROADCAST.mon [rtr]CALLS.mon [rtr]CHANNEL.mon [rtr]CONNECTS.mon [rtr]DDTM.mon [rtr]DTX.mon [rtr]DTXREC.mon [rtr]EVENT.mon [rtr]FACILITY.mon [rtr]FLOW.mon [rtr]FRONTEND.mon [rtr]GROUP.mon [rtr]IPC.mon [rtr]IPCRATE.mon [rtr]JCALLS.mon [rtr]JOURNAL.mon [rtr]LINK.mon [rtr]NETBYTES.mon [rtr]NETSTAT.mon [rtr]PARTIT.mon [rtr]QUEUES.mon [rtr]QUORUM.mon [rtr]RDM.mon [rtr]RECOVERY.mon [rtr]REJECTS.mon [rtr]REJHIST.mon [rtr]RESPONSE.mon [rtr]RFB.mon [rtr]ROLEQUOR.mon [rtr]ROUTERS.mon [rtr]ROUTING.mon [rtr]RSCBE.mon [rtr]RTR.mon [rtr]STALLS.mon [rtr]SYSTEM.mon [rtr]TPS.mon [rtr]TPSLO.mon [rtr]TRAFFIC.mon [rtr]TRANS.mon [rtr]V2CALLS.mon [rtr]XA.mon [sysmsg]oormsg.exe (optional component) [syslib]oorcmp.exe (optional component) [sysexe]ooro7v2.exe (optional component) sys$examples:[rtr]crtr.cxx sys$examples:[rtr]crtr.hxx sys$examples:[rtr]cslb.hxx sys$examples:[rtr]example_cli.cxx sys$examples:[rtr]example_cslib.hxx sys$examples:[rtr]example_srv.cxx sys$examples:[rtr]rtr_ivp_osf.sh sys$examples:[rtr]rtrreq.c sys$examples:[rtr]rtrsrv.c

This chapter describes a full installation on Windows NT to run RTR as a server. For information on installing RTR for client applications on Windows 95 or Windows 98, see Section 1.2.

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

• For full-function functionality, any Alpha or Intel architecture system that runs Windows NT Version 4.0.
• For frontend functionality, any Alpha or Intel system that runs Windows NT Version 4.0, or any system that runs Windows 95 or Window 98.
• A :CD-ROM drive is required for installation.

• Windows NT Operating System Version 4.0, or Windows 95 or Windows 98 Operating System (frontend only).
• TCP/IP
• For Windows NT, Microsoft Windows NT Service Pack 3 is required as a minimum. RTR has also been tested with Service Pack 4.

• For Windows 95, Windows 98, and Windows NT Intel systems, a minimum of 16MB RAM is recommended.
• For Windows NT Alpha systems, a minimum of 32MB RAM is recommended.

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. (Issue the following commands in an MS DOS window):

      RTR STOP RTR RTR DISCONNECT SERVER/DAEMON

   2. Delete the file RTRENVPS in the RTR root directory.
   3. Logout of your Windows NT session and login again. (This to ensure that no background RTR tasks are running.)
   4. To eradicate RTR V3.1D from the disk, issue the following command:

      DELETE /S/Q C:\RTR

   5. Delete existing icon
3. Insert the RTR CD into the drive.
4. Exit all Windows programs to run Setup.
5. From the Start button, invoke Windows Explorer to view files.
6. Choose the drive letter of your :CD-ROM and open the directory ALPHA or I386, depending on your processor type (Alpha or Intel, respectively). Double click on the file SETUP.EXE. This starts the InstallShield that takes you through the setup process.
7. The InstallShield wizard steps you through the installation. Click on the Next button to continue installation or on the Cancel button to stop it.
8. Accept the terms of the License Agreement. If you reject the terms, installation is stopped.
9. Follow the screen instructions to enter the name of the directory where you want to install RTR. The default is

   C:\Program Files\Compaq\Reliable Transaction Router

   
   Compaq recommends that you install RTR on a local hard disk (NTFS or FAT).

10. Choose the Setup Type: Typical, Compact, or Custom by selecting a radio button. Choices are:
    • Typical: RTR is installed with the most common options. Recommended for most users.
    • Compact: RTR is installed with the minimum required options. Selecting compact installs RTR with no example files.
    • Custom: Choose the options to install (for advanced users only). Choose this to install an add-on such as ODBC Over RTR or RTR as a Service (NT only).
    
    If you select Custom, the components screen appears. Choose components to install. The screen display indicates how much disk space is required for each component.

    Note RTR as a Service runs only on Windows NT; the InstallShield does not register the service but RTR provides batch procedures to do so in the target directory.

11. Setup adds a program icon to the Program Folder you select, and installs files in the appropriate location.
12. The InstallShield completes the installation, displaying a progress graphic until installation is complete.
13. Click on Finish to complete the installation of RTR.

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

The following examples are provided in the [EXAMPLES] directory:

• rtrreq.c
• rtrsrv.c
• rtrw32rq.c

The program rtrreq.c is a console mode client; the program rtrsrv.c is a console mode server. The program rtrw32rq.c is a sample GUI client that can run with rtrsrv.c. The example applications can be built by using the examples.mak file:

NMAKE/f examples.mak

4.4 Files Installed on Microsoft Windows NT

        <DIR>          . 
        <DIR>          .. 
                 Accfail.mon 
                 Acp2app.mon 
                 Active.mon 
                 App2acp.mon 
                 Broadcast.mon 
                 Calls.mon 
                 Channel.mon 
                 Connects.mon 
                 Ddtm.mon 
                 Dtx.mon 
                 Dtxrec.mon 
        <DIR>          examples 
                 Event.mon 
                 Facility.mon 
                 Flow.mon 
                 Frontend.mon 
                 Group.mon 
                 installservice.bat 
                 Ipc.mon 
                 Ipcrate.mon 
                 Jcalls.mon 
                 Journal.mon 
                 Link.mon 
                 Msvcrt.dll 
                 Oorcmp.dll 
                 Oorodb32.dll 
                 Ooroml32.dll 
                 Oorrot13.dll 
                 Oorstp32.dll 
                 Netbytes.mon 
                 Netstat.mon 
                 Partit.mon 
                 Queues.mon 
                 Quorum.mon 
                 Rdm.mon 
                 readment.txt 
                 Recovery.mon 
                 Rejects.mon 
                 Rejhist.mon 
                 Response.mon 
                 Rfb.mon 
                 Rolequor.mon 
                 Routers.mon 
                 Routing.mon 
                 Rscbe.mon 
                 rtr.exe 
                 Rtr.h 
                 Rtr.hlb 
                 Rtr.hlp 
                 rtr.ico 
                 Rtr.mon 
                 rtrdll.dll 
                 rtrdll.lib 
                 RTRSvc.exe 
                 shutdown.bat 
                 Stalls.mon 
                 System.mon 
                 Tps.mon 
                 Tpslo.mon 
                 Traffic.mon 
                 Trans.mon 
                 Uninst.isu 
                 uninstallservice.bat 
                 V2calls.mon 
                 xa.mon 
 
             \examples 
                 doswin16.mak 
                 examples.mak 
                 rtrreq.c 
                 rtrsrv.c 
                 rtrw32rq.c 
                 rtrw32rq.def 
                 rtrw32rq.dlg 
                 rtrw32rq.h 
                 rtrw32rq.rc 
 

This chapter provides descriptions of all steps in doing a full installation including:

• Preparing for installation
• Installing
• Verifying the installation

RTR software is distributed on :CD-ROM as part of Compaq'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:

• A :CD-ROM for systems with :CD-ROM drives
• A :CD-ROM booklet and :CD-ROM read first letter

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

5.1.2 Reading the Online Release Notes

RTR provides online release notes. Compaq 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 on the :CD-ROM:

rtr3xx_relnotes.txt

Where "xx" represents a revision level.

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

more rtr3xx_relnotes.txt

Where "xx" represents a revision level.

5.1.3 Registering Your Software License

RTR includes support for the License Management Facility (LMF). You must register your License Product Authorization Key (License PAK) in the License Database (LDB) in order to use RTR on a newly licensed node. 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 Compaq Tru64 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.

5.1.4 Checking Installation Requirements

This section discusses 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.

5.1.4.1 Checking Login Privileges

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

5.1.4.2 Checking Hardware Requirements

To install RTR, you need the following hardware:

• Software distribution device (if installing from media)
  Locate the :CD-ROM drive for the :CD-ROM software distribution media. The CD booklet or the documentation for the :CD-ROM drive you are using explains how to load the :CD-ROM media.
• Terminal
  You can use a hardcopy or video terminal or a workstation 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.

5.1.4.3 Checking Software Requirements

RTR requires the Compaq Tru64 UNIX operating system shown on the cover of this manual.

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

• OSFBASE---the Base System subset

The following Compaq Tru64 UNIX software subsets are optional on the system where you install RTR:

• OSFCLINET200---Basic Networking Services (TCP/IP) subset
• DNABASE110---DECnet/OSI Base Components subset, together with
• 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.
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 Compaq Tru64 UNIX software before installing RTR. (For 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:

• rtrbase320
  RTR runtime and system management.

Table 5-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 5-1 RTR Subset Size (Kilobytes Required)

Subset Title	Subset Name	/usr/opt/	/rtr
RTR	rtrbase320	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 /rtrjnl.

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

5.1.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 5-1, RTR Subset Size (Kilobytes Required).

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.

5.1.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/RTR320

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

If the rtr320 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/rtr320 .
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.

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:

• A RTR network kit is available for use.
• 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.

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