Northgate Public Services (UK) Ltd

                            Peoplebuilding 2
                            Maylands Avenue
                            Hemel Hempstead
                            Herts.  HP2 4NW
                          www.northgateps.com
                             01442.298149

                      NPS Customisation Package
                      ~~~~~~~~~~~~~~~~~~~~~~~~~

This package contains utilities to customise UNIX systems for applications
supplied by NPS. It supports AIX 64 bit and Linux 64 bit. The most recent
version of this package may be downloaded from the Reality web site.

Solaris customisation is handled with the 'solcus' customisation package
which is available from the Reality web site. 

You will normally run the customisation directly from the CD-ROM, mounted ISO
image or unpacked tar by executing the 'setup' script in this root directory.

Prior to running 'setup' a number of preliminaries may be required, please
refer to the "Preliminaries" sections below for your target platform.


Customisation Modules Available
===============================

The 'L' and 'A' columns indicate availability on Linux and AIX respectively.

Module			L A	Description
------			- -	-----------
C_Compiler		  Y	Ensure gcc & gdb exist & are accessible from a
				known location.

Customise_Reality	Y Y	Fix installation/build issues with Reality.
				There are occasions where a Reality build
				issue cannot be corrected with a Reality fix.

Kernel_Configuration	  Y	Adjust kernel parameters for the required
				number of Reality users.

Northgate_Utilities	Y Y	Provide termid utility to get terminal type.

Perl			Y Y	Ensure Perl exists & is accessible from a known
				location.

Prism_Definitions	Y Y	Install Prism terminal definitions.

Tape_Configuration	  Y	Configure tape devices to support variable
				block size.

System_Configuration	Y	Update Linux, install required packages, adjust
				networking. Create realman & rosi user IDs.

User_Profiles		Y Y	Adjust users' environments, $TERM, $PATH.

NOTE: On Linux you should install 'System_Configuration' before any other
modules this will ensure that ksh (Korn shell) is installed before other
module installations try to use it. Check 'Linux - preliminaries' below.

NOTE: It is recommended that before installing Reality you should
install, in this order, where available for your platform:

System_Configuration, User_Profiles, Perl, C_Compiler and
Kernel_Configuration.

Then, after installing Reality but before building it, you should 
install, if available:

Customise_Reality.


Linux - preliminaries
=====================

The Linux customisation scripts, particularly System_Configuration assume that
the system is connected to the internet. The device names vary from platform to
platform, eth0, ens32, enp0s3 and presumably others, held in:

/etc/sysconfig/network-scripts/

There is an 'ONBOOT=' parameter which must be set 'yes', once changed
networking must be restarted by rebooting the system or with the command:

# service network restart


AIX - preliminaries
===================

AIX - Loading GNU Package Manager
---------------------------------

This is required in order to load any of the GNU packages, e.g. C compiler and
debugger.

$ su - to root
o Insert the AIX Toolkit CD-ROM in drive
# mount -vcdrfs -oro /dev/cd0 /mnt/cdrom -- cd0 may differ
# installp -qaXgd /cdrom/INSTALLP/ppc rpm.rte


AIX - Loading GNU C compiler and debugger
-----------------------------------------

# su - to root
o Insert the AIX Toolkit CD-ROM in drive
# mount -vcdrfs -oro /dev/cd0 /mnt/cdrom -- cd0 may differ
# cd to /cdrom/RPMS/ppc-4.3.3
# rpm -i gcc-2.9.aix43.010414-3.aix4.3.ppc.rpm -- C compiler
# rpm -i gdb-2.9.aix43.010414-6.aix4.3.ppc.rpm -- gdb debugger

The above may change, you should refer to /cdrom/README for more information.