1. Download and extract the installation filesets.
2. Run the installation script.
3. Enter licence/evaluation keys. 

Each of these steps must be carried out by a super-user. 

 

The Utools Directory

All Realtime Holdings software products reside within a single sub-directory called Utools. The software is installed by extracting from the 'tar' archive into the tmp sub-directory of the filesystem that will contain the Utools sub-directory. For example, if the software is to be loaded into the /usr2 filesystem, you should change into the /usr2/tmp the sub-directory, and if it does not exist, it should be created. If the 'tar' archive is extracted into the root /tmp directory, the installation will assume that the software is to be loaded into the /usr filesystem. 

 

The installation script will also add the following lines to /etc/profile and /etc/cshrc if they do not already exist. i.e. If other Realtime Holdings products have not already been installed. This is the only modification done to any files external to the Utools directory. Note that the actual setting of Utools will be that which was entered in during the installation session.

 

In /etc/profile the following will be added: 

Utools=/usr PATH=$PATH:$Utools/Utools/bin export Utools PATH

In /etc/cshrc the following will be added: 

setenv Utools /usr set path=($path $Utools/Utools/bin)

Software Media

The software is distributed from the Realtime Holdings web site as a common text file and individual binary distribution files for each platform in compressed "tar" format. These archives extract files relative to the current directory. These distibution files are available from;

ftp://ftp.realtime.com.au/realtime/Distribution/PCF5.0

There is a common text file which must be downloaded for all platforms;

ftp://ftp.realtime.com.au/realtime/Distribution/PCF5.0/TEXT1.ENG.tar.Z

And one of the following binary files must be downloaded to suit the target platform;

Sun Solaris 6 and higher
Linux 2.4 (Redhat 7)
AIX 4.1.x
SCO 3.2.4 (V4 and V5)

To commence installation, run the install script, i.e.; 

./install

Initial Software Package Installation

Following is the output from a typical installation session. The script asks a series of questions, and presents a default response in each case. To accept the default setting simply press <Enter>, or you may enter a different setting by typing it in and pressing the return key. If you already have other Realtime Holdings products installed, the $Utools variable will be set accordingly. This variable identifies the root directory for the binary and library files, and is the first parameter asked at installation. If this is correct, you may simply press <Enter>.

================================================================ Realtime Holdings Pty Ltd - Software Installation Utility ================================================================ Copyright 2002 - Realtime Holdings PL & SCOS Automation BV. This software is protected by copyright. All rights reserved. ================================================================ Installation (Utools) directory [/usr]:

 Next you will be prompted for the software package name before proceeding with file installation. At this prompt, you should also press <Enter>.

The following product(s) will be installed under /usr PCR Print Control version 5 Is this correct? [y]:

The installation will now proceed to move all the files extracted from the distribution media into the correct places, whilst also setting correct ownership and permissions, and creating any required directories.

Installation is in progress, please wait ======================================== Creating file list......... Checking directories....... Installing text files...... Installing binary files.... Checking /etc/profile and /etc/cshrc...... Executing PCR_install_exec........

You will now be asked whether you wish to install the supplied evaluation or license keys. These keys may be be entered at a later stage if you choose to skip this step (by entering the command pcm -IDinstall).

Do you wish to install the Print Control demo/license now [y]:

If you answer 'yes' to the last prompt, the installation will invoke Print Control's licensing screen. To enter a demo (evaluation) key, follow these steps:

1. Press function key F2 or press Esc 2. 
2. Enter the supplied evaluation key, using Tab to move between fields.
3. When the key is entered, press F1 or Esc 1. 
4. You will be prompted to confirm key installaion.
5. Press Y to proceed, or N to return to the key entry screen.
6. Press function key F4 or press Esc 4 to quit.

To enter a full license key, follow the following steps:

1. Press function key F1 or press Esc 1. 
2. Enter the supplied license key, using Tab to move between fields. 
3. Enter all the other suppled details (serial, sitename, nodename).
4. When all the data is entered, press F1 or Esc 1. 
5. You will be prompted to confirm key installaion. 
6. Press Y to proceed, or N to return to the key entry screen. 
7. Press function key F4 or press Esc 4 to quit. 

The installtion script will complete after the licenses are entered.

 

Software Installation Completion Messages

All installation activity and messages are recorded in an error log file. If any errors occured during the installation this file may be reviewed to determine the reason for the failure.

 

If the software has been re-loaded over a previous version, any modified files will be saved in a sub-directory within Utools. These files will also be recorded in the error log file. If any files have been saved, a message such as the following will displayed; 

NOTE: 3 files were saved under /usr/Utools/saved.021016 This directory may be removed after the software has been successfully installed. To undo this installation, execute the following: cd /usr/Utools/saved.021016 ./restore

This final message is displayed upon completion of the installation. The error log is generated in the temporary directory into which the software was originally extracted. This file may be examined (with 'vi' or 'pg') to review all the alterations which resulted from the installation.

SOFTWARE INSTALLATION IS NOW COMPLETE. ====================================== Examine the 'errlog' for any errors that may have occured during installation.