Changeset 714


Ignore:
Timestamp:
Jun 30, 2015, 6:09:43 PM (4 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.

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