1 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
2 |
% |
3 |
% Copyright (c) 2003-2009 by University of Queensland |
4 |
% Earth Systems Science Computational Center (ESSCC) |
5 |
% http://www.uq.edu.au/esscc |
6 |
% |
7 |
% Primary Business: Queensland, Australia |
8 |
% Licensed under the Open Software License version 3.0 |
9 |
% http://www.opensource.org/licenses/osl-3.0.php |
10 |
% |
11 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
12 |
|
13 |
\section{Linux binary installation} |
14 |
\label{sec:binlinux} |
15 |
|
16 |
\esfinley can be installed as a stand-alone bundle, containing all the required dependencies. |
17 |
Alternatively, if we have a package for your distribution you can use the standard tools to install. |
18 |
Please note, however, that the current binary packages do not support \openmp\footnote{This is due to a bug related to gcc 4.3.2.} or \mpi\footnote{Producing packages for \mpi requires knowing something about your computer's configuration.}. |
19 |
If you need these features you may need to compile \esfinley from source (see \Sec{sec:compilesrc} and \Sec{sec:compileescriptlinux}.) |
20 |
|
21 |
For more information on using the \filename{escript} command please see the User's Guide. |
22 |
|
23 |
If you are using Debian (5.0 - ``Lenny'') or Ubuntu (8.10-``Intrepid Ibex'', 9.04-``Jaunty Jackalope'') then see \Sec{sec:debian}. |
24 |
For other Linux distributions refer to \Sec{sec:standalonelinux}. |
25 |
|
26 |
\subsection{Debian 5.0(``Lenny''), Ubuntu 8.10(``Intrepid Ibex'') or 9.04(``Jaunty Jakalope'')}\label{sec:debian} |
27 |
|
28 |
At the time of this writing we only produce deb's for the i386 and amd64 architectures. |
29 |
The package file will be named \filename{escript-X-D_A.deb} where \texttt{X} is the version, \texttt{D} is either ``\texttt{lenny}'' or ``\texttt{jaunty}'' and \texttt{A} is the architecture. |
30 |
For example, \filename{escript-3.0-1-lenny_amd64.deb} would be the file for lenny (and intrepid) for 64bit processors. |
31 |
To install \esfinley download the appropriate \filename{.deb} file and execute the following commands as root (you need to be in the directory containing the file): |
32 |
\begin{shellCode} |
33 |
dpkg --unpack escript.deb |
34 |
aptitude install escript |
35 |
\end{shellCode} |
36 |
|
37 |
If you use sudo (for example on Ubuntu) enter the following instead: |
38 |
\begin{shellCode} |
39 |
sudo dpkg --unpack escript.deb |
40 |
sudo aptitude install escript |
41 |
\end{shellCode} |
42 |
|
43 |
This should install \esfinley and its dependencies on your system. |
44 |
Please notify the development team if something goes wrong. |
45 |
|
46 |
|
47 |
\subsection{Stand-alone bundle}\label{sec:standalonelinux} |
48 |
|
49 |
If there is no package available for your distribution, you may be able to use one of our stand alone bundles. |
50 |
These come in two parts: escript itself (\filename{escript_3.0_i386.tar.bz2}) and a group of required programs (\filename{escript-support_3.0_i386.tar.bz2}). For $64$-bit Intel and Amd processors substitute \texttt{amd64} for \texttt{i386}. |
51 |
\begin{shellCode} |
52 |
tar -xjf escript-support_3.0_i386.tar.bz2 |
53 |
tar -xjf escript_3.0_i386.tar.bz2 |
54 |
\end{shellCode} |
55 |
This will produce a directory called \filename{stand} which contains a stand-alone version of \esfinley and its dependencies. |
56 |
You can rename or move it as is convenient to you, no installation is required. |
57 |
Test your installation by running: |
58 |
\begin{shellCode} |
59 |
stand/escript.d/bin/escript |
60 |
\end{shellCode} |
61 |
This should give you a normal python shell. |
62 |
If you wish to save on typing you can add \filename{x/stand/escript.d/bin}\footnote{or whatever you renamed \texttt{stand} to.} to your \texttt{PATH} variable (where x is the absolute path to your install). |
63 |
|