Ignore:
Timestamp:
Jun 30, 2015, 10:35:39 AM (9 years ago)
Author:
djay
Message:

Small fixes in the main documentation.

Location:
branches/PublicaMundi_David-devel/docs/install
Files:
3 added
1 deleted
1 edited
4 moved

Legend:

Unmodified
Added
Removed
  • branches/PublicaMundi_David-devel/docs/install/download.rst

    • Property svn:keywords set to Date Author
    r695 r696  
    1919::
    2020
    21   svn checkout http://svn.zoo-project.org/svn/trunk zoo-project
     21  svn checkout http://svn.zoo-project.org/svn/trunk zoo-src
    2222
    2323Registered ZOO-Project developers would prefer the following:
     
    2626
    2727  sed "s:\[tunnels\]:\[tunnels\]\nzoosvn = /usr/bin/ssh -p 1046:g" -i ~/.subversion/config
    28   svn co svn+zoosvn://svn.zoo-project.org/var/svn/repos/trunk zoo-project
     28  svn co svn+zoosvn://svn.zoo-project.org/var/svn/repos/trunk zoo-src
    2929 
    3030.. note::
  • branches/PublicaMundi_David-devel/docs/install/index.rst

    • Property svn:keywords set to Date Author
    r684 r696  
    1010   :maxdepth: 2
    1111   
    12    install-prerequisites
    13    install-download
    14    install-confoptions
    15    install-installation
    16    install-onwindows
     12   prerequisites
     13   download
     14   installation
     15   debian
     16   opensuse
     17   centos
     18   windows
    1719
    1820
  • branches/PublicaMundi_David-devel/docs/install/installation.rst

    • Property svn:keywords set to Date Author
    r695 r696  
    22
    33Installation on Unix/Linux
    4 =================
     4==========================
     5
     6To build and install ZOO-Project on your Web Server you will need 4
     7steps :
     8
     9 * build the cgic library,
     10 * install the ZOO-Kernel,
     11 * install the ZOO-Services,
     12 * testing your installation.
     13
     14Build cgic
     15----------
     16
     17Run the following commands from the ``thirds/cgic`` directory to build
     18the cgic library.
     19
     20::
     21
     22   cd thirds/cgic
     23   make
     24
     25The cgic library originaly come from `http://www.boutell.com/cgic
     26<http://www.boutell.com/cgic>`_.
     27
     28.. warning::
     29
     30   You may need to edit the ``Makefile`` in case you are using a 64 bits
     31   platform for building and your fcgi library is not located in ``/usr/lib64``.
     32
     33Install the ZOO-Kernel
     34----------------------
     35
    536
    637For the impatient
    7 --------------
     38.................
    839
    940Run 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.
     
    1142::
    1243
    13    cd zoo-kernel
     44   cd zoo-project/zoo-kernel
    1445   autoconf 
    1546   ./configure
    1647   make
    17 
    18 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.
     48   make install
     49
     50This should produce executables for the *zoo_loader.cgi* CGI program
     51(located per default in ``/usr/lib/cgi-bin/``) and a shared library
     52``libzoo_service``  (located per default in ``/usr/local/lib``).
    1953
    2054.. warning::
    2155
    22    Edit ZOO-Kernel installation settings in the *main.cfg* file (set ``tmpPath`` and ``tmpUrl`` to fit your web server configuration).
    23 
    24 Debian / Ubuntu
    25 ----------------------
    26 
    27 Use the following instructions to install `ZOO-Project <http://zoo-project.org>`__ on Debian or Ubuntu distributions.
    28 
    29 Prerequisites
    30 ......................
    31 
    32 Using Debian
    33 **********************
    34 
    35 The following command should install all the required dependancies on Debian. See the :ref:`install-prereq` section for additional information.
    36 
    37 .. code-block:: guess
    38 
    39    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
    40 
    41 Using Ubuntu
    42 **********************
    43 
    44 On Ubuntu, use the following command first to install the required dependancies :
    45 
    46 .. code-block:: guess
    47 
    48    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
    49 
    50 Then add the *UbuntuGIS* repository in order to get the latest versions of libraries
    51 
    52 .. code-block:: guess
    53 
    54    sudo add-apt-repository ppa:ubuntugis/ppa
    55    sudo apt-get update
    56 
    57 Install the geographic library as follow:
    58 
    59 .. code-block:: guess
    60 
    61    sudo apt-get install libgdal1-dev
    62 
    63 
    64 Installation
    65 ......................
    66 
    67 :ref:`install-download` ZOO-Project latest version from svn using the following command:
    68 
    69 .. code-block:: guess
    70 
    71   svn checkout http://svn.zoo-project.org/svn/trunk zoo-project
    72 
    73 Install the *cgic* library from packages using the following command:
    74 
    75 .. code-block:: guess
    76 
    77   cd zoo-project/thirds/cgic206/
    78   make
    79 
    80 Head to the :ref:`kernel_index` directory
    81 
    82 .. code-block:: guess
    83 
    84   cd ../../zoo-project/zoo-kernel/
    85 
    86 Create a configure file as follow:
    87 
    88 .. code-block:: guess
    89 
    90   autoconf
    91 
    92 Run configure with the desired options, for example with the following command:
    93 
    94 .. code-block:: guess
    95 
    96   ./configure --with-js --with-python
     56   Edit ZOO-Kernel installation settings in the ``main.cfg`` file (set
     57   ``tmpPath`` and ``tmpUrl`` to fit your web server configuration).
     58
     59
     60Configure options
     61.................
     62
     63This section provides information on :ref:`kernel_index` configure options. It is recommanded to also read the :ref:`kernel_config` section for configuration technical details.
     64
     65Here is the list of available options as returned by ``./configure --help`` command:
     66
     67.. list-table:: Configure Options
     68   :header-rows: 1
     69
     70   * - Option
     71     - Description
     72   * - ``--with-cgi-dir=PATH``
     73     - Specifies an alternative cgi directory path (default:
     74       /usr/lib/cgi-bin)
     75   * - ``--with-db-backend``
     76     - Relies on a database for storing status messages and response
     77       files
     78   * - ``--with-yaml=PATH``
     79     - Specifies an alternative location for the yaml library
     80   * - ``--with-fastcgi=PATH``
     81     - Specifies an alternative location for the fastcgi library
     82   * - ``--with-gdal-config=FILE``
     83     - Specifies an alternative gdal-config file
     84   * - ``--with-xml2config=FILE``
     85     - Specifies an alternative xml2-config file
     86   * - ``--with-python=PATH``
     87     - Enables python support or specifies an alternative directory
     88       for python installation (disabled by default)
     89   * - ``--with-pyvers=NUM``
     90     - Uses a specific python version
     91   * - ``--with-js=PATH``
     92     - Enables javascript support, disabled by default
     93   * - ``--with-php=PATH``
     94     - Enables php support or specify an alternative directory for php
     95       installation, disabled by default
     96   * - ``--with-java=PATH``
     97     - Enables java support or specifies a JDK_HOME, disabled by
     98       default
     99   * - ``--with-ruby=PATH``
     100     - To enable ruby support or specify an alternative directory for
     101       ruby installation, disabled by default
     102   * - ``--with-rvers=NUM``
     103     - To use a specific ruby version
     104   * - ``--with-perl=PATH``
     105     - Enables perl support or specifies an alternative directory for
     106       perl installation, disabled by default
     107   * - ``--with-mapserver=PATH``
     108     - Specifies the path for MapServer compiled source tree
     109   * - ``--with-itk=PATH``
     110     - Specifies an alternative location for the ITK library
     111   * - ``--with-itk-version=VERSION``
     112     - Specifies an alternative version for the ITK library
     113   * - ``--with-otb=PATH``
     114     - Enables optional OrfeoToolbox support
     115   * - ``--with-wx-config=PATH``
     116     - Specifies an alternative path for the wx-config tool
     117   * - ``--with-saga=PATH``
     118     - Enables optional SAGA GIS support
     119
     120
     121.. code ::
     122
     123  --with-cgi-dir=PATH     Specifies an alternative cgi directory path (
     124                          default: /usr/lib/cgi-bin)
     125  --with-db-backend       Relies on a database for storing status messages and
     126                          response files
     127  --with-yaml=PATH        Specifies an alternative location for the yaml
     128                          library
     129  --with-fastcgi=PATH     Specifies an alternative location for the fastcgi
     130                          library
     131  --with-xml2config=FILE  Specifies an alternative xml2-config file
     132  --with-xsltconfig=FILE  Specifies an alternative xslt-config file
     133  --with-gdal-config=FILE Specifies an alternative gdal-config file
     134  --with-proj=PATH        Specifies an alternative location for PROJ4 setup
     135  --with-geosconfig=FILE  Specifies an alternative geos-config file
     136  --with-cgal=PATH        Specifies an alternative location for CGAL setup
     137  --with-mapserver=PATH   Specifies the path for MapServer compiled source
     138                          tree
     139  --with-python=PATH      To enable python support or Specifies an alternative
     140                          directory for python installation, disabled by
     141                          default
     142  --with-pyvers=NUM       To use a specific python version
     143  --with-js=PATH          Specifies --with-js=path-to-js to enable js support,
     144                          specify --with-js on linux debian like, js support
     145                          is disabled by default
     146  --with-php=PATH         To enable php support or specify an alternative
     147                          directory for php installation, disabled by default
     148  --with-java=PATH        To enable java support, specify a JDK_HOME, disabled
     149                          by default
     150  --with-ruby=PATH        To enable ruby support or specify an alternative
     151                          directory for ruby installation, disabled by default
     152  --with-rvers=NUM        To use a specific ruby version
     153  --with-perl=PATH        To enable perl support or specify an alternative
     154                          directory for perl installation, disabled by default
     155  --with-itk=PATH         Specifies an alternative location for the itk
     156                          library
     157  --with-itk-version=VERSION
     158                          Specifies an alternative version for the itk library
     159  --with-otb=PATH         Specifies an alternative location for the otb
     160                          library
     161  --with-wx-config=PATH   Specifies an alternative path for the wx-config tool
     162  --with-saga=PATH        Specifies an alternative location for the SAGA-GIS
     163                          library
     164
     165
     166
     167
     168::
     169
     170  --with-cgi-dir=PATH     Specifies an alternative cgi directory path (default: /usr/lib/cgi-bin)
     171  --with-db-backend       Relies on a database for storing status messages and response files
     172  --with-yaml=PATH        Specifies an alternative location for the yaml library
     173  --with-fastcgi=PATH     Specifies an alternative location for the fastcgi library
     174  --with-gdal-config=FILE Specifies an alternative gdal-config file
     175  --with-xml2config=FILE  Specifies an alternative xml2-config file
     176  --with-python=PATH      Enables python support or specifies an alternative directory for python installation (disabled by default)
     177  --with-pyvers=NUM       Uses a specific python version
     178  --with-js=PATH          Enables javascript support, disabled by default
     179  --with-php=PATH         Enables php support or specify an alternative directory for php installation, disabled by default
     180  --with-java=PATH        Enables java support or specifies a JDK_HOME, disabled by default
     181  --with-ruby=PATH        To enable ruby support or specify an alternative directory for ruby installation, disabled by default
     182  --with-rvers=NUM        To use a specific ruby version
     183  --with-perl=PATH        Enables perl support or specifies an alternative directory for perl installation, disabled by default
     184  --with-mapserver=PATH   Specifies the path for MapServer compiled source tree
     185  --with-itk=PATH          Specifies an alternative location for the ITK library
     186  --with-itk-version=VERSION          Specifies an alternative version for the ITK library     
     187  --with-otb=PATH         Enables optional OrfeoToolbox support
     188  --with-wx-config=PATH   Specifies an alternative path for the wx-config tool
     189  --with-saga=PATH        Enables optional SAGA GIS support
     190
     191All the options are described in more details in the following sections.
     192
     193GDAL Support (Required)
     194........................
     195
     196If gdal-config program is not found in your ``PATH``, a
     197``--with-gdal-config`` option can be used to specify its location. For
     198instance, if ``gdal-config`` lies in ``/usr/local/bin`` which is not in
     199your PATH, you may use the following command:
     200
     201::
     202
     203  $ ./configure --with-gdal-config=/usr/local/bin/gdal-config
     204
     205XML2 Support (Required)
     206........................
     207
     208If 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:
     209
     210::
     211
     212  $ ./configure --with-xml2config=/usr/local/bin/xml2-config
     213
     214
     215Python Support (Optional)
     216..............................................
     217
     218The ``--with-python=yes`` option is required to activate the :ref:`kernel_index` Python support, using the following command:
     219
     220::
     221
     222  $ ./configure --with-python=yes
     223
     224This assumes that python-config is found in your ``PATH``. If not,
     225then you can specify the Python installation directory using the
     226following command (with Python installed in the ``/usr/local``
     227directory):
     228
     229::
     230
     231  $ ./configure --with-python=/usr/local
     232
     233
     234Python Version
     235**************
     236
     237If multiple Python versions are available and you want to use a
     238specific one, then you can use the ``--with-pyvers`` option as shown
     239bellow:
     240
     241::
     242
     243  $ ./configure --with-pyvers=2.7
     244
     245
     246PHP Support (Optional)
     247..............................................
     248
     249The ``--with-php=yes`` option is required to activate the
     250:ref:`kernel_index` PHP support`, using the following command:
     251
     252::
     253
     254  $ ./configure --with-php=yes
     255
     256This assumes that ``php-config`` can be found in the ``<PATH>/bin``
     257directory . So, supposing the your ``php-config`` can be found in
     258``/usr/local/bin``, then use the following command:
     259
     260::
     261
     262  $ ./configure --with-php=/usr/local
     263
     264.. warning::
     265    ZOO-Kernel optional PHP support requires a local PHP Embedded installation. Read more `here <http://zoo-project.org/trac/wiki/ZooKernel/Embed/PHP>`__.
     266
     267
     268Perl Support (Optional)
     269..............................................
     270
     271The ``--with-perl=yes`` option can be used for activating the
     272ZOO-Kernel Perl support, as follow:
     273
     274::
     275
     276  $ ./configure --with-perl=yes
     277
     278This assumes that perl is found in your PATH. For instance, if Perl is
     279installed in ``/usr/local`` and ``/usr/local/bin`` is not found in
     280your ``PATH``, then the following command can be used (this assumes
     281that ``/usr/local/bin/perl`` exists):
     282
     283::
     284
     285  $ ./configure --with-perl=/usr/local
     286
     287
     288Java Support (Optional)
     289..............................................
     290
     291In order to activate the Java support for ZOO-Kernel, the
     292`--with-java` configure option must be specified and sets the
     293installation path of your Java SDK. For instance,  if Java SDK is
     294installed in the ``/usr/lib/jvm/java-6-sun-1.6.0.22/`` directory,
     295then the following command can be used:
     296
     297::
     298
     299  $ ./configure --with-java=/usr/lib/jvm/java-6-sun-1.6.0.22/
     300
     301This assumes that the ``include/linux`` and ``jre/lib/i386/client/``
     302subdirectories exist in ``/usr/lib/jvm/java-6-sun-1.6.0.22/``, and
     303that the ``include/linux`` directory contains the ``jni.h`` headers file
     304and that the ``jre/lib/i386/client/`` directory contains the ``libjvm.so``
     305file.
     306
     307
     308.. note::
     309   With Mac OS X you only have to set *macos* as the value for the
     310   ``--with-java`` option to activate Java support. For example:
     311
     312   ::
     313
     314     $ ./configure --with-java=macos
     315
     316.. _js-support:
     317
     318JavaScript Support (Optional)
     319..............................................
     320
     321In order to activate the JavaScript support for ZOO-Kernel,
     322the ``--with-js=yes`` configure option must be specified. If you are using
     323a "Debian-like" GNU/Linux distribution then  dpkg will be used to
     324detect if the required packages are installed and you don't have to
     325specify anything here. The following command is only needed (assuming
     326that js_api.h and libmozjs.so are found in default directories):
     327
     328
     329::
     330
     331  $ ./configure --with-js=yes
     332
     333If you want to use a custom installation of `SpiderMonkey
     334<https://developer.mozilla.org/en/SpiderMonkey>`__ , or if you are not
     335using a Debian packaging  system, then you'll have to specify the
     336directory where it is installed. For  instance, if SpiderMonkey is in
     337``/usr/local/``, then the following command must be used:
     338
     339::
     340
     341  $ ./configure --with-js=/usr/local
     342
     343
     344MapServer Support (Optional)
     345..............................................
     346
     347
     348In order to activate the WMS, WFS and WCS output support using
     349MapServer, the ``--with-mapserver`` option must be used. The path to
     350``mapserver-config`` which is located in the source code of MapServer
     351must also be set, using the following command:
     352
     353::
     354
     355  $ ./configure --with-mapserver=/path/to/your/mapserver_config/
     356
     357
     358Read more about the :ref:`kernel-mapserver`.
     359
     360
     361Orfeo Toolbox Support (Optional)
     362.....................................................
     363
     364In order to activate the optional Orfeo Toolbox support, the
     365``--with-otb`` option must be used, using the following command:
     366
     367::
     368
     369  $ ./configure --with-otb=/path/to/your/otb/
     370
     371
     372Read more about the :ref:`kernel-orfeotoolbox`.
     373
     374.. warning::
     375    To build the Orfeo Toolbox support you will require ITK, the
     376    default version of ITK is 4.5, in case you use another version,
     377    please make sure to use the ``--with-itk-version`` to specificy
     378    what is the version available on your system.
     379
     380SAGA GIS Support (Optional)
     381.....................................................
     382
     383
     384In order to activate the optional SAGA GIS support, the *--with-saga* option must be used, using the following command:
     385
     386::
     387
     388  $ ./configure --with-saga=/path/to/your/saga/
     389
     390
     391Read more about the :ref:`kernel-sagagis`.
     392
     393.. warning::
     394    In case wx-config is not in your ``PATH`` please, make sure to use
     395    the ``--with-wx-config``  to specify its location.
     396
     397Install ZOO-Services
     398--------------------
     399
     400.. warning::
     401    We present here a global installation procedure for basics
     402    ZOO-Services, for details about automatic installation of services
     403    provided by :ref:`kernel-orfeotoolbox` or :ref:`kernel-sagagis`,
     404    please refer to there specific documentations.
     405
     406Depending on the programming language used to implement the
     407ZOO-Services you want to install, you will need to build a
     408Services Provider. In the case of *C* and *Fotran*, you would create a
     409shared library exporting the functions corresponding to all the
     410ZOO-Services provided by this Services Provider. In case of *Java*,
     411you will need to build a Java Class. In any other programming
     412language, you should simply have to install the ServiceProvider and
     413the zcfg files.
     414
     415If building a Shared library or a Java class is required, then you
     416should find a ``Makefile`` in the service directory which is
     417responsible to help you build this Services Provider. So you should
     418simply run the `make` command from the Service directory to generate
     419the required file.
     420
     421Then you simply need to copy the content of the ``cgi-env`` directory
     422in ``cgi-bin``.
     423
     424To install the ``ogr/base-vect-ops`` Services Provider, supposing that
     425your ``cgi-bin`` directory is ``/usr/local/lib`` use the following
     426commands:
     427
     428.. code::
     429
     430    cd zoo-project/zoo-services/ogr/base-vect-ops
     431    make
     432    cp cgi-env/*.* /usr/lib/cgi-bin
    97433
    98434.. note::
    99    Refer to the :ref:`install-configure` section for the full list of available options
    100 
    101 Compile ZOO-Kernel as follow:
    102 
    103 .. code-block:: guess
    104 
    105   make
    106 
    107 Copy the necessary files to the `cgi-bin` directory (as administrator user)
    108 
    109 .. code-block:: guess
    110 
    111   cp main.cfg /usr/lib/cgi-bin
    112   cp zoo_loader.cgi /usr/lib/cgi-bin
    113 
    114 Install ZOO ServiceProviders, for example the basic Python service (as administrator user)
    115 
    116 .. code-block:: guess
    117 
    118   cp ../zoo-services/hello-py/cgi-env/*.zcfg /usr/lib/cgi-bin
    119   cp ../zoo-services/hello-py/*.py /usr/lib/cgi-bin/
    120 
    121 Edit the *main.cfg* file as follow (example configuration):
    122 
    123 .. code-block:: guess
    124 
    125   nano /usr/lib/cgi-bin/main.cfg
    126   - serverAddress = http://127.0.0.1
    127 
    128 
    129 Test the ZOO-Kernel installation with the following requests:
    130 
    131 .. code-block:: guess
    132 
    133    http://127.0.0.1/cgi-bin/zoo_loader.cgi?ServiceProvider=&metapath=&Service=WPS&Request=GetCapabilities&Version=1.0.0
    134 
    135 .. code-block:: guess
    136 
    137    http://127.0.0.1/cgi-bin/zoo_loader.cgi?ServiceProvider=&metapath=&Service=WPS&Request=DescribeProcess&Version=1.0.0&Identifier=HelloPy
    138 
    139 .. code-block:: guess
    140 
    141    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
    142 
    143 
    144 .. note::
    145 
    146    Such request should return well formed XML documents (OWS documents responses).
    147 
    148 .. warning::
    149 
    150    If ZOO-Kernel returns an error please check the :ref:`kernel_config` and beware of the :ref:`install-prereq`.
    151 
    152 
    153 OpenSUSE
    154 ----------------------
    155 
    156 :ref:`kernel_index` is maintained as a package in `OpenSUSE Build Service (OBS) <https://build.opensuse.org/package/show?package=zoo-kernel&project=Application%3AGeo>`__. RPM are thus provided for all versions of OpenSUSE Linux (11.2, 11.3, 11.4, Factory).
    157 
    158 Stable release
    159 ......................
    160 
    161 Use the following instructions to install ZOO-Project latetst release on OpenSUSE distribution.
    162 
    163 One-click installer
    164 *******************
    165 
    166 A one-click installer is available `here <http://software.opensuse.org/search?q=zoo-kernel&baseproject=openSUSE%3A11.4&lang=en&exclude_debug=true>`__.
    167 For openSUSE 11.4, follow this direct `link <http://software.opensuse.org/ymp/Application:Geo/openSUSE_11.4/zoo-kernel.ymp?base=openSUSE%3A11.4&query=zoo-kernel>`__.
    168 
    169 Yast software manager
    170 *********************
    171 
    172 Add the `Application:Geo <http://download.opensuse.org/repositories/Application:/Geo/>`__ repository to the software repositories and then ZOO-Kernel can then be found in Software Management using the provided search tool.
    173 
    174 Command line (as root for openSUSE 11.4)
    175 ****************************************
    176 
    177 Install ZOO-Kernel package by yourself using the following command:
    178 
    179 .. code-block:: guess
    180 
    181   zypper ar http://download.opensuse.org/repositories/Application:/Geo/openSUSE_11.4/
    182   zypper refresh
    183   zypper install zoo-kernel
    184 
    185 Developement version
    186 ......................
    187 
    188 The latest development version of ZOO-Kernel can be found in OBS under the project `home:tzotsos <https://build.opensuse.org/project/show?project=home%3Atzotsos>`__. 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 <http://download.opensuse.org/repositories/home:/tzotsos/>`__ repository instead.
    189 
    190 Command line (as root for openSUSE 11.4)
    191 ********************************************
    192 
    193 Install latest ZOO-Kernel trunk version with the following command:
    194 
    195 .. code-block:: guess
    196 
    197   zypper ar http://download.opensuse.org/repositories/home:/tzotsos/openSUSE_11.4/
    198   zypper refresh
    199   zypper install zoo-kernel
    200   zypper install zoo-kernel-grass-bridge
    201 
    202 Note that there is the option of adding the zoo-wps-grass-bridge package. This option will automatically install grass7 (svn trunk).
    203 
    204 
    205 CentOS
    206 ----------------------
    207 
    208 Use the following instructions to install `ZOO-Project <http://zoo-project.org>`__ on CentOS distributions.
    209 
    210 Prerequisites
    211 ......................
    212 
    213 .. code-block:: guess
    214 
    215   yum install apache2
    216   yum install build-essentials
    217   yum install gcc-c++
    218   yum install zlib-devel
    219   yum install libxml2-devel
    220   yum install bison
    221   yum install openssl
    222   yum install python-devel
    223   yum install subversion
    224 
    225 
    226 Compile then install FastCGI library from source
    227 
    228 ::
    229 
    230   wget http://www.fastcgi.com/dist/fcgi.tar.gz
    231   tar xzf fcgi-2.4.0.tar.gz
    232   ./configure
    233   make
    234   make install
    235   echo /usr/local/lib >> /etc/ld.so.conf.d/local.conf
    236   ldconfig
    237 
    238 Compile then install the autoconf tools :
    239 
    240 ::
    241 
    242   wget http://ftp.gnu.org/gnu/autoconf/autoconf-latest.tar.gz
    243   tar xzf autoconf-latest.tar.gz
    244   ./configure --prefix=/usr
    245   make
    246   make install
    247 
    248 Compile then install the flex tool :
    249 
    250 ::
    251 
    252   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
    253   tar xzf flex-2.5.35.tar.gz
    254   cd flex-2.5.35
    255   ./configure --prefix=/usr
    256   make
    257   make install
    258 
    259 Using the curl provided in the CentOS distribution will produce a ZOO-Kernel unable to run any
    260 Service. Indeed, some segmentation faults occur when trying to run ``Execute`` requests on the ZOO-Kernel,
    261 compiling the ZOO-Kernel setting ``USE_GDB`` flag in the ``CFLAGS`` of your ``Makefile`` will let you run
    262 ZOO-Kernel from gdb and be able to get more information on what is going wrong with your ZOO-Kernel.
    263 Doing this we can figure out that code on `line 173 <http://zoo-project.org/trac/browser/trunk/zoo-kernel/ulinet.c#L173>`__
    264 and `line 175 <http://zoo-project.org/trac/browser/trunk/zoo-kernel/ulinet.c#L175>`__ have to be commented in the
    265 ``ulinet.c`` file to get a ZOO-Kernel working using the curl available in CentOS (curl version 7.15.5).
    266 If you don't apply the modification, you will get an error from a gdb session pointing
    267 segfault in ``Curl_cookie_clearall``.
    268 
    269 You can optionally compile then install curl from source :
    270 
    271 ::
    272 
    273   wget http://curl.haxx.se/download/curl-7.21.3.tar.bz2
    274   tar xjf curl-7.21.3.tar.bz2
    275   cd curl-7.21.3
    276   ./configure --prefix=/usr
    277   make
    278   make install
    279 
    280 Compile then install Python :
    281 
    282 ::
    283  
    284   wget http://www.python.org/ftp/python/2.6.6/Python-2.6.6.tar.bz2
    285   tar xjf Python-2.6.6.tar.bz2
    286   cd Python-2.6.6
    287   ./configure
    288   make
    289   make install
    290 
    291 Compile then install your own GDAL library :
    292 
    293 ::
    294 
    295   wget http://download.osgeo.org/gdal/gdal-1.7.3.tar.gz
    296   tar xzf gdal-1.7.3.tar.gz
    297   cd gdal-1.7.3
    298   ./configure  # add your options here
    299   make
    300   make install
    301 
    302 Install the Sun JAVA SDK into ``/usr/share`` then use the following command to ensure that the ``libjvm.so``
    303 will be found at runtime from any context.
    304 
    305 ::
    306 
    307   echo /usr/share/java-1.6.0-openjdk-1.6.0.0/jre/lib/i386/client/ >> /etc/ld.so.conf.d/jvm.conf
    308   ldconfig
    309  
     435    You may also run ``make install`` directly after ``make``.
     436
     437
     438To install the hello-py Services Provider, use the following commands:
     439
     440.. code::
     441
     442    cd zoo-project/zoo-services/hello-py/
     443    cp cgi-env/* /usr/lib/cgi-bin
     444
     445
     446Testing your installation
     447-------------------------
     448
     449To test your installation yous should first be able to run the
     450following command from the ``cgi-bin`` directory:
     451
     452.. code::
     453
     454    ./zoo_loader.cgi "request=GetCapabilities&service=WPS"
     455
     456
  • branches/PublicaMundi_David-devel/docs/install/prerequisites.rst

    • Property svn:keywords set to Date Author
    r695 r696  
    1010
    1111- autoconf (`http://www.gnu.org/software/autoconf/ <http://www.gnu.org/software/autoconf/>`_)
    12 - cgic (`http://www.boutell.com/cgic <http://www.boutell.com/cgic>`_)
     12- gettext (`https://www.gnu.org/software/gettext/ <https://www.gnu.org/software/gettext/>`_ )
    1313- cURL (`http://curl.haxx.se <http://curl.haxx.se>`_ )
    1414- FastCGI (`http://www.fastcgi.com <http://www.fastcgi.com>`_ )
     
    1616- libxml2 (  http://xmlsoft.org )
    1717- OpenSSL (  http://www.openssl.org )
    18 - Python (  http://www.python.org )
    19 - GDAL (for using the available GDAL based ZOO-Services) (http://gdal.org/)
     18- GDAL (http://gdal.org/)
    2019
    2120 .. warning::
     
    2827
    2928- MapServer (for ZOO-Kernel optional WMS, WFS and WCS support) (http://mapserver.org)
     29- Python (  http://www.python.org )
    3030- PHP Embedded (for ZOO-Kernel optional PHP support) (http://www.php.net)
    3131- Java SDK (for ZOO-Kernel optional Java support) (http://java.sun.com)
  • branches/PublicaMundi_David-devel/docs/install/windows.rst

    • Property svn:keywords set to Date Author
Note: See TracChangeset for help on using the changeset viewer.

Search

Context Navigation

ZOO Sponsors

http://www.zoo-project.org/trac/chrome/site/img/geolabs-logo.pnghttp://www.zoo-project.org/trac/chrome/site/img/neogeo-logo.png http://www.zoo-project.org/trac/chrome/site/img/apptech-logo.png http://www.zoo-project.org/trac/chrome/site/img/3liz-logo.png http://www.zoo-project.org/trac/chrome/site/img/gateway-logo.png

Become a sponsor !

Knowledge partners

http://www.zoo-project.org/trac/chrome/site/img/ocu-logo.png http://www.zoo-project.org/trac/chrome/site/img/gucas-logo.png http://www.zoo-project.org/trac/chrome/site/img/polimi-logo.png http://www.zoo-project.org/trac/chrome/site/img/fem-logo.png http://www.zoo-project.org/trac/chrome/site/img/supsi-logo.png http://www.zoo-project.org/trac/chrome/site/img/cumtb-logo.png

Become a knowledge partner

Related links

http://zoo-project.org/img/ogclogo.png http://zoo-project.org/img/osgeologo.png