UNIX Workstations

To install FEMGV you require no special user privileges or disc areas. We suggest that all Femsys Limited software be placed in one ``master'' directory with separate subdirectories for the various programs. In this document we will refer to this master directory as femsys

The following installation procedure assumes that you are running the Bourne shell.

Any text which appears in italics is site dependent.

1.

Check that you have sufficient free disc space and that the operating system software requirements have been met.

2.

If you do not already have a master directory create one now:

$ mkdir femsys
$ chmod 755 femsys

3.

The UNIX directory on the distribution CD contains sub-directories based on machine type and operating system. Use tar to extract the FEMGV installation from the relevant sub-directory into your master directory.

$ cd femsys
$ tar xvof /CDROM/unix/sg/irix65/fgv6101.tar

for example. The 'o' option is not always supported; it may be omitted if necessary.

This procedure will create a subdirectory in femsys the name of which reflects the version number of the software; for example, fgv6.1-01

4.

Establish your security keyfile.

Each FEMGV installation will be issued with a program security file known as a 'keyfile'. In general, a keyfile consists of ten lines with each line containing 10 characters.

The installation kit includes a demonstration keyfile and your customised keyfile will be provided as part of the covering documentation. If it is supplied in printed form only you will need to create the keyfile using your favourite text editor. The keyfile should be named fgvkey.k60 and stored in the same directory as your FEMGV executables, femsys/fgv6.1-01, for example. Note that if you are upgrading to FEMGV from FEMGV 5 you can simply copy your existing fgvkey.k50 into fgvkey.k60

Whenever FEMGV is executed the security file fgvkey.k60 is examined. The pathname of the security file is obtained from an environment variable FGVKEY. If this variable does not exist then an attempt is made to open the file fgvkey.k60 in the current directory.

The way in which environment variables are defined depends on the command shell in use:

Bourne C Shell Korn

FGVKEY=femsys setenv FGVKEY femsys export FGVKEY=femsys export FGVKEY

This declaration could be placed in each user login startup file; .profile, .cshrc or .kshrc, for example. However, it is usually possible to declare global environment variables by placing them in a file such as /etc/profile or /etc/cshrc .

5.

Define a command which will allow users to run FEMGV

The mechanism by which users access the FEMGV executable is dependent upon your local customs.

The distribution contains a convenience shell script femgv.sh, which may be edited in order to set environment variable etc.. This file should then be used in order to run FEMGV. Perhaps the simplest way to achieve this is to create a soft link in a directory which is already in all users' paths; /bin or /usr/local/bin for example.

$ cd femsys
$ chmod +x femgv.sh
$ cd /usr/local/bin
$ ln -s femsys/fgv6.1-01/femgv.sh femgv

for example. Note that you will need access to a privileged account for this operation. In this way all users can run FEMGV by simply typing, femgv

Alternatively, the pathname of the directory holding the executable could be placed in the global path or in each users path ( via .profile).