1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
4 <TITLE> Code Management and Installation for AliRoot </TITLE>
5 <!-- Changed by: Yiota Foka, 19-Mar-1999 -->
6 <STYLE TYPE="text/css">
8 H2 { color: red ; font-size: 22pt }
9 H3 { color: blue ; font-size: 20pt }
10 H4 { color: violet; font-size: 18pt }
11 H5 { color: olive ; font-size: 16pt }
12 H6 { color: maroon; font-size: 14pt }
13 TABLE { font-size: 14pt }
16 <!-- Header material -->
17 <body background="../picts/back.gif" text=black>
18 <basefont face="verdana,arial,helvetica,sans-serif">
20 <!-- Header material -->
21 <table border=0 cellpadding=5 cellspacing=0 width="100%">
23 <td align=left width=20%> <img src="../picts/MadHatter.jpg" HEIGHT=130 WIDTH=130>
27 Code Management and Installation for AliRoot
28 <td align=right width=20%> <img src="../picts/Logo.gif">
32 <td colspan=3 align=right><font size="-1">
33 <script language="JavaScript">
34 document.write("Last modified "+ document.lastModified)
43 <BODY TEXT="#000000" BGCOLOR="#FFFFFF"
44 LINK="#0000FF" VLINK="#551A8B" ALINK="#FF0000">
52 <LI><A HREF="#1">Code management</A>
53 <LI><A HREF="#2">Release Policy</A>
54 <LI><A HREF="#3">Porting and availability</A>
55 <LI><A HREF="#4">Installation</A>
60 <H2><A NAME="1">1. Code Management</A></H2>
62 <P>The code is maintained under <a href="http://www.cyclic.com/">cvs</a>.
63 The cvs repository will be made public soon.
66 <!======================================================================>
69 <H2>2. Release Policy</H2>
71 <P>It is the responsibility of the different detector groups to maintain
72 and develop the different modules describing the Alice detectors. The
73 modular structure of the code has been developed to reflect this fact, and
74 changes in one module should not affect the others.
76 <P>New modules can be provided, incorporated and tested within the AliRoot
77 framework. These should then be submitted and incorporated into the
78 centrally maintained filebase.
80 <P>Any query or proposal for a change in the code can be addressed to the
81 <A HREF="mailto:alice-sim@alice-lb.cern.ch">Alice Simulation Mailing
82 List</A>. Portions of code have to be sent to the <A
83 HREF="mailto:Frederico.Carminati@cern.ch">current maintainer</A> who has
84 the task to introduce them in the official code for the next release.
86 <P>For the moment we do not use any version control for the code. It is
87 expected that a version control mechanism will be soon put in place in the
88 framework of the Alice Offline Software. Then AliRoot package will be
89 maintained via this control mechanism.
91 <P> We expect the code to evolve rapidly, as the TDR studies will require
92 frequent modifications and updates, so we have decided to reserve the right
93 to release a new version up to once a week.
95 <P>The AliRoot framework will support an <A HREF="
96 http://home.cern.ch/~ivana/AliceG4/AG4Presentations/AliceWeekMar99/index.html">
97 interface</A> to Geant4. Reconstruction and analysis of simulated events
98 are also supported by AliRoot.
100 <!======================================================================>
103 <H2>3. Status and availability</H2>
105 <P>The code is installed at CERN on the
106 <a href="http://wwwinfo.cern.ch/dis/ues/services/ion/service.html">ION
107 Work Group Server</a>. The ALICE environment is automatically setup at login
108 time, so users can immediately start using the code. Both a HP-UX and a Linux
109 versions are installed.
111 <p>All the code and the related material is available in the directory
112 pointed by the variable $ALICE_ROOT. The AliRoot package needs the few
113 packages and routines from the CERN Library. These are contained in a
114 reduced subset of the CERN Library available from the ALICE distribution.
116 <p>Users who do not have access to afs or who want to have a local installation
117 of the ALICE software should install the code locally according to the
118 procedure described in the next chapter.
120 <p>As of writing the code has been tested on HP-UX 10.2, Linux 5.1, DEC OSF
121 and Solaris. Porting to other platforms and compilers will take place.
125 <!======================================================================>
127 <A NAME="4"><H2>4. Installation Procedure </H2>
129 <p>In order to install the code, the following steps should be performed:
133 <p><li>Install <a href="http://root.cern.ch">ROOT</a> and define the necessary
136 <p><li>Decide in which directory you will install the ALICE sofware. We will
137 indicate it with <i>directory</i>
139 <p><li>Define the following global variables in the login script
141 <p><table align=centre border=yes>
142 <tr><th>variable</th><th>value</th></tr>
143 <tr><td width=30%>ALICE </td><td> <i>directory</i>
144 <tr><td>ALICE_LEVEL </td><td> pro </td></tr>
145 <tr><td>ALICE_ROOT </td><td> $ALICE/$ALICE_LEVEL </td></tr>
146 <tr><td>ALICE_TARGET </td><td> `uname`
147 (i.e. result of the Unix <b>uname</b> command)</td></tr>
149 LD_LIBRARY_PATH<BR>SHLIB_PATH </td>
150 <td> $LD_LIBRARY_PATH\:$ALICE_ROOT/lib (on all systems) <br>
151 $SHLIB_PATH\:$ALICE_ROOT/lib (on hpux) </td></tr>
153 <tr><td>PATH </td><td> $PATH\:$ALICE_ROOT/bin </td></tr>
156 <p>At this point you should logout, login again and check that the symbols
159 <p><li><u><b>Either</b></u>
161 <li>Get the file <a href="file:/afs/cern.ch/alice/offline/dist/AliOffline3.01.tar.gz">/afs/cern.ch/alice/offline/dist/AliOffline3.01.tar.gz</a>
163 <p><li>Unpack it with
168 $ gtar xvfz AliOffline3.01.tar.gz
176 <p><a href="file:/afs/cern.ch/alice/offline/dist/AliRoot3.01.tar.gz">/afs/cern.ch/alice/offline/dist/AliRoot3.01.tar.gz</a>
177 <br><a href="file:/afs/cern.ch/alice/offline/dist/AliLibs3.01.tar.gz">/afs/cern.ch/alice/offline/dist/AliLibs3.01.tar.gz</a>
179 <p><li>Unpack them with
184 $ gtar xvfz AliRoot3.01.tar.gz
185 $ gtar xvfz AliLibs3.01.tar.gz
189 <p><li>install the CERN library part
196 <p><li>Install the ALICE specific software
203 <p><li>Copy the file $ALICE_ROOT/.rootrc to your home directory
205 <p><li>Change to your home directory and run the code
212 <output from aliroot>
218 <h3>Notice for Linux users</h3>
220 <p>AliRoot requires the compiler system egcs 1.1.1 or later. Unfortunately
221 the location of the include files is dependent on the compiler version on
222 Linux. While g++ knows the location of the files relative to its own
223 version, but this is not the case for the makedepend, that should be told
224 where include files are. This is accomplished by the DEPINC variable in the
227 <p>In case several error message appear during the make phase, complaining
228 for include files not found, the list of include directories in DEPINC
229 should be compared with the standard list of the compiler, that can be
230 found out with the following commands:
237 <p>and looking at the output between the lines:
240 #include <...> search starts here:
249 <!===========================================================================>
255 <A HREF="mailto:Yiota.Foka@cern.ch">Yiota Foka</A>
258 <A HREF="http://www1.cern.ch/ALICE">ALICE home,</A>
259 <A HREF="http://www1.cern.ch/ALICE/Projects/offline">Offline home</A>