Ignore:
Timestamp:
Jun 30, 2015, 6:09:43 PM (9 years ago)
Author:
djay
Message:

Various fixes in the installation documentation.

File:
1 edited

Legend:

Unmodified
Added
Removed

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

    r713 r714  
    3232   platform for building and your fcgi library is not located in ``/usr/lib64``.
    3333
    34 Install the ZOO-Kernel
    35 ----------------------
     34Install ZOO-Kernel
     35------------------
    3636
    3737
    … …  
    6262.................
    6363
     64This section provides information on :ref:`kernel_index` configure options. It is recommanded to also read the :ref:`kernel_config` section for configuration technical details.
     65
     66
     67Here is the list of available options in the same order as returned by
     68``./configure --help`` command:
     69
    6470.. contents::
    6571    :local:
    6672    :depth: 2
    6773    :backlinks: top
    68 
    69 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.
    70 
    71 
    72 Here is the list of available options as returned by ``./configure --help`` command:
    73 
    74 
    75 .. list-table:: Configure Options
    76    :header-rows: 1
    77 
    78    * - Option
    79      - Description
    80    * - ``--with-cgi-dir=PATH``
    81      - Specifies an alternative cgi directory path (default:
    82        /usr/lib/cgi-bin)
    83    * - ``--with-db-backend``
    84      - Relies on a database for storing status messages and response
    85        files
    86    * - ``--with-yaml=PATH``
    87      - Specifies an alternative location for the yaml library
    88    * - ``--with-fastcgi=PATH``
    89      - Specifies an alternative location for the fastcgi library
    90    * - ``--with-gdal-config=FILE``
    91      - Specifies an alternative gdal-config file
    92    * - ``--with-xml2config=FILE``
    93      - Specifies an alternative xml2-config file
    94    * - ``--with-python=PATH``
    95      - Enables python support or specifies an alternative directory
    96        for python installation (disabled by default)
    97    * - ``--with-pyvers=NUM``
    98      - Uses a specific python version
    99    * - ``--with-js=PATH``
    100      - Enables javascript support, disabled by default
    101    * - ``--with-php=PATH``
    102      - Enables php support or specify an alternative directory for php
    103        installation, disabled by default
    104    * - ``--with-java=PATH``
    105      - Enables java support or specifies a JDK_HOME, disabled by
    106        default
    107    * - ``--with-ruby=PATH``
    108      - To enable ruby support or specify an alternative directory for
    109        ruby installation, disabled by default
    110    * - ``--with-rvers=NUM``
    111      - To use a specific ruby version
    112    * - ``--with-perl=PATH``
    113      - Enables perl support or specifies an alternative directory for
    114        perl installation, disabled by default
    115    * - ``--with-mapserver=PATH``
    116      - Specifies the path for MapServer compiled source tree
    117    * - ``--with-itk=PATH``
    118      - Specifies an alternative location for the ITK library
    119    * - ``--with-itk-version=VERSION``
    120      - Specifies an alternative version for the ITK library
    121    * - ``--with-otb=PATH``
    122      - Enables optional OrfeoToolbox support
    123    * - ``--with-wx-config=PATH``
    124      - Specifies an alternative path for the wx-config tool
    125    * - ``--with-saga=PATH``
    126      - Enables optional SAGA GIS support
    127 
    128 
    129 .. code ::
    130 
    131   --with-cgi-dir=PATH     Specifies an alternative cgi directory path (
    132                           default: /usr/lib/cgi-bin)
    133   --with-db-backend       Relies on a database for storing status messages and
    134                           response files
    135   --with-yaml=PATH        Specifies an alternative location for the yaml
    136                           library
    137   --with-fastcgi=PATH     Specifies an alternative location for the fastcgi
    138                           library
    139   --with-xml2config=FILE  Specifies an alternative xml2-config file
    140   --with-xsltconfig=FILE  Specifies an alternative xslt-config file
    141   --with-gdal-config=FILE Specifies an alternative gdal-config file
    142   --with-proj=PATH        Specifies an alternative location for PROJ4 setup
    143   --with-geosconfig=FILE  Specifies an alternative geos-config file
    144   --with-cgal=PATH        Specifies an alternative location for CGAL setup
    145   --with-mapserver=PATH   Specifies the path for MapServer compiled source
    146                           tree
    147   --with-python=PATH      To enable python support or Specifies an alternative
    148                           directory for python installation, disabled by
    149                           default
    150   --with-pyvers=NUM       To use a specific python version
    151   --with-js=PATH          Specifies --with-js=path-to-js to enable js support,
    152                           specify --with-js on linux debian like, js support
    153                           is disabled by default
    154   --with-php=PATH         To enable php support or specify an alternative
    155                           directory for php installation, disabled by default
    156   --with-java=PATH        To enable java support, specify a JDK_HOME, disabled
    157                           by default
    158   --with-ruby=PATH        To enable ruby support or specify an alternative
    159                           directory for ruby installation, disabled by default
    160   --with-rvers=NUM        To use a specific ruby version
    161   --with-perl=PATH        To enable perl support or specify an alternative
    162                           directory for perl installation, disabled by default
    163   --with-itk=PATH         Specifies an alternative location for the itk
    164                           library
    165   --with-itk-version=VERSION
    166                           Specifies an alternative version for the itk library
    167   --with-otb=PATH         Specifies an alternative location for the otb
    168                           library
    169   --with-wx-config=PATH   Specifies an alternative path for the wx-config tool
    170   --with-saga=PATH        Specifies an alternative location for the SAGA-GIS
    171                           library
    172 
    173 
    174 
    175 
    176 ::
    177 
    178   --with-cgi-dir=PATH     Specifies an alternative cgi directory path (default: /usr/lib/cgi-bin)
    179   --with-db-backend       Relies on a database for storing status messages and response files
    180   --with-yaml=PATH        Specifies an alternative location for the yaml library
    181   --with-fastcgi=PATH     Specifies an alternative location for the fastcgi library
    182   --with-gdal-config=FILE Specifies an alternative gdal-config file
    183   --with-xml2config=FILE  Specifies an alternative xml2-config file
    184   --with-python=PATH      Enables python support or specifies an alternative directory for python installation (disabled by default)
    185   --with-pyvers=NUM       Uses a specific python version
    186   --with-js=PATH          Enables javascript support, disabled by default
    187   --with-php=PATH         Enables php support or specify an alternative directory for php installation, disabled by default
    188   --with-java=PATH        Enables java support or specifies a JDK_HOME, disabled by default
    189   --with-ruby=PATH        To enable ruby support or specify an alternative directory for ruby installation, disabled by default
    190   --with-rvers=NUM        To use a specific ruby version
    191   --with-perl=PATH        Enables perl support or specifies an alternative directory for perl installation, disabled by default
    192   --with-mapserver=PATH   Specifies the path for MapServer compiled source tree
    193   --with-itk=PATH          Specifies an alternative location for the ITK library
    194   --with-itk-version=VERSION          Specifies an alternative version for the ITK library     
    195   --with-otb=PATH         Enables optional OrfeoToolbox support
    196   --with-wx-config=PATH   Specifies an alternative path for the wx-config tool
    197   --with-saga=PATH        Enables optional SAGA GIS support
    198 
    199 All the options are described in more details in the following sections.
    20074
    20175Specific CGI Directory
    … …  
    236110    linked files.
    237111
     112YAML Support (Optional)
     113************************
     114
     115If ``yaml.h`` file is not found in your ``/usr/include`` directory and
     116``libyaml.so`` is not found in ``/usr/lib``, a ``--with-yaml`` option
     117can be used to specify its location. For instance, if the headeer file
     118lies in ``/usr/local/include`` and the shared library is located in
     119``/usr/local/lib``, you may use the following command:
     120
     121::
     122
     123  $ ./configure --with-yaml=/usr/local
     124
     125
     126FastCGI Support (Required)
     127***************************
     128
     129If your FastCGI library is not available in the default search path, a
     130``--with-fastcgi`` option can be used to specify its location. For
     131instance, if ``libfcgi.so`` lies in ``/usr/local/lib`` which is not in
     132your ``LD_SEARCH_PATH``, you may use the following command:
     133
     134::
     135
     136  $ ./configure --with-fastcgi=/usr/local
    238137
    239138
    … …  
    245144``--with-gdal-config`` option can be used to specify its location. For
    246145instance, if ``gdal-config`` lies in ``/usr/local/bin`` which is not in
    247 your PATH, you may use the following command:
     146your ``PATH``, you may use the following command:
    248147
    249148::
    250149
    251150  $ ./configure --with-gdal-config=/usr/local/bin/gdal-config
     151
     152
     153GEOS Support (Optional)
     154************************
     155
     156If ``geos-config`` program is not found in your ``PATH``, a
     157``--with-geosconfig`` option can be used to specify its location. For
     158instance, if ``geos-config`` lies in ``/usr/local/bin`` which is not in
     159your ``PATH``, you may use the following command:
     160
     161::
     162
     163  $ ./configure --with-geosconfig=/usr/local/bin/geos-config
     164
     165
     166CGAL Support (Optional)
     167************************
     168
     169If ``CGAL/Delaunay_triangulation_2.h`` program is not found in your
     170``/usr/include`` directory, a ``--with-cgal`` option can be used to
     171specify its location. For instance, if the file lies in
     172``/usr/local/include`` which is not in your PATH, you may use the
     173following command:
     174
     175::
     176
     177  $ ./configure --with-cgal=/usr/local
     178
     179
     180
     181MapServer Support (Optional)
     182*****************************
     183
     184
     185In order to activate the WMS, WFS and WCS output support using
     186MapServer, the ``--with-mapserver`` option must be used. The path to
     187``mapserver-config`` which is located in the source code of MapServer
     188must also be set, using the following command:
     189
     190::
     191
     192  $ ./configure --with-mapserver=/path/to/your/mapserver_config/
     193
     194
     195Read more about the :ref:`kernel-mapserver`.
    252196
    253197XML2 Support (Required)
    … …  
    290234  $ ./configure --with-pyvers=2.7
    291235
    292 
    293 PHP Support (Optional)
    294 ***********************
    295 
    296 The ``--with-php=yes`` option is required to activate the
    297 :ref:`kernel_index` PHP support`, using the following command:
    298 
    299 ::
    300 
    301   $ ./configure --with-php=yes
    302 
    303 This assumes that ``php-config`` can be found in the ``<PATH>/bin``
    304 directory . So, supposing the your ``php-config`` can be found in
    305 ``/usr/local/bin``, then use the following command:
    306 
    307 ::
    308 
    309   $ ./configure --with-php=/usr/local
    310 
    311 .. warning::
    312     ZOO-Kernel optional PHP support requires a local PHP Embedded installation. Read more `here <http://zoo-project.org/trac/wiki/ZooKernel/Embed/PHP>`__.
    313 
    314 
    315 Perl Support (Optional)
    316 ************************
    317 
    318 The ``--with-perl=yes`` option can be used for activating the
    319 ZOO-Kernel Perl support, as follow:
    320 
    321 ::
    322 
    323   $ ./configure --with-perl=yes
    324 
    325 This assumes that perl is found in your PATH. For instance, if Perl is
    326 installed in ``/usr/local`` and ``/usr/local/bin`` is not found in
    327 your ``PATH``, then the following command can be used (this assumes
    328 that ``/usr/local/bin/perl`` exists):
    329 
    330 ::
    331 
    332   $ ./configure --with-perl=/usr/local
    333 
    334 
    335 Java Support (Optional)
    336 ************************
    337 
    338 In order to activate the Java support for ZOO-Kernel, the
    339 `--with-java` configure option must be specified and sets the
    340 installation path of your Java SDK. For instance,  if Java SDK is
    341 installed in the ``/usr/lib/jvm/java-6-sun-1.6.0.22/`` directory,
    342 then the following command can be used:
    343 
    344 ::
    345 
    346   $ ./configure --with-java=/usr/lib/jvm/java-6-sun-1.6.0.22/
    347 
    348 This assumes that the ``include/linux`` and ``jre/lib/i386/client/``
    349 subdirectories exist in ``/usr/lib/jvm/java-6-sun-1.6.0.22/``, and
    350 that the ``include/linux`` directory contains the ``jni.h`` headers file
    351 and that the ``jre/lib/i386/client/`` directory contains the ``libjvm.so``
    352 file.
    353 
    354 
    355 .. note::
    356    With Mac OS X you only have to set *macos* as the value for the
    357    ``--with-java`` option to activate Java support. For example:
    358 
    359    ::
    360 
    361      $ ./configure --with-java=macos
    362236
    363237.. _js-support:
    … …  
    389263
    390264
    391 MapServer Support (Optional)
    392 *****************************
    393 
    394 
    395 In order to activate the WMS, WFS and WCS output support using
    396 MapServer, the ``--with-mapserver`` option must be used. The path to
    397 ``mapserver-config`` which is located in the source code of MapServer
    398 must also be set, using the following command:
    399 
    400 ::
    401 
    402   $ ./configure --with-mapserver=/path/to/your/mapserver_config/
    403 
    404 
    405 Read more about the :ref:`kernel-mapserver`.
     265PHP Support (Optional)
     266***********************
     267
     268The ``--with-php=yes`` option is required to activate the
     269:ref:`kernel_index` PHP support`, using the following command:
     270
     271::
     272
     273  $ ./configure --with-php=yes
     274
     275This assumes that ``php-config`` can be found in the ``<PATH>/bin``
     276directory . So, supposing the your ``php-config`` can be found in
     277``/usr/local/bin``, then use the following command:
     278
     279::
     280
     281  $ ./configure --with-php=/usr/local
     282
     283.. warning::
     284    ZOO-Kernel optional PHP support requires a local PHP Embedded installation. Read more `here <http://zoo-project.org/trac/wiki/ZooKernel/Embed/PHP>`__.
     285
     286
     287Java Support (Optional)
     288************************
     289
     290In order to activate the Java support for ZOO-Kernel, the
     291`--with-java` configure option must be specified and sets the
     292installation path of your Java SDK. For instance,  if Java SDK is
     293installed in the ``/usr/lib/jvm/java-6-sun-1.6.0.22/`` directory,
     294then the following command can be used:
     295
     296::
     297
     298  $ ./configure --with-java=/usr/lib/jvm/java-6-sun-1.6.0.22/
     299
     300This assumes that the ``include/linux`` and ``jre/lib/i386/client/``
     301subdirectories exist in ``/usr/lib/jvm/java-6-sun-1.6.0.22/``, and
     302that the ``include/linux`` directory contains the ``jni.h`` headers file
     303and that the ``jre/lib/i386/client/`` directory contains the ``libjvm.so``
     304file.
     305
     306
     307.. note::
     308   With Mac OS X you only have to set *macos* as the value for the
     309   ``--with-java`` option to activate Java support. For example:
     310
     311   ::
     312
     313     $ ./configure --with-java=macos
     314
     315
     316Perl Support (Optional)
     317************************
     318
     319The ``--with-perl=yes`` option can be used for activating the
     320ZOO-Kernel Perl support, as follow:
     321
     322::
     323
     324  $ ./configure --with-perl=yes
     325
     326This assumes that perl is found in your PATH. For instance, if Perl is
     327installed in ``/usr/local`` and ``/usr/local/bin`` is not found in
     328your ``PATH``, then the following command can be used (this assumes
     329that ``/usr/local/bin/perl`` exists):
     330
     331::
     332
     333  $ ./configure --with-perl=/usr/local
    406334
    407335
Note: See TracChangeset for help on using the changeset viewer.

Download now !

Search

Context Navigation

Main 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