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

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

Massive update of zoo docs
File size: 18.3 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 Windows ™ &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="Installation on MacOSX ™" href="install-onmacos.html"/>
37        <link rel="prev" title="Installation on Unix/Linux" href="install-installation.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 current"><a class="current reference internal" href="">Installation on Windows ™</a></li>
89<li class="toctree-l2"><a class="reference internal" href="install-onmacos.html">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 Windows ™</li>
156      <li class="wy-breadcrumbs-aside">
157       
158          <a href="../_sources/install/install-onwindows.txt" rel="nofollow"> View page source</a>
159       
160      </li>
161  </ul>
162  <hr/>
163</div>
164          <div role="main" class="document">
165           
166  <div class="section" id="installation-on-windows-trade">
167<span id="install-onwindows"></span><h1>Installation on Windows ™<a class="headerlink" href="#installation-on-windows-trade" title="Permalink to this headline"></a></h1>
168<div class="section" id="using-osgeo4w">
169<h2>Using OSGeo4W<a class="headerlink" href="#using-osgeo4w" title="Permalink to this headline"></a></h2>
170<div class="section" id="install-osgeo4w">
171<h3>Install OSGeo4W<a class="headerlink" href="#install-osgeo4w" title="Permalink to this headline"></a></h3>
172<p>First download the OSGeo4W installer from  <a class="reference external" href="http://trac.osgeo.org/osgeo4w/">http://trac.osgeo.org/osgeo4w/</a>, and install it with all the dependencies needed by your
173WPS services such as GDAL for example.</p>
174<div class="admonition warning">
175<p class="first admonition-title">Warning</p>
176<p class="last">FastCGI, libxml, Python and cURL are mandatory</p>
177</div>
178</div>
179<div class="section" id="install-zoo4w">
180<h3>Install ZOO4W<a class="headerlink" href="#install-zoo4w" title="Permalink to this headline"></a></h3>
181<p>Once OSGeo4W installed on your platform, you will need more GNU tools and libraries. <a class="reference external" href="http://www.zoo-project.org/dl/tool-win32.zip">This package</a>  contains full dependencies required to compile on a WIN32 platform and this one contains <a class="reference external" href="http://www.zoo-project.org/dl/zoo-runtime.zip">full runtime dependencies</a> . Place it to your <code class="docutils literal"><span class="pre">C:\OSGeo4W\bin</span></code>.</p>
182<p>Download the <a class="reference external" href="http://www.zoo-project.org/dl/zoo_loader.cgi">binary version</a>  of ZOO Kernel for WIN32, then place it in the <code class="docutils literal"><span class="pre">C:\OSGeo4W\bin</span></code> directory. Don&#8217;t forget to place the <em>main.cfg</em> file in the same directory, you can use a modified copy of  <a class="reference external" href="http://www.zoo-project.org/trac/browser/trunk/zoo-kernel/main.cfg">this file</a>.</p>
183<p>Additionaly, the binary version of the OGR Services Provider available from <a class="reference external" href="http://www.zoo-project.org/dl/zoo-services-win32.zip">here</a> can be used directly. Place the two libraries with their respective .zcfg files in your local <code class="docutils literal"><span class="pre">C:\OSGeo4W\bin</span></code> directory to do so.</p>
184</div>
185</div>
186<div class="section" id="compile-zoo-from-source">
187<h2>Compile ZOO from source<a class="headerlink" href="#compile-zoo-from-source" title="Permalink to this headline"></a></h2>
188<div class="admonition warning">
189<p class="first admonition-title">Warning</p>
190<p class="last">Ensure to first perform the <span class="xref std std-ref">prerequisite steps</span> before compiling the ZOO Kernel.</p>
191</div>
192<p>The following steps are for use with the Microsoft Visual Studio compiler (and tested with MSVC 2008).</p>
193<ol class="arabic">
194<li><p class="first">Make sure the gnuwin32 tools <em>bison.exe</em>  and <em>flex.exe</em> are found in your path.  You can download the GNUwin32 tools <a class="reference external" href="http://www.zoo-project.org/dl/tool-win32.zip">here</a>.</p>
195</li>
196<li><p class="first">Modify the <em>nmake.opt</em> file to point to your local libraries.  You can find a modified nmake.opt that points to local libs <a class="reference external" href="http://www.zoo-project.org/trac/attachment/ticket/27/nmake.opt">here</a>.
197You can also find a modified <code class="docutils literal"><span class="pre">zoo-project\zoo-kernel\makefile.vc</span></code> file <a class="reference external" href="http://www.zoo-project.org/trac/attachment/ticket/27/makefile.vc">here</a>.</p>
198</li>
199<li><p class="first">Execute:</p>
200<div class="highlight-python"><div class="highlight"><pre>nmake /f makefile.vc
201</pre></div>
202</div>
203</li>
204<li><p class="first">A file <em>zoo_loader.cgi</em> should be created.  Note that if another file named <em>zoo_loader.cgi.manifest</em> is also created, you
205will have to run another command:</p>
206<div class="highlight-python"><div class="highlight"><pre>nmake /f makefile.vc embed-manifest
207</pre></div>
208</div>
209</li>
210<li><p class="first">Copy the files <em>zoo_loader.cgi</em>  and <em>main.cfg</em> into your cgi-bin directory.</p>
211</li>
212<li><p class="first">Using the command prompt, test the zoo-kernel by executing the following command:</p>
213<div class="highlight-python"><div class="highlight"><pre>D:\ms4w\Apache\cgi-bin&gt; zoo_loader.cgi
214</pre></div>
215</div>
216<p>which should display a message such as:</p>
217<div class="highlight-python"><div class="highlight"><pre>Content-Type: text/xml; charset=utf-8
218Status: 200 OK
219
220&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;
221&lt;ows:ExceptionReport xmlns:ows=&quot;http://www.opengis.net/ows/1.1&quot; xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot; xmlns:xlink=&quot;http://www.w3.org/1999/xlink&quot; xsi:schemaLocation=&quot;http://www.opengis.net/ows/1.1 http://schemas.opengis.net/ows/1.1.0/owsExceptionReport.xsd&quot; xml:lang=&quot;en-US&quot; version=&quot;1.1.0&quot;&gt;
222  &lt;ows:Exception exceptionCode=&quot;MissingParameterValue&quot;&gt;
223    &lt;ows:ExceptionText&gt;Parameter &amp;lt;request&amp;gt; was not specified&lt;/ows:ExceptionText&gt;
224  &lt;/ows:Exception&gt;
225&lt;/ows:ExceptionReport&gt;
226</pre></div>
227</div>
228</li>
229<li><p class="first">Edit the <em>main.cfg</em> file so that it contains values describing your WPS service.  An example of such
230a file running on Windows is:</p>
231<div class="highlight-python"><div class="highlight"><pre>[main]
232encoding = utf-8
233version = 1.0.0
234serverAddress = http://localhost/
235lang = en-CA
236tmpPath=/ms4w/tmp/ms_tmp/
237tmpUrl = /ms_tmp/
238
239[identification]
240title = The Zoo WPS Development Server
241abstract = Development version of ZooWPS. See http://www.zoo-project.org
242fees = None
243accessConstraints = none
244keywords = WPS,GIS,buffer
245
246[provider]
247providerName=Gateway Geomatics
248providerSite=http://www.gatewaygeomatics.com
249individualName=Jeff McKenna
250positionName=Director
251role=Dev
252adressDeliveryPoint=1101 Blue Rocks Road
253addressCity=Lunenburg
254addressAdministrativeArea=False
255addressPostalCode=B0J 2C0
256addressCountry=ca
257addressElectronicMailAddress=info@gatewaygeomatics.com
258phoneVoice=False
259phoneFacsimile=False
260</pre></div>
261</div>
262</li>
263<li><p class="first">Open a web browser window, and execute a GetCapababilites request on your WPS service: <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>
264<p>The response should be displayed in your browser, such as:</p>
265<div class="highlight-python"><div class="highlight"><pre>&lt;wps:Capabilities xsi:schemaLocation=&quot;http://www.opengis.net/wps/1.0.0 http://schemas.opengis.net/wps/1.0.0/wpsGetCapabilities_response.xsd&quot; service=&quot;WPS&quot; xml:lang=&quot;en-US&quot; version=&quot;1.0.0&quot;&gt;
266&lt;ows:ServiceIdentification&gt;
267  &lt;ows:Title&gt;The Zoo WPS Development Server&lt;/ows:Title&gt;
268  &lt;ows:Abstract&gt;
269    Development version of ZooWPS. See http://www.zoo-project.org
270  &lt;/ows:Abstract&gt;
271  &lt;ows:Keywords&gt;
272    &lt;ows:Keyword&gt;WPS&lt;/ows:Keyword&gt;
273    &lt;ows:Keyword&gt;GIS&lt;/ows:Keyword&gt;
274    &lt;ows:Keyword&gt;buffer&lt;/ows:Keyword&gt;
275  &lt;/ows:Keywords&gt;
276  &lt;ows:ServiceType&gt;WPS&lt;/ows:ServiceType&gt;
277  &lt;ows:ServiceTypeVersion&gt;1.0.0&lt;/ows:ServiceTypeVersion&gt;
278  ...
279</pre></div>
280</div>
281</li>
282</ol>
283<div class="section" id="optionally-compile-individual-services">
284<h3>Optionally Compile Individual Services<a class="headerlink" href="#optionally-compile-individual-services" title="Permalink to this headline"></a></h3>
285<p>An example could be the <em>OGR base-vect-ops</em> provider located in the <code class="docutils literal"><span class="pre">zoo-project\zoo-services\ogr\base-vect-ops</span></code> directory.</p>
286<ol class="arabic">
287<li><p class="first">First edit the <em>makefile.vc</em> located in that directory, and execute:</p>
288<div class="highlight-python"><div class="highlight"><pre>nmake /f makefile.vc
289</pre></div>
290</div>
291<p>Inside that same directory, the <em>ogr_service.zo</em> file should be created.</p>
292</li>
293<li><p class="first">Copy all the files inside <code class="docutils literal"><span class="pre">zoo-services\ogr\base-vect-ops\cgi-env</span></code> into your <code class="docutils literal"><span class="pre">cgi-bin</span></code> directory</p>
294</li>
295<li><p class="first">Test this service provider through the following URL:</p>
296</li>
297</ol>
298<p><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">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</a></p>
299<blockquote>
300<div><p>The response displayed in your browser should contain:</p>
301<div class="highlight-python"><div class="highlight"><pre>&lt;wps:ProcessSucceeded&gt;Service &quot;Buffer&quot; run successfully.&lt;/wps:ProcessSucceeded&gt;
302</pre></div>
303</div>
304</div></blockquote>
305</div>
306</div>
307</div>
308
309
310          </div>
311          <footer>
312 
313    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
314     
315        <a href="install-onmacos.html" class="btn btn-neutral float-right" title="Installation on MacOSX ™">Next <span class="fa fa-arrow-circle-right"></span></a>
316     
317     
318        <a href="install-installation.html" class="btn btn-neutral" title="Installation on Unix/Linux"><span class="fa fa-arrow-circle-left"></span> Previous</a>
319     
320    </div>
321 
322
323  <hr/>
324  <div class="pfoot">
325  <div role="contentinfo">
326    <p>
327        &copy; Copyright 2009-2015, ZOO-Project team.
328    </p>
329  </div>
330  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>.
331</div>
332</footer>
333
334        </div>
335      </div>
336
337    </section>
338
339  </div>
340 
341
342
343 
344
345    <script type="text/javascript">
346        var DOCUMENTATION_OPTIONS = {
347            URL_ROOT:'../',
348            VERSION:'1.4a0',
349            COLLAPSE_INDEX:false,
350            FILE_SUFFIX:'.html',
351            HAS_SOURCE:  true
352        };
353    </script>
354      <script type="text/javascript" src="../_static/jquery.js"></script>
355      <script type="text/javascript" src="../_static/underscore.js"></script>
356      <script type="text/javascript" src="../_static/doctools.js"></script>
357
358 
359
360 
361 
362    <script type="text/javascript" src="../_static/js/theme.js"></script>
363 
364
365 
366 
367  <script type="text/javascript">
368      jQuery(function () {
369          SphinxRtdTheme.StickyNav.enable();
370      });
371  </script>
372   
373
374</body>
375</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