3.2. Installation guide

Compiling |  Installation |  Configuration


3.2.1. Compiling

If you are installing binary files, just unpack the distribution and follow instructions in the section Installation.

Requirements

  1. Source files with RESTRAX (available at the home page)
  2. Fortran 90 (or F77 with extensions) is required for compilation. The GNU g77 compiler can be used to compile the EXCI modules, but not for the rest of the package. Configuration files with appropriate options are available for Absoft Fortran 95 on PC/Linux and Digital Fortran on Alpha/OSF1. Contact the authors for help with porting to other systems.
  3. Shared PGPLOT library (libpgplot.so) is needed for both compiling and running RESTRAX.

Configure and make

Unzip the distribution, e.g.

% gunzip < restrax-4.8.1.tar.gz | tar -xf -

The distribution would unzip into a new subdirectory restrax-4.8.1. Make it your current directory and use following commands to compile RESTRAX:

% configure <sys> -all
% make

<sys> defines the extension of a configuration file ./config/config.<sys> with system dependent linker and compiler options. There should be config.<sys> files available for following systems/compilers:

Use one of these files as a template for porting to other systems.

You may test the program now — just call the starting script:

% start

and follow the steps described in the section Quick start.

Other make targets:

Compile EXCI modules separately:
% make excilib

Create source documentation:
% make srcdoc

Make archive with source distribution:
% make dist

Make archive with binary distribution:
% make distbin

Make archive with html documentation:
% make distdoc

Clean temporary objects:
% make clean

Clean all (requires configure before next make command):
% make cleandist


3.2.2. Installation

Call the script Install <dir> with the <dir> argument specifying the target directory, e.g.

% Install /usr/local/restax

NOTE: the installation directory must already exist and you need write permissions to it.

In order to permit access for all system users, make a link to a directory listed in the environment variable $PATH, e.g. /usr/local/bin:

% ln -sf /usr/local/restax/start /usr/local/bin/restrax
% chmod 755 /usr/local/bin/restrax

Otherwise you will need to call /usr/local/restax/start directly. You may also edit the start script to add or modify start-up menus.


3.2.3. Configuration

(see also the description of installation package)

restrax.ini

The restrax.ini file is read at the start-up, either from the current directory or from a directory with instrument configurations (see the search order). It contains default input values required when you start RESTRAX (configuration file, path to data files, data filename etc.). You can also specify a job file to be executed initially (JOB=filename).

Environment variables

Environment variables for the PGPLOT and for the shared library loader are defined in the starting scripts start or restrax_run. You can edit these scripts to set the environment according to your requirements. The shared library with the EXCI run-time module is searched according to the paths defined the environment variable LD_LIBRARY_PATH (see the search order).