Installation on Unix/Linux

For the impatient

Run the following commands from the directory where you Download and extracted the ZOO Kernel source code in order to build the zoo_loader.cgi CGI program with default options.

cd zoo-kernel
autoconf
./configure
make

This should produce executables for the zoo_loader.cgi CGI program in the zoo-kernel directory. Copy the zoo_loader.cgi and main.cfg files to the HTTP server cgi directory and start using it.

Warning

Edit ZOO-Kernel installation settings in the main.cfg file (set tmpPath and tmpUrl to fit your web server configuration).

Debian / Ubuntu

Use the following instructions to install ZOO-Project on Debian or Ubuntu distributions.

Prerequisites

Using Debian

The following command should install all the required dependancies on Debian. See the Prerequisites section for additional information.

apt-get install flex bison libfcgi-dev libxml2 libxml2-dev curl openssl autoconf apache2 python-software-properties subversion python-dev libgdal1-dev build-essential libmozjs185-dev

Using Ubuntu

On Ubuntu, use the following command first to install the required dependancies :

sudo apt-get install flex bison libfcgi-dev libxml2 libxml2-dev curl openssl autoconf apache2 python-software-properties subversion libmozjs185-dev python-dev build-essential

Then add the UbuntuGIS repository in order to get the latest versions of libraries

sudo add-apt-repository ppa:ubuntugis/ppa
sudo apt-get update

Install the geographic library as follow:

sudo apt-get install libgdal1-dev

Installation

Download ZOO-Project latest version from svn using the following command:

svn checkout http://svn.zoo-project.org/svn/trunk zoo-project

Install the cgic library from packages using the following command:

cd zoo-project/thirds/cgic206/
make

Head to the ZOO-Kernel directory

cd ../../zoo-project/zoo-kernel/

Create a configure file as follow:

autoconf

Run configure with the desired options, for example with the following command:

./configure --with-js --with-python

Note

Refer to the Configure options section for the full list of available options

Compile ZOO-Kernel as follow:

make

Copy the necessary files to the cgi-bin directory (as administrator user)

cp main.cfg /usr/lib/cgi-bin
cp zoo_loader.cgi /usr/lib/cgi-bin

Install ZOO ServiceProviders, for example the basic Python service (as administrator user)

cp ../zoo-services/hello-py/cgi-env/*.zcfg /usr/lib/cgi-bin
cp ../zoo-services/hello-py/*.py /usr/lib/cgi-bin/

Edit the main.cfg file as follow (example configuration):

nano /usr/lib/cgi-bin/main.cfg
- serverAddress = http://127.0.0.1

Test the ZOO-Kernel installation with the following requests:

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

Such request should return well formed XML documents (OWS documents responses).

Warning

If ZOO-Kernel returns an error please check the ZOO-Kernel configuration and beware of the Prerequisites.

OpenSUSE

ZOO-Kernel is maintained as a package in OpenSUSE Build Service (OBS). RPM are thus provided for all versions of OpenSUSE Linux (11.2, 11.3, 11.4, Factory).

Stable release

Use the following instructions to install ZOO-Project latetst release on OpenSUSE distribution.

One-click installer

A one-click installer is available here. For openSUSE 11.4, follow this direct link.

Yast software manager

Add the Application:Geo repository to the software repositories and then ZOO-Kernel can then be found in Software Management using the provided search tool.

Command line (as root for openSUSE 11.4)

Install ZOO-Kernel package by yourself using the following command:

zypper ar http://download.opensuse.org/repositories/Application:/Geo/openSUSE_11.4/
zypper refresh
zypper install zoo-kernel

Developement 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 for the stable version. Make sure to use this repository instead.

Command line (as root for openSUSE 11.4)

Install latest ZOO-Kernel trunk version with the following command:

zypper ar http://download.opensuse.org/repositories/home:/tzotsos/openSUSE_11.4/
zypper refresh
zypper install zoo-kernel
zypper install zoo-kernel-grass-bridge

Note that there is the option of adding the zoo-wps-grass-bridge package. This option will automatically install grass7 (svn trunk).

CentOS

Use the following instructions to install ZOO-Project on CentOS distributions.

Prerequisites

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