Setting up the Environment

This section describes the setting of the installation relevant environment variables. It is not intended to provide a description of the environment that is needed to run the software. The installation environment will not be sufficient to run the software. Please see the instrument specific cookbooks for a detailed description on how to set-up the environment to actually run the OSA software.

Compiler

Make sure that your compiler's bin and lib directories are contained in environment variables PATH and LD_LIBRARY_PATH respectively. A way to check this, is to use the `which' command followed by the name of your compiler. If the compiler is not found, type the following commands:

setenv PATH ``__path_to_your_compiler__/bin:$PATH''

setenv LD_LIBRARY_PATH ``__path_to_your_compiler__/lib:$LD_LIBRARY_PATH''

If one or both of the above commands fail with a message like: 'LD_LIBRARY_PATH: Undefined variable', omit the `:$PATH' or `:$LD_LIBRARY_PATH' part in the commands respectively.

If the setenv commands fail with a message like: 'setenv: command not found' or 'setenv: not found' please read the appendix on `Troubleshooting'.

In addition, you have to make sure that all compiler relevant environment variables are correctly set up. Depending on the compiler and OS used, those variables are:

Linux (including Ubuntu) using GNU C/C++ and Fortran Compilers

• setenv CC "gcc -Df2cFortran"
• setenv CXX "g++ -Df2cFortran"
• setenv F90 gfortran

The ISDC default setting on Linux is to switch the code optimiser on (option -O2).

You must have a FORTRAN90 compiler installed on your system and compatible with gcc (e.g., gfortran). Otherwise the build will fail.

If the setenv commands fail with a message like: `setenv: command not found' or `setenv: not found' please read the appendix on `Troubleshooting'.

ROOT

You can choose between an installation with and without ROOT. If you choose to install without ROOT, you will NOT benefit from all OSA functionalities, i.e. GUI support is not available. Once you have installed OSA software without ROOT and would like to use the GUIs, you will have to re-install OSA software from the source code.

If you choose NOT to install with ROOT, you have to make sure that environment variable ROOTSYS is NOT set. Otherwise you will run into problems during the OSA software compilation.

If you choose to install with ROOT, make sure that environment variable ROOTSYS is set to where your ROOT installation is located. The ROOTSYS environment variable should typically point to a directory with at least the following sub-directories: bin, etc, icons, include and lib. Make sure that your ROOT's bin and lib directories are contained in environment variables PATH and LD_LIBRARY_PATH respectively. A way to check that is to actually execute the `root' command and verify the version of root. To exit root, please type `.q'. If root is not found, type the following commands:

setenv PATH ``$ROOTSYS/bin:$PATH''

setenv LD_LIBRARY_PATH ``$ROOTSYS/lib:$LD_LIBRARY_PATH''

If one or both of the above commands fail with a message like: 'LD_LIBRARY_PATH: Undefined variable', omit the `:$PATH' or `:$LD_LIBRARY_PATH' part in the commands respectively.

If the setenv commands fail with a message like: 'setenv: command not found' or 'setenv: not found' please read the appendix on `Troubleshooting'.

ISDC_ENV

Decide where the ISDC software package should be installed. This is controlled via the environment variable ISDC_ENV. You may set the value of ISDC_ENV to any location where you have write permission. It is however recommended to set ISDC_ENV to the directory where the source code of the OSA software package is located.

When installing on a multi-platform system, you might find it useful to have a common source code tree for the various binary installations you maintain. This can be achieved by setting the ISDC_ENV environment variable to e.g. __osa_src_rep__/LocalLinux for an installation under Linux.

Make sure that $ISDC ENV/bin is contained in the environment variable PATH - even if this directory does not yet exist at this stage of the installation. If $ISDC ENV/bin is not included, execute the following command: setenv PATH $ISDC_ENV/bin:$PATH. If the setenv command fails, please read the appendix on `Troubleshooting'.