For the impatient

Run the following commands from the directory where you :ref:`install-download` and extracted the ZOO Kernel source code in order to build the zoo_loader.cgi CGI program with default options.

cd zoo-project/zoo-kernel
autoconf
./configure
make
make install

This should produce executables for the zoo_loader.cgi CGI program (located per default in /usr/lib/cgi-bin/) and a shared library libzoo_service (located per default in /usr/local/lib).

Configure options

This section provides information on :ref:`kernel_index` configure options. It is recommanded to also read the :ref:`kernel_config` section for configuration technical details.

Here is the list of available options as returned by ./configure --help command:

--with-cgi-dir=PATH     Specifies an alternative cgi directory path (
                        default: /usr/lib/cgi-bin)
--with-db-backend       Relies on a database for storing status messages and
                        response files
--with-yaml=PATH        Specifies an alternative location for the yaml
                        library
--with-fastcgi=PATH     Specifies an alternative location for the fastcgi
                        library
--with-xml2config=FILE  Specifies an alternative xml2-config file
--with-xsltconfig=FILE  Specifies an alternative xslt-config file
--with-gdal-config=FILE Specifies an alternative gdal-config file
--with-proj=PATH        Specifies an alternative location for PROJ4 setup
--with-geosconfig=FILE  Specifies an alternative geos-config file
--with-cgal=PATH        Specifies an alternative location for CGAL setup
--with-mapserver=PATH   Specifies the path for MapServer compiled source
                        tree
--with-python=PATH      To enable python support or Specifies an alternative
                        directory for python installation, disabled by
                        default
--with-pyvers=NUM       To use a specific python version
--with-js=PATH          Specifies --with-js=path-to-js to enable js support,
                        specify --with-js on linux debian like, js support
                        is disabled by default
--with-php=PATH         To enable php support or specify an alternative
                        directory for php installation, disabled by default
--with-java=PATH        To enable java support, specify a JDK_HOME, disabled
                        by default
--with-ruby=PATH        To enable ruby support or specify an alternative
                        directory for ruby installation, disabled by default
--with-rvers=NUM        To use a specific ruby version
--with-perl=PATH        To enable perl support or specify an alternative
                        directory for perl installation, disabled by default
--with-itk=PATH         Specifies an alternative location for the itk
                        library
--with-itk-version=VERSION
                        Specifies an alternative version for the itk library
--with-otb=PATH         Specifies an alternative location for the otb
                        library
--with-wx-config=PATH   Specifies an alternative path for the wx-config tool
--with-saga=PATH        Specifies an alternative location for the SAGA-GIS
                        library

--with-cgi-dir=PATH     Specifies an alternative cgi directory path (default: /usr/lib/cgi-bin)
--with-db-backend       Relies on a database for storing status messages and response files
--with-yaml=PATH        Specifies an alternative location for the yaml library
--with-fastcgi=PATH     Specifies an alternative location for the fastcgi library
--with-gdal-config=FILE Specifies an alternative gdal-config file
--with-xml2config=FILE  Specifies an alternative xml2-config file
--with-python=PATH      Enables python support or specifies an alternative directory for python installation (disabled by default)
--with-pyvers=NUM       Uses a specific python version
--with-js=PATH          Enables javascript support, disabled by default
--with-php=PATH         Enables php support or specify an alternative directory for php installation, disabled by default
--with-java=PATH        Enables java support or specifies a JDK_HOME, disabled by default
--with-ruby=PATH        To enable ruby support or specify an alternative directory for ruby installation, disabled by default
--with-rvers=NUM        To use a specific ruby version
--with-perl=PATH        Enables perl support or specifies an alternative directory for perl installation, disabled by default
--with-mapserver=PATH   Specifies the path for MapServer compiled source tree
--with-itk=PATH          Specifies an alternative location for the ITK library
--with-itk-version=VERSION          Specifies an alternative version for the ITK library
--with-otb=PATH         Enables optional OrfeoToolbox support
--with-wx-config=PATH   Specifies an alternative path for the wx-config tool
--with-saga=PATH        Enables optional SAGA GIS support

All the options are described in more details in the following sections.

GDAL Support (Required)

If gdal-config program is not found in your PATH, a --with-gdal-config option can be used to specify its location. For instance, if gdal-config lies in /usr/local/bin which is not in your PATH, you may use the following command:

$ ./configure --with-gdal-config=/usr/local/bin/gdal-config

XML2 Support (Required)

If xml2-config program is not found in PATH, a --with-xml2config option can be used to specify its location. For instance, if xml2-config is installed in /usr/local/bin which is not in PATH, you may use the following command:

$ ./configure --with-xml2config=/usr/local/bin/xml2-config

Use a Database Backend (Optional)

If you want to share the ongoing informations of running services between various ZOO-Kernel instances then you should activate this option. This way, both the GetStatus, GetResult and Dismiss requests can be run from any host accessing the same database.

Python Support (Optional)

The --with-python=yes option is required to activate the :ref:`kernel_index` Python support, using the following command:

$ ./configure --with-python=yes

This assumes that python-config is found in your PATH. If not, then you can specify the Python installation directory using the following command (with Python installed in the /usr/local directory):

$ ./configure --with-python=/usr/local

$ ./configure --with-pyvers=2.7

PHP Support (Optional)

The --with-php=yes option is required to activate the :ref:`kernel_index` PHP support`, using the following command:

$ ./configure --with-php=yes

This assumes that php-config can be found in the <PATH>/bin directory . So, supposing the your php-config can be found in /usr/local/bin, then use the following command:

$ ./configure --with-php=/usr/local

Perl Support (Optional)

The --with-perl=yes option can be used for activating the ZOO-Kernel Perl support, as follow:

$ ./configure --with-perl=yes

This assumes that perl is found in your PATH. For instance, if Perl is installed in /usr/local and /usr/local/bin is not found in your PATH, then the following command can be used (this assumes that /usr/local/bin/perl exists):

$ ./configure --with-perl=/usr/local

Java Support (Optional)

In order to activate the Java support for ZOO-Kernel, the --with-java configure option must be specified and sets the installation path of your Java SDK. For instance, if Java SDK is installed in the /usr/lib/jvm/java-6-sun-1.6.0.22/ directory, then the following command can be used:

$ ./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/, and that the include/linux directory contains the jni.h headers file and that the jre/lib/i386/client/ directory contains the libjvm.so file.

$ ./configure --with-java=macos

JavaScript Support (Optional)

In order to activate the JavaScript support for ZOO-Kernel, the --with-js=yes configure option must be specified. 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. The following command is only needed (assuming that js_api.h and libmozjs.so are found in default directories):

$ ./configure --with-js=yes

If you want to use a custom installation of SpiderMonkey , or if you are not using a Debian packaging system, then you'll have to specify the directory where it is installed. For instance, if SpiderMonkey is in /usr/local/, then the following command must be used:

$ ./configure --with-js=/usr/local

MapServer Support (Optional)

In order to activate the WMS, WFS and WCS output support using MapServer, the --with-mapserver option must be used. The path to mapserver-config which is located in the source code of MapServer must also be set, using the following command:

$ ./configure --with-mapserver=/path/to/your/mapserver_config/

Read more about the :ref:`kernel-mapserver`.

Orfeo Toolbox Support (Optional)

In order to activate the optional Orfeo Toolbox support, the --with-otb option must be used, using the following command:

$ ./configure --with-otb=/path/to/your/otb/

Read more about the :ref:`kernel-orfeotoolbox`.

SAGA GIS Support (Optional)

In order to activate the optional SAGA GIS support, the --with-saga option must be used, using the following command:

$ ./configure --with-saga=/path/to/your/saga/

Read more about the :ref:`kernel-sagagis`.