Installing the Software

The INTEGRAL OSA software is available via the following URL

http://www.isdc.unige.ch/integral/analysis#Software

Packages containing the OSA binaries for the following Linux distributions are provided for your convenience: [label= ]

• CentOS 5 - x86_32
• CentOS 6 - x86_64
• CentOS 7 - x86_64
• Ubuntu 16.04 - x86_64
• Ubuntu 20.04 - x86_64

The OSA software requires as run-time library the libgfortran.so.3 and the libc.so.6 libraries. These library should be installed before the OSA software can be used. The libc.so library is most likely already installed with recent operating systems. The libgfortran.so library can be received by various packages, depending on the Linux distribution. For Ubuntu 20.04 - x86_64, we distribute libgfortran.so.3 together with OSA, as it is not anymore available using the most common installation methods.

If you are running an operating system for which no binary package is available, you can use the docker image, which is giving full portability to OSA (Section 6). Testers have successfully used the Ubuntu version on Open Suse 42.2 and 42.3. You can also download and install the source code package. Please see Appendix B for the detailed system requirements and instructions to install the OSA software from the source code.

We strongly recommend that you first install and possibly test the binary package for your operating system(s) or use the docker image.

Linux users:
Once you have downloaded the binary package for a Linux operating system,

1. Move it to a directory to which you have write access and
2. unpack the downloaded tar-file using e.g. the following command: tar xfzv "Binary-file"

Resulting from the above command(s) you will find the directory osa11 containing all the OSA software. This directory is referred to as ISDC_ENV in the INTEGRAL OSA user documentation.

You will have to set the environment variable ISDC_ENV to the full pathname of this directory to use the just installed OSA software. Details on setting up the run-time environment can be found in the cookbook sections of the instrument specific OSA user manuals.

Mac OS X users: Docker is a system that enables to run a software within its native environment without modification of the users' operating system. The only requirement it to install the docker server and download the docker image for a specific task. We provide OSA and Heasoft in a docker image built on Linux CentOS7.

Mac OS X users are invited to use docker distribution, and are referred to 6 for full instructions.

For any platform, you need to install the `Instrument Characteristics' and the ``Reference Catalogue''. Their installation is described in the following two sections. Then, you need to fetch data and perform the analysis.