The Kerridge ToolSet Division KCML 4 UNIX Quick Upgrade Guide

To upgrade KCML you need to be logged in as the super user.   You should also make sure that there are no active KCML users and background processes.  You can test for any currently active KCML tasks with the following

ps -ef  |  grep kcml

All KCML processes must be terminated before the upgrade can proceed.

Step 1 - 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 upgrade option. 

Next you will be asked to supply the installation media device address, this is the same address used with the cpio command above.  You will then be asked for the KCML utilities directory name.  Normally this would be "/usr/lib/kcml". 

When asked "Would you like to upgrade the TERMINFO database?", enter "n", unless you have a specific reason to upgrade the terminal definition files on your system.

Answer 'y' to all other prompts.

Step 4 - Test

You should now be able to run KCML. Login to your software and start any background processes required by your application.

Important Note

If you are upgrading from a version of KCML prior to release 3.22 then please read the following:

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.