Changes between Initial Version and Version 1 of ZooWebSite/ZooKernel/InstallationNew

Timestamp:

Apr 13, 2010, 9:30:31 PM (15 years ago)

Author:

djay

Comment:

--

ZooWebSite/ZooKernel/InstallationNew

@@ +1 @@
+= ZOO Kernel Installation =
+
+The ZOO installation process requires the following libraries to be installed on your linux/mac system:
+
+    * FastCGI ( http://www.fastcgi.com )
+    * cgic ( http://www.boutell.com/cgic )
+    * libxml2 ( http://xmlsoft.org )
+    * cURL ( http://curl.haxx.se )
+    * OpenSSL ( http://www.openssl.org )
+    * Python ( http://www.python.org )
+    * PHP Embedded (optional) ( http://www.php.net )
+    * Java SDK (optional) ( http://java.sun.com )
+    * SpiderMonkey (optional) ( http://www.mozilla.org/js/spidermonkey/)
+
+= Getting the code from SVN =
+
+Please use the following command to get the ZOO Kernel source code :
+
+{{{
+svn checkout http://svn.zoo-project.org/svn/trunk zoo
+}}}
+
+= Compiling ZOO Kernel =
+
+Please use the following command to compile ZOO Kernel source code. Please use 
+./configure --help to get more informations about options.
+
+{{{
+cd trunk/zoo-kernel
+./configure --with-js=/usr/ \
+                 --with-gdal-config=/usr/bin/gdal-config \
+                 --with-php=/usr/lib/php5.2.10/ \
+                 --with-java=/opt/sun-jdk-1.6.0.02/
+make zoo_loader.cgi
+}}}
+
+= Install ZOO Kernel and ZOO ServiceProvider =
+
+Assuming that your Apache server handle cgi-scripts located in /var/www/localhost/cgi-bin, you must copy the zoo_loader.cgi script in this directory as the main.cfg file (see bellow).
+
+{{{
+# Install ZOO Kernel
+cp main.cfg /var/www/localhost/cgi-bin
+cp zoo_loader.cgi /var/www/localhost/cgi-bin
+# Install ZOO ServiceProvider
+cp ../zoo-services/hello-py/cgi-env/*.zcfg /var/www/localhost/cgi-bin
+cp ../zoo-services/hello-py/*.py /var/www/localhost/cgi-bin/
+}}}
+
+The main configuration file is named main.cfg and contains configuration parameters that can be accessed from your service (using the main_cfg parameter) or by the ZOO Kernel. Please edit main.cfg according to your environment.
+Apache ZOO .htaccess
+
+Then, create and edit a file called .htaccess in a zoo directory in your Apache DocumentRoot, using the following command:
+
+{{{
+mkdir /var/www/localhost/htdocs/zoo/
+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
+}}}
+
+= Test your ZOO installation =
+
+Finally, run the following GetCapabilities, DescribeProcess and Execute requests to test your ZOO Kernel installation :
+
+{{{
+http://my.website/zoo/?Service=WPS&Request=GetCapabilities&Version=1.0.0
+http://my.website/zoo/?Service=WPS&Request=DescribeProcess&Version=1.0.0&Identifier=HelloPy
+http://my.website/zoo/?Service=WPS&Request=Execute&Version=1.0.0&Identifier=HelloPy&DataInputs=a=My%20Name
+}}}
+
+You are done, congrats ! You can now use the ZOO Services or create your own.