html/README

   1 AliRoot
   2 -------
   3
   4 Last update 18-March-1998 - Federico Carminati
   5
   6 This is the Version 3.00 of the ALICE simulation and reconstruction
   7 software. This code has been released on March 18 after the ALICE Week. It
   8 is intended to offer a general purpose framework for ALICE simulation and
   9 reconstruction. The program should not be considered complete, and we are
  10 relying on the feed-back from users to correct bugs and provide
  11 improvements.
  12
  13 The simulation program is based on GEANT3.21. A special version of the
  14 GEANT library and a mini-CERN Library are needed to run this code.
  15
  16 Installation
  17 ------------
  18
  19 Installation of the mini-CERN Library
  20
  21 - Take the file in /afs/cern.ch/alice/offline/AliCernlib.tar.gz and
  22 unpack it into a directory:
  23
  24 $ cd <topdir>
  25 $ gtar xvfz AliCernlib.tar.gz
  26
  27 - Edit the login file and assign the name of the directory where the file
  28 has been unpacked to the variable ALITOP
  29
  30 setenv ALITOP <topdir>
  31 setenv LD_LIBRARY_PATH $LD_LIBRARY_PATH\:$ALITOP/cern/new/lib\:. (on all systems)
  32 setenv SHLIB_PATH $SHLIB_PATH\:$ALITOP/cern/new/lib (on hpux)
  33
  34 or
  35
  36 export ALITOP=<topdir>
  37 export LD_LIBRARY_PATH=$LD_LIBRARY_PATH\:$ALITOP/cern/new/lib\:. (on all systems)
  38 export SHLIB_PATH=$SHLIB_PATH\:$ALITOP/cern/new/lib (on hpux)
  39
  40 - install the minicernlib:
  41
  42 cd $TOPDIR/cern/new/mkf
  43 gmake -f Makefile.<mysystem>
  44
  45 where <mysystem> = linux_egcs or linux_gcc or alpha or solaris or
  46 hpux. Some warning messages will appear during installation. At the end the
  47 $TOPDIR/cern/new/lib file should contain:
  48
  49 $ ls -1 $TOPDIR/cern/new/lib
  50 libgeant321.so
  51 libgxint321.so
  52 libminicern.so
  53
  54 (where .so is replaced by .sl in case of hpux).
  55
  56 - Take the file in /afs/cern.ch/alice/offline/AliRoot.tar.gz and
  57 unpack it into a directory that you have created:
  58
  59 $ cd <wherever_you_want>
  60 $ mkdir AliRoot
  61 $ cd AliRoot
  62 $ gtar xvfz ../AliRoot.tar.gz
  63
  64 - install the code
  65
  66 $ gmake -f Makefile.<mysystem> depend
  67 $ gmake -f Makefile.<mysystem>
  68
  69 - run the code
  70
  71 $ aliroot
  72