Previous | Contents |
Your Reliable Transaction Router for SunOS 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 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
# pkginfo -l rtr # rtr stop rtr # rtr disconnect server |
# pkgrm rtr |
# cd /cdrom/rtr_kit # pkgadd -d . |
Section 1.4.3 shows an example installation of RTR for the
SunOS.
1.4.2 Running the IVP
The Installation Verification Procedure (IVP) requires a working C language compiler to run.
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. |
You may run the IVP separately from the installation procedure. If you are not using the C shell, start it by typing /usr/bin/csh and run the IVP by typing the following:-
# setenv BASEDIR /opt |
and then executing the file pkg/rtr/reloc/rtr/RTRxxx/examples/rtr/rtr_ivp_osf.sh.
Your Reliable Transaction Router for AIX 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.4.3 Sample SunOS Installation
sunbox# pkgadd -d .
The following packages are available:
1 rtr Reliable Transaction Router
(sun4u) 320
Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,q]: 1
Processing package instance <rtr> from </kit238sun_ins/pkg>
Reliable Transaction Router
(sun4u) 320
COMPAQ
Enter path to package base directory [?,q] /opt
Using </opt> as the package base directory.
## Processing package information.
## Processing system information.
1 package pathname is already properly installed.
## Verifying disk space requirements.
## Checking for conflicts with packages already installed.
## Checking for setuid/setgid programs.
This package contains scripts which will be executed with super-user
permission during the process of installing this package.
Do you want to continue with the installation of <rtr> [y,n,?]
Do you want to continue with the installation of <rtr> [y,n,?] y
Installing Reliable Transaction Router as <rtr>
## Installing part 1 of 1.
/opt/rtr/RTR320/bin/rtr
/opt/rtr/RTR320/bin/rtr_r
/opt/rtr/RTR320/bin/rtr_remote
/opt/rtr/RTR320/bin/rtr_rqif
/opt/rtr/RTR320/bin/rtr_snapshot.sh
/opt/rtr/RTR320/examples/rtr/crtr.cxx
/opt/rtr/RTR320/examples/rtr/crtr.hxx
/opt/rtr/RTR320/examples/rtr/cslb.hxx
/opt/rtr/RTR320/examples/rtr/example_cli.cxx
/opt/rtr/RTR320/examples/rtr/example_cslb.hxx
/opt/rtr/RTR320/examples/rtr/example_srv.cxx
/opt/rtr/RTR320/examples/rtr/rtr_ivp_osf.sh
/opt/rtr/RTR320/examples/rtr/rtrreq.c
/opt/rtr/RTR320/examples/rtr/rtrsrv.c
/opt/rtr/RTR320/hlp/copyright.txt
/opt/rtr/RTR320/hlp/license.txt
/opt/rtr/RTR320/hlp/rtr.hlb
/opt/rtr/RTR320/hlp/rtr.hlp
/opt/rtr/RTR320/lib/rtr.h
/opt/rtr/RTR320/mon/accfail.mon
/opt/rtr/RTR320/mon/acp2app.mon
/opt/rtr/RTR320/mon/active.mon
/opt/rtr/RTR320/mon/app2acp.mon
/opt/rtr/RTR320/mon/broadcast.mon
/opt/rtr/RTR320/mon/calls.mon
/opt/rtr/RTR320/mon/channel.mon
/opt/rtr/RTR320/mon/connects.mon
/opt/rtr/RTR320/mon/ddtm.mon
/opt/rtr/RTR320/mon/dtx.mon
/opt/rtr/RTR320/mon/dtxrec.mon
/opt/rtr/RTR320/mon/event.mon
/opt/rtr/RTR320/mon/facility.mon
/opt/rtr/RTR320/mon/flow.mon
/opt/rtr/RTR320/mon/frontend.mon
/opt/rtr/RTR320/mon/group.mon
/opt/rtr/RTR320/mon/ipc.mon
/opt/rtr/RTR320/mon/ipcrate.mon
/opt/rtr/RTR320/mon/jcalls.mon
/opt/rtr/RTR320/mon/journal.mon
/opt/rtr/RTR320/mon/link.mon
/opt/rtr/RTR320/mon/netbytes.mon
/opt/rtr/RTR320/mon/netstat.mon
/opt/rtr/RTR320/mon/partit.mon
/opt/rtr/RTR320/mon/queues.mon
/opt/rtr/RTR320/mon/quorum.mon
/opt/rtr/RTR320/mon/rdm.mon
/opt/rtr/RTR320/mon/recovery.mon
/opt/rtr/RTR320/mon/rejects.mon
/opt/rtr/RTR320/mon/rejhist.mon
/opt/rtr/RTR320/mon/response.mon
/opt/rtr/RTR320/mon/rfb.mon
/opt/rtr/RTR320/mon/rolequor.mon
/opt/rtr/RTR320/mon/routers.mon
/opt/rtr/RTR320/mon/routing.mon
/opt/rtr/RTR320/mon/rscbe.mon
/opt/rtr/RTR320/mon/rtr.mon
/opt/rtr/RTR320/mon/stalls.mon
/opt/rtr/RTR320/mon/system.mon
/opt/rtr/RTR320/mon/tps.mon
/opt/rtr/RTR320/mon/tpslo.mon
/opt/rtr/RTR320/mon/traffic.mon
/opt/rtr/RTR320/mon/trans.mon
/opt/rtr/RTR320/mon/v2calls.mon
/opt/rtr/RTR320/mon/xa.mon
/opt/rtr/RTR320/shlib/librtr.so
/opt/rtr/RTR320/shlib/librtr_r.so
[ verifying class <none> ]
## Executing postinstall script.
# 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.
This kit will only run on Sun Solaris 2.5 and higher.
Installation should complete in approximately 1 minute.
1.4.4 Sample IVP Output
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 SunOS
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 will normally be recycled correctly.
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.
IVP: The following question is ignored in a non-interactive install
IVP: unless NONABI_SCRIPTS=TRUE, see man pkgadd for details...
IVP: Would you like to abort the IVP? (y/n)
n
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 sunbox
%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 sunbox
© 1999 Compaq Computer Corporation and Digital Equipment Corporation.
All rights reserved.
Reliable Transaction Router V3.2 for SunOS
Installation Verification Procedure successful
1.5 Installing RTR for AIX
Running RTR on AIX requires that asynchronous I/O (aio) is available. If aio is not available, the following messages appear:
To check for aio, issue the following command:
To configure aio, use one of the following methods:
or
|
# rtr stop rtr # rtr disconnect server |
+-----------------------------------------------------------------------------+ Pre-installation Verification... +-----------------------------------------------------------------------------+ Verifying selections...done Verifying requisites...done Results... SUCCESSES --------- Filesets listed in this section passed pre-installation verification and will be installed. -- Filesets are listed in the order in which they will be installed. -- The reason for installing each fileset is indicated with a keyword in parentheses and explained by a "Success Key" following this list. RTR320.rte x.xx.xxx.x (Selected) Reliable Transaction Router Success Key: Selected -- Explicitly selected by user for installation. Maintenance -- Maintenance Level fileset update; being installed automatically to enable the level of the system to be tracked. Mandatory -- Considered to be important to the system; will always be installed when detected on the installation media. Requisite -- Requisite of other filesets being installed. P_Requisite -- Previously installed fileset's requisite; being installed automatically now to ensure system's consistency. (Only installed automatically when "auto-install" (-g flag) is specified.) Supersedes -- Superseding fileset update; not selected, chosen instead of an older, selected update. (Only chosen in this fashion when "auto-install" is specified (-g flag)). << End of Success Section >> FILESET STATISTICS ------------------ 1 Selected to be installed, of which: 1 Passed pre-installation verification ---- 1 Total to be installed +-----------------------------------------------------------------------------+ Installing Software... +-----------------------------------------------------------------------------+ installp: APPLYING software for: RTR320.rte x.xx.xxx.x . . . . . << Copyright notice for RTR320 >> . . . . . . . # 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. . . . . . << End of copyright notice for RTR320 >>. . . . New volume on /usr/users/zhang/kit238install/output/usr/sys/inst.images/RTR320: Cluster size is 51200 bytes (100 blocks). The volume number is 1. The backup date is: Fri May 28 14:31:21 EDT 1999 Files are backed up by name. The user is scrtest. The number of restored files is 73. x 0 ./usr/lpp/RTR320 x 0 ./usr/lpp/RTR320/bin x 2450 ./usr/lpp/RTR320/bin/rtr x 10083 ./usr/lpp/RTR320/bin/rtr_rqif x 4027 ./usr/lpp/RTR320/bin/rtr_snapshot.sh x 0 ./usr/lpp/RTR320/shlib x 8048187 ./usr/lpp/RTR320/shlib/librtr_r.a x 0 ./usr/lpp/RTR320/lib x 0 ./usr/lpp/RTR320/lib/doclib x 577269 ./usr/lpp/RTR320/lib/rtr.h x 0 ./usr/lpp/RTR320/examples x 0 ./usr/lpp/RTR320/examples/rtr x 11736 ./usr/lpp/RTR320/examples/rtr/rtrreq.c x 8317 ./usr/lpp/RTR320/examples/rtr/rtrsrv.c x 11464 ./usr/lpp/RTR320/examples/rtr/crtr.cxx x 6139 ./usr/lpp/RTR320/examples/rtr/crtr.hxx x 378 ./usr/lpp/RTR320/examples/rtr/cslb.hxx x 501 ./usr/lpp/RTR320/examples/rtr/example_cslb.hxx x 897 ./usr/lpp/RTR320/examples/rtr/example_srv.cxx x 933 ./usr/lpp/RTR320/examples/rtr/example_cli.cxx x 13319 ./usr/lpp/RTR320/examples/rtr/rtr_ivp_osf.sh x 0 ./usr/lpp/RTR320/mon x 3477 ./usr/lpp/RTR320/mon/accfail.mon x 7657 ./usr/lpp/RTR320/mon/acp2app.mon x 1080 ./usr/lpp/RTR320/mon/active.mon x 3926 ./usr/lpp/RTR320/mon/app2acp.mon x 2295 ./usr/lpp/RTR320/mon/broadcast.mon x 10621 ./usr/lpp/RTR320/mon/calls.mon x 955 ./usr/lpp/RTR320/mon/channel.mon x 2633 ./usr/lpp/RTR320/mon/connects.mon x 6629 ./usr/lpp/RTR320/mon/ddtm.mon x 4953 ./usr/lpp/RTR320/mon/dtx.mon x 4681 ./usr/lpp/RTR320/mon/dtxrec.mon x 1847 ./usr/lpp/RTR320/mon/event.mon x 5596 ./usr/lpp/RTR320/mon/facility.mon x 4081 ./usr/lpp/RTR320/mon/flow.mon x 1432 ./usr/lpp/RTR320/mon/frontend.mon x 2546 ./usr/lpp/RTR320/mon/group.mon x 3150 ./usr/lpp/RTR320/mon/ipc.mon x 3398 ./usr/lpp/RTR320/mon/ipcrate.mon x 6375 ./usr/lpp/RTR320/mon/jcalls.mon x 4899 ./usr/lpp/RTR320/mon/journal.mon x 3873 ./usr/lpp/RTR320/mon/link.mon x 2561 ./usr/lpp/RTR320/mon/netbytes.mon x 3960 ./usr/lpp/RTR320/mon/netstat.mon x 15563 ./usr/lpp/RTR320/mon/rdm.mon x 1181 ./usr/lpp/RTR320/mon/partit.mon x 1289 ./usr/lpp/RTR320/mon/queues.mon x 1276 ./usr/lpp/RTR320/mon/quorum.mon x 1502 ./usr/lpp/RTR320/mon/recovery.mon x 1372 ./usr/lpp/RTR320/mon/rejects.mon x 9108 ./usr/lpp/RTR320/mon/rejhist.mon x 1284 ./usr/lpp/RTR320/mon/response.mon x 3265 ./usr/lpp/RTR320/mon/rfb.mon x 2444 ./usr/lpp/RTR320/mon/rolequor.mon x 1796 ./usr/lpp/RTR320/mon/routers.mon x 1390 ./usr/lpp/RTR320/mon/routing.mon x 48092 ./usr/lpp/RTR320/mon/rscbe.mon x 2444 ./usr/lpp/RTR320/mon/rtr.mon x 2859 ./usr/lpp/RTR320/mon/stalls.mon x 6271 ./usr/lpp/RTR320/mon/system.mon x 1786 ./usr/lpp/RTR320/mon/tps.mon x 1848 ./usr/lpp/RTR320/mon/tpslo.mon x 2844 ./usr/lpp/RTR320/mon/traffic.mon x 2018 ./usr/lpp/RTR320/mon/trans.mon x 5271 ./usr/lpp/RTR320/mon/v2calls.mon x 3873 ./usr/lpp/RTR320/mon/xa.mon x 0 ./usr/lpp/RTR320/hlp x 726615 ./usr/lpp/RTR320/hlp/rtr.hlb x 708 ./usr/lpp/RTR320/hlp/copyright.txt x 4425 ./usr/lpp/RTR320/hlp/license.txt x 700198 ./usr/lpp/RTR320/hlp/rtr.hlp x 0 ./usr/lpp/RTR320/inst_root The total size is 10339047 bytes. # 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. aio0 Available Asynchronous I/O autoconfig available STATE to be configured at system restart True aio0 Available aio0 changed aio0 Available Asynchronous I/O autoconfig available STATE to be configured at system restart True Installation of RTR V3.2 complete Finished processing all filesets. (Total time: 19 secs). +-----------------------------------------------------------------------------+ Summaries: +-----------------------------------------------------------------------------+ Installation Summary -------------------- Name Level Part Event Result ------------------------------------------------------------------------------- RTR320.rte x.xx.xxx.x USR APPLY SUCCESS RTR320.rte x.xx.xxx.x ROOT APPLY SUCCESS |
The following shows output from an AIX IVP.
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. |
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 AIX 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 will normally be recycled correctly. 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. IVP: Would you like to abort the IVP? (y/n) n 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 nodeA %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 nodeA © 1999 Compaq Computer Corporation and Digital Equipment Corporation. All rights reserved. Reliable Transaction Router V3.2 for AIX Installation Verification Procedure successful |
Previous | Next | Contents |