2 Installation

2.1 Requirements

2.2 Installation

2.2.1 Executables installation

2.2.2 Source code installation

2.1 Requirements

Requirements for compilation and linkage:

• A C++ compiler (we recommend gcc 2.7.0). You have to set environment variable:
  • ANTCOMPILER ... contains the path of the chosen compiler (e.g. /usr/local/bin/gcc).
  You will also need some utility for using standard makefiles.
• The PVM software package of version 3.3.11 or higher installed. For the installation steps see PVM homepage. We use the static PVM libraries for linking. You have to set environment variables:
  • PVM_ROOT ... contains the path to the PVM header file pvm3.h.
  • LD_LIBRARY_PATH ... contains the path to the static library libpvm3.a.
• QT Toolkit of version 1.41 or higher installed if you want to make the graphical X-Windows applications. For details of installation of this software package see QT homepage. You have to set environment variables:
  • QT_DIR ... contains the path to the installed QT Toolkit.
  • LD_LIBRARY_PATH ... contains the path to the installed shared libraries of QT Toolkit.

Requirements for running system Antares:

• Sun Solaris UNIX operating system or compatible to run the system kernel. Otherwise you would have to download the source code distribution and rebuild it for your system.
• The PVM software package of version 3.3.11 or higher to be installed. For the installation steps see PVM homepage. You have to modify your environment variable:
  • PATH ... contains the path to the PVM binary files.
• X-Windows and QT Toolkit shared libraries of version 1.41 or higher installed to run the graphical X-Windows applications. For details of installation of this software package see QT homepage. You have to set environment variable:
  • LD_LIBRARY_PATH ... contains the path to the installed shared libraries of QT Toolkit.

2.2 Installation

There are two types of installation of the Antares system:

• The Executables installation installs fully functional executables compiled for systems mentioned in Requirements.
• The Source code installation provides all source code files in Antares system. This installation is necessary if you want to add new features or recompile it for your system.

We also offer a download for Antares documentation (doc.tar.gz) in HTML format (it is identical to the WWW Antares on-line documentation). To unpack the documentation into current directory use:
tar -xzf doc.tar.gz
The documents are then located in subdirectory doc.

2.2.1 Executables installation

This distribution contains binary files for Sun Solaris UNIX, X-Windows applications and 3 examples. Short description how to install the executable files follows:

1. Select the destination directory. This will be your Antares root directory
2. Download the progs.tar.gz into the Antares root
3. Unpack files by typing (in Antares root):
   tar -xzf progs.tar.gz
   The executables are now located in subdirectory summary.
4. Check whether you have all other necessary software packages installed and whether you have all required environment variables set as specified in the Requirements.
5. If you want to use our demo applications, you have to do one additional step: modify parameter ChildFilename in demo parameter files. For details see User's Guide.
6. Now the installation is complete!

List of installed executables : parent, child, consh, train, check, xparam, rviewer, kimarthy, kihistogram, kijerry. For details of usage see User's Guide.

2.2.2 Source code installation

Short description how to install the source code follows:

1. Select the destination directory. This will be your Antares root directory
2. Download the source.tar.gz into the Antares root
3. Unpack the files by typing (in Antares root):
   tar -xzf source.tar.gz
4. Check whether you have all other necessary software packages installed and whether you have all required environment variables set as specified in the Requirements.
5. If you want to use our demo applications, you have to do one additional step: modify parameter ChildFilename in demo parameter files. For details see User's Guide.
6. Now the installation is complete!

   Now you can use these scripts (located in directory summary) for building the system Antares:

   • makekernel - makes all kernel executables (parent, child, consh, train, check).
   • makeapps - makes all X Windows applications (xparam, kimarthy, kijerry, kihistogram, rviewer).
   • makeall - makes all above executables

    

   User's quideProject Antares