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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 3322 - (hide annotations)
Thu Oct 28 05:26:37 2010 UTC (9 years, 5 months ago) by jfenwick
File MIME type: application/x-tex
File size: 3930 byte(s)
Adapt install guide to new style.
Simplify package building scripts to autodetect necessary info and build control file automatically.

1 jfenwick 2289 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2     %
3 jfenwick 2881 % Copyright (c) 2003-2010 by University of Queensland
4 jfenwick 2289 % 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 jfenwick 2294 \label{sec:binlinux}
15    
16 caltinay 2536 \esfinley can be installed as a stand-alone bundle, containing all the required dependencies.
17 jfenwick 2294 Alternatively, if we have a package for your distribution you can use the standard tools to install.
18 caltinay 2536 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 jfenwick 3322 If you need these features you may need to compile \esfinley from source (see Section~\ref{sec:compilesrc} and Section~\ref{sec:compileescriptlinux}.)
20 jfenwick 2294
21 jfenwick 3322 For more information on using the \file{run-escript} command please see the User's Guide.
22 jfenwick 2294
23 jfenwick 3322 If you are using Debian (5.0 - ``Lenny'') or Ubuntu (8.10-``Intrepid Ibex'', 9.04-``Jaunty Jackalope'') then see Section~\ref{sec:debian}.
24     For Ubuntu 9.10-``karmic koala'' see Section~\ref{sec:karmic}.
25     For other Linux distributions refer to Section~\ref{sec:standalonelinux}.
26 jfenwick 2294
27 caltinay 2536 \subsection{Debian 5.0(``Lenny''), Ubuntu 8.10(``Intrepid Ibex'') or 9.04(``Jaunty Jakalope'')}\label{sec:debian}
28 jfenwick 2529
29 jfenwick 2568 At the time of this writing we only produce deb's for the i386 and amd64 architectures.
30 jfenwick 3322 The package file will be named \file{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, \file{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 \file{.deb} file and execute the following commands as root (you need to be in the directory containing the file):
33 jfenwick 2294 \begin{shellCode}
34 jfenwick 2923 dpkg --unpack escript*.deb
35 caltinay 2547 aptitude install escript
36 jfenwick 2294 \end{shellCode}
37    
38 caltinay 2547 If you use sudo (for example on Ubuntu) enter the following instead:
39 jfenwick 2294 \begin{shellCode}
40 jfenwick 2923 sudo dpkg --unpack escript*.deb
41 jfenwick 2294 sudo aptitude install escript
42     \end{shellCode}
43    
44 caltinay 2536 This should install \esfinley and its dependencies on your system.
45     Please notify the development team if something goes wrong.
46 jfenwick 2294
47 jfenwick 2923 \subsection{Ubuntu 9.10(``Karmic Koala'')}\label{sec:karmic}
48 jfenwick 2294
49 jfenwick 3322 You will need to download either \file{escript-noalias-3.1-1-lenny_i386.deb} (for 32bit processors) or \file{escript-noalias-3.1-1-lenny_amd64.deb} (for 64bit processors).
50 jfenwick 2923
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 jfenwick 2529 \subsection{Stand-alone bundle}\label{sec:standalonelinux}
60 jfenwick 2294
61 jfenwick 2602 If there is no package available for your distribution, you may be able to use one of our stand alone bundles.
62 jfenwick 3322 These come in two parts: escript itself (\file{escript_3.0_i386.tar.bz2}) and a group of required programs (\file{escript-support_3.0_i386.tar.bz2}). For $64$-bit Intel and Amd processors substitute \texttt{amd64} for \texttt{i386}.
63 jfenwick 2317 \begin{shellCode}
64 jfenwick 2602 tar -xjf escript-support_3.0_i386.tar.bz2
65     tar -xjf escript_3.0_i386.tar.bz2
66 jfenwick 2317 \end{shellCode}
67 jfenwick 3322 This will produce a directory called \file{stand} which contains a stand-alone version of \esfinley and its dependencies.
68 caltinay 2547 You can rename or move it as is convenient to you, no installation is required.
69 jfenwick 2317 Test your installation by running:
70     \begin{shellCode}
71 jfenwick 2923 stand/escript.d/bin/run-escript
72 jfenwick 2317 \end{shellCode}
73 caltinay 2547 This should give you a normal python shell.
74 jfenwick 3322 If you wish to save on typing you can add \file{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 jfenwick 2317

  ViewVC Help
Powered by ViewVC 1.1.26