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

Diff of /trunk/doc/install/srclinux.tex

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 3334 by jfenwick, Thu Oct 28 05:26:37 2010 UTC revision 3335 by jfenwick, Wed Nov 3 05:02:57 2010 UTC
# Line 13  Line 13 
13  \section{Installing from source for \linux}  \section{Installing from source for \linux}
14  \label{sec:srclinux}  \label{sec:srclinux}
15    
16  \subsection{Preliminaries}  \subsection{Dependencies}
17    
18  The following instructions assume you are running the \file{bash} shell.  The following instructions assume you are running the \file{bash} shell.
19  Comments are indicated with \# characters.  Comments are indicated with \# characters.
# Line 36  make sure to get the development package Line 36  make sure to get the development package
36  \end{itemize}  \end{itemize}
37    
38    
39    \subsection{Preliminaries}
40    \label{sec:prelim}
41  You will also need a copy of the \esfinley source code.  You will also need a copy of the \esfinley source code.
42  If you retrieved the source using subversion, don't forget that one can use the export command instead of checkout to get a smaller copy.  If you retrieved the source using subversion, don't forget that one can use the export command instead of checkout to get a smaller copy.
43  For additional visualization functionality see Section~\ref{sec:addfunc}.  For additional visualization functionality see Section~\ref{sec:addfunc}.
# Line 59  There are a number of uses of the \file{ Line 60  There are a number of uses of the \file{
60  If your computer has multiple cores/processors you can speed up the compilation process by adding -j 2 after the make command.  If your computer has multiple cores/processors you can speed up the compilation process by adding -j 2 after the make command.
61  For example to use all processors on a computer with 4 cores:  For example to use all processors on a computer with 4 cores:
62  \begin{shellCode}  \begin{shellCode}
63   make  make
64  \end{shellCode}  \end{shellCode}
65  becomes  becomes
66  \begin{shellCode}  \begin{shellCode}
67   make -j 4  make -j 4
68  \end{shellCode}  \end{shellCode}
69    
70  \begin{shellCode}  \begin{shellCode}
# Line 317  Change to the directory containing your Line 318  Change to the directory containing your
318    
319  \begin{shellCode}  \begin{shellCode}
320  cd escript.d/scons  cd escript.d/scons
321  cp linux_standalone_options_example.py YourMachineName_options.py  cp TEMPLATE_linux.py YourMachineName_options.py
322    
323  echo $PKG_ROOT  echo $PKG_ROOT
324  \end{shellCode}  \end{shellCode}
325  Where \texttt{YourMachineName} is the name of your computer as returned by the hostname command.  Where \texttt{YourMachineName} is the name of your computer as returned by the hostname command.
326  If the name contains non-alphanumeric characters, then you will need to replace them with underscores.  If the name contains non-alphanumeric characters, then you will need to replace them with underscores.
327  For example the options file for \texttt{bob-desktop} would be named \file{bob_desktop_options.py}.  For example the options file for \texttt{bob-desktop} would be named \file{bob_desktop_options.py}.
328    If you wish to build with OpenMP, MPI or configure other aspects of the system take a quick look at Section~\ref{sec:compilesrc}.
329    
330  Edit the options file and put the value of PKG_ROOT between the quotes in the PKG_ROOT= line.  
331  For example:  You will need to edit your options file and specify where to find boost and netcdf.
332  \begin{shellCode}  (replace \file{x/stand} with the path to \file{stand})
333  PKG_ROOT="/home/bob/stand/pkg"  
334  \end{shellCode}  \begin{python}
335    #boost_prefix = '/usr/local'
336    \end{python}
337    
338    should be
339    \begin{python}
340    boost_prefix = ['x/stand/pkg/boost/include/boost-1_39/', 'x/stand/pkg/boost/lib/']
341    \end{python}
342    
343    \begin{python}
344    #netcdf = True
345    \end{python}
346    
347    should be
348    \begin{python}
349    netcdf = True
350    \end{python}
351    
352    \begin{python}
353    #netcdf_prefix = '/usr/local'
354    \end{python}
355    
356    should be \begin{python}
357    netcdf_prefix = ['x/stand/pkg/netcdf/include/',
358                'x/stand/pkg/netcdf/lib/']}
359    \end{python}
360    
361    %
362    % Edit the options file and put the value of PKG_ROOT between the quotes in the PKG_ROOT= line.
363    % For example:
364    % \begin{shellCode}
365    % PKG_ROOT="/home/bob/stand/pkg"
366    % \end{shellCode}
367    
368  \begin{shellCode}  \begin{shellCode}
369  cd ../bin  cd ../bin
# Line 355  scons all_tests Line 389  scons all_tests
389  \end{shellCode}  \end{shellCode}
390    
391  \subsection{Cleaning up}  \subsection{Cleaning up}
392  Once you are satisfied, the \file{escript.d/build} and \file{\$PKG_ROOT/build} directories can be removed.  Once you are satisfied, the \file{escript.d/build} and \file{stand/build} directories can be removed.
393    
394  If you \emph{really} want to save space and do not wish to be able to edit or recompile \esfinley, you can remove the following:  If you \emph{really} want to save space and do not wish to be able to edit or recompile \esfinley, you can remove the following:
395  \begin{itemize}  \begin{itemize}
# Line 370  in the \file{escript.d} directory. Line 404  in the \file{escript.d} directory.
404  \end{itemize}  \end{itemize}
405  \item from the \file{pkg} directory:  \item from the \file{pkg} directory:
406  \begin{itemize}  \begin{itemize}
407  \item  \file{scons}, \file{scons-1.2.0}, \file{cmake-2.6.3} and \file{cmake}  \item  \file{scons}, \file{scons-1.2.0}
408  \end{itemize}  \end{itemize}
409  \item \file{package\_src}\footnote{Do not remove this if you intend to redistribute.}.  \item \file{package\_src}\footnote{Do not remove this if you intend to redistribute.}.
410  \end{itemize}  \end{itemize}

Legend:
Removed from v.3334  
changed lines
  Added in v.3335

  ViewVC Help
Powered by ViewVC 1.1.26