Index: trunk/docs/kernel/install-centos.txt =================================================================== --- trunk/docs/kernel/install-centos.txt (revision 240) +++ trunk/docs/kernel/install-centos.txt (revision 240) @@ -0,0 +1,165 @@ +.. _kernel-installation-centos: + +CentOS +====== + +.. contents:: Table of Contents + :depth: 2 + :backlinks: top + +.. 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 `__ +and `line 175 `__ 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 Index: trunk/docs/kernel/install-debian.txt =================================================================== --- trunk/docs/kernel/install-debian.txt (revision 240) +++ trunk/docs/kernel/install-debian.txt (revision 240) @@ -0,0 +1,130 @@ +.. _kernel-installation-debian: + +Debian / Ubuntu +=============== + +.. contents:: Table of Contents + :depth: 2 + :backlinks: top + +.. 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 `__ or use the xulrunner-dev package + which includes SpiderMonkey. + For PHP, you must make sure to compile PHP with `--enable-embed `__. + +:: + + ./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 + + +- 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= Index: trunk/docs/kernel/install-mac.txt =================================================================== --- trunk/docs/kernel/install-mac.txt (revision 240) +++ trunk/docs/kernel/install-mac.txt (revision 240) @@ -0,0 +1,188 @@ +.. _kernel-installation-mac: + +Mac OS X +======== + +.. contents:: Table of Contents + :depth: 2 + :backlinks: top + +Using the Installer +------------------- + +1. To install a default build of the ZOO-Project on your Mac OS X computer use the `installer `__. + + .. 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`` + +2. Make sure that your Apache server is running, and then access the ZOO Project Demo at: + + http://localhost/zoo-demo/spatialtools.html + +3. To add additional services, please follow the following intructions to compile your own ZOO Project instance. + +Compiling from Source +--------------------- + +1. Install `Xcode `__. + +2. 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 `__. + + 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 + +3. Then, create a ``src`` directory and inside that directory download the `gettext source code `__ 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 + +4. 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 `__ +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 `__ 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 `__ +if everything is ok with your setup. + +Test using Local Demo Page +-------------------------- + +- Download the `OpenLayers `__ library and uncompress it in your personal Sites directory + (located in your home directory). + +- Rename the OpenLayers directory as openlayers. + +- Download this `zip archive `__ + 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 + + Index: trunk/docs/kernel/install-opensuse.txt =================================================================== --- trunk/docs/kernel/install-opensuse.txt (revision 240) +++ trunk/docs/kernel/install-opensuse.txt (revision 240) @@ -0,0 +1,64 @@ +.. _kernel-installation-opensuse: + +OpenSUSE +======== + +.. contents:: Table of Contents + :depth: 2 + :backlinks: top + +Zoo-Kernel is maintained as a package in `OpenSUSE Build Service (OBS) `__. +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 `__. +For openSUSE 11.4 this is the direct `link `__. + +Yast Software Manager using a GUI +********************************* + +The `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 `__. +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 `__ 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 Index: trunk/docs/kernel/install-prerequisites.txt =================================================================== --- trunk/docs/kernel/install-prerequisites.txt (revision 240) +++ trunk/docs/kernel/install-prerequisites.txt (revision 240) @@ -0,0 +1,70 @@ +.. _kernel-installation-prereq: + +Prerequisites +============= + +.. contents:: Table of Contents + :depth: 2 + :backlinks: top + +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* Index: trunk/docs/kernel/install-unix.txt =================================================================== --- trunk/docs/kernel/install-unix.txt (revision 240) +++ trunk/docs/kernel/install-unix.txt (revision 240) @@ -0,0 +1,204 @@ +.. _kernel-installation-unix: + +Unix +==== + +.. contents:: Table of Contents + :depth: 2 + :backlinks: top + +.. note:: + You must be sure to perform the :ref:`prerequisite steps ` before following this page. + +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. Index: trunk/docs/kernel/install-windows.txt =================================================================== --- trunk/docs/kernel/install-windows.txt (revision 240) +++ trunk/docs/kernel/install-windows.txt (revision 240) @@ -0,0 +1,169 @@ +.. _kernel-installation-windows: + +Windows +======= + +.. contents:: Table of Contents + :depth: 2 + :backlinks: top + +Using OSGeo4W +------------- + +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 `__ +contains full dependencies required to compile on WIN32 platform and this one contains `full runtime dependencies to place `__ +in your c:\OSGeo4W\bin. + +Download and Install ZOO Kernel +******************************* + +Download the `binary version `__ 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 `__. + +Deploy ZOO Services Providers +***************************** + +Your can use the binary version of the OGR Services Provider available from `here `__. +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). + +1. Make sure the gnuwin32 tools ``bison.exe`` and ``flex.exe`` are found in your path. You can download the GNUwin32 tools `here `__. + +2. 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 `__. + You can also find a modified ``zoo-project\zoo-kernel\makefile.vc`` file `here `__. + +3. Execute: + + :: + + nmake /f makefile.vc + +4. 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 + +5. Copy the files ``zoo_loader.cgi`` and ``main.cfg`` into your cgi-bin directory. + +6. 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 + + + + + Parameter <request> was not specified + + + +7. 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 + +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 + + The response should be displayed in your browser, such as: + + :: + + + + The Zoo WPS Development Server + + Development version of ZooWPS. See http://www.zoo-project.org + + + WPS + GIS + buffer + + WPS + 1.0.0 + ... + +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. + +1. 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. + +2. Copy all of the files inside ``zoo-services\ogr\base-vect-ops\cgi-env`` into your cgi-bin directory + +3. 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: + + :: + + Service "Buffer" run successfully. + Index: trunk/docs/kernel/installation.txt =================================================================== --- trunk/docs/kernel/installation.txt (revision 230) +++ trunk/docs/kernel/installation.txt (revision 240) @@ -4,968 +4,16 @@ ============ -.. 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 ` 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) `__. -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 `__. -For openSUSE 11.4 this is the direct `link `__. - -Yast Software Manager using a GUI -################################# - -The `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 `__. -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 `__ 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 `__ -and `line 175 `__ 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 `__ or use the xulrunner-dev package - which includes SpiderMonkey. - For PHP, you must make sure to compile PHP with `--enable-embed `__. - -:: - - ./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= - -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 `__ -contains full dependencies required to compile on WIN32 platform and this one contains `full runtime dependencies to place `__ -in your c:\OSGeo4W\bin. - -Download and Install ZOO Kernel -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Download the `binary version `__ 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 `__. - -Deploy ZOO Services Providers -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Your can use the binary version of the OGR Services Provider available from `here `__. -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). - -1. Make sure the gnuwin32 tools ``bison.exe`` and ``flex.exe`` are found in your path. You can download the GNUwin32 tools `here `__. - -2. 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 `__. - You can also find a modified ``zoo-project\zoo-kernel\makefile.vc`` file `here `__. - -3. Execute: - - :: - - nmake /f makefile.vc - -4. 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 - -5. Copy the files ``zoo_loader.cgi`` and ``main.cfg`` into your cgi-bin directory. - -6. 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 - - - - - Parameter <request> was not specified - - - -7. 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 - -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 - - The response should be displayed in your browser, such as: - - :: - - - - The Zoo WPS Development Server - - Development version of ZooWPS. See http://www.zoo-project.org - - - WPS - GIS - buffer - - WPS - 1.0.0 - ... - -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. - -1. 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. - -2. Copy all of the files inside ``zoo-services\ogr\base-vect-ops\cgi-env`` into your cgi-bin directory - -3. 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: - - :: - - Service "Buffer" run successfully. - -Mac OS X --------- - -Using the Installer -******************* - -1. To install a default build of the ZOO-Project on your Mac OS X computer use the `installer `__. - - .. 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`` - -2. Make sure that your Apache server is running, and then access the ZOO Project Demo at: - - http://localhost/zoo-demo/spatialtools.html - -3. To add additional services, please follow the following intructions to compile your own ZOO Project instance. - -Compiling from Source -********************* - -1. Install `Xcode `__. - -2. 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 `__. - - 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 - -3. Then, create a ``src`` directory and inside that directory download the `gettext source code `__ 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 - -4. 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 `__ -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 `__ 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 `__ -if everything is ok with your setup. - -Test using Local Demo Page -************************** - -- Download the `OpenLayers `__ library and uncompress it in your personal Sites directory - (located in your home directory). - -- Rename the OpenLayers directory as openlayers. - -- Download this `zip archive `__ - 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 - - -