source:
branches/PublicaMundi_David-devel/docs/install/install-confoptions.rst
@
689
Last change on this file since 689 was 679, checked in by nbozon, 10 years ago | |
---|---|
File size: 6.9 KB |
Configure options
Configure options ==============
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.
Configure options
Here is the list of available options as returned by ./configure --help command:
--with-PACKAGE[=ARG] Use PACKAGE [ARG=yes] --without-PACKAGE Do not use PACKAGE (same as --with-PACKAGE=no) --with-gdal-config=FILE Specifies an alternative gdal-config file --with-xml2config=FILE Specifies an alternative xml2-config file --with-python=PATH Enables python support or specifies an alternative directory for python installation (disabled by default) --with-pyvers=NUM Uses a specific python version --with-php=PATH Enables php support or specify an alternative directory for php installation, disabled by default --with-perl=PATH Enables perl support or specifies an alternative directory for perl installation, disabled by default --with-java=PATH Enables java support or specifies a JDK_HOME, disabled by default --with-js=PATH Enables javascript support, disabled by default --with-mapserver=PATH Specifies the path for MapServer compiled source tree --with-itk=PATH Specifies an alternative location for the ITK library --with-itk-version=VERSION Specifies an alternative version for the ITK library --with-otb=PATH Enables optional OrfeoToolbox support --with-saga=PATH Enables optional SAGA GIS support
All the options are described in more details in the following sections.
GDAL Support (Required)
If gdal-config program is not found in 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 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 option is required to activate the :ref:`kernel_index` Python support, using the following command:
$ ./configure --with-python
This assumes that python-config is found in PATH. If not, then you can specify the Python installation directory using the following command (with /usr/local as example python directory):
$ ./configure --with-python=/usr/local
Python Version (Optional)
A specific version of Python can be used, with the --with-pyvers option as shown bellow:
$ ./configure --with-pyvers=2.6
PHP Support (Optional)
The --with-php option is required to activate the :ref:`kernel_index` PHP support, using the following command:
$ ./configure --with-php
This assumes that php-config is found in PATH. If not, then you can specify the PHP installation directory, using the following command (with /usr/local as example PHP directory)
$ ./configure --with-php=/usr/local
Warning
ZOO-Kernel optional PHP support requires a local PHP Embedded installation. Read more here.
Perl Support (Optional)
The --with-perl option can be used for activating the ZOO-Kernel Perl support, as follow:
$ ./configure --with-perl
This assumes that perl is found in PATH. For instance, if Perl is installed in /usr/local and /usr/local/bin which is not found in PATH, then the following command can be used (this assumes that /usr/local/bin/perl exists):
$ ./configure --with-perl=/usr/local
Java Support (Optional)
In order to activate the Java support for ZOO-Kernel, the --with-java configure option must be specified and sets the installation path of your Java SDK. For instance, if Java SDK is installed in the /usr/lib/jvm/java-6-sun-1.6.0.22/ directory, then the following command can be used:
$ ./configure --with-java=/usr/lib/jvm/java-6-sun-1.6.0.22/
This assumes that the include/linux and jre/lib/i386/client/ subdirectories exist in /usr/lib/jvm/java-6-sun-1.6.0.22/, that the include/linux directory contains the jni.h headers file and that the jre/lib/i386/client/ directory contains the libjvm.so file.
Note
With Mac OS X you only have to set macos as the value for the --with-java option to activate Java support. For example:
$ ./configure --with-java=macos
JavaScript Support (Optional)
In order to activate the JavaScript support for ZOO-Kernel, the --with-js configure option must be specified. If you are using a "Debian-like" GNU/Linux distribution then dpkg will be used to detect if the required packages are installed and you don't have to specify anything here. The following command is only needed (assuming that js_api.h and libmozjs.so are found in default directories):
$ ./configure --with-js
If youwant to use a custom installation of SpiderMonkey ,or if you are not using a Debian packaging system, then you'll have to specify the directory where it is installed. For instance, if SpiderMonkey is in /usr, then the following command must be used:
$ ./configure --with-js=/usr
MapServer Support (Optional)
In order to activate the WMS, WFS and WCS output support using MapServer, the --with-mapserver option must be used. The path to mapserver-config which is located in the source code of MapServer must also be set, using the following command:
$ ./configure --with-mapserver=/path/to/your/mapserver_config/
Read more about the :ref:`kernel-mapserver`.
Orfeo Toolbox Support (Optional)
In order to activate the optional Orfeo Toolbox support, the --with-otb option must be used, using the following command:
$ ./configure --with-otb=/path/to/your/otb/
Read more about the :ref:`kernel-orfeotoolbox`.
SAGA GIS Support (Optional)
In order to activate the optional SAGA GIS support, the --with-saga option must be used, using the following command:
$ ./configure --with-saga=/path/to/your/saga/
Read more about the :ref:`kernel-sagagis`.