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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 3942 - (show annotations)
Fri Jul 27 01:04:48 2012 UTC (6 years, 11 months ago) by jfenwick
File MIME type: application/x-tex
File size: 3811 byte(s)
Porting changes back from 3.3 release branch

1 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2 %
3 % Copyright (c) 2003-2012 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
19
20 For more information on using the \file{run-escript} command please see the User's Guide.
21
22 If you are using Debian~6.0(``Squeeze''), Ubuntu~10.4(``Lucid Lynx'') or greater, then see Section~\ref{sec:debian}.
23 For other linux distributions refer to Section~\ref{sec:standalonelinux}.
24
25 \subsection{Debian and Ubuntu}\label{sec:debian}
26
27 At the time of this writing we only produce deb's for the i386 and amd64 architectures.
28 The package file will be named \file{escript-X-D_A.deb} where \texttt{X} is the version, \texttt{D}
29 is the distribution codename (eg ``\texttt{squeeze}'' or ``\texttt{lucid}'') and \texttt{A} is the architecture.
30 For example, \file{escript-3.3-1-squeeze_amd64.deb} would be the file for squeeze for 64bit processors.
31 To install \esfinley download the appropriate \file{.deb} file and execute the following
32 commands as root (you need to be in the directory containing the file):
33
34 \begin{verse}
35 \textbf{(For users of Ubuntu~10.10 \textit{``Maverick Meercat''} or later)}\\
36 You will need to either install \texttt{aptitude}\footnote{Unless you are short on disk space \texttt{aptitude} is recommended} or replace use \texttt{apt-get} where this guide uses \texttt{aptitude}.
37 \begin{shellCode}
38 sudo apt-get install aptitude
39 \end{shellCode}
40 \end{verse}
41
42 \begin{shellCode}
43 dpkg --unpack escript*.deb
44 aptitude install escript
45 \end{shellCode}
46
47 Installing escript should not remove any packages from your system.
48 If aptitude suggests removing escript, then choose 'N'.
49 It should then suggest installing some dependencies choose 'Y' here.
50 If it suggests removing \texttt{escript-noalias} then agree.
51
52 If you use sudo (for example on Ubuntu) enter the following instead:
53 \begin{shellCode}
54 sudo dpkg --unpack escript*.deb
55 sudo aptitude install escript
56 \end{shellCode}
57
58 This should install \esfinley and its dependencies on your system.
59 Please notify the development team if something goes wrong.
60
61 \subsection{Stand-alone bundle}\label{sec:standalonelinux}
62
63 If there is no package available for your distribution, you may be able to use one of our stand alone bundles.
64 These come in two parts: escript itself (\file{escript_3.3_i386.tar.bz2}) and a group of required programs (\file{escript-support_3.0_i386.tar.bz2}) (Note that the support bundle is version~3.0 not 3.2) . For $64$-bit Intel and Amd processors substitute \texttt{amd64} for \texttt{i386}.
65 This point release uses the same support bundle as previous releases so if you already have it you don't need a new version.
66 \begin{shellCode}
67 tar -xjf escript-support_3.0_i386.tar.bz2
68 tar -xjf escript_3.3_i386.tar.bz2
69 \end{shellCode}
70 This will produce a directory called \file{stand} which contains a stand-alone version of \esfinley and its dependencies.
71 You can rename or move it as is convenient to you, no installation is required.
72 Test your installation by running:
73 \begin{shellCode}
74 stand/escript.d/bin/run-escript
75 \end{shellCode}
76 This should give you a normal python shell.
77 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).
78

  ViewVC Help
Powered by ViewVC 1.1.26