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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 2923 - (show annotations)
Thu Feb 4 04:05:36 2010 UTC (9 years, 6 months ago) by jfenwick
File MIME type: application/x-tex
File size: 3930 byte(s)
Bringing non-release specific things from stage3.1 r2922 back to trunk

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{run-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 Ubuntu 9.10-``karmic koala'' see \Sec{sec:karmic}.
25 For other Linux distributions refer to \Sec{sec:standalonelinux}.
26
27 \subsection{Debian 5.0(``Lenny''), Ubuntu 8.10(``Intrepid Ibex'') or 9.04(``Jaunty Jakalope'')}\label{sec:debian}
28
29 At the time of this writing we only produce deb's for the i386 and amd64 architectures.
30 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.
31 For example, \filename{escript-3.0-1-lenny_amd64.deb} would be the file for lenny (and intrepid) for 64bit processors.
32 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):
33 \begin{shellCode}
34 dpkg --unpack escript*.deb
35 aptitude install escript
36 \end{shellCode}
37
38 If you use sudo (for example on Ubuntu) enter the following instead:
39 \begin{shellCode}
40 sudo dpkg --unpack escript*.deb
41 sudo aptitude install escript
42 \end{shellCode}
43
44 This should install \esfinley and its dependencies on your system.
45 Please notify the development team if something goes wrong.
46
47 \subsection{Ubuntu 9.10(``Karmic Koala'')}\label{sec:karmic}
48
49 You will need to download either \filename{escript-noalias-3.1-1-lenny_i386.deb} (for 32bit processors) or \filename{escript-noalias-3.1-1-lenny_amd64.deb} (for 64bit processors).
50
51 Type the following in the directory containing the file.
52 \begin{shellCode}
53 sudo dpkg --unpack escript-noalias*.deb
54 sudo aptitude install escript
55 \end{shellCode}
56
57
58
59 \subsection{Stand-alone bundle}\label{sec:standalonelinux}
60
61 If there is no package available for your distribution, you may be able to use one of our stand alone bundles.
62 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}.
63 \begin{shellCode}
64 tar -xjf escript-support_3.0_i386.tar.bz2
65 tar -xjf escript_3.0_i386.tar.bz2
66 \end{shellCode}
67 This will produce a directory called \filename{stand} which contains a stand-alone version of \esfinley and its dependencies.
68 You can rename or move it as is convenient to you, no installation is required.
69 Test your installation by running:
70 \begin{shellCode}
71 stand/escript.d/bin/run-escript
72 \end{shellCode}
73 This should give you a normal python shell.
74 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).
75

  ViewVC Help
Powered by ViewVC 1.1.26