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
- Source files with RESTRAX (available at the home page)
- 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.
- 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:
- Linux/Absoft Fortran 95 (Absoft)
- OSF1/Digital Fortran 90 (DEC)
- GNU g77 (g77, only for EXCI)
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).