source: branches/PublicaMundi_David-devel/docs/_build/html/install/install-onmacos.html @ 659

Last change on this file since 659 was 659, checked in by nbozon, 9 years ago

Massive update of zoo docs
File size: 19.4 KB
Line 
1
2
3<!DOCTYPE html>
4<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
5<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
6<head>
7  <meta charset="utf-8">
8  <meta name="viewport" content="width=device-width, initial-scale=1.0">
9 
10  <title>Installation on MacOSX ™ &mdash; ZOO-Project 1.4a0 documentation</title>
11 
12  <link href="http://fonts.googleapis.com/css?family=Days+One" rel="stylesheet" type="text/css">
13 
14 
15
16 
17
18 
19 
20   
21      <link rel="search" type="application/opensearchdescription+xml" title="Search within ZOO-Project 1.4a0 documentation" href="../_static/opensearch.xml"/>
22   
23
24 
25
26 
27 
28    <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
29 
30
31 
32
33 
34    <link rel="top" title="ZOO-Project 1.4a0 documentation" href="../index.html"/>
35        <link rel="up" title="ZOO-Project installation" href="index.html"/>
36        <link rel="next" title="ZOO-Kernel" href="../kernel/index.html"/>
37        <link rel="prev" title="Installation on Windows ™" href="install-onwindows.html"/> 
38
39 
40  <script src="_static/js/modernizr.min.js"></script>
41
42</head>
43
44<body class="wy-body-for-nav" role="document">
45
46  <div class="wy-grid-for-nav">
47
48   
49    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
50      <div class="wy-side-nav-search">
51       
52
53       
54          <a class="shrink" href="http://zoo-project.org"><img src="http://zoo-project.org/img/zoo-sun-logo.png" class="img-responsive sun" style="display: inline;"> ZOO</a>
55       
56
57       
58        </a>
59
60       
61<div role="search">
62  <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
63    <input type="text" name="q" placeholder="Search docs" />
64    <input type="hidden" name="check_keywords" value="yes" />
65    <input type="hidden" name="area" value="default" />
66  </form>
67</div>
68
69       
70      </div>
71
72      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
73       
74         
75         
76              <ul class="current">
77<li class="toctree-l1"><a class="reference internal" href="../intro.html">Introduction</a><ul>
78<li class="toctree-l2"><a class="reference internal" href="../intro.html#what-is-zoo-project">What is ZOO-Project ?</a></li>
79<li class="toctree-l2"><a class="reference internal" href="../intro.html#zoo-project-components">ZOO-Project components</a></li>
80<li class="toctree-l2"><a class="reference internal" href="../intro.html#open-source">Open Source</a></li>
81</ul>
82</li>
83<li class="toctree-l1 current"><a class="reference internal" href="index.html">ZOO-Project installation</a><ul class="current">
84<li class="toctree-l2"><a class="reference internal" href="install-prerequisites.html">Prerequisites</a></li>
85<li class="toctree-l2"><a class="reference internal" href="install-download.html">Download</a></li>
86<li class="toctree-l2"><a class="reference internal" href="install-confoptions.html">Configure options</a></li>
87<li class="toctree-l2"><a class="reference internal" href="install-installation.html">Installation on Unix/Linux</a></li>
88<li class="toctree-l2"><a class="reference internal" href="install-onwindows.html">Installation on Windows ™</a></li>
89<li class="toctree-l2 current"><a class="current reference internal" href="">Installation on MacOSX ™</a></li>
90</ul>
91</li>
92<li class="toctree-l1"><a class="reference internal" href="../kernel/index.html">ZOO-Kernel</a><ul>
93<li class="toctree-l2"><a class="reference internal" href="../kernel/what.html">What is ZOO-Kernel ?</a></li>
94<li class="toctree-l2"><a class="reference internal" href="../kernel/configuration.html">ZOO-Kernel configuration</a></li>
95<li class="toctree-l2"><a class="reference internal" href="../kernel/mapserver.html">Optional MapServer support</a></li>
96<li class="toctree-l2"><a class="reference internal" href="../kernel/orfeotoolbox.html">Optional Orfeo Toolbox support</a></li>
97<li class="toctree-l2"><a class="reference internal" href="../kernel/sagagis.html">Optional SAGA GIS support</a></li>
98</ul>
99</li>
100<li class="toctree-l1"><a class="reference internal" href="../services/index.html">ZOO-Services</a><ul>
101<li class="toctree-l2"><a class="reference internal" href="../services/what.html">What are ZOO-Services ?</a></li>
102<li class="toctree-l2"><a class="reference internal" href="../services/zcfg-reference.html">ZOO-Service configuration file</a></li>
103<li class="toctree-l2"><a class="reference internal" href="../services/process-profiles.html">Process profiles registry</a></li>
104<li class="toctree-l2"><a class="reference internal" href="../services/howtos.html">Create your own ZOO-Services</a></li>
105<li class="toctree-l2"><a class="reference internal" href="../services/status.html">ZOO Status Service</a></li>
106<li class="toctree-l2"><a class="reference internal" href="../services/debug.html">Debugging ZOO Services</a></li>
107<li class="toctree-l2"><a class="reference internal" href="../services/zoo-services.html">Available ZOO-Services</a></li>
108</ul>
109</li>
110<li class="toctree-l1"><a class="reference internal" href="../api/index.html">ZOO-API</a><ul>
111<li class="toctree-l2"><a class="reference internal" href="../api/what.html">What is ZOO-API ?</a></li>
112<li class="toctree-l2"><a class="reference internal" href="../api/howto.html">Using ZOO-API</a></li>
113<li class="toctree-l2"><a class="reference internal" href="../api/classes.html">ZOO-API Classes</a></li>
114<li class="toctree-l2"><a class="reference internal" href="../api/examples.html">Examples</a></li>
115</ul>
116</li>
117<li class="toctree-l1"><a class="reference internal" href="../client/index.html">ZOO-Client</a><ul>
118<li class="toctree-l2"><a class="reference internal" href="../client/what.html">What is ZOO-Client ?</a></li>
119<li class="toctree-l2"><a class="reference internal" href="../client/howto.html">Using ZOO-Client</a></li>
120<li class="toctree-l2"><a class="reference internal" href="../client/example.html">Example application</a></li>
121</ul>
122</li>
123<li class="toctree-l1"><a class="reference internal" href="../contribute/index.html">Contributor Guide</a><ul>
124<li class="toctree-l2"><a class="reference internal" href="../contribute/howto.html">How to contribute ?</a></li>
125<li class="toctree-l2"><a class="reference internal" href="../contribute/code.html">Contribute code</a></li>
126</ul>
127</li>
128</ul>
129
130         
131       
132      </div>
133      &nbsp;
134    </nav>
135
136    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
137
138     
139      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
140        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
141        <a href="../contents.html">ZOO-Project</a>
142      </nav>
143
144
145     
146      <div class="wy-nav-content">
147        <div class="rst-content">
148          <div role="navigation" aria-label="breadcrumbs navigation">
149  <ul class="wy-breadcrumbs">
150
151    <li><a href="../contents.html"> Docs</a> &#8725; &#160;</li>
152     
153          <li><a href="index.html">ZOO-Project installation</a> &#8725; &#160;</li>
154     
155    <li>Installation on MacOSX ™</li>
156      <li class="wy-breadcrumbs-aside">
157       
158          <a href="../_sources/install/install-onmacos.txt" rel="nofollow"> View page source</a>
159       
160      </li>
161  </ul>
162  <hr/>
163</div>
164          <div role="main" class="document">
165           
166  <span class="target" id="install-onmacos"></span><div class="section" id="installation-on-macosx-trade">
167<h1>Installation on MacOSX ™<a class="headerlink" href="#installation-on-macosx-trade" title="Permalink to this headline"></a></h1>
168<div class="section" id="compile-zoo-from-source">
169<h2>Compile ZOO from source<a class="headerlink" href="#compile-zoo-from-source" title="Permalink to this headline"></a></h2>
170<p>Follow the steps indicated bellow to install ZOO-Kernel on Mac OS ™ operating systems.</p>
171<ol class="arabic">
172<li><p class="first">Install <a class="reference external" href="http://developer.apple.com/technologies/tools/">Xcode</a>.</p>
173</li>
174<li><p class="first">Before you start downloading the ZOO-Project source code, some more tools are required in order to compile ZOO-Kernel properly. First of all install PROJ, GEOS and GDAL frameworks from <a class="reference external" href="http://www.kyngchaos.com/software/frameworks">here</a>. At this step, you should get the following directories on your local hard drive :</p>
175<div class="highlight-python"><div class="highlight"><pre>/Library/Frameworks/PROJ.framework
176/Library/Frameworks/GEOS.framework
177/Library/Frameworks/GDAL.framework
178</pre></div>
179</div>
180</li>
181<li><p class="first">Then, create a <code class="docutils literal"><span class="pre">src</span></code> directory and inside that directory download the <a class="reference external" href="http://www.gnu.org/software/gettext/#TOCdownloading">gettext source code</a> and
182uncompress it. Now, compile gettext with the following commands to produce a universal binary :</p>
183<div class="highlight-python"><div class="highlight"><pre>cd gettext-0.18.1.1
184CFLAGS=&quot;-O -g -arch i386 -arch ppc -arch x86_64&quot;  \
185  LDFLAGS=&quot;-arch i386 -arch ppc -arch x86_64&quot;   ./configure
186make
187sudo make install
188</pre></div>
189</div>
190</li>
191<li><p class="first">Compile and install ZOO-Kernel</p>
192<ul>
193<li><p class="first">Download source from SVN, and use the following command to compile libcgic :</p>
194<div class="highlight-python"><div class="highlight"><pre>svn co http://svn.zoo-project.org/svn/trunk zoo
195cd zoo/thirds/cgic206
196make
197</pre></div>
198</div>
199</li>
200<li><p class="first">If you produced the <code class="docutils literal"><span class="pre">libcgic.a</span></code> file, you can run <code class="docutils literal"><span class="pre">autoconf</span></code> and then <code class="docutils literal"><span class="pre">configure</span></code> from zoo-kernel directory.</p>
201<div class="highlight-python"><div class="highlight"><pre>cd zoo/zoo-kernel
202autoconf
203./configure --with-python --with-java=macos \
204   --with-gdal-config=/Library/Frameworks/GDAL.framework/Versions/1.8/Programs/gdal-config
205</pre></div>
206</div>
207<p>Obviously, if you don&#8217;t need Python or Java support then you should remove the corresponding configure option.</p>
208<div class="admonition note">
209<p class="first admonition-title">Note</p>
210<p class="last">Note that we used the &#8211;with-java=macos configure option. Due to the generic location of the JDK on all
211Mac OS X platforms, you don&#8217;t have to provide its full path.</p>
212</div>
213</li>
214<li><p class="first">Now, run the following commands to compile and deploy your ZOO-Kernel on your Apache server :</p>
215<div class="highlight-python"><div class="highlight"><pre>make
216cp zoo_loader.cgi main.cfg /Library/WebServer/CGI-Executables
217</pre></div>
218</div>
219<p>You should be ready to request your ZOO-Kernel installation using the following link :  <a class="reference external" href="http://localhost/cgi-bin/zoo_loader.cgi?request=GetCapabilities&amp;service=WPS">http://localhost/cgi-bin/zoo_loader.cgi?request=GetCapabilities&amp;service=WPS</a> .</p>
220<p>If everything is ok, you can follow the next steps to deploy new Services Providers.</p>
221<div class="admonition note">
222<p class="first admonition-title">Note</p>
223<p class="last">If you are using your own libs (not the default libs on your system) then you must take care to create
224universal versions of those libs, as the ZOO-Kernel will try to create a universal binary.  If you are
225not following this advice, you might receive compile errors of <code class="docutils literal"><span class="pre">symbol(s)</span> <span class="pre">not</span> <span class="pre">found</span> <span class="pre">for</span> <span class="pre">architecture</span> <span class="pre">ppc</span></code> or <code class="docutils literal"><span class="pre">file</span> <span class="pre">was</span> <span class="pre">built</span> <span class="pre">for</span>
226<span class="pre">unsupported</span> <span class="pre">file</span> <span class="pre">format</span> <span class="pre">which</span> <span class="pre">is</span> <span class="pre">not</span> <span class="pre">the</span> <span class="pre">architecture</span> <span class="pre">being</span> <span class="pre">linked</span> <span class="pre">(ppc)</span></code>.</p>
227</div>
228</li>
229</ul>
230</li>
231</ol>
232</div>
233<div class="section" id="deploy-the-ogr-services-provider">
234<h2>Deploy the OGR Services Provider<a class="headerlink" href="#deploy-the-ogr-services-provider" title="Permalink to this headline"></a></h2>
235<div class="section" id="requirements">
236<h3>Requirements<a class="headerlink" href="#requirements" title="Permalink to this headline"></a></h3>
237<p>Before your try to use any service, please set the correct path in the <code class="docutils literal"><span class="pre">main.cfg</span></code> for tmpPath and tmpUrl.</p>
238<p>You can use the following setup :</p>
239<div class="highlight-python"><div class="highlight"><pre>tmpPath = /Library/WebServer/Documents/tmp
240tmpUrl = ../../tmp
241</pre></div>
242</div>
243<p>Obviously you&#8217;ll then need to create this directory, using the following command :</p>
244<div class="highlight-python"><div class="highlight"><pre><span class="n">mkdir</span> <span class="o">/</span><span class="n">Library</span><span class="o">/</span><span class="n">WebServer</span><span class="o">/</span><span class="n">Documents</span><span class="o">/</span><span class="n">tmp</span>
245</pre></div>
246</div>
247</div>
248<div class="section" id="c-version">
249<h3>C Version<a class="headerlink" href="#c-version" title="Permalink to this headline"></a></h3>
250<p>To compile the base-vect-ops ServicesProvider you&#8217;ll need to edit the Makefile in <em>zoo/zoo-services/ogr/base-vect-ops/</em>
251directory. Add &#8220;-I/Library//Frameworks/GEOS.framework/Versions/3/Headers/&#8221; to the CFLAGS value on the first line.
252To compile, add GDAL framework to the PATH environmenet variable, to ensure that gdal-config tool will be found,
253run make and then copy cgi-env files in the /Library/WebServer/CGI-Executables directory.</p>
254<div class="highlight-python"><div class="highlight"><pre>cd zoo/zoo-services/ogr/base-vect-ops/
255export PATH=$PATH:/Library/Frameworks/GDAL.framework/Versions/1.7/Programs/
256make
257cp cgi-env/* /Library/WebServer/CGI-Executables
258</pre></div>
259</div>
260<p>You can test using this <a class="reference external" href="http://localhost/cgi-bin/zoo_loader.cgi?request=Execute&amp;service=WPS&amp;version=1.0.0&amp;Identifier=Buffer&amp;DataInputs=BufferDistance=1&#64;datatype=interger;InputPolygon=Reference&#64;xlink:href=http%3A%2F%2Fwww.zoo-project.org%3A8082%2Fgeoserver%2Fows%3FSERVICE%3DWFS%26REQUEST%3DGetFeature%26VERSION%3D1.0.0%26typename%3Dtopp%3Astates%26SRS%3DEPSG%3A4326%26FeatureID%3Dstates.15">url</a>
261if everything is ok with your setup.</p>
262</div>
263<div class="section" id="python-version">
264<h3>Python Version<a class="headerlink" href="#python-version" title="Permalink to this headline"></a></h3>
265<p><strong>Requirements</strong></p>
266<p>First of all run python from a Terminal.app and try the following import from the python interpreter :</p>
267<div class="highlight-python"><div class="highlight"><pre><span class="kn">import</span> <span class="nn">osgeo.ogr</span>
268<span class="kn">import</span> <span class="nn">libxml2</span>
269</pre></div>
270</div>
271<p>If you get an issue when importing the libxml2 module from your python interpreter then that means you
272need to install the Python support for the libxml2 library which is already installed on your Mac OS X environment.
273To accomplish this, you have first to determine what version of libxml2 is installed on your platform, using the following command:</p>
274<p>xml2-config &#8211;version</p>
275<p>Download the source corresponding to your version (i.e. on 10.6.6 you get 2.7.3) from the libxml2
276<a class="reference external" href="ftp://xmlsoft.org/libxml2/">download page</a> into your <code class="docutils literal"><span class="pre">src</span></code> directory then uncompress it.</p>
277<p>Use the following command to install the python support :</p>
278<div class="highlight-python"><div class="highlight"><pre>cd src/libxml2-2.7.3/python/
279python setup.py install
280</pre></div>
281</div>
282<p><strong>Deploy OGR Python Services Provider</strong></p>
283<ul class="simple">
284<li>Now copy the <code class="docutils literal"><span class="pre">zoo-services/ogt/base-vect-ops/cgi-env</span></code> files into <code class="docutils literal"><span class="pre">/Library/WebServer/CGI-Executables</span></code>.</li>
285</ul>
286<p>You can test using this <a class="reference external" href="http://localhost/cgi-bin/zoo_loader.cgi?request=Execute&amp;service=WPS&amp;version=1.0.0&amp;Identifier=BufferPy&amp;DataInputs=BufferDistance=1&#64;datatype=interger;InputPolygon=Reference&#64;xlink:href=http%3A%2F%2Fwww.zoo-project.org%3A8082%2Fgeoserver%2Fows%3FSERVICE%3DWFS%26REQUEST%3DGetFeature%26VERSION%3D1.0.0%26typename%3Dtopp%3Astates%26SRS%3DEPSG%3A4326%26FeatureID%3Dstates.15">url</a>
287if everything is ok with your setup.</p>
288</div>
289</div>
290<div class="section" id="test-using-local-demo-page">
291<h2>Test using Local Demo Page<a class="headerlink" href="#test-using-local-demo-page" title="Permalink to this headline"></a></h2>
292<ul>
293<li><p class="first">Download the <a class="reference external" href="http://openlayers.org">OpenLayers</a> library and uncompress it in your personal Sites directory
294(located in your home directory).</p>
295</li>
296<li><p class="first">Rename the OpenLayers directory as openlayers.</p>
297</li>
298<li><p class="first">Download this <a class="reference external" href="http://www.zoo-project.org/trac/raw-attachment/wiki/ZooDocumentation/ZOOKernel/MacOSX_installation/zoo-demo.zip">zip archive</a>
299and then uncompress it in your personal Sites directory.</p>
300</li>
301<li><p class="first">Load your local demo pages using urls similar to the following (replacing MyUserName by your MacOS user name) :</p>
302<blockquote>
303<div><ul class="simple">
304<li><a class="reference external" href="http://localhost/~MyUserName/zoo-demo/spatialtools.html">http://localhost/~MyUserName/zoo-demo/spatialtools.html</a></li>
305<li><a class="reference external" href="http://localhost/~MyUserName/zoo-demo/spatialtools-py.html">http://localhost/~MyUserName/zoo-demo/spatialtools-py.html</a></li>
306</ul>
307</div></blockquote>
308</li>
309</ul>
310</div>
311</div>
312
313
314          </div>
315          <footer>
316 
317    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
318     
319        <a href="../kernel/index.html" class="btn btn-neutral float-right" title="ZOO-Kernel">Next <span class="fa fa-arrow-circle-right"></span></a>
320     
321     
322        <a href="install-onwindows.html" class="btn btn-neutral" title="Installation on Windows ™"><span class="fa fa-arrow-circle-left"></span> Previous</a>
323     
324    </div>
325 
326
327  <hr/>
328  <div class="pfoot">
329  <div role="contentinfo">
330    <p>
331        &copy; Copyright 2009-2015, ZOO-Project team.
332    </p>
333  </div>
334  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> inspired by <a href="https://readthedocs.org">Read the Docs</a>.
335</div>
336</footer>
337
338        </div>
339      </div>
340
341    </section>
342
343  </div>
344 
345
346
347 
348
349    <script type="text/javascript">
350        var DOCUMENTATION_OPTIONS = {
351            URL_ROOT:'../',
352            VERSION:'1.4a0',
353            COLLAPSE_INDEX:false,
354            FILE_SUFFIX:'.html',
355            HAS_SOURCE:  true
356        };
357    </script>
358      <script type="text/javascript" src="../_static/jquery.js"></script>
359      <script type="text/javascript" src="../_static/underscore.js"></script>
360      <script type="text/javascript" src="../_static/doctools.js"></script>
361
362 
363
364 
365 
366    <script type="text/javascript" src="../_static/js/theme.js"></script>
367 
368
369 
370 
371  <script type="text/javascript">
372      jQuery(function () {
373          SphinxRtdTheme.StickyNav.enable();
374      });
375  </script>
376   
377
378</body>
379</html>
Note: See TracBrowser for help on using the repository browser.

Download now !

Search

Context Navigation

Main Navigation

ZOO Sponsors

http://www.zoo-project.org/trac/chrome/site/img/geolabs-logo.pnghttp://www.zoo-project.org/trac/chrome/site/img/neogeo-logo.png http://www.zoo-project.org/trac/chrome/site/img/apptech-logo.png http://www.zoo-project.org/trac/chrome/site/img/3liz-logo.png http://www.zoo-project.org/trac/chrome/site/img/gateway-logo.png

Become a sponsor !

Knowledge partners

http://www.zoo-project.org/trac/chrome/site/img/ocu-logo.png http://www.zoo-project.org/trac/chrome/site/img/gucas-logo.png http://www.zoo-project.org/trac/chrome/site/img/polimi-logo.png http://www.zoo-project.org/trac/chrome/site/img/fem-logo.png http://www.zoo-project.org/trac/chrome/site/img/supsi-logo.png http://www.zoo-project.org/trac/chrome/site/img/cumtb-logo.png

Become a knowledge partner

Related links

http://zoo-project.org/img/ogclogo.png http://zoo-project.org/img/osgeologo.png