New html files
[u/mrichter/AliRoot.git] / html / installation.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
2                "http://www.w3.org/TR/REC-html40/loose.dtd">
3 <HTML>
4 <HEAD>
5 <TITLE>Installation</TITLE>
6 <link rev="made" href="mailto:Federico.Carminati@cern.ch">
7 <STYLE>
8 BODY    {       
9         background:     #FFFFFF;
10         }       
11
12 COL, COLGROUP, TABLE, TBODY, TD, TR     {       
13         color:  black;
14         text-decoration:        none;
15         border-color:   black;
16         border-style:   none;
17         background:     #FFFFFF;
18         }                       
19
20 </STYLE>
21 <link rel="stylesheet" href="http://www.w3.org/StyleSheets/Core/Swiss" type="text/css">
22 </HEAD>
23
24 <BODY background=#FFFFFF>
25 <TABLE>
26 <TR>
27 <TD><img src="picts/MadHatter.gif" alt="ALICE Off-line Project Logo">
28 <TD><img src="picts/installation_name.gif" alt="Installation Name">
29 <TD><img src="picts/AliceLogo.gif" alt="ALICE Logo">
30 </TR>
31 </TABLE>
32
33 <h2>Installation</h2>
34
35 <ol> 
36 <p><li> Install <a href="http://root.cern.ch">ROOT</a> and define the
37 necessary variables correctly.
38
39 <p><li> Decide where the code will reside (from here on <i>directory</i>).
40
41 <p><li>Define the following global variables in the login script
42
43 <p><table align=centre borders=no>
44 <tr><th align=left>variable</th><th align=left>value</th></tr>
45 <tr><td width=30%>ALICE        </td><td> <i>directory</i>
46 <tr><td>ALICE_LEVEL             </td><td> pro </td></tr>
47 <tr><td>ALICE_ROOT              </td><td> $ALICE/$ALICE_LEVEL </td></tr>
48 <tr><td>ALICE_TARGET            </td><td> `uname` 
49 (i.e. result of the Unix <b>uname</b> command)</td></tr>
50 <tr><td colspan=2><i><center>on all systems but HP-UX</center></i></td></tr>
51 <tr><td>LD_LIBRARY_PATH</td>
52 <td>$ALICE_ROOT/lib/tgt_${ALICE_TARGET}\:$LD_LIBRARY_PATH</td></tr>
53 <tr><td colspan=2><i><center>on HP-UX</center></i></td></tr>
54 <tr><td>SHLIB_PATH</td>
55 <td>$ALICE_ROOT/lib/tgt_${ALICE_TARGET}\:$SHLIB_PATH</td></tr>
56 <tr><td>PATH</td>
57 <td> $PATH\:$ALICE_ROOT/bin/tgt_${ALICE_TARGET} </td></tr>
58 </table>
59
60 <p>At this point you should logout, login again and check that the symbols
61 are set correctly.
62
63 <p><li> Retrieve the AliRoot code. There are two ways to do this:
64
65 <ul> 
66 <p><li> <em>From a tar file</em>. This is the preferred way for those who
67 do not have an internet connection to the <em>cvs</em> server from the
68 machine where the code has to be installed. The <a
69 href="ftp://pcepaip01.cern.ch/pub">files</a> containing the latest release
70 should be brought on the target machine. Three files are offered:
71
72 <p><table align=center borders=no>
73 <tr><th align=left>File<th align=left>Content</tr>
74 <tr><td align=center colspan=2><em>Either</em></tr>
75 <tr><td>AliOffline<i>MM.mm-pp</i>.tar.gz
76 <td>Code and the data files of ALICE Off-line</tr>
77 <tr><td align=center colspan=2><em>Or</em></tr>
78 <tr><td>AliLibs<i>MM.mm-pp</i>.tar.gz
79 <td>Code and the data files of the auxiliary libraries</tr>
80 <tr><td>AliRoot<i>MM.mm-pp</i>.tar.gz
81 <td>All the code and the data files of the AliRoot system</tr>
82 </table>
83
84 <p> <i>MM.mm-pp</i> is the number of the latest <i>M</i>ajor and
85 <i>m</i>inor version and the <i>p</i>atch number. Please refer to the
86 README file found in this directory for further information on file
87 content. The file(s) have to be unpacked into the $ALICE directory via the
88 command:
89
90 <p><pre>$ gtar xvfz Ali[...].tar.gz</pre>
91
92
93 <p><li> <em>From cvs remote cvs server</em>. This method has the advantage
94 that new patches can be incrementally retrieved and installed via internet.
95 At the moment the problem is that the version of cvs currently installed at
96 CERN (1.09) does not support well binary files. Therefore some data files
97 will be missing with this download mechanism, and these will have to be
98 fetched <em>by hand</em>. The setup of the access to the remote cvs server
99 is described in the <a href="management.html">Code Management</a> section. The
100 code is dowloaded via the command:
101
102 <p><pre>
103 $ cd $ALICE
104 $ cvsa co -d pro AliRoot
105 </pre>
106
107 </ul>
108
109 <p><li>install the CERN library part
110
111 <p><pre>
112 $ cd $ALICE_ROOT
113 $ gmake cernlibs
114 </pre>
115
116 <p><li>Install the ALICE specific software
117
118 <p><pre>
119 $ cd $ALICE_ROOT
120 $ gmake
121 </pre>
122
123 <p><li>Copy the file $ALICE_ROOT/.rootrc to your home directory
124
125 <p><li>Change to your home directory and run the code
126
127 <p>
128 <pre>
129 $ cd
130 $ aliroot
131
132 <output from aliroot>
133
134 root [1] .x menu.C
135 </pre>
136 </ol>
137
138 <hr>
139 <address>
140           <script language="JavaScript">
141              document.write("Last modified "+ document.lastModified)
142              // end of script -->
143           </script>
144 by <a href="mailto:Federico.Carminati@cern.ch">Federico Carminati</a>
145 </address>
146 </BODY>
147 </HTML>