| Previous | Contents |
Your Reliable Transaction Router for HP-UX 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 3000KB
free disk space. The installation procedure takes about two minutes to
complete.
1.6.1 Installation Procedure
# rtr stop rtr # rtr disconnect server |
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. |
To run the IVP, execute the following command:
<source depot>/RTR320/rtr/examples/rtr/rtr_ivp_osf.sh |
or, if source depot is /opt/rtr:
/opt/rtr/RTR320/rtr/examples/rtr/rtr_ivp_osf.sh |
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 HP-UX
Installation Verification Procedure
IVP: This is not a clean start:
IVP: Result may be affected by previous settings in shared memory.
IVP: Result may be affected by existing processes.
IVP: Result may be affected by locks held by existing processes.
IVP: Existing pipe files IVP: This is not a clean start:
IVP: Any existing journal will be used and modified.
IVP: Facilities RTR_IVP_FACILITY and RTR will be created.
IVP: Result may be affected by size and contents of any existing journal.
IVP: The sample client and server do not necessarily complete
IVP: if they encounter previously journalled transactions.
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 hpnode
%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 hpnode
Copyright 1994, 1999 Digital Equipment Corporation.
All rights reserved.
Reliable Transaction Router V3.2 for Compaq Tru64 UNIX
Installation Verification Procedure successful
|
To upgrade RTR, use the following process:
To uninstall RTR, enter a command of the following form:
remove-command RTR320
Remove commands do not eradicate all RTR files from your disks. This is particularly important when you are upgrading from one version of RTR to another. You must eliminate all RTR files from your system, but must not discard any customized monitor files in /rtr or a journal containing recoverable transactions in /rtrjnl. Copy these to another directory before completing the uninstall instructions. |
To remove RTR, use the following command:
PRODUCT REMOVE RTR |
You must unregister RTR as a service before uninstalling RTR on these systems. Do this with the following menu picks from the Program menu:
Compaq -> RTR -> Useful Batch Files -> Unregister Service
You also need to delete all *.LCK files, and the file called RTRenvps (shared memory).
To uninstall RTR, issue the following command at the :MS--DOS prompt:
RTR STOP RTR RTR DISCONNECT SERVER/DAEMON DELETE /S/Q C:\Program Files\Compaq\Reliable Transaction Router |
You can also use the Shutdown command, which executes Shutdown.bat.
You can access the shutdown procedure with the following menu picks:
Compaq -> RTR -> Useful Batch Files -> Shutdown
2.1.3 Uninstalling on Compaq Tru64 UNIX
Use the following command:
setld -d RTR320
Also remove all RTR files with the following commands:
The last directory is user configurable, so verify its location before executing the last command. |
rm -rf /rtr rm -rf /rtrjnl rm -rf /usr/opt/rtr |
Use the following command:
pkgrm RTR320
Remove all RTR files with the following commands:
The last directory is user configurable, so verify its location before executing the last command. |
rm -rf /rtr rm -rf /rtrjnl rm -rf /opt/rtr |
Use the following command:
smit install_remove
Also remove all RTR files with the following commands:
The last directory is user configurable, so verify its location before executing the last command. |
rm -rf /rtr rm -rf /rtrjnl rm -rf /usr/lpp/RTR320 |
Use the following command:
swremove RTR320
You can also use the swremove graphical utility to accomplish the same thing.
See the man pages and documentation provided by HP for details regarding swremove and swinstall.
To completely eradicate RTR from your system, enter the following additional commands (the last directory is user configurable, so verify its location before executing this last command):
rm -rf /rtr
rm -rf /rtrjnl
rm -rf /opt/rtr
|
This chapter describes how to install Reliable Transaction Router on OpenVMS for both OpenVMS VAX and OpenVMS Alpha systems.
A step-by-step description of the installation procedure is given.
3.1 Preparing for Installation
Before you start the installation, complete the preparation tasks
outlined in this section.
3.1.1 Prerequisite and Optional Software
Table 3-1 provides information on the software that must be installed on your system before installing Reliable Transaction Router. The table also includes information about optional software that you can use with Reliable Transaction Router. The Software Product Description (SPD) contains a complete list of prerequisite and optional software and their required version numbers.
| Prerequisite Products | Purpose |
|---|---|
| OpenVMS VAX Version 6.2,7.1,7.2 | System Software |
| or | |
| OpenVMS Alpha Version 6.2,7.1,7.2 | System Software |
| Optional Products | Purpose |
| Compaq TCP/IP Services for OpenVMS (Version 4.0 or higher) | Network Transport |
| DECnet or DECnet-Plus (Version 6.3 ECO5 or higher) | Network Transport |
The Installation Verification Procedure (IVP) will complete
successfully only if at least one of the supported network protocols
(DECnet or TCP/IP) is installed.
3.1.2 Registering your Software License
You must register and load your license for Reliable Transaction Router before you start the installation in order to run the Installation Verification Procedure (IVP) and use the software.
To register a license under OpenVMS, first log in to the system manager's account, SYSTEM. You then have a choice of two ways to perform the registration:
If you plan to use Reliable Transaction Router on more than one node in a VMScluster, you will need to perform a license load on the other nodes after you complete this installation (or reboot the cluster).
For complete information on using LMF, see the OpenVMS License
Management Utility Manual.
3.1.3 Required Disk Space
Reliable Transaction Router's requirements for free disk storage space are different during installation and after installation. Table 3-2 summarizes the storage requirements.
| Kit | Blocks During Installation | Blocks After Installation |
|---|---|---|
| Reliable Transaction Router for OpenVMS VAX | 50000 | 36000 |
| Reliable Transaction Router for OpenVMS Alpha | 50000 | 36000 |
To determine the number of free disk blocks on the current system disk, enter the following command at the DCL prompt:
$ SHOW DEVICE SYS$SYSDEVICE |
Installing Reliable Transaction Router for OpenVMS requires certain system parameter settings. Table 3-3 lists the minimum required system parameter values for the installation. Depending on the kinds of programs and applications running at your site, you may need higher values for some settings.
| System Parameter | Minimum Value |
|---|---|
| GBLPAGES | 4000 |
| GBLSECTIONS | 4 |
Log on to the System Manager's account to do the installation.
The Reliable Transaction Router installation procedure uses the POLYCENTER Software Installation Utility (PCSI). For details on using PCSI, refer to the OpenVMS System Manager's Manual, Section "Installing with the POLYCENTER Software Installation Utility."
The logical name PCSI$SOURCE is used to define the location of the software kits you want to install. For example, if the Reliable Transaction Router software is located in DISK1:[KITS], enter the following at the DCL prompt (or include the line in the system manager's login command file):
$ DEFINE PCSI$SOURCE DISK1:[KITS] |
When running the installation procedure for Reliable Transaction Router, you can choose whether to install the ODBC Over RTR Oracle7 Server. This is an RTR server used for supporting ODBC-enabled client applications on Windows.
Do not install the ODBC Over RTR Oracle7 Server unless you already have Oracle7 installed. |
Before starting the installation, stop all RTR processes on the system. To do this, issue the following commands:
$ RTR STOP RTR $ RTR DISCONNECT SERVER |
For information on installing ODBC over RTR, see Appendix B. |
The installation prompts you with questions. Enter your response to each question and press the [Return] key. Defaults are shown in square brackets, for example, [YES].
To start the installation, enter the command:
$ PRODUCT INSTALL RTR/HELP |
A display similar to the following appears:
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-239: 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
|
After completing the installation, you can:
To access the Reliable Transaction Router Release Notes, type the command:
$ PRODUCT EXTRACT RELEASE_NOTES RTR /file=rtr_relnotes.txt |
You should read the Release Notes before using Reliable Transaction Router.
3.4.2 Editing System Files
You must edit the system startup and shutdown files to provide for automatic startup and the installation of Reliable Transaction Router images when your system is rebooted.
Add the command line that starts Reliable Transaction Router to the system startup file, SYS$MANAGER:SYSTARTUP_VMS.COM. Reliable Transaction Router cannot start until after the network has started. You must position this new command line after the lines that invoke the network startup command procedures.
Add the command line that stops Reliable Transaction Router to the system shutdown
file, SYS$MANAGER:SYSHUTDWN.COM.
3.4.3 User Account Requirements
To work with Reliable Transaction Router, user accounts on your system must have
certain quotas and privileges. The next two sections contain
information on these requirements.
3.4.3.1 Quotas
Table 3-4 summarizes the required user account quotas.
| Account Quota | Value |
|---|---|
| ASTLM | At least 2000 |
| BIOLM | At least 2000 |
| BYTLM | At least 150000 1 |
| DIOLM | At least 2000 |
| TQELM | At least 2000 |
| Previous | Next | Contents |