Reliable Transaction Router

Reliable Transaction Router

Installation Guide

Order Number: AA-Q88DE-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.1D, and has been completely revised.

Operating Systems: Windows NT Version 4.0
Windows 95
Windows 98
Compaq Tru64 UNIX Version 4.0D, 4.0E, 4.0F
Sun Solaris Version 2.5, 2.6x
IBM AIX Version 4.2 to 4.3.x
Hewlett-Packard HP-UX Version 10.20
OpenVMS Version 6.2, 7.1, 7.2

Software Version: Reliable Transaction Router Version 3.2

Compaq Computer Corporation
Houston, Texas


June, 1999

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.

Copyright ©1999 Digital Equipment 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.

The following are trademarks of Compaq Computer Corporation: AlphaGeneration, AlphaServer, AlphaStation, Compaq Internet Personal Tunnel, DEC, DECconnect, DECdtm, DECnet, DIGITAL, OpenVMS, PATHWORKS, POLYCENTER, Reliable Transaction Router, TruCluster, Tru64 UNIX, VAX, and VMScluster.

The following are third-party trademarks:

AIX and IBM are registered trademarks of International Business Machines Corporation.
Encina is a registered trademark of Transarc Corporation.
Hewlett-Packard and HP-UX are registered trademarks of Hewlett-Packard Company.
InstallShield is a registered trademark of InstallShield Software Corporation.
Intel is a trademark of Intel Corporation.
Microsoft, Microsoft Access, Microsoft SQL Server, Internet Explorer, :MS--DOS, Visual Basic, Visual C++, Windows, Windows 95, Windows 98, and Windows NT are trademarks or registered trademarks of Microsoft Corporation.
Netscape, Netscape Communicator, and Netscape Navigator are registered trademarks of Netscape Communications Corporation.
Oracle, ORACLE7, PL/SQL, SQL*Net, AND SQL*Plus are trademarks or registered trademarks of Oracle Corporation.
Solaris, SPARCstation, SUN, SunOS, and Sunlink are trademarks or registered trademarks of Sun Microsystems, Inc.
UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company, Ltd.

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.


Chapter 1
Quick Installation

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

1.1 Installing RTR for OpenVMS

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. Log on to the System Manager's account.
  2. Define the logical name for the location of the software kit, for example:


    $ DEFINE PCSI$SOURCE DISK1:[KITS] 
    

  3. Register your software license.
  4. Check disk space and system parameters GBLPAGES and GBLSECTIONS.
  5. Determine if you need to install ODBC Over RTR Oracle7 Server.
  6. Stop all RTR processes on the system:


    $ RTR STOP RTR 
    $ RTR DISCONNECT SERVER 
    

  7. Start the installation with the following command:


    $ PRODUCT INSTALL RTR 
    

1.1.2 Sample OpenVMS Installation


 
$ product install rtr/help 
 
   1 - DEC VAXVMS RTR V3.2-xxx             Layered Product 
   2 - Exit 
 
Choose one or more items from the menu separated by commas: 1 
 
The following product has been selected: 
    DEC VAXVMS RTR V3.2-xxx                Layered Product 
 
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 VAXVMS RTR V3.2-xxx: Reliable Transaction Router for OpenVMS 
 
    Software fault tolerant middleware for high performance distributed 
    transaction processing. Also available for, and interoperable with 
    the following platforms: 
 
        o  Compaq Tru64 UNIX 
        o  Windows NT 
        o  Solaris 
        o  AIX 
        o  with others in preparation 
 
    Copyright Digital Equipment Corporation. 1994, 1999. All rights reserved. 
 
 
       1994, 1999 Digital Equipment Corporation. 
      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 Compaq Computer Corporation and Digital Equipment Corporation. 
      Possession, use, or copying of this software and media is authorized 
      only pursuant to a valid written license from Compaq or an 
      authorized sublicensor. 
 
      Compaq, the Compaq logo, and the Digital logo are registered in the 
      U.S. Patent and Trademark Office. 
 
 
    This product uses the PAKs RTR-CL and RTR-SVR. 
 
     This software is furnished under the licensing provisions of Compaq 
     Computer Corporation's Standard Terms and Conditions.  For more in- 
     formation about Compaq's licensing terms and policies, contact your 
     local Compaq office. 
 
    This product requires one of the following PAKS: 
 
        RTR-CL  - enables front end functionality 
        RTR-SVR - additionally enables RTR router and back end roles. 
 
 
Do you want the defaults for all options? [YES] no 
 
    Please delete all RTRACP*, RTRCSV* and RTRD processes, 
    as well as any user processes showing the "RTR>" prompt. 
 
 
    Have all RTR processes on the system been stopped? [YES] 
 
    This option installs the Oracle7 server for use with ODBC Over RTR. 
    If this server is installed, client software that uses the OOR 
    (ODBC Over RTR) ODBC driver can access an Oracle7 database using RTR 
    as the transport. 
 
    Installing this option requires that Oracle7 is installed on the system. 
 
 
    ODBC Over RTR Oracle7 Server [NO] 
 
    Before running the IVP on a production system, first shut down all 
    RTR applications and stop RTR on all nodes booting from this system disk. 
 
 
    Run installation verification procedure [NO] yes 
 
    Please see your Compaq Representative about obtaining the ECO 5 
    patch to DECNet/OSI V6.3.  Failure to do so may result in run-time 
    problems with erroneous link shutdowns.  If you plan to use only 
    TCP as a transport or are installing RTR in a test environment, 
    you can safely proceed with the intallation. 
 
    DECnet Phase IV users can also ignore this warning. 
 
 
    DECnet users:Have you read the Release Note regarding minimum version? [YES] 
 
 
Do you want to review the options? [NO] 
 
Execution phase starting ... 
 
The following product will be installed to destination: 
    DEC VAXVMS RTR V3.2-xxx                DISK$OVMSVAXSYS:[VMS$COMMON.] 
 
Portion done: 0%...10%...20%...30%...50%...60%...70%...80%...90%...100% 
 
The following product has been installed: 
    DEC VAXVMS RTR V3.2-xxx                Layered Product 
 
%PCSI-I-IVPEXECUTE, executing test procedure for DEC VAXVMS RTR V3.2-xxx ... 
%PCSI-I-PRCOUTPUT, output from subprocess follows ... 
%PCSI-I-IVPSUCCESS, test procedure completed successfully 
 
DEC VAXVMS RTR V3.2-xxx: 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 
 
 
 

1.1.3 Sample IVP Output


%PCSI-I-IVPEXECUTE, executing test procedure for DEC VAXVMS RTR V3.2-xxx ... 
%PCSI-I-PRCOUTPUT, output from subprocess follows ... 
%PCSI-I-IVPSUCCESS, test procedure completed successfully 
 
DEC VAXVMS RTR V3.2-xxx: 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.

1.2 Installing RTR for Windows NT, Windows 95, and Windows 98

Your Reliable Transaction Router for Windows NT, Windows 95, or Windows 98 kit is supplied on :CD-ROM. The Release Notes are also on the :CD-ROM; you are advised to read the Release Notes 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 you are installing on Windows NT, log in as the Administrator, or with administrator privileges.
  2. If you have a version of RTR already installed, you must:
  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 ALPHA or I386, depending on your processor type.
  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. The Release Notes are also on the :CD-ROM; 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 you have any previous version, make sure that it is not running:


    # rtr stop rtr 
    # rtr disconnect server 
    

  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:

    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 RTRBASE3xx 
    

    Where "xx" is the version number.
    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 1994, 1999 Digital Equipment Corporation. 
 
  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 Compaq Computer Corporation and Digital Equipment Corporation. 
  Possession, use, or copying of this software and media is authorized 
  only pursuant to a valid written license from Compaq or an 
  authorized sublicensor. 
 
  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 
 
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                                            
 
Is this correct? (y/n): y 
 
Checking file system space required to install selected subsets: 
 
File system space checked OK. 
 
1 subset(s) will be installed. 
 
Loading 1 of 1 subset(s).... 
 
  Reliable Transaction Router V3.2 for Compaq Tru64 UNIX 
 
 
  Installation started at Tue Jun  1 15:51:23 EDT 1999. 
 
  Installation proceeds automatically, and should complete in approximately 
  1 minute. 
 
 
RTR API & Management Utility 
   Copying from . (disk) 
   Verifying 
 
1 of 1 subset(s) installed successfully. 
 
 
Configuring "RTR API & Management Utility" (RTRBASE320) 
 
  reusing existing /rtr directory 
 
# Copyright 1994, 1999  Digital Equipment Corporation. 
# 
# 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 Compaq Computer Corporation and Digital Equipment Corporation. 
# Possession, use, or copying of this software and media is authorized 
# only pursuant to a valid written license from Compaq or an 
# authorized sublicensor. 
# 
# Compaq, the Compaq logo, and the Digital logo are registered in the 
# U.S. Patent and Trademark Office. 
 
  Reliable Transaction Router V3.2 for Compaq Tru64 UNIX 
 
  Installation completed at Tue Jun  1 15:51:37 EDT 1999. 
 
  You can run the Installation Verification Procedure using this command: 
                   setld -v RTRBASE320 
 
 
 
 

1.3.3 Sample IVP Output


 
# setld -v RTRBASE320 
 
RTR API & Management Utility (RTRBASE320) 
 
  Copyright 1994, 1999 Digital Equipment Corporation. 
 
  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 Compaq Computer Corporation and Digital Equipment Corporation. 
  Possession, use, or copying of this software and media is authorized 
  only pursuant to a valid written license from Compaq or an 
  authorized sublicensor. 
 
  Compaq, the Compaq logo, and the Digital logo are registered in the 
  U.S. Patent and Trademark Office. 
 
 
  Starting     Reliable Transaction Router V3.2 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-S-RTRSTART, RTR started on node sarand.zko.dec.com 
%RTR-S-FACCREATED, facility RTR$DEFAULT_FACILITY created 
  starting an rtr server application 
  running an rtr client application, should complete in a few seconds 
  stopping rtr 
%RTR-S-RTRSTOP, RTR stopped on node sarand.zko.dec.com 
 
 Copyright 1994, 1999 Digital Equipment Corporation. 
 All rights reserved. 
 
      Reliable Transaction Router V3.2 for Compaq Tru64 UNIX 
 
  Installation Verification Procedure successful 
 
 
 


Next Contents