Systems Installation

ESS software systems are distributed either on 8mm Exabyte, or 4mm DAT (DSS-2 or DSS-3) tapes. Systems like AirWare, WaterWare or RiskWare are also distributed on CD; alternatively, systems and in particular, updates, can be downloaded from the ESS ftp server.

On the distribution tape, the system is packed as a UNIX tar tape archive.

To unload and install, insert the tape in the respective drive, log in as root or a user with sufficient privileges to create a project directory as the root of the respective installation.

Create a systems root directory, for example, called AIR, WATER, or RISK in the directory /export/home :

% cd export/home
% mkdir AIR
% chmod 777 AIR
% cd AIR

To untar the tape file, type:

% tar xvf /dev/rmt/0

or whatever the appropriate device name for the tape drive may be. The system will then list the contents of the tapes while the files are extracted. tar extract files and directories recursively, and creates the necessary files structure on the target system.

Please note that the modification dates will be set to the current time, and ownership will be set to the UID of the current user running the tar command.

After installation, you should, if necessary, change the ownership of the new directory tree recursively: chown -R user /export/home/AIR for the example location above.

If necessary, individual subdirectories that are referenced in the CONFIG can now be relocated. The largest one is the ./data directory. Assuming it should be moved to a new location, this has to be updated in the CONFIG file. The original entry:

setenv  DATADIR     data

would then be changed into

setenv DATADIR    ../newdata

assuming the new location for the data directory should be in /export/home/newdata (moved from the default /export/home/AIR/data.

To run the AirWare/WaterWare/RiskWare system properly, you have to set up a few more files for the user(s) that will use the system. The following assumes you are using the CDE, the Common Desktop Environment that is supported on SUN, HP, and IBM.

The user(s) should set the following environment variables in their home directories:

in .Xdefaults:
Dtwm*xaca*clientDecoration: none
(this will cause the window manager to NOT put a window frame around the application; if you want one, which can be useful to drag or iconify the application without the mouse button window menus, just delete this line).
in .cshrc:
setenv LD_LIBRARY_PATH /usr/dt/lib:/usr/openwin/lib: \\ /opt/X11r5/lib:/usr/local/lib:/usr/dt/lib:/opt/SUNWmotif/lib
(this will make sure that the dynamic libraries needed are found by the loader; however, you may have to make sure that they are indeed in their default locations; if you gate an error message about any files *.lib, just use the find command to verify its actual location: find . -name "file_name" -print

Please note that the above should be typed in a single line without space and line break.

License Keys

AirWare/WaterWare/RiskWare executables are node-locked, i.e., they can only be run on CPU's for which a valid license key has been obtained from ESS as part of your system's purchase.

You need to copy your license key into the file .aca_licenses which is located in the project root directory together with the executable.

A typical example would look like this:

2SaaJJnE2iiiccOrJJoolZggww     Hostid: 8089845e Expires: Never
W9RRKK33ofe9CrDkpmSgN3O3II     Hostid: c151f43e Expires: 31-12-1997

including the license code proper, the hostid of the machine for which the license is valid, and the expiration date, if any.

To get a license key, please mail the hostid of the respective machine(s) to info@ess.co.at. We will mail you back your license key of keys for insertion into the .aca_licenses file. You can obtain the hostid of your machine by simply typing hostid at a shell prompt (on A SUN). The results should be an eight-digit hexadecimal string, for example: 8089845e.

On an IBM machine under AIX, please note that the command hostid resides in /usr/sbin, and the result is preceded by 0x to indicate that this is a hexadecimal string:

ibm% /usr/sbin/hostid
0xc151f460

For Linux installation, copy the program install that you will find on the distribution CD or tape to your computer and run it by typing: install at the shell prompt. You have to be super user (root) to do this correctly. The program will return an eight digit host ID string as above.