XAS Installation Guide

In the XAS distribution no makefile is supplied. The required makefiles for the compilation are automatically generated by the XASBUILD utility in the way most suitable for your system. XASBUILD is included in the XAS distribution.

To install XAS:

• decide a directory for the software installation;

• create this directory and define it as the global variable XASTOP:
  mkdir /youdisk/xas ; setenv XASTOP /youdisk/xas
  (or XASTOP=/youdisk/xas ; export XASTOP if you are running sh or ksh)

• get in binary mode the file XASx.x.x.tar.gz

• put XASx.x.x.tar.gz in the $XASTOP directory

• gunzip XAS_x.x.x.tar.gz

• tar xvf xas_x.x.x.tar

• create a logic link to the VOS source directory relevant to your operating system with the command:
  ln -s vos_YYY vos
  where YYY is:
  • osf, if one is installing XAS on a ALPHA/OSF1 platform
  • sun, if one is installing XAS on a SunOS platform

• choose the favourite make by setting the environmental variables XAS_MAKE (defaults are /usr/opt/ultrix/usr/bin/make for Alpha/OSF1 and make for SunOS:

  setenv XAS_MAKE gmake

• compile the external library SSDAUX through the commands:
  • cd $XASTOP/external/ssdaux
  • make -f Makefile_YYY all where YYY is:
    • OSF1, if one is installing XAS on a ALPHA/OSF1 platform
    • SunOS, if one is installing XAS on a SunOS platform

• enter in the XASBUILD environment through the command:

  $XASTOP/config/Scripts/xasbuild

• select option 6 switch to the extended XASbuild menu

• select option 10 running the local configurator; you will be prompted for a few questions (in bold an example of user's answers. The local user must substitute to them the local paths to the object libraries in her/his own system. default means $XASTOP/lib):

  
        What is the root directory for XAS (XASTOP)?
        /sun/xas/
        Now you define the "ULIBDIR" macro in the Makefiles.
        This macro defines ALL references to external libraries.
        You must answer with couples of "/dir1/dir2/mylibdir mylib"
        answers, and /dir1/dir2/mylibdir/libmylib.a must exist.
        If you add libraries already in the default serch path
        of the linker, answer with "default library"
        (e. g. "default curses" adds the curses library to the
        link path; "default X11" adds the X11 Xlib library, and so on).
        System libraries should be the last ones to be inserted.
        As an example, if the pgplot and fitsio libraries are not
        in $XASTOP/lib, you MUST add them with this macro.
        You end the definition with a return. If you give a return
        at the first time, you select the default answer (that is
        ULIBDIR= -L/usr/local/lib -lpgplot -lfitsio -lX11
        and that could be obtained with:
        /usr/local/lib pgplot<return>
        default fitsio<return>
        default ssdaux<return>
        default X11<return>
        default m<return>
        <return>.
        Warning! This script IS case sensitive for this answer!
        /ftools/ftools/host fitsio
        /ftools/ftools/host pgplot
        default ssdaux
        /usr/openwin/lib X11
        /usr/lib m 
        ULIBDIR=-L/usr/local/lib -lpgplot -lfitsio -lX11
        Select the destination directory for the XAS library
        (default: $XASTOP/lib)
        /sun/xas/lib
        Select the destination directory for the executables
        (default: $XASTOP/bin)
        /sun/xas/bin
        Removing Makefile/SunOS in $XASTOP.
        Done!
  

  IMPORTANT WARNING: the localize option /usr/lib m must be used only when XAS is installed on ALPHA/OSF1.

• select option 1 creating Makefiles

  This will create in most of the $XASTOP subdirectories files named Makefile_system, where system is e.g. ULTRIX, SunOS, etc. Makefiles for different operating systems may coexist in the same directory due to the presence of the suffix.

• select option 3 running 'make' in $XASTOP

  This will build XAS.

Questions, comments or suggestions concerning the BeppoSAX software can be addressed to helpdesk@sax.sdc.asi.it