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
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.
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 |
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.
This guide contains the following chapters and appendixes:
In addition to this guide, the RTR documentation set includes the following:
Table 1 describes the 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. |
This chapter gives brief instructions for installing Reliable Transaction Router on the following platforms:
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
$ DEFINE PCSI$SOURCE DISK1:[KITS] |
$ RTR STOP RTR $ RTR DISCONNECT SERVER |
$ PRODUCT INSTALL RTR |
$ 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
|
%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
RTR STOP RTR RTR DISCONNECT SERVER/DAEMON |
DELETE /S/Q C:\RTR |
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
# setld -i | grep RTR |
# rtr stop rtr # rtr disconnect server |
# setld -d RTRBASE3xx |
# setld -l /cdrom/rtr3xx/kit |
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 |
# 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
|
# 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 |