### 2 Installing ESP

Most of what follows is likely to be of interest to site system managers only and may be skipped by the normal user.

ESP is supplied as a compressed tar file: esp.tar.Z. To install ESP the file must be must be uncompressed and the contents extracted to a suitable directory. On Starlink systems, this would be /star/sources/esp.

% mkdir /star/sources/esp ; cd /star/sources/esp
% zcat /tmp/esp.tar.Z | tar xvf -

You must then set an environment variable to identify the type of operating system you are using. The example given below shows the value of SYSTEM needed to create a Solaris version of the software. The values required for other Starlink supported systems may be found in the files mk and makefile.

% setenv SYSTEM sun4_Solaris

The UNIX ‘make’ facility may then be employed to generate ESP in the current directory, clean up after itself and move the run system to the install directories:

% setenv INSTALL /star
% ./mk build
% ./mk clean
% ./mk strip
% ./mk install

On Starlink systems, the necessary environment files and aliases will be automatically set up by the /star/etc/login and /star/etc/cshrc files on login, if ESP is detected as being installed in /star/bin/esp.

If it isn’t, you should set ESP_DIR and ESP_HELP as follows in your own  ~/.login file:

setenv ESP_DIR /star/bin/esp
setenv ESP_HELP /star/help/esp/esp