source: trunk/docs/kernel/installation.txt @ 130

Last change on this file since 130 was 130, checked in by jmckenna, 13 years ago

more restructuring

File size: 7.5 KB
Line 
1.. _kernel-installation:
2
3ZOO Kernel Installation
4=======================
5
6.. contents:: Table of Contents
7    :depth: 4
8    :backlinks: top
9
10This page provides documentation on how to compile then install ZOO-Kernel on Unix and Win32 platforms.
11
12Unix
13----
14
15For Unix users, ZOO-Kernel comes with a GNU autoconf "configure" script that should take care of (hopefully!)
16all compilation issues for you.
17
18The configure script won't work on Windows. See section WIN32 for details on compiling on Windows systems.
19
20For the impatient
21*****************
22
23To build zoo_loader.cgi CGI program with the default options, go to the default options, go to the directory
24where you extracted the ZOO-Kernel source code package and use the following command:
25
26::
27
28  $ cd zoo-kernel
29  $ ./configure
30  $ make
31
32Unless something went wrong, you should have executables in the current directory for the zoo_loader.cgi
33CGI program. You can copy the zoo_loader.cgi program and the main.cfg file to your HTTP server's CGI
34directory and start using it.
35
36At this step your ZOO-Kernel should work. Nevertheless, don't forget to correct the main.cfg settings
37to set tmpPath and tmpUrl to fit your web server configuration.
38
39Configure Options
40*****************
41
42Here is the list of available options as returned by *./configure --help*:
43
44::
45
46  --with-gdal-config=FILE specify an alternative gdal-config file
47  --with-xml2config=FILE  specify an alternative xml2-config file
48  --with-python=PATH      To enabled python support or specify an alternative
49                          directory for python installation, disabled by
50                          default
51  --with-php=PATH         To enabled php support or specify an alternative
52                          directory for php installation, disabled by default
53  --with-perl=PATH        To enabled perl support or specify an alternative
54                          directory for perl installation, disabled by default
55  --with-java=PATH        To enabled java support, specify a JDK_HOME,
56                          disabled by default
57  --with-js=PATH          specify --with-js=path-to-js to enabled js support,
58                          specify --with-js on linux debian like, js support
59                          is disabled by default
60
61All the options are described in more details below.
62
63(Required) GDAL Support
64^^^^^^^^^^^^^^^^^^^^^^^
65
66If your gdal-config program is not found in your PATH then you can use the
67"*--with-gdal-config*" option to speficy its location. For instance, let suppose that your gdal-config
68was installed in /usr/local/bin and this directory is not in your PATH, then you can use
69the following command:
70
71::
72
73  $ ./configure --with-gdal-config=/usr/local/bin/gdal-config
74
75(Required) XML2 Support
76^^^^^^^^^^^^^^^^^^^^^^^
77
78If your xml2-config program is not found in your PATH then you can use the
79"*--with-xml2config*" option to specify its location. For instance, let suppose that
80your xml2-config was installed in /usr/local/bin end this directory is not in you PATH,
81then you can use the following command:
82
83::
84
85  $ ./configure --with-xml2config=/usr/local/bin/xml2-config
86
87(Optional) Python Support
88^^^^^^^^^^^^^^^^^^^^^^^^^
89
90If you want to activate the Python Support for ZOO-Kernel then you will have to use the
91"*--with-python*" option. If your python-config program is found in your PATH then you
92don't have to specify the path where Python was installed, so using the following command:
93
94::
95
96  $ ./configure --with-python
97
98This suppose that python-config is found in your PATH.
99
100In case your python-config is not found in your PATH, then you can set the Python installation
101directory you are using. For instance, let suppose that you installed Python in /usr/local,
102then you can use the following command:
103
104::
105
106  $ ./configure --with-python=/usr/local
107
108This suppose that /usr/local/bin/python-config exists.
109
110(Optional) PHP Support
111^^^^^^^^^^^^^^^^^^^^^^
112
113To be able to activate PHP Support for ZOO-Kernel you'll need to get a local PHP Embedded
114installation, for more informations about configure options to use to get such kind of PHP
115installation you can refer to this page :
116
117     http://zoo-project.org/trac/wiki/ZooKernel/Embed/PHP
118
119If you want to activate the PHP Support for ZOO-Kernel then you will have to use the
120"*--with-php*" option. If your php-config program is found in your PATH then you don't have
121to specify the path where PHP was installed, so using the following commnd:
122
123::
124
125  $ ./configure --with-php
126
127This suppose that php-config is found in your PATH.
128
129In case your php-config is not found in your PATH, then you can set the PHP installation
130directory you are using. For instance, let suppose that you installed PHP in /usr/local,
131then you can use the following command:
132
133::
134
135  $ ./configure --with-php=/usr/local
136
137This suppose that /usr/local/bin/php-config exists.
138
139(Optional) Perl Support
140^^^^^^^^^^^^^^^^^^^^^^^
141
142If you want to activate the Perl Support for ZOO-Kernel then you will have to use the
143"*--with-perl*" option. If you do not set any value to this option, then perl program will
144be searched in your PATH. So in such case, you can use the following command:
145
146::
147
148  $ ./configure --with-perl
149
150This suppose that perl is found in your PATH.
151
152In other case, for custom Perl installation, you can set the installation directory. For instance,
153let suppose that you installed Perl in /usr/local and /usr/local/bin is not in your PATH,
154then you can use the following command:
155
156::
157
158  $ ./configure --with-perl=/usr/local
159
160This suppose that /usr/local/bin/perl exists.
161
162(Optional) Java Support
163^^^^^^^^^^^^^^^^^^^^^^^
164
165If you want to activate the Java Support for ZOO-Kernel then you will have to use the
166"*--with-java*" option and set the installation path of your Java SDK. For instance,
167let suppose that your Java SDK was installed in /usr/lib/jvm/java-6-sun-1.6.0.22/ directory,
168then you can use the following command:
169
170::
171
172  $ ./configure --with-java=/usr/lib/jvm/java-6-sun-1.6.0.22/
173
174This suppose that the include/linux and jre/lib/i386/client/ subdirectories exist in
175/usr/lib/jvm/java-6-sun-1.6.0.22/, include/linux contains the jni.h headers file and
176jre/lib/i386/client/ contains the libjvm.so file.
177
178Note that on MacOS X you only have to set macos as value for the "*--with-java*" option
179to get the Java Support for ZOO-Kernel activated. So using the following command:
180
181::
182
183  $ ./configure --with-java=macos
184
185(Optional) JavaScript Support
186^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
187
188If you want to activate the JavaScript Support for ZOO-Kernel then you will have to use
189the "*--with-js*" option. If you are using a "Debian-like" GNU/Linux distribution then
190dpkg will be used to detect if the required packages was installed and you don't have to
191specify anything here, so you can use the following command:
192
193::
194
195  $ ./configure --with-js
196
197This suppose that js_api.h and libmozjs.so are found in default directories.
198
199If you get a custom installation of SpiderMonkey or you are not using a Debian packaging
200system, then you'll have to specify the directory where you installed it. For
201instance, let suppose that you installed your SpiderMonkey in /usr, then you'll
202have to use the following command:
203
204::
205
206  $ ./configure --with-js=/usr
207
208This suppose that the /usr/include/js exists and contains the js_api.h headers file and
209/usr/lib contains libmozjs.so file.
210
211WIN32
212-----
213
214To be written soon ...
215
216
Note: See TracBrowser for help on using the repository browser.

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