ZooKernel description page

On this page you will find everything you need to know about the ZooKernel.

Current status

Acutaly, you could compile and use the code available on the svn server on your own GNU / LINUX platform this way :

Requirements

To be able to compile the current source, you need to have some library allready installed on your system :

• ​FastCGI (installed in /path/to/trunk/dist/, using --prefix=/path/to/trunk/dist configure option),
• ​cgic (same, use just make from the /path/to/trunk/../third/cgic/ ) .
• ​libxml2,
• ​Python.

Getting the source code

To get the source code and compile on your platform, use the following command :

cd zoo/trunk/
svn checkout svn+ssh://dev.cartography.st/mnt/data3/zoo-project/trunk/zoo-kernel zoo-kernel

Compiling the source code

First of all, you'll need to edit the Makefile and uncomment "-DLINUX_FREE_ISSUE" on the first line, then use the following commands :

cd zoo-kernel
make
make zoo_loader.cgi
make demo_service.zo

Now, you get the ZooKernel (Shell and Cgi version) and two "service providers" of different kind : demo_service.zo (C++) and test_service.py (Python).

Using the code

From the command line

To run request with ZooKernel from command command line, use the following example :

./service_loader ./ test_service.zo GetCapabilities
./service_loader ./Buffer.zcfg test_service.zo DescribeProcess
./service_loader ./Buffer.zcfg ./demo_service.zo Execute helloworld
./service_loader ./Buffer.zcfg ./demo_service.zo Execute printAgrument 1 2
./service_loader ./Buffer.zcfg ./demo_service.zo Execute printAgrument 1 2 bg
PYTHONPATH=. ./service_loader ./Distance.zcfg test_service Execute helloworld

From an apache web server

You could use the cgi version of zoo_loader on your own apache server. Do do this, use the following instruction.

Copy the cgi script, the demo service and the required files in your cgi-bin directory.

cp /path/to/trunk/zoo-kernel/zoo_loader.cgi /var/www/localhost/cgi-bin
cp /path/to/trunk/zoo-kernel/demo_service.zo /var/www/localhost/cgi-bin/test_service.zo
cp /path/to/trunk/zoo-kernel/*zcfg /var/www/localhost/cgi-bin
cp /path/to/trunk/zoo-kernel/*cfg /var/www/localhost/cgi-bin

Create a file .htaccess in a zoo directory from the directory index of your apache instalaltion.

cat > /var/www/localhost/htdocs/zoo/.htaccess << EOF
  RewriteEngine on
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteCond %{DOCUMENT_ROOT}/%{REQUEST_FILENAME} !=%{DOCUMENT_ROOT}/login.php
  RewriteRule (.*)/(.*)/(.*) /cgi-bin/zoo_loader.cgi?ServiceProvider=$2&metapath=$1 [L,QSA]
  RewriteRule (.*)/(.*)/ /cgi-bin/zoo_loader.cgi?ServiceProvider=$2&metapath=$1 [L,QSA]
  RewriteRule (.*)/(.*) /cgi-bin/zoo_loader.cgi?ServiceProvider=$1&metapath= [L,QSA]
EOF

Then you have to request your installation using your favorite browser. For instance, this ​link should work from your Apache web server.

You could also see the Cgi Version from ​Shilpa !

Some samples requests running on the Shilpa server :

• DescribeProcess? samples :
  • ​Buffer
  • ​Distance
  • ​Multiply
  • ​Gdal_Translate
  • ​Distance,Buffer
• Execute samples :
  • ​Execute Sample for Multiply Identifier.
  • ​Using Gdal_Translate to convert a GeoTiff datasource to an AAIGrid datasource.
  • ​Using Gdal_Translate to crop a GeoTiff datasource and potentialy convert datasource format

Finally you've runed two services from two services provider, the same way.