README

   1 AliRoot
   2 -------
   3
   4 ########################### Release version 3.01 ##############################
   5
   6 Last update Tue Jun 15 08:10:40 1999 - Federico Carminati
   7
   8 This is the Version 3.01 of the ALICE simulation and reconstruction
   9 software. This code will be released after the May ALICE Offline
  10 Meeting. It is intended to offer a general purpose framework for ALICE
  11 simulation and reconstruction. The program should not be considered
  12 complete, and we are relying on the feed-back from users to correct bugs
  13 and provide improvements.
  14
  15 The simulation program is based on GEANT3.21. A special version of the
  16 GEANT library and a mini-CERN Library are needed to run this code.
  17
  18 Installation
  19 ------------
  20
  21 - Install ROOT and define the ROOTSYS symbol correctly.
  22
  23 - Decide in which directory you will install the ALICE sofware. We will
  24 indicate it with <directory>
  25
  26 - Define the following global variables in the login script
  27
  28 ALICE                   = <directory>
  29 ALICE_LEVEL             = pro
  30 ALICE_ROOT              = $ALICE/$ALICE_LEVEL
  31 ALICE_TARGET            = `uname`
  32 LD_LIBRARY_PATH         = $LD_LIBRARY_PATH\:$ALICE_ROOT/lib (on all systems)
  33 SHLIB_PATH              = $SHLIB_PATH\:$ALICE_ROOT/lib (on hpux)
  34 PATH                    = $PATH\:$ALICE_ROOT/bin
  35
  36 At this point you should logout, login again and check that the symbols are
  37 set correctly
  38
  39 EITHER
  40 ======
  41
  42 - Get the file /afs/cern.ch/alice/offline/dist/AliOffline3.01.tar.gz
  43
  44 - Unpack it with
  45
  46 $ cd $ALICE
  47 $ gtar xvfz AliOffline3.01.tar.gz
  48
  49 OR
  50 ==
  51
  52 - Get the files
  53
  54       /afs/cern.ch/alice/offline/dist/AliRoot3.01.tar.gz (AliRoot code)
  55       /afs/cern.ch/alice/offline/dist/AliLibs3.01.tar.gz (minicern code)
  56
  57 THEN PROCEED WITH
  58 =================
  59
  60 - install the CERN library part
  61
  62 $ cd $ALICE_ROOT
  63 $ gmake cernlibs
  64
  65 - Install the ALICE specific software
  66
  67 $ cd $ALICE_ROOT
  68 $ gmake
  69
  70 - Copy the file $ALICE_ROOT/.rootrc to your home directory
  71
  72 - run the code
  73
  74 $ aliroot
  75
  76 root [1] .x menu.C
  77
  78
  79 Notice for Linux users
  80 ======================
  81
  82 AliRoot requires the compiler system egcs 1.1.1 or later. Unfortunately the
  83 location of the include files is dependent on the compiler version on Linux.
  84 While g++ knows the location of the files relative to its own version, but
  85 this is not the case for the makedepend, that should be told where include
  86 files are. This is accomplished by the DEPINC variable in the file
  87 $ALIROOT/conf.
  88
  89 In case several error message appear during the make phase, complaining for
  90 include files not found, the list of include directories in DEPINC should
  91 be compared with the standard list of the compiler, that can be found out
  92 with the following commands:
  93
  94 touch dummy.cxx
  95 g++ -v dummy.cxx
  96
  97 and looking at the output between the lines:
  98
  99 #include <...> search starts here:
 100 .
 101 .
 102 .
 103 .
 104 End of search list.
 105
 106
 107 List of changes
 108 ===============
 109
 110 Sun Mar 21 12:38:38 CET 1999 ==================================================
 111
 112 -------------------------------------------------------------------------------
 113 AliRun.cxx
 114 removed AliDetector::FinishEvent call from AliRun::FinishRun
 115
 116 -------------------------------------------------------------------------------
 117 Makefile.hpux
 118 added +Onolimit to the optimisation on the hp to avoid warning messages
 119
 120 -------------------------------------------------------------------------------
 121 TOPDIR changed to ALITOP as it should be in this README file.
 122
 123 Wed Mar 24 15:44:49 CET 1999 ==================================================
 124
 125 -------------------------------------------------------------------------------
 126 SGI Makefile corrected
 127
 128 -------------------------------------------------------------------------------
 129 Make-macros corrected to include the ITS*.det files in the distribution
 130
 131 -------------------------------------------------------------------------------
 132 Code of PHOSv2 introduced, thanks to M. Volkov
 133
 134 Thu Mar 25 21:19:52 CET 1999 ==================================================
 135
 136 -------------------------------------------------------------------------------
 137 Change the load order in Make-macros
 138
 139 Wed Apr  7 09:25:51 CEST 1999 =================================================
 140
 141 -------------------------------------------------------------------------------
 142 AliTPC.cxx, AliTPCv2.cxx, AliTPCSecGeo.h, GeantPatch.F
 143
 144 The drift gas parameters updated using the recent numbers from A.Sharma.
 145 M.Kowalski
 146
 147 Thu Apr  8 16:08:12 CEST 1999 =================================================
 148
 149 -------------------------------------------------------------------------------
 150 Slight changes to M.Volkov files to correct some syntactical problems
 151
 152 -------------------------------------------------------------------------------
 153 Changed common_ to G..._t in TGeant3.h to be compatible with P.Murat, CDF.
 154
 155 Fri Apr  9 08:06:21 CEST 1999 =================================================
 156
 157 -------------------------------------------------------------------------------
 158 Restructuration of TGeant3. Common addresses are now returned by access
 159 functions and they are all private.
 160
 161 Fri Apr 20 08:06:21 CEST 1999 =================================================
 162
 163 -------------------------------------------------------------------------------
 164 Introduction of the cvs repository. Now all changes are maintained via cvs.