1 | .. _install-configure: |
---|
2 | |
---|
3 | Configure options |
---|
4 | ============== |
---|
5 | |
---|
6 | 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. |
---|
7 | |
---|
8 | Configure options |
---|
9 | ----------------- |
---|
10 | |
---|
11 | Here is the list of available options as returned by *./configure --help* command: |
---|
12 | |
---|
13 | :: |
---|
14 | |
---|
15 | --with-PACKAGE[=ARG] Use PACKAGE [ARG=yes] |
---|
16 | --without-PACKAGE Do not use PACKAGE (same as --with-PACKAGE=no) |
---|
17 | --with-gdal-config=FILE Specifies an alternative gdal-config file |
---|
18 | --with-xml2config=FILE Specifies an alternative xml2-config file |
---|
19 | --with-python=PATH Enables python support or specifies an alternative directory for python installation (disabled by default) |
---|
20 | --with-pyvers=NUM Uses a specific python version |
---|
21 | --with-php=PATH Enables php support or specify an alternative directory for php installation, disabled by default |
---|
22 | --with-perl=PATH Enables perl support or specifies an alternative directory for perl installation, disabled by default |
---|
23 | --with-java=PATH Enables java support or specifies a JDK_HOME, disabled by default |
---|
24 | --with-js=PATH Enables javascript support, disabled by default |
---|
25 | --with-mapserver=PATH Specifies the path for MapServer compiled source tree |
---|
26 | --with-otb=PATH Enables optional OrfeoToolbox support |
---|
27 | --with-saga=PATH Enables optional SAGA GIS support |
---|
28 | |
---|
29 | All the options are described in more details in the following sections. |
---|
30 | |
---|
31 | GDAL Support (Required) |
---|
32 | ........................................ |
---|
33 | |
---|
34 | 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: |
---|
35 | |
---|
36 | :: |
---|
37 | |
---|
38 | $ ./configure --with-gdal-config=/usr/local/bin/gdal-config |
---|
39 | |
---|
40 | XML2 Support (Required) |
---|
41 | ........................................ |
---|
42 | |
---|
43 | |
---|
44 | 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: |
---|
45 | |
---|
46 | :: |
---|
47 | |
---|
48 | $ ./configure --with-xml2config=/usr/local/bin/xml2-config |
---|
49 | |
---|
50 | |
---|
51 | Python Support (Optional) |
---|
52 | .............................................. |
---|
53 | |
---|
54 | The *--with-python* option is required to activate the :ref:`kernel_index` Python support, using the following command: |
---|
55 | |
---|
56 | :: |
---|
57 | |
---|
58 | $ ./configure --with-python |
---|
59 | |
---|
60 | This assumes that python-config is found in PATH. If not, then you can specify the Python |
---|
61 | installation directory using the following command (with ``/usr/local`` as example python directory): |
---|
62 | |
---|
63 | :: |
---|
64 | |
---|
65 | $ ./configure --with-python=/usr/local |
---|
66 | |
---|
67 | |
---|
68 | Python Version (Optional) |
---|
69 | .............................................. |
---|
70 | |
---|
71 | A specific version of Python can be used, with the *--with-pyvers* option as shown bellow: |
---|
72 | :: |
---|
73 | |
---|
74 | $ ./configure --with-pyvers=2.6 |
---|
75 | |
---|
76 | |
---|
77 | PHP Support (Optional) |
---|
78 | .............................................. |
---|
79 | |
---|
80 | The *--with-php* option is required to activate the :ref:`kernel_index` PHP support, using the following command: |
---|
81 | |
---|
82 | :: |
---|
83 | |
---|
84 | $ ./configure --with-php |
---|
85 | |
---|
86 | 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) |
---|
87 | |
---|
88 | :: |
---|
89 | |
---|
90 | $ ./configure --with-php=/usr/local |
---|
91 | |
---|
92 | .. warning:: |
---|
93 | ZOO-Kernel optional PHP support requires a local PHP Embedded installation. Read more `here <http://zoo-project.org/trac/wiki/ZooKernel/Embed/PHP>`__. |
---|
94 | |
---|
95 | |
---|
96 | Perl Support (Optional) |
---|
97 | .............................................. |
---|
98 | |
---|
99 | The *--with-perl* option can be used for activating the ZOO-Kernel Perl support, as follow: |
---|
100 | |
---|
101 | :: |
---|
102 | |
---|
103 | $ ./configure --with-perl |
---|
104 | |
---|
105 | 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, |
---|
106 | then the following command can be used (this assumes that /usr/local/bin/perl exists): |
---|
107 | |
---|
108 | :: |
---|
109 | |
---|
110 | $ ./configure --with-perl=/usr/local |
---|
111 | |
---|
112 | |
---|
113 | Java Support (Optional) |
---|
114 | .............................................. |
---|
115 | |
---|
116 | In irder to activate the Java support for ZOO Kernel, you have to use the *--with-java* configure option and to set the installation path of your Java SDK. For instance, |
---|
117 | 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: |
---|
118 | |
---|
119 | :: |
---|
120 | |
---|
121 | $ ./configure --with-java=/usr/lib/jvm/java-6-sun-1.6.0.22/ |
---|
122 | |
---|
123 | 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. |
---|
124 | |
---|
125 | .. note:: |
---|
126 | With Mac OS X you only have to set *macos* as the value for the *--with-java* option |
---|
127 | to activate Java support. For example: |
---|
128 | |
---|
129 | :: |
---|
130 | |
---|
131 | $ ./configure --with-java=macos |
---|
132 | |
---|
133 | |
---|
134 | .. _js-support: |
---|
135 | |
---|
136 | JavaScript Support (Optional) |
---|
137 | .............................................. |
---|
138 | |
---|
139 | In order to activate the JavaScript support for ZOO Kernel then you will have to use |
---|
140 | the *--with-js* configure option. If you are using a "Debian-like" GNU/Linux distribution then |
---|
141 | dpkg will be used to detect if the required packages are installed and you don't have to |
---|
142 | specify anything here. The following command is only needed (assuming that js_api.h and libmozjs.so are found in default directories): |
---|
143 | |
---|
144 | :: |
---|
145 | |
---|
146 | $ ./configure --with-js |
---|
147 | |
---|
148 | . |
---|
149 | |
---|
150 | If youwant to use a custom installation of `SpiderMonkey <https://developer.mozilla.org/en/SpiderMonkey>`__ ,or if you are not using a Debian packaging |
---|
151 | 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: |
---|
152 | |
---|
153 | :: |
---|
154 | |
---|
155 | $ ./configure --with-js=/usr |
---|
156 | |
---|
157 | |
---|
158 | MapServer Support (Optional) |
---|
159 | .............................................. |
---|
160 | |
---|
161 | |
---|
162 | In order to activate the WMS, WFS and WCS output support using MapServer, the *--with-mapserver* option must be used. You must also set the path to ``mapserver-config`` which is located in the source code of MapServer as following command: |
---|
163 | |
---|
164 | :: |
---|
165 | |
---|
166 | $ ./configure --with-mapserver=/path/to/your/mapserver_config/ |
---|
167 | |
---|
168 | |
---|
169 | Read more abour the :ref:`kernel-mapserver`. |
---|
170 | |
---|
171 | |
---|
172 | Orfeo Toolbox Support (Optional) |
---|
173 | ..................................................... |
---|
174 | |
---|
175 | |
---|
176 | In order to activate the optional Orfeo Toolbox support, the *--with-otb* option must be used, using the following command: |
---|
177 | |
---|
178 | :: |
---|
179 | |
---|
180 | $ ./configure --with-otb=/path/to/your/otb/ |
---|
181 | |
---|
182 | |
---|
183 | Read more about the :ref:`kernel-orfeotoolbox`. |
---|
184 | |
---|
185 | |
---|
186 | SAGA GIS Support (Optional) |
---|
187 | ..................................................... |
---|
188 | |
---|
189 | |
---|
190 | In order to activate the optional SAGA GIS support, the *--with-saga* option must be used, using the following command: |
---|
191 | |
---|
192 | :: |
---|
193 | |
---|
194 | $ ./configure --with-saga=/path/to/your/saga/ |
---|
195 | |
---|
196 | |
---|
197 | Read more about the :ref:`kernel-sagagis`. |
---|