Reliable Transaction Router

Reliable Transaction Router

Installation Guide

Order Number: AA-Q88DF-TE

This guide describes how to install Reliable Transaction Router for all operating systems on which RTR is supported.

Revision/Update Information: This manual supersedes the Reliable Transaction Router Installation Guide for RTR Version 3.2, and has been completely revised.

Software Version: Reliable Transaction Router Version 4.0

Compaq Computer Corporation
Houston, Texas


January, 2001

COMPAQ COMPUTER CORPORATION SHALL NOT BE LIABLE FOR TECHNICAL OR EDITORIAL ERRORS OR OMISSIONS CONTAINED HEREIN, NOR FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES RESULTING FROM THE FURNISHING, PERFORMANCE, OR USE OF THIS MATERIAL. THIS INFORMATION IS PROVIDED "AS IS" AND COMPAQ COMPUTER CORPORATION DISCLAIMS ANY WARRANTIES, EXPRESS, IMPLIED OR STATUTORY AND EXPRESSLY DISCLAIMS THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR PARTICULAR PURPOSE, GOOD TITLE AND AGAINST INFRINGEMENT. This publication contains information protected by copyright. No part of this publication may be photocopied or reproduced in any form without prior written consent from Compaq Computer Corporation.

© 2001 Compaq Computer Corporation

The software described in this guide is furnished under a license agreement or nondisclosue agreement. The software may be used or copied only in accordance with the terms of the agreement.

Compaq and the Compaq logo are registered in the United States Patent and Trademark Office.

Compaq Internet Personal Tunnel, DEC, DECdtm, DECnet, DIGITAL, OpenVMS, Tru64 UNIX, and VAX are trademarks of Compaq Information Technologies Group, L.P. in the United States and/or other countries.

Microsoft, Microsoft SQL Server, Internet Explorer, MS-DOS, Visual C++, Windows, Windows 95, Windows 98, and Windows NT are trademarks or registered trademarks of Microsoft Corporation in the United States and/or other countries.
Intel is a trademark of Intel Corporation in the United States and/or other countries.
UNIX is a registered trademark of The Open Group in the United States and/or other countries.

All other product names mentioned herein may be trademarks or registered trademarks of their respective companies.

Contents


Preface

This guide explains how to install Reliable Transaction Router (RTR) on supported platforms. If you are installing RTR on only one platform, you need only read the sections that apply to that platform.

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

Structure of this Document

This guide contains the following chapters and appendixes:

Associated Documents

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

Conventions

Table 1 describes the conventions used in this guide.

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 for many UNIX systems.
$ A dollar sign ($) is the default user prompt for OpenVMS systems.
[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
lowercase
The UNIX operating system 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 quotation 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 (UNIX systems only).
[y] In a prompt, square brackets indicate that the enclosed item is the default response. For example, [y] means the default response is Yes.

Reading Path

The reading path to follow when using the Reliable Transaction Router information set is shown in Figure 1.

Figure 1 RTR Reading Path



Chapter 1
Quick Installation

This chapter gives brief instructions for installing Reliable Transaction Router on the following platforms:

1.1 Installing RTR for OpenVMS

Your Reliable Transaction Router for OpenVMS kit is supplied on CD-ROM. After installation, the Release Notes are located in the directory SYS$COMMON:[SYSHLP] ; you are advised to read the Release Notes before using RTR.

The installation of the RTR base product requires about 50000 blocks during installation, and about 36000 blocks after installation is done. The installation takes less than five minutes to complete. For more detailed instructions, see Chapter 3, Full Installation on OpenVMS .

1.1.1 Installation Procedure

  1. If RTR is already installed on your system, see Section 2.2.1, Uninstalling on OpenVMS, for information on uninstalling RTR and removing related processes.
  2. Log on to the System Manager's account.
  3. Define the logical name for the location of the software kit, for example:


    $ DEFINE PCSI$SOURCE DISK1:[KITS] 
    

  4. Check disk space and system parameters GBLPAGES and GBLSECTIONS.
  5. Start the installation with the following command:


    $ PRODUCT INSTALL RTR 
    

1.1.2 Sample OpenVMS Installation


 
$ product install rtr 
 
 
The following product has been selected: 
    DEC AXPVMS RTR V4.0-0                    Layered Product [Installed] 
 
Do you want to continue? [YES] 
 
Configuration phase starting ... 
 
You will be asked to choose options, if any, for each selected product and 
for any products that may be installed to satisfy software dependency 
requirements. 
 
DEC AXPVMS RTR V4.0-0: Reliable Transaction Router for OpenVMS [Installed] 
 
  Copyright 1996 Compaq Computer Corporation 
 
Do you want the defaults for all options? [YES] no 
 
  Have all RTR processes on the system been stopped? [YES] 
  Run installation verification procedure [NO] yes 
 
  DECnet users:Have you read the Release Note regarding minimum version? [YES] 
 
  Do you want the V2 programming kit installed? [NO] yes 
 
Do you want to review the options? [NO] 
 
Execution phase starting ... 
 
The following product will be installed: 
    DEC AXPVMS RTR V4.0-0                Layered Product 
 
Portion done: 0%...10%...20%...30%...40%...50%...80%...90%...100% 
 
The following product has been installed: 
    DEC AXPVMS RTR V4.0-0                Layered Product 
 
DEC AXPVMS RTR V4.0-0: Reliable Transaction Router for OpenVMS 
 
    Insert the following lines in SYS$MANAGER:SYSTARTUP_VMS.COM: 
        @sys$startup:rtr$startup.com 
    Insert the following lines in SYS$MANAGER:SYSHUTDWN.COM: 
        @sys$manager:rtr$shutdown 
 

For additional information, see Chapter 3, Full Installation on OpenVMS .

1.2 Installing RTR for Windows Systems

Your Reliable Transaction Router for Windows NT, Windows 2000, Windows 95, Windows 98, or Windows ME kit is supplied on CD-ROM. After installation the Readme file is located in the directory where you installed RTR; you are advised to read the Readme file before using RTR.

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

1.2.1 Installation Procedure

  1. If RTR is already installed on your system, see Section 2.2.2, Uninstalling on Windows Systems, for information on uninstalling RTR and removing related processes.
  2. If you are installing on Windows NT or Windows 2000, log in as the Administrator, or with administrator privileges.
  3. Insert the RTR CD-ROM into the drive.
  4. From Windows Explorer, choose the drive letter of your CD-ROM and open the directory I386.
  5. Double click on SETUP.EXE to start the InstallShield® that takes you through the setup process.

1.3 Installing RTR for Compaq Tru64 UNIX

Your Reliable Transaction Router for Compaq Tru64 UNIX kit is supplied on CD-ROM. After installation the Release Notes are located in the directory /usr/opt/RTR400/hlp; you are advised to read the Release Notes before using RTR.

The installation requires about 60KB on the partition given in response to the RTRbase directory prompt. The installation procedure takes about two minutes to complete.

1.3.1 Installation Procedure

  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 RTR is already installed on your system, see Section 2.2.3, Uninstalling on Compaq Tru64 UNIX, for information on uninstalling RTR and removing related processes.
  4. Install from the directory (disk or CD-ROM) where the kit is located, for example:


    # setld -l /cdrom/rtr4xx/kit 
    

    Where "xx" is the version number, for example, rtr400 .

  5. Answer "1" and "y" to the questions from setld .
  6. To run the IVP (Installation Verification Procedure) use the following command:

    Note

    Do not run the IVP program on a production system, as it may alter the RTR journal or interrupt processing of transactions. You will be prompted to abort the IVP before it can do any damage. Consider your situation carefully before running the IVP.


    # setld -v RTRBASE4xx 
    

    Where "xx" is the kit number, for example, RTRBASE400 .
    Note that the Installation Verification Procedure requires a working C language compiler to run.

1.3.2 Sample Compaq Tru64 UNIX Installation


 
  # setld -l . 
 
  Copyright 2001  Compaq Computer Corporation. 
 
  Confidential computer software. Valid license from Compaq required for 
  possession, use or copying. Consistent with FAR 12.211 and 12.212, 
  Commercial Computer Software, Computer Software, Computer Software 
  Documentation, and Technical Data for Commercial Items are licensed to 
  the U.S. Government under vendor's standard commercial license. 
 
  Compaq, the Compaq logo, and the Digital logo are registered in the 
  U.S. Patent and Trademark Office. 
 
 
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:67.7 usr:1669.2 
 
Enter your choices or press RETURN to redisplay menus. 
 
Choices (for example, 1 2 4-6): 1 
 
You are installing the following optional subsets: 
 
        RTR API & Management Utility                                           
 
Estimated free diskspace(MB) in root:67.7 usr:1649.2 
 
Is this correct? (y/n): y 
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.0 for Compaq Tru64 UNIX 
 
 
  Installation started at Mon Nov 27 15:33:03 EST 2000. 
 
  Installation proceeds automatically, and should complete in approximately 
  1 minute. 
 
 
RTR API & Management Utility 
   Copying from . (disk) 
   Verifying 
 
1 of 1 subsets installed successfully. 
 
Configuring "RTR API & Management Utility" (RTRBASE400) 
 
  reusing existing /rtr directory 
 
# Copyright 2001 Compaq Computer Corporation. 
# 
# Confidential computer software. Valid license from Compaq required for 
# possession, use or copying. Consistent with FAR 12.211 and 12.212, 
# Commercial Computer Software, Computer Software, Computer Software 
# Documentation, and Technical Data for Commercial Items are licensed to 
# the U.S. Government under vendor's standard commercial license. 
# 
# Compaq, the Compaq logo, and the Digital logo are registered in the 
# U.S. Patent and Trademark Office. 
  Reliable Transaction Router V4.0 for Compaq Tru64 UNIX 
 
  Installation completed at Mon Nov 27 15:33:12 EST 2000. 
 
  You can run the Installation Verification Procedure using this command: 
                   setld -v RTRBASE400 
 
 
  Release Notes are available in: /usr/opt/RTR400/hlp/rtr_relnotes.* 

1.3.3 Sample IVP Output


 
# setld -v RTRBASE400 
RTR API & Management Utility (RTRBASE400) 
 
  Copyright 2001 Compaq Computer Corporation. 
 
  Confidential computer software. Valid license from Compaq required for 
  possession, use or copying. Consistent with FAR 12.211 and 12.212, 
  Commercial Computer Software, Computer Software, Computer Software 
  Documentation, and Technical Data for Commercial Items are licensed to 
  the U.S. Government under vendor's standard commercial license. 
 
  Compaq, the Compaq logo, and the Digital logo are registered in the 
  U.S. Patent and Trademark Office. 
 
 
  Starting     Reliable Transaction Router V4.0  for Compaq Tru64 UNIX 
  Installation Verification Procedure 
WARNING: This is not a first time install. 
WARNING: Please ensure that you have terminated *all* existing 
WARNING: rtr processes and rtr applications before continuing. 
 
Rtr will find and reuse any existing rtr journal files in the 
top level rtrjnl directory on each suitable filesystem, and will 
reuse any existing shared memory segment associated with /rtr/RTRENVPS 
Normally this is intended and should not cause any problems. 
 
WARNING: Any existing journal will be used and modified, otherwise 
WARNING: a new journal will be created on the default filesystem. 
WARNING: Facilities RTR_IVP_FACILITY and RTR will be created. 
WARNING: Result may be affected by size and contents of any existing journal. 
WARNING: The sample client and server do not necessarily complete if they 
WARNING: encounter previously journalled transactions for their facilities. 
 
Would you like to abort the IVP? (y/n) 
n 
IVP continuing ... 
 
 
  keeping any existing log file settings (RTR_DBG not set) 
  starting RTR . . . 
  creating a journal, if not already created  . . . 
  creating test facility . . . 
  stopping RTR. 
 
  [OPTIONAL] attempting to compile and link rtr test applications . . . 
 
  If this system is not configured with an application development 
  environment, or the platform does not support threads, then some 
  messages about application compilation not succeeding are normal. 
 
  multithreaded server rtr application compiled 
  single-threaded client rtr application compiled 
  applications rtrreq and rtrsrv available 
  starting rtr and creating default facility 
%RTR-I-NOLOGSET, logging not set 
%RTR-S-RTRSTART, RTR started on node nodea in group "root" 
%RTR-S-RTRSTOP, RTR stopped on node nodea in group "root" 
 
  Copyright © 2001 Compaq Computer Corporation. 
 
      Reliable Transaction Router V4.0  for Compaq Tru64 UNIX 
 
  Installation Verification Procedure successful 
 
 

1.4 Installing RTR for SunOS

Your Reliable Transaction Router for SunOS kit is supplied on CD-ROM. After installation the Release Notes are located in the directory /opt/rtr/RTR400/hlp; you are advised to read the Release Notes before using RTR.

The installation requires about 2950 KB 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.

1.4.1 Installation Procedure

Note

There are both an rtr and rtr_r (the latter is installed only on SunOS 5.6/Solaris 2.6 systems); a soft link is established to the proper one from /usr/bin/rtr .

Both librtr_r.so and librtr.so are provided for both SunOS 5.5 and 5.6, in case there is a need to link your application with the threaded version, but only on SunOS 5.6 will RTR itself use librtr_r.so , thus enabling asynchronous I/O (aio) support.
  1. Login as user root or su to root .
  2. Use the pkginfo utility to check if you have a version of RTR already installed:


    # pkginfo -l rtr 
    

  3. If RTR is already installed on your system, see Section 2.2.4, Uninstalling on Sun, for information on uninstalling RTR and removing related processes.
  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 . 
    

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

Section 1.4.3 shows an example installation of RTR for the SunOS.


Next Contents