# hp Reliable Transaction Router
Installation Guide

Previous | Contents | Index

### 4.2.1.1 Install from CD-ROM

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. Use the `setld` utility to check if you have a version of RTR already installed:

       # setld -i | grep RTR

5. If RTR is already installed on your system, see Section B.3 for information on uninstalling RTR and removing related processes.
6. Specify the `/cd-rom` directory to be the mount point for the distribution file system on the drive. For example, if your drive is `rz0` , enter the following command:

           # mount -dr /dev/rz0c /CD-ROM

7. Enter a `setld` command that requests the load function ( `-l` ) and identifies the directory in the mounted file system where RTR subsets are located.
   For example, if the directory location for these subsets is `rtrbase420` , enter the following command:

           # setld -l RTRBASE420

See Section 4.2.3 to continue the installation.

### 4.2.1.2 Install from RIS

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.

## 4.2.2 Read the Online Release Notes

The Release Notes provide information for RTR that could not be included in the printed documentation. After installation the Release Notes are located in the directory /usr/opt/RTR420/hlp; you are advised to read the Release Notes before using RTR.

To read the release notes, navigate to the directory where RTR is installed and issue the following command:

    more rtr_relnotes.txt

## 4.2.3 Installation Example

This section explains the installation procedure prompts and displays.

### 4.2.3.1 Select 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.

    # setld -l RTRBASE420

      Copyright 1994, 2003 Hewlett-Packard Development Company, L.P.

      Confidential computer software. Valid license from HP and/or
      its subsidiaries required for possession, use or copying.
      Consistent  with FAR 12.211 and 12.212, Commercial Computer
      Software, Computer Software Documentation, and Technical
      Data for Commercial Items are licensed to the U.S.
      Government under vendor's standard commercial license.

    The subsets listed below are optional:

          There may be more optional subsets than can be presented
          on a single
          screen. If this is the case, you can choose subsets
          screen by screen
          or all at once on the last screen. All of the choices
          you make will
          be collected for your confirmation before any subsets
          are installed.

          1) RTR API & Management Utility

    Or you may choose one of the following options:

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

    Estimated free diskspace(MB) in root:33.2 usr:198.8

    Press RETURN to display the next screen.

    Enter your choices or press RETURN to redisplay menus.

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

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 optional subsets:

            RTR API & Management Utility

    Estimated free diskspace(MB) in root:33.2 usr:177.9

    Is this correct? (y/n): y

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` .

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:

    Checking file system space required to install selected subsets:

    File system space checked OK.

    1 subsets will be installed.

    Loading subset 1 of 1 ...

      Reliable Transaction Router V4.2 for Tru64 UNIX

      Installation started at Wed Apr 10 16:08:17 EDT 2002

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

    RTR API & Management Utility
       Copying from . (disk)
            Working....Wed Apr 10 16:08:29 EDT 2002
       Verifying

    1 of 1 subset(s) installed successfully.
    reusing existing /usr/doc/rtr directory
    /usr/doc/rtr//rtr_relnotes.txt: File exists
    /usr/doc/rtr//rtr_relnotes.ps: File exists
    mkdir: cannot create /var/opt/rtrjnl.
    /var/opt/rtrjnl: File exists

    Configuring "RTR API & Management Utility" (RTRBASE420)

      directory /var/run/rtr created

      reusing existing /rtr directory

    Copyright 1994, 2003 Hewlett-Packard Development Company, L.P.

    Confidential computer software. Valid license from HP and/or
    its
    subsidiaries required for possession, use or copying. Consistent
    with FAR 12.211 and 12.212, Commercial Computer Software,
    Computer
    Software Documentation, and Technical Data for Commercial Items
    are licensed to the U.S. Government under vendor's standard
    commercial license.

      Reliable Transaction Router V4.2 for Tru64 UNIX

      Installation completed at Wed Apr 10 16:09:31 EDT 2002.

      You can run the Installation Verification Procedure using
      this command:
                       setld -v RTRBASE420

      Release Notes are available in:
      /usr/opt/RTR420/hlp/rtr_relnotes.*
    #

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.

Section 4.2.4 explains how to run the IVP after installation, and how to delete old RTR subsets before installing a new version of RTR.

## 4.2.4 Run 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:

- Starts RTR
- Creates an RTR journal
- Creates an RTR facility
- Stops RTR
- Compiles and links the example client and server programs

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

    # setld -v RTRBASE420

For a sample RTR IVP, see Section 1.2.4.

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

## 4.2.5 Stop 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):

    /rtr40/kit/instctrl/rtrbase420.inv

## 4.2.6 Delete RTR from Your System

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

To delete subsets:

1. Log in as superuser (login name `root` ).
2. Make sure you are at the root directory (/) by entering the following command:

           # cd /

3. Enter the following form of the `setld` command:

           # setld -i | grep RTRBASE

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

       # setld -d RTRBASE420

## 4.2.7 Display Documentation from CD-ROM

The Reliable Transaction Router documentation is provided on the Tru64 UNIX Layered Products Online Documentation CD-ROM in hypertext (.html) file format. You can display the hypertext files on your workstation using any HTML browser such as Netscape or Internet Explorer.

# 4.3 Complete RTR Setup

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

Requirements for Application Permissions If the RTR executable is modified after installation to no longer be `suid` root or the mode of the `/rtr` directory is changed, an application process (for example a client) can encounter a fatal error (Unable to locate a socket) when the client process finds it cannot create an `rtr_ipc_sock_*` file for the process ID (pid) in the `/rtr` directory. To avoid this, ensure that application processes run with user and group IDs that have access permission to create and remove files in this directory.

## 4.3.1 Check Installed Files

To see the list of files installed on your system, use the following command:

    % setld -i subset_name

## 4.3.2 Enable Remote RTR Commands

RTR supports the use of remote commands (described in Chapter 1 of the Reliable Transaction Router System Manager's Manual). To use this feature on Tru64 UNIX, check your operating system documentation for how to ensure access to a TCP/IP environment.

You may, for example, need to create an `.rhosts` file in the home directory of the RTR user on the target node or nodes, among other things. This file would 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.3.3 Run RTR

To run RTR, enter the following command at the system prompt:

    % RTR
    RTR>

You can then enter commands at the RTR prompt to configure facilities and partitions, and run applications that use RTR.

### 4.3.3.1 Configure RTR Facilities and Partitions

For information on configuring RTR facilities and setting up partitions, refer to the Reliable Transaction Router Getting Started and the Reliable Transaction Router System Manager's Manual.

## 4.3.4 Install and Run Applications

Once applications that use RTR have been designed and tested, they can be deployed on the systems configured for use with RTR. For information on designing RTR applications, refer to the Reliable Transaction Router Application Design Guide; for information on deployment and use, refer to the Reliable Transaction Router System Manager's Manual.

Application programming interfaces that can be used to write transaction processing applications used with RTR are described in the Reliable Transaction Router C++ Foundation Classes manual and the Reliable Transaction Router C Application Programmer's Reference Manual.

# Chapter 5
Full Installation on Windows

This chapter describes how to install Reliable Transaction Router on Windows systems. It includes steps for:

- Preparing for installation
- Installing RTR
- Completing RTR setup

# 5.1 Prepare for Installation

Before you start the installation, review the hardware and software requirements described in the following sections.

User-Changed Monitor Files If you have changed any RTR monitor (*.mon) files, you must rename them or they will be overwritten during installation. To avoid this, always work from renamed copies of RTR monitor files when making local modifications.

## 5.1.1 Check Required Hardware

- For client/server/router functionality, any Intel system that runs Windows NT, Windows 2000, or Windows XP.
- For client functionality, any Intel system that runs Windows 2000, Windows NT, Windows XP, Windows 98, or Windows ME.

## 5.1.2 Check Required Software

The following list contains the required version of Windows for each system to be used with RTR:

- Windows NT Version 4.0, Service Pack 4
- Windows 2000, Service Pack 1
- Windows XP
- Windows ME (client only)
- Windows 98 (client only), Service Pack 1, Y2K update
- all systems must include TCP/IP support

## 5.1.3 Check Required Disk Space

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

## 5.1.4 Check System Parameters

RTR has basic memory requirements. This section references setup instructions for the relevant system parameters.

### 5.1.4.1 Check Memory-Mapped I/O Requirements

For information on how to size memory-mapped I/O appropriately, refer to Reliable Transaction Router System Manager's Manual, RTR Shared Memory Sizing.

### 5.1.4.2 Check Virtual Memory Requirements

The basic memory requirement for an unconfigured RTRACP is 5.6MB. Additional memory may be required. For additional information, refer to the Reliable Transaction Router System Manager's Manual, RTRACP Virtual Memory Sizing for All Systems.

# 5.2 Install RTR

1. If you are installing on Windows 2000, Windows XP, or Windows NT, ensure that you are logged in as the Administrator, or have administrator privileges.
2. If RTR is already installed on your system, see Section B.2, Uninstalling on Windows Systems, for information on uninstalling RTR and removing related processes.
3. Insert the RTR CD-ROM into the drive.
4. Exit all Windows programs to run Setup.
5. From the Start button, invoke Windows Explorer to view files.
6. Choose the drive letter of your CDROM and open the directory I386. Double click on the file SETUP.EXE. This starts the InstallShield that takes you through the setup process.
7. The InstallShield wizard steps you through the installation. Click on the Next button to continue installation or on the Cancel button to stop it.
8. 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\HP\RTR

   HP 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 users familiar with RTR only). Choose this to install an add-on such as 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.
    RTR as a Service runs only on Windows NT, Windows 2000, or Windows XP; the InstallShield does not register the service but RTR provides batch procedures to do so in the target directory.
    To use the batch procedures for RTR as a Service, follow this sequence:
    Start -> Programs -> Compaq -> RTR -> Service -> Register
    To remove RTR as a Service, end the above sequence with -> Unregister.
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.

## 5.2.1 Read the Readme File

The Readme file provides information about RTR that could not be included in the printed documentation. The Readme file is located in the directory where you installed RTR. You should read the Readme before you use RTR. You can also open the RTR Readme from the Start menu as follows:

Start -> Programs -> Compaq -> RTR -> Documentation -> Readme

# 5.3 Complete RTR Setup

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

Note The Windows registry is modified slightly as a result of a RTR installation.

## 5.3.1 Check Installed Files

Navigate to the directory where you installed RTR.

To see a list of the files installed, use Windows Explorer or enter the following command:

    Tree/F

## 5.3.2 Enable RTR Remote Commands

To make it possible to execute RTR commands on remote systems, you must use the remote shell (RSH). See the documentation on remote shell on your Windows system.

The RSH service runs commands on remote computers running the RSH service. This command is available only if the TCP/IP protocol has been installed.

You can also execute remote commands with /NODE qualifiers on certain RTR commands, and in conjunction with the RTR SET ENVIRONMENT command. For more information on executing RTR commands remotely, refer to the Reliable Transaction Router System Manager's Manual.

## 5.3.3 Display Documentation

Softcopy documentation for Reliable Transaction Router is available on the RTR Software Kit in distilled PostScript (.pdf) file format. You can display .pdf files with Acrobat Reader, a free reader of electronic files from Adobe Systems.

## 5.3.4 Run RTR

To run RTR, follow these steps:

- Click on
  Start -> Programs -> Compaq -> RTR -> Reliable Transaction Router
  This brings up a DOS-style RTR command window. To start RTR, enter Start RTR at the `RTR>` prompt.
- Click on Start -> Programs -> Compaq -> RTR -> Web Browser Interface
  This brings up the browser-based RTR screens with which you monitor and manage RTR.

### 5.3.4.1 Configure RTR Facilities and Partitions

For information on configuring RTR facilities and setting up partitions, refer to the Reliable Transaction Router Getting Started and the Reliable Transaction Router System Manager's Manual.

## 5.3.5 Install and Run Applications

Once applications that use RTR have been designed and tested, they can be deployed on the systems configured for use with RTR. For information on designing applications, refer to the Reliable Transaction Router Application Design Guide; for information on deployment and monitoring, refer to the Reliable Transaction Router System Manager's Manual.

Previous | Next | Contents | Index