SATAN Installation
| GSI | Biophysics | SATAN long write-up |

Installation

Prerequisites

Minimum prerequisites to install and run are:

Installation on UNIX systems

It is recommended to keep all SATAN-related files in a single directory. Assume the installation directory is SATAN. Then:
  1. cd SATAN
    
  2. Download the tar'ed and compressed file, e.g. 'SATAN.<os>.<yymmr>.tar.Z' or 'SATAN.<os>.<yymmr>.tar.gzip' where <os> stands for the operating system, e.g. AIX or Linux,
    and <yymmr> denotes some version number, e.g. 0112c
  3. unpack it, e.g.:
    zcat SATAN.AIX.0112c.tar.Z | tar -xvf -
    
    or
    gunzip -c SATAN.Linux.0112c.tar.gz | tar -xvf -
    
    You might also use separate calls of uncompress and tar.
    It may also happen that the archives are decompressed during download, in this case the decompression step must be skipped and only tar be applied:
    tar -xvf SATAN.AIX.0112c.tar
    
  4. Define the shell variable $SATAN to point to the SATAN directory:
    export SATAN=`pwd`
    
    This is the quick and dirty way. To be permanent you must define the shell variable in your login script (e.g. .profile if you use the ksh)
  5. Also, upgrade your command path:
    export PATH=$SATAN/bin:$PATH
    
  6. For the creation of listmode data analysis programs on MacOS X, you need to define the location of the Developers toolkit, e.g.
    export SATANSDK=/Developer/SDKs/MacOSX10.3.0.sdk   # this is the default
    
This should be sufficient. As a test you could run SATAN with a tutorial
satan
tut fleg
As of the 0112g release, versioning is supported, i.e. in addition to the normal version selected by $SATAN, $SATANNEW, $SATANOLD and $SATANTEST may point to different directories and are selected by the new, old and test keywords, respectively, of the various shell scripts. Note, however, that also the PATH variable should reflect the chosen version.

Installation on AmigaOS

It is recommended to keep all SATAN-related files in a single directory. Assume the installation directory is work:SATAN. Then:
  1. cd SATAN
    
  2. Download the self-extracting archive file 'SATAN.amiga.<yymmr>.run' where <yymmr> denotes some version number, e.g. 0112g
  3. unpack by simply invoking:
    satan.amiga.0112g.run
    
  4. Assign and define the environment variable SATAN to point to the SATAN directory:
    assign SATAN: work:SATAN
    setenv SATAN  work:SATAN
    
    This is the quick and dirty way. To be permanent you must put these definitions in your startup procedure, e.g. s:user-startup
  5. Also, upgrade your command path:
    PATH SATAN:C add
    
This should be sufficient. As a test you could run SATAN with a tutorial
satan
tut fleg
As of the 0112g release, versioning is supported, i.e. in addition to the normal version selected by SATAN:, SATANNEW:, SATANOLD: and SATANTEST: may point to different directories and are selected by the new, old and test keywords, respectively, of the various shell scripts. Note, however, that also the PATH definition should reflect the chosen version.
| GSI | Biophysics | SATAN long write-up |
Last updated: M.Kraemer@gsi.de, 15-Mar-2006