source: trunk/docs/kernel/install-windows.txt @ 272

Last change on this file since 272 was 272, checked in by nbozon, 13 years ago

add keywords with svn propset

  • Property svn:keywords set to HeadURL Date Author Id Rev
File size: 6.8 KB
Line 
1.. _kernel-installation-windows:
2
3Windows
4=======
5
6:Last Updated: $Date: 2011-07-16 13:26:31 +0000 (Sat, 16 Jul 2011) $
7:Id:    $Id: install-windows.txt 272 2011-07-16 13:26:31Z nbozon $
8:Author: $Author: nbozon $
9:HeadURL: $HeadURL: trunk/docs/kernel/install-windows.txt $
10
11.. contents:: Table of Contents
12    :depth: 2
13    :backlinks: top
14
15Using OSGeo4W
16-------------
17
18Install OSGeo4W
19***************
20
21Download the OSGeo4W installer from  http://trac.osgeo.org/osgeo4w/, and install it with all the dependencies needed by your
22services (GDAL/OGR for example). The following libs are required: FastCGI, libxml, Python, cURL.
23
24Install other tools and libraries
25*********************************
26
27After installing OSGeo4W on your platform you'll need more GNU tools and libraries. `This package <http://www.zoo-project.org/dl/tool-win32.zip>`__
28contains full dependencies required to compile on WIN32 platform and this one contains `full runtime dependencies to place <http://www.zoo-project.org/dl/zoo-runtime.zip>`__
29in your c:\OSGeo4W\bin.
30
31Download and Install ZOO Kernel
32*******************************
33
34Download the `binary version <http://www.zoo-project.org/dl/zoo_loader.cgi>`__  of the ZOO Kernel for WIN32 then place it in the
35``C:\OSGeo4W\bin`` directory. Don't forget to place a ``main.cfg`` file in the same directory, you can use a modified copy of
36`this file <http://www.zoo-project.org/trac/browser/trunk/zoo-kernel/main.cfg>`__.
37
38Deploy ZOO Services Providers
39*****************************
40
41Your can use the binary version of the OGR Services Provider available from `here <http://www.zoo-project.org/dl/zoo-services-win32.zip>`__.
42Then place the two libraries with their respective .zcfg files in your local ``C:\OSGeo4W\bin`` directory.
43
44Testing
45*******
46
47Now you should be able to query your local ZOO Kernel.
48
49Compiling Using Your Own Libraries
50----------------------------------
51
52.. note::
53   You must be sure to perform the :ref:`prerequisite steps <kernel-installation-prereq>` before compiling the ZOO Kernel.
54
55The following steps are for use with the Microsoft Visual Studio compiler (and tested with MSVC 2008).
56
571. Make sure the gnuwin32 tools ``bison.exe`` and ``flex.exe`` are found in your path.  You can download the GNUwin32 tools `here <http://www.zoo-project.org/dl/tool-win32.zip>`__.
58
592. Modify the file ``zoo-project\zoo-kernel\nmake.opt`` to point to your local libraries.  You can find a modified nmake.opt that points to local libs `here <http://www.zoo-project.org/trac/attachment/ticket/27/nmake.opt>`__.
60   You can also find a modified ``zoo-project\zoo-kernel\makefile.vc`` file `here <http://www.zoo-project.org/trac/attachment/ticket/27/makefile.vc>`__.
61   
623. Execute:
63
64   ::
65   
66     nmake /f makefile.vc
67     
684. A file ``zoo_loader.cgi`` should be created.  Note that if another file named ``zoo_loader.cgi.manifest`` is also created, you
69   will have to run another command:
70   
71   ::
72   
73     nmake /f makefile.vc embed-manifest
74     
755. Copy the files ``zoo_loader.cgi`` and ``main.cfg`` into your cgi-bin directory.
76
776. Using the command prompt, test the zoo-kernel by executing the following command:
78
79   ::
80   
81     D:\ms4w\Apache\cgi-bin> zoo_loader.cgi
82     
83   which should display a message such as:
84   
85   ::
86   
87     Content-Type: text/xml; charset=utf-8
88     Status: 200 OK
89     
90     <?xml version="1.0" encoding="utf-8"?>
91     <ows:ExceptionReport xmlns:ows="http://www.opengis.net/ows/1.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xlink="http://www.w3.org/1999/xlink" xsi:schemaLocation="http://www.opengis.net/ows/1.1 http://schemas.opengis.net/ows/1.1.0/owsExceptionReport.xsd" xml:lang="en-US" version="1.1.0">
92       <ows:Exception exceptionCode="MissingParameterValue">
93         <ows:ExceptionText>Parameter &lt;request&gt; was not specified</ows:ExceptionText>
94       </ows:Exception>
95     </ows:ExceptionReport>
96     
977. Edit the file ``cgi-bin/main.cfg`` so that it contains values describing your WPS service.  An example of such
98   a file running on Windows is:
99   
100   ::
101   
102     [main]
103     encoding = utf-8
104     version = 1.0.0
105     serverAddress = http://localhost/
106     lang = en-CA
107     tmpPath=/ms4w/tmp/ms_tmp/
108     tmpUrl = /ms_tmp/
109     
110     [identification]
111     title = The Zoo WPS Development Server
112     abstract = Development version of ZooWPS. See http://www.zoo-project.org
113     fees = None
114     accessConstraints = none
115     keywords = WPS,GIS,buffer
116     
117     [provider]
118     providerName=Gateway Geomatics
119     providerSite=http://www.gatewaygeomatics.com
120     individualName=Jeff McKenna
121     positionName=Director
122     role=Dev
123     adressDeliveryPoint=1101 Blue Rocks Road
124     addressCity=Lunenburg
125     addressAdministrativeArea=False
126     addressPostalCode=B0J 2C0
127     addressCountry=ca
128     addressElectronicMailAddress=info@gatewaygeomatics.com
129     phoneVoice=False
130     phoneFacsimile=False
131     
1328. Open a web browser window, and execute a GetCapababilites request on your WPS service: http://localhost/cgi-bin/zoo_loader.cgi?request=GetCapabilities&service=WPS
133
134   The response should be displayed in your browser, such as:
135   
136   ::
137   
138     <wps:Capabilities xsi:schemaLocation="http://www.opengis.net/wps/1.0.0 http://schemas.opengis.net/wps/1.0.0/wpsGetCapabilities_response.xsd" service="WPS" xml:lang="en-US" version="1.0.0">
139     <ows:ServiceIdentification>
140       <ows:Title>The Zoo WPS Development Server</ows:Title>
141       <ows:Abstract>
142         Development version of ZooWPS. See http://www.zoo-project.org
143       </ows:Abstract>
144       <ows:Keywords>
145         <ows:Keyword>WPS</ows:Keyword>
146         <ows:Keyword>GIS</ows:Keyword>
147         <ows:Keyword>buffer</ows:Keyword>
148       </ows:Keywords>
149       <ows:ServiceType>WPS</ows:ServiceType>
150       <ows:ServiceTypeVersion>1.0.0</ows:ServiceTypeVersion>
151       ...
152       
153Optionally Compile Individual Services
154**************************************
155
156An example could be the ``OGR base-vect-ops`` provider in the ``zoo-project\zoo-services\ogr\base-vect-ops`` directory. 
157
1581. Edit the makefile.vc located in that directory, and execute:
159
160   ::
161   
162     nmake /f makefile.vc
163     
164   Inside that same directory, the file ``cgi-env\ogr_service.zo`` should be created.
165   
1662. Copy all of the files inside ``zoo-services\ogr\base-vect-ops\cgi-env`` into your cgi-bin directory
167
1683. Test this service provider through the following URL:
169
170   http://localhost/cgi-bin/zoo_loader.cgi?request=Execute&service=WPS&version=1.0.0&Identifier=Buffer&DataInputs=BufferDistance=1@datatype=interger;InputPolygon=Reference@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
171   
172   The response displayed in your browser should contain:
173   
174   ::
175   
176     <wps:ProcessSucceeded>Service "Buffer" run successfully.</wps:ProcessSucceeded>
177
Note: See TracBrowser for help on using the repository browser.

Search

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