||Traffic and air quality|
SIMTRAP User Manual - Installation Guide
Systems InstallationESS software systems are distributed either on 8mm Exabyte, or 4mm DAT (DSS-2 or DSS-3) tapes or CDs. 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 Simtrap installation.
Create a systems root directory, for example, called SIMTRAP in the directory /export/home :
% cd export/home % mkdir SIMTRAP % chmod 777 SIMTRAP % cd SIMTRAPTo untar the tape file, type:
% tar xvf /dev/rmt/0or 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/SIMTRAP 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 datawould then be changed into
setenv DATADIR ../newdataassuming the new location for the data directory should be in /export/home/newdata (moved from the default /export/home/SIMTRAP/data.
To run the Simtrap 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:
License KeysSimtrap 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-1997including 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 email@example.com. 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.