[u/mrichter/AliRoot.git] / html / installation.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
               "http://www.w3.org/TR/REC-html40/loose.dtd">
<HTML>
<HEAD>
<TITLE>Installation</TITLE>
<link rev="made" href="mailto:Federico.Carminati@cern.ch">
<STYLE>
BODY	{	
	background:	#FFFFFF;
	}	

COL, COLGROUP, TABLE, TBODY, TD, TR	{	
	color:	black;
	text-decoration:	none;
	border-color:	black;
	border-style:	none;
	background:	#FFFFFF;
	}			

</STYLE>
<link rel="stylesheet" href="http://www.w3.org/StyleSheets/Core/Swiss" type="text/css">
</HEAD>

<BODY background=#FFFFFF>
<TABLE>
<TR>
<TD><img src="picts/MadHatter.gif" alt="ALICE Off-line Project Logo">
<TD><img src="picts/installation_name.gif" alt="Installation Name">
<TD><img src="picts/AliceLogo.gif" alt="ALICE Logo">
</TR>
</TABLE>

<h2>Installation</h2>

<ol> 
<p><li> Install <a href="http://root.cern.ch">ROOT</a> and define the
necessary variables correctly.

<p><li> Decide where the code will reside (from here on <i>directory</i>).

<p><li>Define the following global variables in the login script

<p><table align=centre borders=no>
<tr><th align=left>variable</th><th align=left>value</th></tr>
<tr><td width=30%>ALICE	       </td><td> <i>directory</i>
<tr><td>ALICE_LEVEL		</td><td> pro </td></tr>
<tr><td>ALICE_ROOT		</td><td> $ALICE/$ALICE_LEVEL </td></tr>
<tr><td>ALICE_TARGET		</td><td> `uname` 
(i.e. result of the Unix <b>uname</b> command)</td></tr>
<tr><td colspan=2><i><center>on all systems but HP-UX</center></i></td></tr>
<tr><td>LD_LIBRARY_PATH</td>
<td>$ALICE_ROOT/lib/tgt_${ALICE_TARGET}\:$LD_LIBRARY_PATH</td></tr>
<tr><td colspan=2><i><center>on HP-UX</center></i></td></tr>
<tr><td>SHLIB_PATH</td>
<td>$ALICE_ROOT/lib/tgt_${ALICE_TARGET}\:$SHLIB_PATH</td></tr>
<tr><td>PATH</td>
<td> $PATH\:$ALICE_ROOT/bin/tgt_${ALICE_TARGET} </td></tr>
</table>

<p>At this point you should logout, login again and check that the symbols
are set correctly.

<p><li> Retrieve the AliRoot code. There are two ways to do this:

<ul> 
<p><li> <em>From a tar file</em>. This is the preferred way for those who
do not have an internet connection to the <em>cvs</em> server from the
machine where the code has to be installed. The <a
href="ftp://pcepaip01.cern.ch/pub">files</a> containing the latest release
should be brought on the target machine. Three files are offered:

<p><table align=center borders=no>
<tr><th align=left>File<th align=left>Content</tr>
<tr><td align=center colspan=2><em>Either</em></tr>
<tr><td>AliOffline<i>MM.mm-pp</i>.tar.gz
<td>Code and the data files of ALICE Off-line</tr>
<tr><td align=center colspan=2><em>Or</em></tr>
<tr><td>AliLibs<i>MM.mm-pp</i>.tar.gz
<td>Code and the data files of the auxiliary libraries</tr>
<tr><td>AliRoot<i>MM.mm-pp</i>.tar.gz
<td>All the code and the data files of the AliRoot system</tr>
</table>

<p> <i>MM.mm-pp</i> is the number of the latest <i>M</i>ajor and
<i>m</i>inor version and the <i>p</i>atch number. Please refer to the
README file found in this directory for further information on file
content. The file(s) have to be unpacked into the $ALICE directory via the
command:

<p><pre>$ gtar xvfz Ali[...].tar.gz</pre>


<p><li> <em>From cvs remote cvs server</em>. This method has the advantage
that new patches can be incrementally retrieved and installed via internet.
At the moment the problem is that the version of cvs currently installed at
CERN (1.09) does not support well binary files. Therefore some data files
will be missing with this download mechanism, and these will have to be
fetched <em>by hand</em>. The setup of the access to the remote cvs server
is described in the <a href="management.html">Code Management</a> section. The
code is dowloaded via the command:

<p><pre>
$ cd $ALICE
$ cvsa co -d pro AliRoot
</pre>

</ul>

<p><li>install the CERN library part

<p><pre>
$ cd $ALICE_ROOT
$ gmake cernlibs
</pre>

<p><li>Install the ALICE specific software

<p><pre>
$ cd $ALICE_ROOT
$ gmake
</pre>

<p><li>Copy the file $ALICE_ROOT/.rootrc to your home directory

<p><li>Change to your home directory and run the code

<p>
<pre>
$ cd
$ aliroot

<output from aliroot>

root [1] .x menu.C
</pre>
</ol>

<hr>
<address>
          <script language="JavaScript">
             document.write("Last modified "+ document.lastModified)
             // end of script -->
          </script>
by <a href="mailto:Federico.Carminati@cern.ch">Federico Carminati</a>
</address>
</BODY>
</HTML>
Commit	Line	Data
14c31136	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>