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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 6651 - (hide annotations)
Wed Feb 7 02:12:08 2018 UTC (17 months, 1 week ago) by jfenwick
File MIME type: application/x-tex
File size: 4701 byte(s)
Make everyone sad by touching all the files

Copyright dates update

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

  ViewVC Help
Powered by ViewVC 1.1.26