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