1. Software Installation

1. 1. System Requirements

The complete installation requires approximately 650Mb disk space. If you wish to execute all the examples, you will need 700Mb of free disk space.

The following platforms are supported:

Solaris 8, 9, 10 (32bit and 64bit for each)
Linux RedHat Enterprise Linux 3.0 (32bit and 64bit)

1. 2. What the Distribution Provides

The distribution provides all the relevant files required to install and operate the Avertec tools. This includes:

1. 3. Scope of the Installation

The distribution can be installed onto any part of a file system so long as the person performing the installation has write access privileges. You may, for example, choose to install all the tools in a user's home directory. Alternatively, you may install the tools on an NFS file server for multi-user access. In both cases, the installation process is the same, apart from the location on the file system. The only requirements for the execution of the binaries are appropriate access privileges together with a network connection to the machine chosen to act as the license server.

1. 4. Performing the Installation

If starting from a CD-ROM, you must first perform the necessary commands to mount it.

You should then open a terminal and change directory to the place on the file system you want the tools to be installed. Launch the installation script as follow.

> /cdrom/AvtTools/Install (Solaris)
> /mnt/cdrom/Install (Linux)

If starting from a TAR archive file, you must first untar it, and change directory to the place on you want the tools to be installed

> cd /users/me/tar/
> tar -xvf AvtTools_2.8.tar
> cd /users/me/work/
> /users/me/tar/AvtTools_2.8/Install

The installation script present you with the installation choices detailed in the subsequent sections. For each choice you will be given a default reply (in square brackets) which you can accept by simply pressing the <RETURN> or <ENTER> key. Unless the choice requires a file or a directory path in response, you will also be given the list of possible replies. An invalid response will result in an error message and will take you straight back to the original question.

   

Enter the source directory [/users/me/tar/AvtTools_2.8]:

Root directory the distribution is installed from. If installation is done from a CD-ROM, default is the root directory of the CD-ROM. If installation is done from an archive, default is the root directory of the archive.

   

You must accept the following license agreement before installation

Press return to continue

Text of a license agreement. Press <SPACE> to advance one screen at a time, or <ENTER> to advance one line at a time. Please read carefully all the terms of this agreement.

   

Do you accept the terms and conditions? [accept]:

You must accept the terms of this license agreement before being able to continue with the installation.

  

Enter the destination directory [/users/me/work/AvtTools]:

Full path of the directory you wish to install the software in. By default this is a subdirectory named AvtTools of the current directory.

   

Directory /users/me/work/AvtTools does not exist...

Do you want to create it now y/n? [y]:

Creating installation directory...

If specifying a destination directory that does not exist, you will be asked to confirm its creation. If you type n then you will be asked to specify an alternative directory.

   

Enter the OS to install

   S2.6       : Solaris 2.6
   S2.8       : Solaris 2.8
   S2.8_64    : Solaris 2.8 64bits
   S2.9       : Solaris 2.9
   S2.9_64    : Solaris 2.9 64bits
   RHEL3.0    : Red Hat Enterprise Linux 3.0
   RHEL3.0_64 : Red Hat Enterprise Linux 3.0 64bits
   RHL8.0     : Red Hat Linux 8.0

OS [S2.6 S2.8 S2.8_64 S2.9 S2.9_64 RHEL3.0 RHL8.0]:

By default executables for all supported platforms are installed. However, you may wish to install only those which you require.

Hit <ENTER> to accept the default, or type the name of the platform for you wish to install.

   

Enter the license server name [cardiff]:

Name of the machine you intend to run the license server on. By default, it is the name of the current machine.

1. 5. Setting-up the Environment

The installation process creates a CSH environment file setting environment variables for tool access:

source $AVT_TOOLS_DIR/etc/avt_env.csh

On 64bit systems, one can choose to use either 32bit or 64bit software version. To use 64bit-software version, add the following argument:

source $AVT_TOOLS_DIR/etc/avt_env.csh 64

Where $AVT_TOOLS_DIR is the destination directory of the installation.

You can either source this file or set explicitly the appopriate environment variables in a startup script such as the .cshrc.

The variables to set are:

AVT_TOOLS_DIR Full path of the Avertec tools root directory.
PATH Access paths for the appropriate binaries, e.g. $AVT_TOOLS_DIR/tools/Solaris_2.8/bin
LD_LIBRARY_PATH Access paths for the appropriate shared object (.so) libraries. e.g. $AVT_TOOLS_DIR/tools/Solaris_2.8/api_lib
MANPATH Access paths for the Avertec man pages, e.g. $AVT_TOOLS_DIR/man
AVT_LICENSE_SERVER Name of the machine hosting the licence server.
AVT_LICENSE_FILE Full path of the licence file.

1. 6. The FLEXLM Licence Server

HITAS license control is done through the standard FLEXLM license server. Avertec's license server daemon is avtlicd.

The command:

> lmgrd -c <avertec_license_key_file>

sets AVTLICD_LICENSE_FILE to avertec_license_key_file

starts avtlicd (provided it is in $PATH)

creates ~/.flexlmrc