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>