Up

EXSAS '97 for LINUX: The installation process



This site provides some additional information on the installation process of EXSAS for Linux. If you have further suggestions or questens please send an email to web@mpe-garching.mpg.de

Before you install EXSAS for Linux you should be aware of the following points:

Warning: This EXSAS software package needs MIDAS release 96NOV for LINUX available from the ESO. You can also find this software from the ROSAT Service Area. Click here to get MIDAS 96NOV used to build EXSAS 97JUN for Linux.

Note that the installation guide assumes that EXSAS will be installed under the MIDAS account and that MIDAS for Linux.ELF has been installed properly following the ESO guidelines distributed with MIDAS for Linux.ELF (i.e. in /usr/local/midas/exsas)

EXSAS for Linux is under the copyright of the MAX-Planck-Institut für extraterrestrische Physik. To distribute this software is not allowed without the permission of MPE. See the copyright (c) information for further details. Exsas for Linux is comming with no warranty. See the DISCLAIMER for further details. We also ask all users to REGISTER by sending us back the registration form filled out properly to get full advantage of the service we provide for registered users.


Hardware requirements: We have tested/build EXSAS/MIDAS for Linux on a 160 MHZ Pentium system with 32 MB memory. We used a Matrox Millenium Graphic board which provides 8 bit pseudo-color devices overlayed on a 24 Bit true colors device using the commercial X-window manager Accelerated X 3.1

MIDAS needs about 52 MB disk space and EXSAS'97 nearly 90 MB (without the test data. The test data are required for software tests and to run the tutorials. To store the test data requires another 60 MB). About 67 MB of the space is used for storing the ROSAT calibration files.

=========================================================================

How to install EXSAS.ELF'97 on your LINUX.ELF box:

=========================================================================
     1) - Go to the place where MIDAS for Linux is installed.

             % cd /usr/local/midas 

     2) - Create the exsas subdirectory

             % mkdir exsas

     3) - Move into the exsas root directory

             % cd /usr/local/midas/exsas 

     4) - Copy the zip'ed EXSAS for Linux files in this directory.
          Assuming you strip the EXSAS for Linux software directly
          from the MPE software pool, go on as follows

            
             % ftp rosat_svc.mpe-garching.mpg.de
             ftp> cd exsas/97JUN_EXP_Linux
             ftp> bin
             ftp  prompt
             ftp> mget 97JUN_*.zip
             ftp> get README
             ftp> get INSTALL.DOC
             ftp> get COPYRIGHT
             ftp> get REGISTER
             ftp> mget testdata*.zip
             ftp> bye
            

          To install all software, i.e. the exe-, prg- and parameter
          files as well as the testdata and callibration files, a
          disk space of about 150 MB is required.

          MIDAS needs about 52 MB disk space and EXSAS'97 nearly 90 MB
          (without the test data. The test data are required for software
          tests and to run the tutorials. To store the test data requires
          another 60 MB). About 67 MB of the space is used for storing the
          ROSAT calibration files.

          After copying all files from the EXSAS software pool, you should
          have the following zip files under /usr/local/midas/exsas:



      The ROSAT/EXSAS calibration files:
     =====================================

        -rw-r--r--   1 root     root         5545 Aug 01 14:18 97JUN_C00.idx
        -rw-r--r--   1 root     root      1394223 Aug 01 14:18 97JUN_C01.zip
        -rw-r--r--   1 root     root      1399966 Aug 01 14:18 97JUN_C02.zip
        -rw-r--r--   1 root     root      1399952 Aug 01 14:18 97JUN_C03.zip
        -rw-r--r--   1 root     root      1399927 Aug 01 14:18 97JUN_C04.zip
        -rw-r--r--   1 root     root      1399903 Aug 01 14:18 97JUN_C05.zip
        -rw-r--r--   1 root     root      1399919 Aug 01 14:18 97JUN_C06.zip
        -rw-r--r--   1 root     root      1399966 Aug 01 14:18 97JUN_C07.zip
        -rw-r--r--   1 root     root      1399751 Aug 01 14:18 97JUN_C08.zip
        -rw-r--r--   1 root     root      1399871 Aug 01 14:18 97JUN_C09.zip
        -rw-r--r--   1 root     root      1399821 Aug 01 14:18 97JUN_C10.zip
        -rw-r--r--   1 root     root      1399888 Aug 01 14:18 97JUN_C11.zip
        -rw-r--r--   1 root     root      1399827 Aug 01 14:18 97JUN_C12.zip
        -rw-r--r--   1 root     root       501333 Aug 01 14:18 97JUN_C13.zip

     Executables, prg-, help and par-files
    ===========================================

        -rw-r--r--   1 root     root      1334700 Aug 01 14:39 97JUN_E1.zip
        -rw-r--r--   1 root     root      1365223 Aug 01 14:39 97JUN_E2.zip
        -rw-r--r--   1 root     root      1392720 Aug 01 14:39 97JUN_E3.zip
        -rw-r--r--   1 root     root      1350990 Aug 01 14:39 97JUN_E4.zip
        -rw-r--r--   1 root     root      1397048 Aug 01 14:39 97JUN_E5.zip
        -rw-r--r--   1 root     root       154155 Aug 01 14:39 97JUN_E6.zip


     EXSAS for Linux installation guide, register, readme and copyright files
    ==========================================================================

        -rw-r--r--   1 root     root          740 Aug 01 15:43 COPYRIGHT
        -rw-r--r--   1 root     root         4215 Aug 01 11:51 README
        -rw-r--r--   1 root     root         2244 Aug 01 15:51 REGISTER



     Test data
    ============

        -rw-r--r--   1 root     root      2146158 Aug 01 11:44 testdata1.zip
        -rw-r--r--   1 root     root      3965715 Aug 01 11:44 testdata2.zip
        -rw-r--r--   1 root     root       649212 Aug 01 12:00 testdata31.zip
        -rw-r--r--   1 root     root      1924288 Aug 01 12:03 testdata32.zip
        -rw-r--r--   1 root     root      2858431 Aug 01 13:38 testdata4.zip


NOTE: See the *.idx for the contents of the ziped files. There is no documentation included in this release. The EXSAS Handbook and command summary are now provided online.


     6) - Now unzip all files. The EXSAS version directory 97JUN_EXP will
          be created and the files are installed:

              % unzip *.zip 

     7) - You might want to delete the ziped files from the directory

              % rm /usr/local/midas/exsas/*.zip 


     8) - Go to the EXSAS version directory which has just been created

              % cd 97JUN_EXP


     9) - If you are working under the GNU shell 'bash', edit the file
          EXSAS.bash (users who are working with the c-shell should do
          the same with EXSAS.csh) and change the definitions appropriate
          to your installation. The defaults are just fine if you have
          installed EXSAS following the description above.

               % vi EXSAS.bash 

          The most important definitions are set at the first 3 lines of
          code. XEXSAS must point to the "version" directory of EXSAS
          (for instance /usr/local/midas/exsas/97JUN_EXP). The alias
          "inmidas"  and "gomidas" in the next lines can be commented,
          if you have already defined them elsewhere. You might also
          wish to define  the environment variable "editor" in order
          to specify  the default ASCII files editor to be used in
          EXSAS (it is currently set to "joe"). We found that setting
          MIDOPTION to PARALLEL is making life easier, but you can
          comment out this line if you don't like it.


    10) - Get now the EXSAS definitions with

               % source EXSAS.bash

           or
               % source EXSAS.csh

          depending on the shell you are using. One of this files should
          be always executed by all EXSAS users. The line 
           
         
source full_path_to_exsas/EXSAS.bash
where full_path_to_exsas is the path to the exsas directory, (e.g. /usr/local/midas/exsas/97JUN) should be contained in all users .bashrc or .login files. % source /usr/local/midas/exsas/97JUN_EXP/EXSAS.bash 11) - Go to the calibration area and rebuild few files which have been splitted for transportation: % cd $XEXSAS/cal % cat de200_new_cnvt.dat.a* > de200_new_cnvt.dat % rm de200_new_cnvt.dat.a* % cat thbrall.tbl.a* > thbrall.tbl % rm thbrall.tbl.a* % cd .. 12) - Copy the EXSAS context file to the proper MIDAS directory: % cp $XEXSAS/exsas.ctx $MIDASHOME/$MIDVERS/context 13) - Copy the special EXSAS look up tables to the proper MIDAS directory: % cp $XEXSAS/lut/*.lut $MIDASHOME/$MIDVERS/systab/bin
=========================================================================

STARTING EXSAS

=========================================================================
14) - In order to start EXSAS, start MIDAS first: % inmidas When you get the MIDAS prompt set the EXSAS context: Midas 001> SET/CONTEXT EXSAS A preferable alternative to that is to initiate automatically EXSAS every time you start MIDAS. If you want this to be true for ALL MIDAS users, then add the line SET/CONTEXT EXSAS at the top of the file $MIDASHOME/$MIDVERS/prim/proc/login.prg; otherwise the single user can decide to place the line SET/CONTEXT EXSAS at the top of his own login.prg (in his MIDWORK directory). Don't put the SET/CONTEXT line at the end of the login.prg files, because this would destroy all the commands defined beforehand (this happens because EXSAS need to expand the MIDAS command buffer).
=========================================================================

USING EXSAS

=========================================================================
15) - Read the helps! Read the manuals! Read the news! Generally it helps a lot. And in case of problems, use the addresses indicated in Chapter 2 of the EXSAS Users Guide. PANIC --> Phone +49-89-3299-3588 (Werner Becker for EXSAS on Linux) or +49-89-3299-3313 (Carlo Izzo else) or send a mail to web@mpe-garching.mpg.de in case of problems with the installation of EXSAS for Linux.
=========================================================================

Optional: ROSAT Test Data

=========================================================================
16) - Optional: get some testdata via ftp (they are not on tape). Skip this if you don't want test data (they take about 40 Mb of disk space but they are required to run the tutorials and software checks). % cd $XEXSAS % ftp rosat_svc.mpe-garching.mpg.de ftp> cd 97JUN_EXP_Linux ftp> get testdata1.zip (PSPC observation of LMC) ftp> get testdata2.zip (Two WFC observations) ftp> get testdata31.zip (PSPC observation of AR LAC) ftp> get testdata32.zip (HRI observation of AR LAC) ftp> get testdata4.zip (PSPC observation of PSR 0656+14) ftp> bye unzip testdata*.zip (don't forget to set the path to the test in EXSAS.bash or EXSAS.csh) 17) - Enjoy Exsas.ELF'97 under Linix :-))



Author: Werner Becker (e-mail: web@mpe-garching.mpg.de ) / Page last modified: 09-SEP-97