Changeset 240

Timestamp:

Jun 16, 2011, 8:55:24 PM (14 years ago)

Author:

jmckenna

Message:

separate install docs

Location:

trunk/docs/kernel

Files:

: 7 added
: 1 edited

Legend:

: Unmodified
: Added
: Removed

trunk/docs/kernel/installation.txt

-                      r230
+                      r240
 ============
+.. contents:: Table of Contents
+    :depth: 4
+    :backlinks: top
+This page provides documentation on how to compile then install the ZOO Kernel on Unix, Win32, and Mac OS X platforms.
+This page provides documentation on how to compile then install the ZOO Kernel on Unix and Win32 platforms.
+Obtaining the ZOO Kernel Source
+-------------------------------
+Use the following command to get the ZOO Kernel source code through Subversion:
+::
+  svn checkout http://svn.zoo-project.org/svn/trunk zoo-project
+For users which get a developer account, use the following:
+::
+  sed "s:\[tunnels\]:\[tunnels\]\nzoosvn = /usr/bin/ssh -p 1046:g" -i ~/.subversion/config
+  svn co svn+zoosvn://svn.zoo-project.org/var/svn/repos/trunk zoo-project
+The first line of the instruction above defines a specific tunnel to access the svn server through
+the SSH protocol. Indeed, the ZOO SVN server listens on the 1046 (1024+22) port rather than the default one (22).
+Prerequisites
+-------------
+The following libraries are required on your system before you can install the ZOO Kernel:
+- autoconf (  http://www.gnu.org/software/autoconf/ )
+- cgic (  http://www.boutell.com/cgic )
+- cURL (  http://curl.haxx.se )
+- FastCGI (  http://www.fastcgi.com )
+- Flex & Bison (  http://flex.sourceforge.net/  http://www.gnu.org/software/bison/ )
+- libxml2 (  http://xmlsoft.org )
+- OpenSSL (  http://www.openssl.org )
+- Python (  http://www.python.org )
+Optional libraries include:
+- PHP Embedded (optional) (  http://www.php.net )
+- Java SDK (optional) (  http://java.sun.com )
+- SpiderMonkey (optional) (  http://www.mozilla.org/js/spidermonkey/ )
+Compile libcgic
+---------------
+The first step is to compile libcgic from the ``zoo-project/thirds`` directory. For such a task, please use
+the following command:
+::
+  cd thirds/cgic206
+  make
+Make sure that a ``libcgic.a`` is created in your ``zoo-project/thirds/cgic206`` directory. If yes, then
+you can go to the next step.
+On Windows, rather than using the make command, please use:
+::
+  nmake /f makefile.vc.
+.. warning::
+   If you don't compile libcgic first, and try to compile the ZOO Kernel, you will get an error such as *cannot find -lcgic*
+Unix
+----
+For Unix users, the ZOO Kernel comes with a GNU autoconf "configure" script that should take care of (hopefully!)
+all compilation issues for you.
+The configure script won't work on Windows. See section :ref:`WIN32 <win32>` for details on compiling
+on Windows systems.
+For the impatient
+*****************
+To build the ``zoo_loader.cgi`` CGI program with the default options, cd to the directory
+where you extracted the ZOO Kernel source code package and use the following commands:
+::
+  $ cd zoo-kernel
+  $ autoconf
+  $ ./configure
+  $ make
+Unless something went wrong, you should have executables in the current directory for the ``zoo_loader.cgi``
+CGI program. You can copy the ``zoo_loader.cgi`` program and the ``main.cfg`` file to your HTTP server's CGI
+directory and start using it.
+At this step your ZOO-Kernel should work. Nevertheless, don't forget to correct the main.cfg settings
+to set ``tmpPath`` and ``tmpUrl`` to fit your web server configuration.
+Configure Options
+*****************
+Here is the list of available options as returned by *./configure --help*:
+::
+  --with-gdal-config=FILE specify an alternative gdal-config file
+  --with-xml2config=FILE  specify an alternative xml2-config file
+  --with-python=PATH      To enable python support or specify an alternative
+                          directory for python installation, disabled by
+                          default
+  --with-php=PATH         To enable php support or specify an alternative
+                          directory for php installation, disabled by default
+  --with-perl=PATH        To enable perl support or specify an alternative
+                          directory for perl installation, disabled by default
+  --with-java=PATH        To enable java support, specify a JDK_HOME,
+                          disabled by default
+  --with-js=PATH          specify --with-js=path-to-js to enable js support,
+                          specify --with-js on linux debian like, js support
+                          is disabled by default
+All the options are described in more details below.
+(Required) GDAL Support
+^^^^^^^^^^^^^^^^^^^^^^^
+If your gdal-config program is not found in your PATH then you can use the
+``--with-gdal-config`` option to specify its location. For instance, let's suppose that your gdal-config
+was installed in /usr/local/bin and this directory is not in your PATH, then you can use
+the following command:
+::
+  $ ./configure --with-gdal-config=/usr/local/bin/gdal-config
+(Required) XML2 Support
+^^^^^^^^^^^^^^^^^^^^^^^
+If your xml2-config program is not found in your PATH then you can use the
+``--with-xml2config`` option to specify its location. For instance, let's suppose that
+your xml2-config was installed in /usr/local/bin and this directory is not in your PATH,
+then you can use the following command:
+::
+  $ ./configure --with-xml2config=/usr/local/bin/xml2-config
+(Optional) Python Support
+^^^^^^^^^^^^^^^^^^^^^^^^^
+If you want to activate Python support for the ZOO Kernel then you will have to use the
+``--with-python`` option. If your python-config program is found in your PATH then you
+don't have to specify the path where Python was installed, such as:
+::
+  $ ./configure --with-python
+This assumes that python-config is found in your PATH.
+In the case that your python-config is not found in your PATH, then you can specify the Python
+installation directory you are using. For instance, let's suppose that you installed
+Python in /usr/local, then you can use the following command:
+::
+  $ ./configure --with-python=/usr/local
+This assumes that /usr/local/bin/python-config exists.
+(Optional) PHP Support
+^^^^^^^^^^^^^^^^^^^^^^
+To be able to activate PHP support for the ZOO Kernel you'll need to get a local PHP Embedded
+installation; for more information about the required configure options when compiling PHP you
+can refer to this page :
+     http://zoo-project.org/trac/wiki/ZooKernel/Embed/PHP
+If you want to activate the PHP support for the ZOO Kernel then you will have to use the
+``--with-php`` option. If your php-config program is found in your PATH then you don't have
+to specify the path where PHP was installed, then you can use the following commnd:
+::
+  $ ./configure --with-php
+This assumes that php-config is found in your PATH.
+In the case that your php-config is not found in your PATH, then you can specify the PHP installation
+directory you are using. For instance, let's suppose that you installed PHP in /usr/local,
+then you can use the following command:
+::
+  $ ./configure --with-php=/usr/local
+This assumes that /usr/local/bin/php-config exists.
+(Optional) Perl Support
+^^^^^^^^^^^^^^^^^^^^^^^
+If you want to activate Perl support for the ZOO Kernel then you will have to use the
+``--with-perl`` option. If you do not set any value to this option, then the perl program will
+be searched in your PATH. So in such a case, you can use the following command:
+::
+  $ ./configure --with-perl
+This assumes that perl is found in your PATH.
+In the other case, for custom Perl installations, you can set the installation directory. For instance,
+let's suppose that you installed Perl in /usr/local and /usr/local/bin is not in your PATH,
+then you can use the following command:
+::
+  $ ./configure --with-perl=/usr/local
+This assumes that /usr/local/bin/perl exists.
+(Optional) Java Support
+^^^^^^^^^^^^^^^^^^^^^^^
+If you want to activate Java support for the ZOO Kernel then you will have to use the
+``--with-java`` option and set the installation path of your Java SDK. For instance,
+let's suppose that your Java SDK was installed in the /usr/lib/jvm/java-6-sun-1.6.0.22/ directory,
+then you can use the following command:
+::
+  $ ./configure --with-java=/usr/lib/jvm/java-6-sun-1.6.0.22/
+This assumes that the include/linux and jre/lib/i386/client/ subdirectories exist in
+/usr/lib/jvm/java-6-sun-1.6.0.22/, include/linux contains the jni.h headers file and
+jre/lib/i386/client/ contains the libjvm.so file.
+.. note::
+   With Mac OS X you only have to set ``macos`` as the value for the ``--with-java`` option
+   to activate Java support. For example:
+   ::
+     $ ./configure --with-java=macos
+(Optional) JavaScript Support
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+If you want to activate JavaScript support for the ZOO Kernel then you will have to use
+the ``--with-js`` option. If you are using a "Debian-like" GNU/Linux distribution then
+dpkg will be used to detect if the required packages are installed and you don't have to
+specify anything here, so you can use the following command:
+::
+  $ ./configure --with-js
+This assumes that js_api.h and libmozjs.so are found in default directories.
+If you have a custom installation of SpiderMonkey or you are not using a Debian packaging
+system, then you'll have to specify the directory where you installed it. For
+instance, let's suppose that you installed your SpiderMonkey in /usr, then you'll
+have to use the following command:
+::
+  $ ./configure --with-js=/usr
+This assumes that the /usr/include/js exists and contains the js_api.h headers file and
+/usr/lib contains libmozjs.so file.
+.. _win32:
+OpenSUSE
+********
+Zoo-Kernel is maintained as a package in `OpenSUSE Build Service (OBS) <https://build.opensuse.org/package/show?package=zoo-kernel&project=Application%3AGeo>`__.
+This way, rpm's are provided for all versions of openSUSE Linux (11.2, 11.3, 11.4, Factory).
+Stable Releases
+^^^^^^^^^^^^^^^
+For installing Zoo-Kernel in openSUSE there are 3 ways available:
+One Click Installer
+###################
+One-click installer that can be found  `here <http://software.opensuse.org/search?q=zoo-kernel&baseproject=openSUSE%3A11.4&lang=en&exclude_debug=true>`__.
+For openSUSE 11.4 this is the direct `link <http://software.opensuse.org/ymp/Application:Geo/openSUSE_11.4/zoo-kernel.ymp?base=openSUSE%3A11.4&query=zoo-kernel>`__.
+Yast Software Manager using a GUI
+#################################
+The `Application:Geo <http://download.opensuse.org/repositories/Application:/Geo/>`__ repository has to be added
+to the Software Repositories and then Zoo-kernel can be found in Software Management through search.
+Command line (as root for openSUSE 11.4)
+########################################
+::
+  zypper ar http://download.opensuse.org/repositories/Application:/Geo/openSUSE_11.4/
+  zypper refresh
+  zypper install zoo-kernel
+Unstable Version
+^^^^^^^^^^^^^^^^
+The latest development version of ZOO-Kernel can be found in OBS under the project `home:tzotsos <https://build.opensuse.org/project/show?project=home%3Atzotsos>`__.
+ZOO-Kernel packages are maintained and tested there before being released to the Application:Geo repository.
+Installation methods are identical as the stable version. Make sure to use `this <http://download.opensuse.org/repositories/home:/tzotsos/>`__ repository instead.
+Command line installation (as root for openSUSE 11.4)
+#####################################################
+::
+  zypper ar http://download.opensuse.org/repositories/home:/tzotsos/openSUSE_11.4/
+  zypper refresh
+  zypper install zoo-kernel
+  zypper install zoo-kernel-grass-bridge
+Additionally, there is the option of adding the zoo-wps-grass-bridge package. This option will automatically install grass7 (svn trunk).
+Try the Installation
+^^^^^^^^^^^^^^^^^^^^
+- http://localhost/cgi-bin/zoo_loader.cgi?ServiceProvider=&metapath=&Service=WPS&Request=GetCapabilities&Version=1.0.0
+- http://localhost/cgi-bin/zoo_loader.cgi?ServiceProvider=&metapath=&Service=WPS&Request=DescribeProcess&Version=1.0.0&Identifier=HelloPy
+- http://localhost/cgi-bin/zoo_loader.cgi?ServiceProvider=&metapath=&Service=WPS&Request=Execute&Version=1.0.0&Identifier=HelloPy&DataInputs=a=myname
+CentOS
+******
+.. note::
+   This documentation was created thanks to Guillaume Sueur from Neogeo Technologies which took time to test
+   installing the ZOO-Kernel on a CentOS 5.5 environment.
+Requirements
+^^^^^^^^^^^^
+Install some standard tools to be able to run ZOO-Kernel on your platform :
+::
+  yum install apache2
+  yum install build-essentials
+  yum install gcc-c++
+  yum install zlib-devel
+  yum install libxml2-devel
+  yum install bison
+  yum install openssl
+  yum install python-devel
+  yum install subversion
+Compile then install FastCGI library from source
+::
+  wget http://www.fastcgi.com/dist/fcgi.tar.gz
+  tar xzf fcgi-2.4.0.tar.gz
+  ./configure
+  make
+  make install
+  echo /usr/local/lib >> /etc/ld.so.conf.d/local.conf
+  ldconfig
+Compile then install the autoconf tools :
+::
+  wget http://ftp.gnu.org/gnu/autoconf/autoconf-latest.tar.gz
+  tar xzf autoconf-latest.tar.gz
+  ./configure --prefix=/usr
+  make
+  make install
+Compile then install the flex tool :
+::
+  wget http://downloads.sourceforge.net/project/flex/flex/flex-2.5.35/flex-2.5.35.tar.gz?r=http%3A%2F%2Fflex.sourceforge.net%2F&ts=1292529005&use_mirror=switch
+  tar xzf flex-2.5.35.tar.gz
+  cd flex-2.5.35
+  ./configure --prefix=/usr
+  make
+  make install
+Using the curl provided in the CentOS distribution will produce a ZOO-Kernel unable to run any
+Service. Indeed, some segmentation faults occur when trying to run ``Execute`` requests on the ZOO-Kernel,
+compiling the ZOO-Kernel setting ``USE_GDB`` flag in the ``CFLAGS`` of your ``Makefile`` will let you run
+ZOO-Kernel from gdb and be able to get more information on what is going wrong with your ZOO-Kernel.
+Doing this we can figure out that code on `line 173 <http://zoo-project.org/trac/browser/trunk/zoo-kernel/ulinet.c#L173>`__
+and `line 175 <http://zoo-project.org/trac/browser/trunk/zoo-kernel/ulinet.c#L175>`__ have to be commented in the
+``ulinet.c`` file to get a ZOO-Kernel working using the curl available in CentOS (curl version 7.15.5).
+If you don't apply the modification, you will get an error from a gdb session pointing
+segfault in ``Curl_cookie_clearall``.
+You can optionally compile then install curl from source :
+::
+  wget http://curl.haxx.se/download/curl-7.21.3.tar.bz2
+  tar xjf curl-7.21.3.tar.bz2
+  cd curl-7.21.3
+  ./configure --prefix=/usr
+  make
+  make install
+Compile then install Python :
+::
+  wget http://www.python.org/ftp/python/2.6.6/Python-2.6.6.tar.bz2
+  tar xjf Python-2.6.6.tar.bz2
+  cd Python-2.6.6
+  ./configure
+  make
+  make install
+Compile then install your own GDAL library :
+::
+  wget http://download.osgeo.org/gdal/gdal-1.7.3.tar.gz
+  tar xzf gdal-1.7.3.tar.gz
+  cd gdal-1.7.3
+  ./configure  # add your options here
+  make
+  make install
+Install the Sun JAVA SDK into ``/usr/share`` then use the following command to ensure that the ``libjvm.so``
+will be found at runtime from any context.
+::
+  echo /usr/share/java-1.6.0-openjdk-1.6.0.0/jre/lib/i386/client/ >> /etc/ld.so.conf.d/jvm.conf
+  ldconfig
+Compile ZOO-Kernel and ZOO-Services
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Compile then install ZOO-Kernel and your first ZOO-Services.
+First of all, compile the cgic library providen in the SVN source tree:
+::
+  svn co http://svn.zoo-project.org/svn/trunk zoo-project
+  cd zoo-project/thirds/cgic206
+  make
+Compile then install ZOO-Kernel.
+::
+  cd ../../zoo-kernel
+  ./configure --with-java=/usr/share/jdk1.6.0_23/ --with-python
+  make zoo_loader.cgi
+  cp main.cfg /var/www/cgi-bin/
+  cp  zoo_loader.cgi /var/www/cgi-bin/
+Compile then deploy your first ZOO-ServicesProviders (simple HelloPy, line 1 and 2, and the OGR base-vect-ops
+ServiceProvider, line 3 to 6):
+::
+  cp ../zoo-services/hello-py/cgi-env/*.zcfg /var/www/cgi-bin/
+  cp ../zoo-services/hello-py/test_service.py /var/www/cgi-bin/
+  cd ../ogr/base-vect-ops/
+  make
+  cp ./cgi-env/* /var/www/cgi-bin/
+  vi /var/www/cgi-bin/main.cfg --> set your own informations here
+To ensure that the ``libjvm.so`` will be found from apache, please restart it :
+::
+  /etc/init.d/httpd restart
+Testing your ZOO-Kernel
+^^^^^^^^^^^^^^^^^^^^^^^
+Test your ZOO-Kernel from command line:
+::
+  cd /var/www/cgi-bin
+  ./zoo_loader.cgi "request=Execute&service=WPS&version=1.0.0&Identifier=HelloPy&DataInputs=a=Djay"
+  ./zoo_loader.cgi "request=Execute&service=WPS&version=1.0.0&Identifier=Buffer&DataInputs=BufferDistance=1@datat
+Debian / Ubuntu
+***************
+.. note::
+   An Ubuntu 10.4 with ZOO virtual image is available at http://www.zoo-project.org/Ubuntu10.4_ZOO.zip
+   (root: ZOO.test)
+The following instructions were tested on Debian Squeeze, Ubuntu 10.04 and Ubuntu 10.10
+Installation Workflow
+^^^^^^^^^^^^^^^^^^^^^
+- install some dependencies
+::
+  sudo apt-get install flex bison libfcgi-dev libxml2 libxml2-dev curl openssl autoconf checkinstall
+- download ZOO  source
+::
+  svn checkout http://svn.zoo-project.org/svn/trunk zoo-project
+- install cgic from packages
+::
+  cd zoo-project/thirds/cgic206/
+- change the path of installation
+::
+  nano Makefile
+    - LIBS=-L./ -lcgic ../fcgi-2.4.0/libfcgi/.libs/libfcgi.a --> LIBS=/path/to/libfcgi.a
+    - cp libcgic.a  ../../dist/lib --> cp libcgic.a /usr/lib
+    - cp cgic.h  ../../dist//include --> cp cgic.h  /usr/include
+    - @echo libcgic.a is in  ../../dist/lib and cgic.h is in  ../../dist//include. --> @echo libcgic.a is in  /usr/lib and cgic.h is in /usr/include.
+- compile
+::
+  make
+- install
+::
+  sudo make install
+- go to kernel path
+::
+  cd ../../zoo-kernel/
+- create configure file
+::
+  autoconf
+- run configure
+.. note::
+   In Ubuntu 10.04 libmozjs-dev does not exist, so to use JS you can compile `SpiderMonkey <https://developer.mozilla.org/en/SpiderMonkey>`__ or use the xulrunner-dev package
+   which includes SpiderMonkey.
+   For PHP, you must make sure to compile PHP with `--enable-embed <http://www.zoo-project.org/trac/wiki/ZooKernel/Embed/PHP#ConfigureandInstallPHPEmbedlibrary>`__.
+::
+  ./configure --with-java=/path/to/java
+  to JavaScript with XulRunner SpiderMonkey you have to edit configure file.
+    - JS_CPPFLAGS="-I$JSHOME/include/js" --> JS_CPPFLAGS="-I$JSHOME/include"
+    - JS_LDFLAGS="-L$JSHOME/lib -ljs -lm" --> JS_LDFLAGS="-L$JSHOME/lib -lmozjs -lm"
+    - JS_LIB="js" --> JS_LIB="mozjs"
+  ./configure --with-js=/usr/lib/xulrunner-devel.1.9.2.n
+- compile
+::
+  make zoo_loader.cgi
+- copy necessary files into your cgi-bin
+::
+  sudo cp main.cfg /usr/lib/cgi-bin
+  sudo cp zoo_loader.cgi /usr/lib/cgi-bin
+- Install ZOO ServiceProvider
+::
+  sudo cp ../zoo-services/hello-py/cgi-env/*.zcfg /usr/lib/cgi-bin
+  sudo cp ../zoo-services/hello-py/*.py /usr/lib/cgi-bin/
+- change some paths in the main.cfg
+::
+  sudo nano /usr/lib/cgi-bin/main.cfg
+    - serverAddress = http://127.0.0.1
+    - providerSite = http://127.0.0.1
+.. toctree::
+   :maxdepth: 2
+   install-prerequisites
+   install-unix
+   install-opensuse
+   install-centos
+   install-debian
+   install-windows
+   install-mac
-- try the installation
-  - http://127.0.0.1/cgi-bin/zoo_loader.cgi?ServiceProvider=&metapath=&Service=WPS&Request=GetCapabilities&Version=1.0.0
-  - http://127.0.0.1/cgi-bin/zoo_loader.cgi?ServiceProvider=&metapath=&Service=WPS&Request=DescribeProcess&Version=1.0.0&Identifier=HelloPy
-  - http://127.0.0.1/cgi-bin/zoo_loader.cgi?ServiceProvider=&metapath=&Service=WPS&Request=Execute&Version=1.0.0&Identifier=HelloPy&DataInputs=a=myname
-.. note::
-   If you have some problem in the execute request, add the following to ``main.cfg``:
-   ::
-     [env]
-     PYTHONPATH=<YOUR_PYTHONPATH>
-Windows
--------
-Using OSGeo4W
-*************
-ZOO4W is the easiest way to use ZOO Kernel on Windows platforms. It is based on the use of OSGeo4W, and some third-party libs.
-Please follow the steps bellow to install ZOO Kernel. Note that Win32 support for ZOO Kernel is still under development and
-that some bugs may still appear.
-Install OSGeo4W
-^^^^^^^^^^^^^^^
-Download the OSGeo4W installer from  http://trac.osgeo.org/osgeo4w/, and install it with all the dependencies needed by your
-services (GDAL/OGR for example). The following libs are required: FastCGI, libxml, Python, cURL.
-Install other tools and libraries
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-After installing OSGeo4W on your platform you'll need more GNU tools and libraries. `This package <http://www.zoo-project.org/dl/tool-win32.zip>`__
-contains 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>`__
-in your c:\OSGeo4W\bin.
-Download and Install ZOO Kernel
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-Download the `binary version <http://www.zoo-project.org/dl/zoo_loader.cgi>`__  of the ZOO Kernel for WIN32 then place it in the
-``C:\OSGeo4W\bin`` directory. Don't forget to place a ``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>`__.
-Deploy ZOO Services Providers
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-Your can use the binary version of the OGR Services Provider available from `here <http://www.zoo-project.org/dl/zoo-services-win32.zip>`__.
-Then place the two libraries with their respective .zcfg files in your local ``C:\OSGeo4W\bin`` directory.
-Testing
-^^^^^^^
-Now you should be able to query your local ZOO Kernel.
-Compiling Using Your Own Libraries
-**********************************
-The following steps are for use with the Microsoft Visual Studio compiler (and tested with MSVC 2008).
-. 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>`__.
-. 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>`__.
-   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>`__.
-. Execute:
-   ::
-     nmake /f makefile.vc
-. A file ``zoo_loader.cgi`` should be created.  Note that if another file named ``zoo_loader.cgi.manifest`` is also created, you
-   will have to run another command:
-   ::
-     nmake /f makefile.vc embed-manifest
-. Copy the files ``zoo_loader.cgi`` and ``main.cfg`` into your cgi-bin directory.
-. Using the command prompt, test the zoo-kernel by executing the following command:
-   ::
-     D:\ms4w\Apache\cgi-bin> zoo_loader.cgi
-   which should display a message such as:
-   ::
-     Content-Type: text/xml; charset=utf-8
-     Status: 200 OK
-     <?xml version="1.0" encoding="utf-8"?>
-     <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">
-       <ows:Exception exceptionCode="MissingParameterValue">
-         <ows:ExceptionText>Parameter &lt;request&gt; was not specified</ows:ExceptionText>
-       </ows:Exception>
-     </ows:ExceptionReport>
-. Edit the file ``cgi-bin/main.cfg`` so that it contains values describing your WPS service.  An example of such
-   a file running on Windows is:
-   ::
-     [main]
-     encoding = utf-8
-     version = 1.0.0
-     serverAddress = http://localhost/
-     lang = en-CA
-     tmpPath=/ms4w/tmp/ms_tmp/
-     tmpUrl = /ms_tmp/
-     [identification]
-     title = The Zoo WPS Development Server
-     abstract = Development version of ZooWPS. See http://www.zoo-project.org
-     fees = None
-     accessConstraints = none
-     keywords = WPS,GIS,buffer
-     [provider]
-     providerName=Gateway Geomatics
-     providerSite=http://www.gatewaygeomatics.com
-     individualName=Jeff McKenna
-     positionName=Director
-     role=Dev
-     adressDeliveryPoint=1101 Blue Rocks Road
-     addressCity=Lunenburg
-     addressAdministrativeArea=False
-     addressPostalCode=B0J 2C0
-     addressCountry=ca
-     addressElectronicMailAddress=info@gatewaygeomatics.com
-     phoneVoice=False
-     phoneFacsimile=False
-. 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
-   The response should be displayed in your browser, such as:
-   ::
-     <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">
-     <ows:ServiceIdentification>
-       <ows:Title>The Zoo WPS Development Server</ows:Title>
-       <ows:Abstract>
-         Development version of ZooWPS. See http://www.zoo-project.org
-       </ows:Abstract>
-       <ows:Keywords>
-         <ows:Keyword>WPS</ows:Keyword>
-         <ows:Keyword>GIS</ows:Keyword>
-         <ows:Keyword>buffer</ows:Keyword>
-       </ows:Keywords>
-       <ows:ServiceType>WPS</ows:ServiceType>
-       <ows:ServiceTypeVersion>1.0.0</ows:ServiceTypeVersion>
-       ...
-Optionally Compile Individual Services
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-An example could be the ``OGR base-vect-ops`` provider in the ``zoo-project\zoo-services\ogr\base-vect-ops`` directory.
-. Edit the makefile.vc located in that directory, and execute:
-   ::
-     nmake /f makefile.vc
-   Inside that same directory, the file ``cgi-env\ogr_service.zo`` should be created.
-. Copy all of the files inside ``zoo-services\ogr\base-vect-ops\cgi-env`` into your cgi-bin directory
-. Test this service provider through the following URL:
-   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
-   The response displayed in your browser should contain:
-   ::
-     <wps:ProcessSucceeded>Service "Buffer" run successfully.</wps:ProcessSucceeded>
-Mac OS X
---------
-Using the Installer
-*******************
-. To install a default build of the ZOO-Project on your Mac OS X computer use the `installer <http://www.zoo-project.org/trac/raw-attachment/wiki/ZooDocumentation/ZOOKernel/MacOSX_installation/ZOO-Project-Installer.pkg>`__.
-   .. note::
-      The installer assumes that you are using the distributed Apache2 version that comes with your Mac.  The installer will
-      place ZOO-Kernel and ZOO-Services into your cgi-bin at ``/Library/WebServer/CGI-Executables``, and the zoo-demo folder
-      will be placed within your document root at ``/Library/WebServer/Documents``
-. Make sure that your Apache server is running, and then access the ZOO Project Demo at:
-      http://localhost/zoo-demo/spatialtools.html
-. To add additional services, please follow the following intructions to compile your own ZOO Project instance.
-Compiling from Source
-*********************
-. Install `Xcode <http://developer.apple.com/technologies/tools/>`__.
-. Before you start downloading the ZOO-Project source code, you'll need to install some tools required to
-   compile ZOO-Kernel properly.
-   First of all install PROJ, GEOS and GDAL frameworks from `here <http://www.kyngchaos.com/software/frameworks>`__.
-   At this step, you should get the following directories on your local hard drive :
-   ::
-     /Library/Frameworks/PROJ.framework
-     /Library/Frameworks/GEOS.framework
-     /Library/Frameworks/GDAL.framework
-. Then, create a ``src`` directory and inside that directory download the `gettext source code <http://www.gnu.org/software/gettext/#TOCdownloading>`__ and uncompress it.
-   now, compile gettext with the following commands to produce a universal binary :
-   ::
-     cd gettext-0.18.1.1
-     CFLAGS="-O -g -arch i386 -arch ppc -arch x86_64"  \
-       LDFLAGS="-arch i386 -arch ppc -arch x86_64"   ./configure
-     make
-     sudo make install
-. Compile and install your ZOO-Kernel
-   - Download source from SVN, and use the following command to compile libcgic :
-     ::
-       svn co http://svn.zoo-project.org/svn/trunk zoo
-       cd zoo/thirds/cgic206
-       make
-   - If you produced the ``libcgic.a`` file, you can run ``autoconf`` and then ``configure`` from zoo-kernel directory.
-     ::
-       cd zoo/zoo-kernel
-       autoconf
-       ./configure --with-python --with-java=macos \
-          --with-gdal-config=/Library/Frameworks/GDAL.framework/Versions/1.8/Programs/gdal-config
-     Obviously, if you don't need Python or Java support then you should remove the corresponding configure option.
-     .. note::
-        Note that we used the --with-java=macos configure option. Due to the generic location of the JDK on all
-        Mac OS X platforms, you don't have to provide its full path.
-   - Now, run the following commands to compile and deploy your ZOO-Kernel on your Apache server :
-     ::
-       make
-       cp zoo_loader.cgi main.cfg /Library/WebServer/CGI-Executables
-     You should be ready to request your ZOO-Kernel installation using the following link :  http://localhost/cgi-bin/zoo_loader.cgi?request=GetCapabilities&service=WPS .
-     If everything is ok, you can follow the next steps to deploy new Services Providers.
-     .. note::
-        If you are using your own libs (not the default libs on your system) then you must take care to create
-        universal versions of those libs, as the ZOO-Kernel will try to create a universal binary.  If you are
-        not following this advice, you might receive compile errors of ``symbol(s) not found for architecture ppc`` or ``file was built for
-        unsupported file format which is not the architecture being linked (ppc)``.
-Deploy the OGR Services Provider
-********************************
-Requirements
-^^^^^^^^^^^^
-Before your try to use any service, please set the correct path in the ``main.cfg`` for tmpPath and tmpUrl.
-You can use the following setup :
-::
-  tmpPath = /Library/WebServer/Documents/tmp
-  tmpUrl = ../../tmp
-Obviously you'll then need to create this directory, using the following command :
-::
-  mkdir /Library/WebServer/Documents/tmp
-C Version
-^^^^^^^^^
-To compile the base-vect-ops ServicesProvider you'll need to edit the Makefile in *zoo/zoo-services/ogr/base-vect-ops/*
-directory. Add "-I/Library//Frameworks/GEOS.framework/Versions/3/Headers/" to the CFLAGS value on the first line.
-To compile, add GDAL framework to the PATH environmenet variable, to ensure that gdal-config tool will be found,
-run make and then copy cgi-env files in the /Library/WebServer/CGI-Executables directory.
-::
-  cd zoo/zoo-services/ogr/base-vect-ops/
-  export PATH=$PATH:/Library/Frameworks/GDAL.framework/Versions/1.7/Programs/
-  make
-  cp cgi-env/* /Library/WebServer/CGI-Executables
-You can test using this `url <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>`__
-if everything is ok with your setup.
-Python Version
-^^^^^^^^^^^^^^
-**Requirements**
-First of all run python from a Terminal.app and try the following import from the python interpreter :
-::
-  import osgeo.ogr
-  import libxml2
-If you get an issue when importing the libxml2 module from your python interpreter then that means you
-need to install the Python support for the libxml2 library which is already installed on your Mac OS X environment.
-To accomplish this, you have first to determine what version of libxml2 is installed on your platform, using the following command:
-xml2-config --version
-Download the source corresponding to your version (i.e. on 10.6.6 you get 2.7.3) from the libxml2
-`download page <ftp://xmlsoft.org/libxml2/>`__ into your ``src`` directory then uncompress it.
-Use the following command to install the python support :
-::
-  cd src/libxml2-2.7.3/python/
-  python setup.py install
-**Deploy OGR Python Services Provider**
-- Now copy the ``zoo-services/ogt/base-vect-ops/cgi-env`` files into ``/Library/WebServer/CGI-Executables``.
-You can test using this `url <http://localhost/cgi-bin/zoo_loader.cgi?request=Execute&service=WPS&version=1.0.0&Identifier=BufferPy&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>`__
-if everything is ok with your setup.
-Test using Local Demo Page
-**************************
-- Download the `OpenLayers <http://openlayers.org>`__ library and uncompress it in your personal Sites directory
-  (located in your home directory).
-- Rename the OpenLayers directory as openlayers.
-- Download this `zip archive <http://www.zoo-project.org/trac/raw-attachment/wiki/ZooDocumentation/ZOOKernel/MacOSX_installation/zoo-demo.zip>`__
-  and then uncompress it in your personal Sites directory.
-- Load your local demo pages using urls similar to the following (replacing MyUserName by your MacOS user name) :
-    *  http://localhost/~MyUserName/zoo-demo/spatialtools.html
-    *  http://localhost/~MyUserName/zoo-demo/spatialtools-py.html

Note: See TracChangeset for help on using the changeset viewer.

Open WPS platform

Changeset 240

Legend:

trunk/docs/kernel/installation.txt

Download in other formats:

Download now !

Support ZOO-Project

Search

Context Navigation

Main Navigation

ZOO Sponsors

Knowledge partners

Related links