The Kerridge ToolSet Division KCML 4 UNIX Quick Installation Guide

To install a new copy of KCML you need to be logged in as the super user.

Step1 - Extract the installation script

cd /tmp
cpio -icv <device_address kcmladmin

The device address obviously depends on the type of media being used.  See the table at the end of this page for a list of common device addresses.  If you have obtained KCML from our FTP site then specify the name of the image archive instead of a device address. Note that the installation images on our FTP server are generally compressed so you will need to uncompress them before you can extract the installation script.  This can be done with the following:

compress -d filename

If installing from a CD ROM then specify the pathname of the image file on the CD.

Step 2 - Run the installation script

Once the script has been extracted from the image file enter the following:

./kcmladmin

Step 3 - Installing KCML

Once executed a list of options is displayed.  Select the install option. 

Next you will be given the choice of an automatic installation or a manual installation, choose automatic.

Step 4 - Test

You should now be able to run KCML. On some systems the installation program creates a login called "kcml".  You will have been prompted for the password for this login during the installation.  Login as the "kcml" user and make sure that KCML starts up.

If a login was not created then change directory into "/usr/lib/kcml" and enter the following:

KTERM=`./selfid` export KTERM
./kcml

KCML should now startup.  If you already know your terminal type then you can set this accordingly before KCML is started, i.e. KTERM=vt220 export KTERM

Important Note:

Depending on the applications being used it is sometimes required to configure the UNIX Kernel.  This is a process that should only be performed by an experienced person.  Users of Kerridge applications, i.e. Autoline, KITE or KUBE, should contact the Kerridge UNIX support department to implement these changes.

The Kernel parameters that need to be changed are as follows.   Note that the names of these parameters may vary on some UNIX implementations.

FLCKREC
Specifies the number of records that can be locked by the system.  This parameter should be set to a value of at least 3000.  A larger value may be required on systems with over 300 users.  This parameter will always need to be set for systems that are running Kerridge Applications, i.e. Autoline, KITE, KUBE etc., as well as any other applications that use the KISAM file access method.

SEMMNU
Specifies the number of semaphore undo structures required by the system.  This should be set to a value greater than the maximum number of KCML users.

Common UNIX device addresses

The x in the device address signifies the drive number.