| 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 |
|
Parent Directory
| 
Revision Log