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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 3989 - (show annotations)
Tue Sep 25 02:21:54 2012 UTC (7 years ago) by jfenwick
File MIME type: application/x-tex
File size: 4620 byte(s)
More copyright fixes.
pyvisi traces removed.
Some install doco
1 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2 % Copyright (c) 2003-2012 by University of Queensland
3 % http://www.uq.edu.au
4 %
5 % Primary Business: Queensland, Australia
6 % Licensed under the Open Software License version 3.0
7 % http://www.opensource.org/licenses/osl-3.0.php
8 %
9 % Development until 2012 by Earth Systems Science Computational Center (ESSCC)
10 % Development since 2012 by School of Earth Sciences
11 %
12 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
13
14 \section{Linux binary installation}
15 \label{sec:binlinux}
16
17 \esfinley can be installed as a stand-alone bundle, containing all the required dependencies.
18 Alternatively, if we have a package for your distribution you can use the standard tools to install.
19
20
21 For more information on using the \file{run-escript} command please see the User's Guide.
22
23 If you are using Debian~6.0(``Squeeze''), Ubuntu~10.4(``Lucid Lynx'') or greater, then see Section~\ref{sec:debian}.
24 For other linux distributions refer to Section~\ref{sec:standalonelinux}.
25
26 \subsection{Debian and Ubuntu}\label{sec:debian}
27
28 We produce \texttt{.deb}s for the i386 and amd64 architectures for Debian stable(``squeeze'') and the
29 following Ubuntu releases:
30 \begin{itemize}
31 \item $11.10$ --- \emph{Oneiric} Ocelot
32 \item $12.04$ --- \emph{Precise} Pangolin (LTS)
33 \item $12.10$ --- \emph{Quantal} Queztal
34 \end{itemize}
35
36 The package file will be named \file{escript-X-D_A.deb} where \texttt{X} is the version, \texttt{D}
37 is the distribution codename (eg ``\texttt{squeeze}'' or ``\texttt{oneric}'') and \texttt{A} is the architecture.
38 For example, \file{escript-3.4-1-squeeze_amd64.deb} would be the file for squeeze for 64bit processors.
39 To install \esfinley download the appropriate \file{.deb} file and execute the following
40 commands as root (you need to be in the directory containing the file):
41
42 \begin{verse}
43 \textbf{(For Ubuntu users)}\\
44 You will need to either install \texttt{aptitude}\footnote{Unless you are short on disk space \texttt{aptitude} is recommended} or substitute \texttt{apt-get} where this guide uses \texttt{aptitude}.
45 \begin{shellCode}
46 sudo apt-get install aptitude
47 \end{shellCode}
48 \end{verse}
49
50 \begin{shellCode}
51 dpkg --unpack escript*.deb
52 aptitude install escript
53 \end{shellCode}
54
55 Installing escript should not remove any packages from your system.
56 If aptitude suggests removing escript, then choose 'N'.
57 It should then suggest installing some dependencies choose 'Y' here.
58 If it suggests removing \texttt{escript-noalias} then agree.
59
60 If you use sudo (for example on Ubuntu) enter the following instead:
61 \begin{shellCode}
62 sudo dpkg --unpack escript*.deb
63 sudo aptitude install escript
64 \end{shellCode}
65
66 This should install \esfinley and its dependencies on your system.
67 Please notify the development team if something goes wrong.
68
69 \subsection{Stand-alone bundle}\label{sec:standalonelinux}
70
71 If there is no package available for your distribution, you may be able to use one of our stand alone bundles.
72 You will need three pieces:
73 \begin{enumerate}
74 \item escript itself (\file{escript_3.4_i386.tar.bz2})\footnotemark\ from launchpad.net.\addtocounter{footnote}{-1}
75 \item the support bundle (\file{escript-support_3.0_i386.tar.bz2})\footnote{For $64$-bit Intel and Amd processors substitute \texttt{amd64} for \texttt{i386}.} from launchpad.net.
76 [This is the same support bundle as in previous releases. So you can reuse it if you have it already.]
77 \item sympy from \url{http://sympy.org} --- This is a new dependency and is not in the support bundle.
78 \end{enumerate}
79
80 Change directory to where you would like to install escript (We assume the three files are in this directory).
81
82 \begin{shellCode}
83 tar -xjf escript-support_3.0_i386.tar.bz2
84 tar -xjf escript_3.4_i386.tar.bz2
85
86 \end{shellCode}
87 This will produce a directory called \file{stand} which contains a stand-alone version of \esfinley and its dependencies.
88 Next, we need to build SymPy(replace 0.7.1 with the version of sympy you have):
89 \begin{shellCode}
90 eval `stand/escript.d/bin/run-escript -e`
91 tar -xzf sympy-0.7.1.tar.gz
92 cd sympy-0.7.1
93 python setup.py install --prefix ../stand/pkg/
94 \end{shellCode}
95
96 You can test your installation by running:
97 \begin{shellCode}
98 stand/escript.d/bin/run-escript
99 \end{shellCode}
100 This should give you a normal python shell.
101 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).
102
103 You may now remove the tar files and the sympy directory from your starting directory.

  ViewVC Help
Powered by ViewVC 1.1.26