1 | .. include:: <xhtml1-lat1.txt> |
---|
2 | .. include:: <xhtml1-symbol.txt> |
---|
3 | |
---|
4 | .. _install-onwindows: |
---|
5 | |
---|
6 | |
---|
7 | Installation on Windows |trade| |
---|
8 | ==================== |
---|
9 | |
---|
10 | Using OSGeo4W |
---|
11 | -------------- |
---|
12 | |
---|
13 | Install OSGeo4W |
---|
14 | .......................................... |
---|
15 | |
---|
16 | First download the OSGeo4W installer from http://trac.osgeo.org/osgeo4w/, and install it with all the dependencies needed by your |
---|
17 | WPS services such as GDAL for example. |
---|
18 | |
---|
19 | .. warning:: |
---|
20 | FastCGI, libxml, Python and cURL are mandatory |
---|
21 | |
---|
22 | Install ZOO4W |
---|
23 | .......................................... |
---|
24 | |
---|
25 | Once OSGeo4W installed on your platform, you will need more GNU tools and libraries. `This package <http://www.zoo-project.org/dl/tool-win32.zip>`__ contains full dependencies required to compile on a WIN32 platform and this one contains `full runtime dependencies <http://www.zoo-project.org/dl/zoo-runtime.zip>`__ . Place it to your ``C:\OSGeo4W\bin``. |
---|
26 | |
---|
27 | Download the `binary version <http://www.zoo-project.org/dl/zoo_loader.cgi>`__ of ZOO Kernel for WIN32, then place it in the ``C:\OSGeo4W\bin`` directory. Don't forget to place the *main.cfg* file in the same directory, you can use a modified copy of `this file <http://www.zoo-project.org/trac/browser/trunk/zoo-kernel/main.cfg>`__. |
---|
28 | |
---|
29 | Additionaly, the binary version of the OGR Services Provider available from `here <http://www.zoo-project.org/dl/zoo-services-win32.zip>`__ can be used directly. Place the two libraries with their respective .zcfg files in your local ``C:\OSGeo4W\bin`` directory to do so. |
---|
30 | |
---|
31 | Compile ZOO from source |
---|
32 | --------------------- |
---|
33 | |
---|
34 | .. warning:: |
---|
35 | Ensure to first perform the :ref:`prerequisite steps <kernel-installation-prereq>` before compiling the ZOO Kernel. |
---|
36 | |
---|
37 | The following steps are for use with the Microsoft Visual Studio compiler (and tested with MSVC 2008). |
---|
38 | |
---|
39 | 1. 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>`__. |
---|
40 | |
---|
41 | 2. Modify the *nmake.opt* file 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>`__. |
---|
42 | 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>`__. |
---|
43 | |
---|
44 | 3. Execute: |
---|
45 | |
---|
46 | :: |
---|
47 | |
---|
48 | nmake /f makefile.vc |
---|
49 | |
---|
50 | 4. A file *zoo_loader.cgi* should be created. Note that if another file named *zoo_loader.cgi.manifest* is also created, you |
---|
51 | will have to run another command: |
---|
52 | |
---|
53 | :: |
---|
54 | |
---|
55 | nmake /f makefile.vc embed-manifest |
---|
56 | |
---|
57 | 5. Copy the files *zoo_loader.cgi* and *main.cfg* into your cgi-bin directory. |
---|
58 | |
---|
59 | 6. Using the command prompt, test the zoo-kernel by executing the following command: |
---|
60 | |
---|
61 | :: |
---|
62 | |
---|
63 | D:\ms4w\Apache\cgi-bin> zoo_loader.cgi |
---|
64 | |
---|
65 | which should display a message such as: |
---|
66 | |
---|
67 | :: |
---|
68 | |
---|
69 | Content-Type: text/xml; charset=utf-8 |
---|
70 | Status: 200 OK |
---|
71 | |
---|
72 | <?xml version="1.0" encoding="utf-8"?> |
---|
73 | <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"> |
---|
74 | <ows:Exception exceptionCode="MissingParameterValue"> |
---|
75 | <ows:ExceptionText>Parameter <request> was not specified</ows:ExceptionText> |
---|
76 | </ows:Exception> |
---|
77 | </ows:ExceptionReport> |
---|
78 | |
---|
79 | 7. Edit the *main.cfg* file so that it contains values describing your WPS service. An example of such |
---|
80 | a file running on Windows is: |
---|
81 | |
---|
82 | :: |
---|
83 | |
---|
84 | [main] |
---|
85 | encoding = utf-8 |
---|
86 | version = 1.0.0 |
---|
87 | serverAddress = http://localhost/ |
---|
88 | lang = en-CA |
---|
89 | tmpPath=/ms4w/tmp/ms_tmp/ |
---|
90 | tmpUrl = /ms_tmp/ |
---|
91 | |
---|
92 | [identification] |
---|
93 | title = The Zoo WPS Development Server |
---|
94 | abstract = Development version of ZooWPS. See http://www.zoo-project.org |
---|
95 | fees = None |
---|
96 | accessConstraints = none |
---|
97 | keywords = WPS,GIS,buffer |
---|
98 | |
---|
99 | [provider] |
---|
100 | providerName=Gateway Geomatics |
---|
101 | providerSite=http://www.gatewaygeomatics.com |
---|
102 | individualName=Jeff McKenna |
---|
103 | positionName=Director |
---|
104 | role=Dev |
---|
105 | adressDeliveryPoint=1101 Blue Rocks Road |
---|
106 | addressCity=Lunenburg |
---|
107 | addressAdministrativeArea=False |
---|
108 | addressPostalCode=B0J 2C0 |
---|
109 | addressCountry=ca |
---|
110 | addressElectronicMailAddress=info@gatewaygeomatics.com |
---|
111 | phoneVoice=False |
---|
112 | phoneFacsimile=False |
---|
113 | |
---|
114 | 8. 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 |
---|
115 | |
---|
116 | The response should be displayed in your browser, such as: |
---|
117 | |
---|
118 | :: |
---|
119 | |
---|
120 | <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"> |
---|
121 | <ows:ServiceIdentification> |
---|
122 | <ows:Title>The Zoo WPS Development Server</ows:Title> |
---|
123 | <ows:Abstract> |
---|
124 | Development version of ZooWPS. See http://www.zoo-project.org |
---|
125 | </ows:Abstract> |
---|
126 | <ows:Keywords> |
---|
127 | <ows:Keyword>WPS</ows:Keyword> |
---|
128 | <ows:Keyword>GIS</ows:Keyword> |
---|
129 | <ows:Keyword>buffer</ows:Keyword> |
---|
130 | </ows:Keywords> |
---|
131 | <ows:ServiceType>WPS</ows:ServiceType> |
---|
132 | <ows:ServiceTypeVersion>1.0.0</ows:ServiceTypeVersion> |
---|
133 | ... |
---|
134 | |
---|
135 | Optionally Compile Individual Services |
---|
136 | ............................................................. |
---|
137 | |
---|
138 | An example could be the *OGR base-vect-ops* provider located in the ``zoo-project\zoo-services\ogr\base-vect-ops`` directory. |
---|
139 | |
---|
140 | 1. First edit the *makefile.vc* located in that directory, and execute: |
---|
141 | |
---|
142 | :: |
---|
143 | |
---|
144 | nmake /f makefile.vc |
---|
145 | |
---|
146 | Inside that same directory, the *ogr_service.zo* file should be created. |
---|
147 | |
---|
148 | 2. Copy all the files inside ``zoo-services\ogr\base-vect-ops\cgi-env`` into your ``cgi-bin`` directory |
---|
149 | |
---|
150 | 3. Test this service provider through the following URL: |
---|
151 | |
---|
152 | 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 |
---|
153 | |
---|
154 | The response displayed in your browser should contain: |
---|
155 | |
---|
156 | :: |
---|
157 | |
---|
158 | <wps:ProcessSucceeded>Service "Buffer" run successfully.</wps:ProcessSucceeded> |
---|
159 | |
---|