| Previous | Contents |
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 Accessing Release Notes
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.1.2 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,7.3 | System Software |
| or | |
| OpenVMS Alpha Version 6.2,7.1,7.2,7.3 | System Software |
| Optional Products | Purpose |
| Compaq TCP/IP Services for OpenVMS (Version 4.2 or higher) | Network Transport |
| DECnet (Version 6.2 or higher) 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.
There is no longer a requirement that you must register a software
license.
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 may mean that you have to increase some system parameter values. Table 3-3 lists the minimum free amount of global pages and global sections required for the installation.
| System Parameter | Required Amount |
|---|---|
| GBLPAGES | 4000 |
| GBLSECTIONS | 4 |
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.
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] |
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 |
A display similar to the following appears:
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%...10%
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
|
After completing the installation, you can:
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.3.2 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.3.2.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 |
To use the features of Reliable Transaction Router, each account must have the following privileges:
In addition, the Rights Identifier RTR$INFO is required.
The RTR System Manager (that is, the account that starts up RTR and
creates facilities) must also have either OPER privilege or
have the Rights Identifier RTR$OPERATOR.
3.4 Files Installed on OpenVMS
To see the files installed on your system by the installation process, use the following command:
$ PRODUCT LIST RTR/SOURCE=[pcsi kit location] |
This chapter describes a full installation on Windows NT to run RTR as a server. For information on Windows 2000 or on installing RTR for client applications on Windows 95, Windows 98, or Windows ME, see Section 1.2.
The installation of the RTR base product requires about five megabytes
of disk space. The installation procedure takes about two minutes to
complete.
4.1 Preparing for Installation
Before you start the installation, review the hardware and software
requirements described in the following sections.
4.1.1 Accessing the Readme file
The Readme file provides information for 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 file before you use RTR.
4.1.2 Hardware Requirements
C:\Program Files\Compaq\Rtr |
RTR as a Service runs only on Windows NT or Windows 2000; the InstallShield does not register the service but RTR provides batch procedures to do so in the target directory. |
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.)
The Windows registry will be modified slightly as a result of a RTR installation. |
Navigate to the directory where you installed RTR.
To see a list of the files installed, enter the following command:
Tree/F |
This chapter provides descriptions of all steps in doing a full installation including:
Before you start the installation, complete the preparation tasks
outlined in this section.
5.1.1 Checking the Software Distribution Kit
RTR software is distributed on CD-ROM. Use the Bill of
Materials (BOM) to check the contents of your RTR software
distribution kit.
5.1.2 Reading 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/RTR400/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 |
RTR includes support for the License Management Facility (LMF). You must register your License Product Authorization Key (License PAK) in the License Database (LDB) in order to use RTR on a newly licensed node. The License PAK may be shipped along with the kit if you ordered the license and media together; otherwise, it is shipped separately to a location based on your license order.
If you are installing RTR as an update on a node already licensed for this software, you have already completed the License PAK registration requirements.
If you are installing prerequisite or optional software along with RTR, review the PAK status and install the PAKs for any prerequisite or optional software before you install RTR.
To register a license under the Compaq Tru64 UNIX operating system, first log in as superuser.
At the superuser prompt, edit an empty PAK template with the lmf register command as follows, and include all the information on your License PAK:
# lmf register |
After you register your license, use the following lmf reset command to copy the license details from the License Database (LDB) to the kernel cache:
# lmf reset |
For complete information on using the License Management Facility, see
the Guide to Software License Management and the lmf(8) reference page.
5.1.4 Checking Installation Requirements
This section discusses requirements for installing RTR.
Installing RTR, including running the Installation
Verification Procedure (IVP), takes approximately 10 to 15 minutes,
depending on your type of media and system configuration.
5.1.4.1 Checking Login Privileges
You must have superuser privileges to install the RTR
software.
5.1.4.2 Checking Hardware Requirements
To install RTR, you need the following hardware:
See the RTR Software Product Description (SPD) for additional
hardware requirements.
5.1.4.3 Checking Software Requirements
RTR requires that the following Compaq Tru64 UNIX software subset be loaded on the system where you install RTR:
One of the following is required:
The following Compaq Tru64 UNIX software subsets are optional on the system where you install RTR:
To check whether these subsets are loaded, follow these steps:
# setld -i | egrep 'OSFBASE|DNA' |
If your path is not set as /usr/sbin/ , you must enter the full path of the command. For example:
% /usr/sbin/setld -i | egrep 'OSFBASE|DNA' |
Check the displayed rows for the name of the relevant subset and any
related patches. The word "installed" appears after the
subset identifier when a subset is loaded. If the word
"installed" does not appear (the second column in a row is
blank), the subset or patch is not loaded. In this case, you must load
the missing Compaq Tru64 UNIX software before installing RTR.
(For information on how to load the operating system software, see the
Guide to Installing Compaq Tru64 UNIX.)
5.1.4.4 Determining Which Subsets to Load
RTR has only one subset:
Table 5-1 lists the disk space requirements for loading the RTR software subset. These requirements apply to the disks where you load the RTR subset. The requirements are listed by directory for convenience if you are doing installations on systems where these directories are mount points for different disk partitions.
| Subset Title | Subset Name | /usr/opt/ | /rtr |
|---|---|---|---|
| RTR | rtrbase400 | 57020 | 1050 |
| Total: | 58070 |
Using these disk space requirements, calculate the total values for the subsets you will load in each directory. You will also require disk space for the RTR journal, which defaults to /rtrjnl .
Compare the space required for the subset with the free space currently
on the disks where RTR files will reside.
5.1.4.5.1 Checking Current Disk Space
To check the current amount of free space for a directory path, log in to the system where you will install RTR. You can check which directories are mounted and where they are by viewing the /etc/fstab file. For example:
# more /etc/fstab /dev/rd0a:/:rw:1:1:ufs:: /dev/rd0g:/usr:rw:1:2:ufs:: /usr/staff/r1/leslie@bigsys:/usr/staff/r1/leslie:rw:0:0:nfs:bg: /usr/man@bigsys:/usr/man:ro:0:0:nfs:bg: |
The display indicates that /usr (mounted to /dev/rd0g ) is the only mount point that affects where RTR files will reside; the system has only one local disk drive, and the /usr/lib and file system resides in the g partition of the disk on that drive.
To check the total space and the free space for the directories where RTR will reside, enter the df command. Given the previous display of the /etc/fstab file, which shows that only /usr is a mount point, you need to check free space only in the /usr file system. For example:
# df /usr Filesystem Total kbytes kbytes % node kbytes used free used Mounted on /dev/rd0g 122598 54447 55892 49% /usr |
This display shows that there are 55,892 Kbytes free. This free space must accommodate the subset requirements listed in Table 5-1, RTR Subset Size (Kilobytes Required).
On systems where /usr/lib and /usr/man are mounted to different devices from /usr , enter the following command:
# df /usr/lib /usr/man |
In this case, you compare space required for RTR files in /usr/lib to the free space displayed in the first line of the df output list, and compare the space required for RTR files in /usr/man to the free space displayed in the second line of that list.
| Previous | Next | Contents |