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

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

Parent Directory Parent Directory | Revision Log Revision Log


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

Copyright dates update

1 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2 % Copyright (c) 2003-2018 by The University of Queensland
3 % http://www.uq.edu.au
4 %
5 % Primary Business: Queensland, Australia
6 % Licensed under the Apache License, version 2.0
7 % http://www.apache.org/licenses/LICENSE-2.0
8 %
9 % Development until 2012 by Earth Systems Science Computational Center (ESSCC)
10 % Development 2012-2013 by School of Earth Sciences
11 % Development from 2014 by Centre for Geoscience Computing (GeoComp)
12 %
13 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
14
15 \section{Installing from source for \macosx}
16 \label{sec:srcmac}
17
18 Before you start installing from source you will need \macosx development tools installed on your Mac.
19 This will ensure that you have the following available:
20 \begin{itemize}
21 \item \file{g++} and associated tools.
22 \item \file{make}
23 \end{itemize}
24
25 Here are the instructions on how to install these.
26 \begin{enumerate}
27 \item Insert the \macosx 10.5 (Leopard) DVD
28 \item Double-click on XcodeTools.mpkg, located inside Optional Installs/Xcode Tools
29 \item Follow the instructions in the Installer
30 \item Authenticate as the administrative user (the first user you create when setting up \macosx has administrator privileges by default)
31 \end{enumerate}
32
33
34 Once these tools have been installed, follow the linux instructions in Section~\ref{sec:prelim}.
35 If you do not know how to open a terminal on Mac, then just type terminal in the spotlight (search tool on the top of the right corner) and once found just click on it.
36
37 % You will also need a copy of the \esfinley source code.
38 % 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.
39 % For additional visualization functionality see Section~\ref{sec:addfunc}.
40 %
41 % These instructions will produce the following directory structure:
42 % \begin{itemize}
43 % \item[] \file{stand}: \begin{itemize}
44 % \item[] \file{escript.d}
45 % \item[] \file{pkg}
46 % \item[] \file{pkg_src}
47 % \item[] \file{build}
48 % \item[] \file{doc}
49 % \end{itemize}
50 % \end{itemize}
51 %
52 % The following instructions assume you are running the \file{bash} shell.
53 % Comments are indicated with \# characters.
54 %
55 % Open a terminal~\footnote{If you do not know how to open a terminal on Mac, then just type terminal in the spotlight (search tool on the top of the right corner) and once found just click on it.} and type
56 %
57 % \begin{shellCode}
58 % mkdir stand
59 % cd stand
60 % export PKG_ROOT=`pwd`/pkg
61 % \end{shellCode}
62 %
63 % Copy compressed source bundles into \file{stand/package_src}.
64 % Copy documentation files into \file{doc}.
65 %
66 % \begin{shellCode}
67 % mkdir packages
68 % mkdir build
69 % cd build
70 % tar -jxf ../pkg_src/Python-2.6.2.tar.bz2
71 % tar -jxf ../pkg_src/boost_1_39_0.tar.bz2
72 % tar -zxf ../pkg_src/scons-1.2.0.tar.gz
73 % tar -zxf ../pkg_src/numpy-1.3.0.tar.gz
74 % tar -zxf ../pkg_src/netcdf-4.0.tar.gz
75 % tar -zxf ../pkg_src/matplotlib-0.98.5.3.tar.gz
76 % \end{shellCode}
77 %
78 % \begin{itemize}
79 %
80 % \item Build python:
81 % \begin{shellCode}
82 % cd Python*
83 % ./configure --prefix=$PKG_ROOT/python-2.6.2 --enable-shared 2>&1 \
84 % | tee tt.configure.out
85 % make
86 % make install 2>&1 | tee tt.make.out
87 %
88 % cd ..
89 %
90 % export PATH=$PKG_ROOT/python/bin:$PATH
91 % export PYTHONHOME=$PKG_ROOT/python
92 % export LD_LIBRARY_PATH=$PKG_ROOT/python/lib:$LD_LIBRARY_PATH
93 %
94 % pushd ../pkg
95 % ln -s python-2.6.2/ python
96 % popd
97 % \end{shellCode}
98 %
99 % Run the new python executable to make sure it works.
100 %
101 % \item Now build NumPy:
102 % \begin{shellCode}
103 % cd numpy-1.3.0
104 % python setup.py build
105 % python setup.py install --prefix $PKG_ROOT/numpy-1.3.0
106 % cd ..
107 % pushd ../pkg
108 % ln -s numpy-1.3.0 numpy
109 % popd
110 % export PYTHONPATH=$PKG_ROOT/numpy/lib/python2.6/site-packages:$PYTHONPATH
111 % \end{shellCode}
112 %
113 % \item Next build scons:
114 % \begin{shellCode}
115 % cd scons-1.2.0
116 % python setup.py install --prefix=$PKG_ROOT/scons-1.2.0
117 %
118 % export PATH=$PKG_ROOT/scons/bin:$PATH
119 % cd ..
120 % pushd ../pkg
121 % ln -s scons-1.2.0 scons
122 % popd
123 % \end{shellCode}
124 %
125 % \item The Boost libraries...:
126 % \begin{shellCode}
127 % pushd ../pkg
128 % mkdir boost_1_39_0
129 % ln -s boost_1_39_0 boost
130 % popd
131 % cd boost_1_39_0
132 % ./bootstrap.sh --with-libraries=python --prefix=$PKG_ROOT/boost
133 % ./bjam
134 % ./bjam install --prefix=$PKG_ROOT/boost --libdir=$PKG_ROOT/boost/lib
135 % export LD_LIBRARY_PATH=$PKG_ROOT/boost/lib:$LD_LIBRARY_PATH
136 % cd ..
137 % pushd ../pkg/boost/lib/
138 % ln -s libboost_python*-1_39.dylib libboost_python.dylib
139 % popd
140 % \end{shellCode}
141 %
142 % \item ...and NetCDF:
143 % \begin{shellCode}
144 % cd netcdf-4.0
145 % CFLAGS="-O2 -fPIC -Df2cFortran" CXXFLAGS="-O2 -fPIC -Df2cFortran" \
146 % FFLAGS="-O2 -fPIC -Df2cFortran" FCFLAGS="-O2 -fPIC -Df2cFortran" \
147 % ./configure --prefix=$PKG_ROOT/netcdf-4.0
148 %
149 % make
150 % make install
151 %
152 % export LD_LIBRARY_PATH=$PKG_ROOT/netcdf/lib:$LD_LIBRARY_PATH
153 % cd ..
154 % pushd ../pkg
155 % ln -s netcdf-4.0 netcdf
156 % popd
157 % \end{shellCode}
158 %
159 % \item Finally matplotlib:
160 % \begin{shellCode}
161 % cd matplotlib-0.98.5.3
162 % python setup.py build
163 % python setup.py install --prefix=$PKG_ROOT/matplotlib-0.98.5.3
164 % cd ..
165 % pushd ../pkg
166 % ln -s matplotlib-0.98.5.3 matplotlib
167 % popd
168 % cd ..
169 % \end{shellCode}
170 % \end{itemize}
171 %
172 % \subsection{Compiling escript}\label{sec:compileescriptmac}
173 %
174 % Change to the directory containing your escript source (\file{stand/escript.d}), then:
175 %
176 % \begin{shellCode}
177 % cd escript.d/scons
178 % cp TEMPLATE_linux.py YourMachineName_options.py
179 %
180 % echo $PKG_ROOT
181 % \end{shellCode}
182 %
183 % Edit the options file and put the value of PKG_ROOT between the quotes in the PKG_ROOT= line.
184 % For example:
185 % \begin{shellCode}
186 % PKG_ROOT="/Users/bob/stand/pkg"
187 % \end{shellCode}
188 %
189 % \begin{shellCode}
190 % cd ../bin
191 % \end{shellCode}
192 %
193 % Modify the STANDALONE line of \file{escript} to read:
194 %
195 % STANDALONE=1
196 %
197 % Start a new terminal and go to the \file{stand} directory.
198 %
199 % \begin{shellCode}
200 % export PATH=$(pwd)/pkg/scons/bin:$PATH
201 % cd escript.d
202 % eval $(bin/run-escript -e)
203 % scons
204 % \end{shellCode}
205 %
206 % If you wish to test your build, then you can do the following.
207 % Note this may take a while if you have a slow processor and/or less than 1GB of RAM.
208 % \begin{shellCode}
209 % scons all_tests
210 % \end{shellCode}
211 %
212 % Once you are satisfied, the \file{build} and \file{\$PKG_ROOT/build} directories can be removed.
213 % Within the \file{packages} directory, the \file{scons}, \file{scons-1.2.0} entries can also be removed.
214 % If you are not redistributing this bundle you can remove \file{\$PKG_ROOT/package_src}.
215 %
216 % If you do not plan to edit or recompile the source you can remove it.
217 % The only entries which are required in \file{escript.d} are:
218 % \begin{itemize}
219 % \item \file{bin}
220 % \item \file{esys}
221 % \item \file{include}
222 % \item \file{lib}
223 % \item \file{README_LICENSE}
224 % \end{itemize}
225 %
226 % Hidden files can be removed with
227 % \begin{shellCode}
228 % find . -name '.?*' | xargs rm -rf
229 % \end{shellCode}
230
231

  ViewVC Help
Powered by ViewVC 1.1.26