Changeset 230


Ignore:
Timestamp:
Jun 15, 2011, 4:45:45 PM (13 years ago)
Author:
jmckenna
Message:

add mac and windows install instructions, both were tested locally

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/docs/kernel/installation.txt

    r222 r230  
    620620     PYTHONPATH=<YOUR_PYTHONPATH>
    621621
    622 WIN32
    623 -----
    624 
    625 To be written soon ...
     622Windows
     623-------
     624
     625Using OSGeo4W
     626*************
     627
     628ZOO4W is the easiest way to use ZOO Kernel on Windows platforms. It is based on the use of OSGeo4W, and some third-party libs.
     629Please follow the steps bellow to install ZOO Kernel. Note that Win32 support for ZOO Kernel is still under development and
     630that some bugs may still appear.
     631
     632Install OSGeo4W
     633^^^^^^^^^^^^^^^
     634
     635Download the OSGeo4W installer from  http://trac.osgeo.org/osgeo4w/, and install it with all the dependencies needed by your
     636services (GDAL/OGR for example). The following libs are required: FastCGI, libxml, Python, cURL.
     637
     638Install other tools and libraries
     639^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
     640
     641After installing OSGeo4W on your platform you'll need more GNU tools and libraries. `This package <http://www.zoo-project.org/dl/tool-win32.zip>`__
     642contains 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>`__
     643in your c:\OSGeo4W\bin.
     644
     645Download and Install ZOO Kernel
     646^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
     647
     648Download the `binary version <http://www.zoo-project.org/dl/zoo_loader.cgi>`__  of the ZOO Kernel for WIN32 then place it in the
     649``C:\OSGeo4W\bin`` directory. Don't forget to place a ``main.cfg`` file in the same directory, you can use a modified copy of
     650`this file <http://www.zoo-project.org/trac/browser/trunk/zoo-kernel/main.cfg>`__.
     651
     652Deploy ZOO Services Providers
     653^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
     654
     655Your can use the binary version of the OGR Services Provider available from `here <http://www.zoo-project.org/dl/zoo-services-win32.zip>`__.
     656Then place the two libraries with their respective .zcfg files in your local ``C:\OSGeo4W\bin`` directory.
     657
     658Testing
     659^^^^^^^
     660
     661Now you should be able to query your local ZOO Kernel.
     662
     663Compiling Using Your Own Libraries
     664**********************************
     665
     666The following steps are for use with the Microsoft Visual Studio compiler (and tested with MSVC 2008).
     667
     6681. 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>`__.
     669
     6702. 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>`__.
     671   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>`__.
     672   
     6733. Execute:
     674
     675   ::
     676   
     677     nmake /f makefile.vc
     678     
     6794. A file ``zoo_loader.cgi`` should be created.  Note that if another file named ``zoo_loader.cgi.manifest`` is also created, you
     680   will have to run another command:
     681   
     682   ::
     683   
     684     nmake /f makefile.vc embed-manifest
     685     
     6865. Copy the files ``zoo_loader.cgi`` and ``main.cfg`` into your cgi-bin directory.
     687
     6886. Using the command prompt, test the zoo-kernel by executing the following command:
     689
     690   ::
     691   
     692     D:\ms4w\Apache\cgi-bin> zoo_loader.cgi
     693     
     694   which should display a message such as:
     695   
     696   ::
     697   
     698     Content-Type: text/xml; charset=utf-8
     699     Status: 200 OK
     700     
     701     <?xml version="1.0" encoding="utf-8"?>
     702     <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">
     703       <ows:Exception exceptionCode="MissingParameterValue">
     704         <ows:ExceptionText>Parameter &lt;request&gt; was not specified</ows:ExceptionText>
     705       </ows:Exception>
     706     </ows:ExceptionReport>
     707     
     7087. Edit the file ``cgi-bin/main.cfg`` so that it contains values describing your WPS service.  An example of such
     709   a file running on Windows is:
     710   
     711   ::
     712   
     713     [main]
     714     encoding = utf-8
     715     version = 1.0.0
     716     serverAddress = http://localhost/
     717     lang = en-CA
     718     tmpPath=/ms4w/tmp/ms_tmp/
     719     tmpUrl = /ms_tmp/
     720     
     721     [identification]
     722     title = The Zoo WPS Development Server
     723     abstract = Development version of ZooWPS. See http://www.zoo-project.org
     724     fees = None
     725     accessConstraints = none
     726     keywords = WPS,GIS,buffer
     727     
     728     [provider]
     729     providerName=Gateway Geomatics
     730     providerSite=http://www.gatewaygeomatics.com
     731     individualName=Jeff McKenna
     732     positionName=Director
     733     role=Dev
     734     adressDeliveryPoint=1101 Blue Rocks Road
     735     addressCity=Lunenburg
     736     addressAdministrativeArea=False
     737     addressPostalCode=B0J 2C0
     738     addressCountry=ca
     739     addressElectronicMailAddress=info@gatewaygeomatics.com
     740     phoneVoice=False
     741     phoneFacsimile=False
     742     
     7438. 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
     744
     745   The response should be displayed in your browser, such as:
     746   
     747   ::
     748   
     749     <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">
     750     <ows:ServiceIdentification>
     751       <ows:Title>The Zoo WPS Development Server</ows:Title>
     752       <ows:Abstract>
     753         Development version of ZooWPS. See http://www.zoo-project.org
     754       </ows:Abstract>
     755       <ows:Keywords>
     756         <ows:Keyword>WPS</ows:Keyword>
     757         <ows:Keyword>GIS</ows:Keyword>
     758         <ows:Keyword>buffer</ows:Keyword>
     759       </ows:Keywords>
     760       <ows:ServiceType>WPS</ows:ServiceType>
     761       <ows:ServiceTypeVersion>1.0.0</ows:ServiceTypeVersion>
     762       ...
     763       
     764Optionally Compile Individual Services
     765^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
     766
     767An example could be the ``OGR base-vect-ops`` provider in the ``zoo-project\zoo-services\ogr\base-vect-ops`` directory. 
     768
     7691. Edit the makefile.vc located in that directory, and execute:
     770
     771   ::
     772   
     773     nmake /f makefile.vc
     774     
     775   Inside that same directory, the file ``cgi-env\ogr_service.zo`` should be created.
     776   
     7772. Copy all of the files inside ``zoo-services\ogr\base-vect-ops\cgi-env`` into your cgi-bin directory
     778
     7793. Test this service provider through the following URL:
     780
     781   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
     782   
     783   The response displayed in your browser should contain:
     784   
     785   ::
     786   
     787     <wps:ProcessSucceeded>Service "Buffer" run successfully.</wps:ProcessSucceeded>
    626788
    627789Mac OS X
Note: See TracChangeset for help on using the changeset viewer.

Search

Context 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