next up previous
Next: Document Change History Up: Installing the Software from Previous: Setting up the Environment

Subsections

Configure, Build and Install

When the installation environment is successfully set up you may proceed to configure, build and install the software package. This is done by executing the following command sequence in the directory where you unpacked the OSA software source package:

configure

  1. cd to the directory where you have unpacked the downloaded tar-file.
  2. If you want to install OSA software without ROOT execute the command
    support-sw/makefiles/ac_stuff/configure -without-cern-root
  3. If you want to install OSA software with ROOT execute the command
    support-sw/makefiles/ac_stuff/configure

These commands will create all system dependent Makefiles that are needed to build the software. Please type `support-sw/makefiles/ac_stuff/configure -help` to learn about the configure options.

Image osainstguide111-img003 The setting of all environment variables mentioned in section `Setting up the Environment' has to be done prior to executing the configure command. If, after executing the configure command, you change your mind about the value of an environment variable, you must first execute `make distclean' and then redo the configuration step.

Image osainstguide111-img003 When installing on a multi-platform system and you decided to share the source code tree, you must execute `make distclean' and then redo the configuration step for each platform.

Image osainstguide111-img003 Make sure that the environment variable MAKEFLAGS is not set.

If the configure step terminated with an error and you cannot figure out the problem yourself, please consult the 'Frequently Asked Questions' at http://www.isdc.unige.ch/integral/analysis#FAQ to check for a solution to your problem or send an E-mail to the INTEGRAL help-desk at mailto:inthelp@rssd.esa.intinthelp@sciops.esa.int. For an efficient trouble-shooting, please see appendix `Troubleshooting' for information you should provide to help us solving the problem you have.

Build and install

As for construction of OSA. you need to directly type

Image osainstguide111-img003 You really have to type `make install'. A simple make will fail.

This will compile all relevant source files, create the library files, the F90 modules and the C/C++ and F90 executables. The installation terminates by moving the library, the C/C++ header files, the F90 modules, the parameter files and the user manuals to the correct location.

If everything went ok, you should see the following message:

************ everything compiled and installed successfully ***********

executables are installed in : $ISDC_ENV/bin

parameter files are installed in : $ISDC_ENV/pfiles

F90 modules are installed in : $ISDC_ENV/f90mod

documentation, help, .txt files are installed in : $ISDC_ENV/help

C/C++ include .h files are installed in : $ISDC_ENV/include

.a, .so library files are installed in : $ISDC_ENV/lib

script files are installed in : $ISDC_ENV/share/default_scripts

other shared files are installed in : $ISDC_ENV/share

FITS file template files are installed in : $ISDC_ENV/templates

If `make install' terminated with an error and you cannot figure out the problem yourself, please consult the 'Frequently Asked Questions' at http://www.isdc.unige.ch/integral/analysis#FAQ to check for a solution to your problem or send an E-mail to the INTEGRAL help-desk at mailto:inthelp@rssd.esa.intinthelp@sciops.esa.int. For an efficient trouble-shooting, please see appendix `Troubleshooting' for information you should provide to help us solving the problem you have.

Once the installation is successfully terminated you may recover some disk space by removing temporary compilation products. This is done by executing `make distclean'. You may even recover more disk space and remove the entire source code tree by executing `rm -rf support-sw analysis-sw other-sw' in OSA source code directory.

Now OSA software is fully installed and is ready to be used. Please refer to the OSA documentation available at http://www.isdc.unige.ch/integral/download/osa_sw http://www.isdc.unige.ch/integral/analysis for details on how to run the OSA software. The `Introduction to INTEGRAL Data Analysis' and the cookbook section of the instrument specific user manual will be of particular use for you.


next up previous
Next: Document Change History Up: Installing the Software from Previous: Setting up the Environment
inthelp@sciops.esa.int