Changeset 713 for branches/PublicaMundi_David-devel/docs/install/installation.rst

Timestamp:

Jun 30, 2015, 5:45:38 PM (9 years ago)

Author:

djay

Message:

Various fixes in installation documentation

File:

• branches/PublicaMundi_David-devel/docs/install/installation.rst (modified) (12 diffs)

branches/PublicaMundi_David-devel/docs/install/installation.rst

@@ -7 +7 @@
 steps :
 
- * build the cgic library,
- * install the ZOO-Kernel,
- * install the ZOO-Services,
- * testing your installation.
+.. contents:: 
+    :local:
+    :depth: 1
+    :backlinks: top
+
 
 Build cgic
@@ -61 +62 @@
 .................
 
+.. contents:: 
+    :local:
+    :depth: 2
+    :backlinks: top
+
 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:
+
 
 .. list-table:: Configure Options
@@ -191 +199 @@
 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
+Specific CGI Directory
+**********************
+
+In the case your ``cgi-bin`` is not located in ``/usr/lib/`` as it is
+assumed per default, then you can specify a specific target location
+by using the following option:
+
+.. code::
+
+    ./configure --with-cgi-dir=/Lbrary/WebServer/CGI-Executables
+
+This way, when you will run the ``make install`` command, the
+ZOO-Kernel will be deployed in the specified directory (so,
+`/Lbrary/WebServer/CGI-Executables`` in this example).
 
 .. _zoo_install_db_backend:
 
 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.
+between various ZOO-Kernel instances then you should use this
+option: ``--with-db-backend``. This way, both the *GetStatus*,
+*GetResult* and *Dismiss* requests can be run from any host accessing
+the same database. Obviously, this will require that the ZOO-Kernel is
+able to access the Database server. To learn how to configure this
+connection and how to create this database please refer to :ref:`[1]
+<zoo_activate_db_backend>` and :ref:`[2] <zoo_create_db_backend>`
+respectively.
 
 .. note::
@@ -231 +238 @@
 
 
+
+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
+
 Python Support (Optional) 
-..............................................
+**************************
 
 The ``--with-python=yes`` option is required to activate the :ref:`kernel_index` Python support, using the following command:
@@ -251 +280 @@
 
 Python Version
-**************
+##############
 
 If multiple Python versions are available and you want to use a
@@ -263 +292 @@
 
 PHP Support (Optional) 
-..............................................
+***********************
 
 The ``--with-php=yes`` option is required to activate the
@@ -285 +314 @@
 
 Perl Support (Optional) 
-..............................................
+************************
 
 The ``--with-perl=yes`` option can be used for activating the
@@ -305 +334 @@
 
 Java Support (Optional) 
-..............................................
+************************
 
 In order to activate the Java support for ZOO-Kernel, the
@@ -335 +364 @@
 
 JavaScript Support (Optional) 
-..............................................
+******************************
 
 In order to activate the JavaScript support for ZOO-Kernel,
@@ -361 +390 @@
 
 MapServer Support (Optional) 
-..............................................
+*****************************
 
 
@@ -378 +407 @@
 
 Orfeo Toolbox Support (Optional) 
-.....................................................
+*********************************
 
 In order to activate the optional Orfeo Toolbox support, the
@@ -397 +426 @@
 
 SAGA GIS Support (Optional) 
-.....................................................
+****************************