XMM-Newton Science Analysis System: User Guide

1.1 SAS installation

The first step in the installation procedure is to identify the operating system and corresponding SAS release. SAS is supplied as a single tgz archive. Help on how to download SAS can be found at the SAS download web page:

http://www.cosmos.esa.int/web/xmm-newton/sas-download

This page provides a table showing the different builds and supported Operating Systems available for each SAS release. Once the tgz archive corresponding to a given SAS build has been downloaded, the installation process is quite straightforward and platform independent. Detailed installation instructions can be found at:

http://www.cosmos.esa.int/web/xmm-newton/sas-installation

SAS can be installed everywhere in your system. If /top_dir is the directory selected to install the SAS, the single tgz archive should be unpacked there. The unpacking provides, among other files, a script named install.sh, which must be run to perform the installation. Once the installation is complete, the correspondent SAS release will be located in a subdirectory named:

xmmsas_YYYYMMDD_HHMM

which identifies uniquely each SAS release by the date (YYYYMMDD) and time (HHMM) of its production. Important changes to each SAS release are included in XMM-Newton SAS Release Notes [7].

The installation script will produce two additional shell scripts within the same directory, named setsas.sh and setsas.csh for the Bourne/Bash/Korn shells and csh/tcsh shells respectively. The purpose of these scripts is to initialize the SAS environment for each particular shell.

The install.sh script makes some checks to the shell environment before completing the installation:

• Whether perl is available or not in the PATH.
• Whether the environment variable SAS_PERL is defined or not and whether it is set to the same perl available through the PATH.
• Whether python is available or not in the PATH and whether the version of such python is the proper one or not.

If any of these checks is not fulfilled, the script produces an error message and interrupts the installation. Once the missing requirement is fulfilled, the installation can be resumed by running the script xmmsas_YYYYMMDD_HHMM/configure_install.

The installation script completes the installation changing the she-bangs of all the SAS Perl procedures to /usr/bin/env perl.

See the following link for more information on any additional requirements:

http://www.cosmos.esa.int/web/xmm-newton/sas-requirements