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

Revision 3335 - (hide annotations)
Wed Nov 3 05:02:57 2010 UTC (9 years, 5 months ago) by jfenwick
File MIME type: application/x-tex
File size: 3792 byte(s)
Fix the launcher so that it can give an environment even if buildvars is not present.
Environment now includes scons for standalone builds.
Fixes and cleanup for the install documentation.
scons TEMPLATES updated to define the optionfile version by default.

...mumble
finley no longer imports escript into the default namespace
...

 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 6 % 7 % Primary Business: Queensland, Australia 8 % Licensed under the Open Software License version 3.0 9 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 19 jfenwick 3335 20 jfenwick 3322 For more information on using the \file{run-escript} command please see the User's Guide. 21 jfenwick 2294 22 jfenwick 3335 If you are using Debian~5.0(Lenny''), Ubuntu~8.10(Intrepid Ibex'') or greater, then see Section~\ref{sec:debian}. 23 For other linux distributions refer to Section~\ref{sec:standalonelinux}. 24 jfenwick 2294 25 jfenwick 3335 \subsection{Debian and Ubuntu}\label{sec:debian} 26 jfenwick 2529 27 jfenwick 2568 At the time of this writing we only produce deb's for the i386 and amd64 architectures. 28 jfenwick 3335 The package file will be named \file{escript-X-D_A.deb} where \texttt{X} is the version, \texttt{D} is the distribution codename (eg \texttt{lenny}'' or \texttt{jaunty}'') and \texttt{A} is the architecture. 29 For example, \file{escript-3.0-1-lenny_amd64.deb} would be the file for lenny for 64bit processors. 30 jfenwick 3322 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): 31 jfenwick 3335 32 \begin{verse} 33 \textbf{(For users of Ubuntu~10.10 \textit{Maverick Meercat''} only)}\\ 34 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}. 35 jfenwick 2294 \begin{shellCode} 36 jfenwick 3335 sudo apt-get install aptitude 37 \end{shellCode} 38 \end{verse} 39 40 \begin{shellCode} 41 jfenwick 2923 dpkg --unpack escript*.deb 42 caltinay 2547 aptitude install escript 43 jfenwick 2294 \end{shellCode} 44 45 jfenwick 3335 Installing escript should not remove any packages from your system. 46 If aptitude suggests removing escript, then choose 'N'. 47 It should then suggest installing some dependencies choose 'Y' here. 48 If it suggests removing escript-noalias then agree. 49 50 caltinay 2547 If you use sudo (for example on Ubuntu) enter the following instead: 51 jfenwick 2294 \begin{shellCode} 52 jfenwick 2923 sudo dpkg --unpack escript*.deb 53 jfenwick 2294 sudo aptitude install escript 54 \end{shellCode} 55 56 caltinay 2536 This should install \esfinley and its dependencies on your system. 57 Please notify the development team if something goes wrong. 58 jfenwick 2294 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 3335 These come in two parts: escript itself (\file{escript_3.2_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}. 63 This point release uses the same support bundle as previous releases so if you already have it you don't need a new version. 64 jfenwick 2317 \begin{shellCode} 65 jfenwick 2602 tar -xjf escript-support_3.0_i386.tar.bz2 66 jfenwick 3335 tar -xjf escript_3.2_i386.tar.bz2 67 jfenwick 2317 \end{shellCode} 68 jfenwick 3322 This will produce a directory called \file{stand} which contains a stand-alone version of \esfinley and its dependencies. 69 caltinay 2547 You can rename or move it as is convenient to you, no installation is required. 70 jfenwick 2317 Test your installation by running: 71 \begin{shellCode} 72 jfenwick 2923 stand/escript.d/bin/run-escript 73 jfenwick 2317 \end{shellCode} 74 caltinay 2547 This should give you a normal python shell. 75 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). 76 jfenwick 2317