/[escript]/trunk/doc/install/binlinux.tex
ViewVC logotype

Contents of /trunk/doc/install/binlinux.tex

Parent Directory Parent Directory | Revision Log Revision Log


Revision 2881 - (show annotations)
Thu Jan 28 02:03:15 2010 UTC (9 years, 4 months ago) by jfenwick
File MIME type: application/x-tex
File size: 3459 byte(s)
Don't panic.
Updating copyright stamps

1 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2 %
3 % Copyright (c) 2003-2010 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

  ViewVC Help
Powered by ViewVC 1.1.26