Changeset 210


Ignore:
Timestamp:
May 6, 2011, 6:55:54 PM (13 years ago)
Author:
jmckenna
Message:

add notes about libcgic step and warning

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/docs/kernel/installation.txt

    r136 r210  
    88    :backlinks: top
    99
    10 This page provides documentation on how to compile then install ZOO-Kernel on Unix and Win32 platforms.
     10This page provides documentation on how to compile then install the ZOO Kernel on Unix and Win32 platforms.
     11
     12Obtaining the ZOO Kernel Source
     13-------------------------------
     14
     15Use the following command to get the ZOO Kernel source code through Subversion:
     16
     17::
     18
     19  svn checkout http://svn.zoo-project.org/svn/trunk zoo-project
     20
     21For users which get a developer account, use the following:
     22
     23::
     24
     25  sed "s:\[tunnels\]:\[tunnels\]\nzoosvn = /usr/bin/ssh -p 1046:g" -i ~/.subversion/config
     26  svn co svn+zoosvn://svn.zoo-project.org/var/svn/repos/trunk zoo-project
     27
     28The first line of the instruction above defines a specific tunnel to access the svn server through
     29the SSH protocol. Indeed, the ZOO SVN server listens on the 1046 (1024+22) port rather than the default one (22).
     30
     31Prerequisites
     32-------------
     33
     34The following libraries are required on your system before you can install the ZOO Kernel:
     35
     36- autoconf (  http://www.gnu.org/software/autoconf/ )
     37- cgic (  http://www.boutell.com/cgic )
     38- cURL (  http://curl.haxx.se )
     39- FastCGI (  http://www.fastcgi.com )
     40- Flex & Bison (  http://flex.sourceforge.net/  http://www.gnu.org/software/bison/ )
     41- libxml2 (  http://xmlsoft.org )
     42- OpenSSL (  http://www.openssl.org )
     43- Python (  http://www.python.org )
     44
     45Optional libraries include:
     46
     47- PHP Embedded (optional) (  http://www.php.net )
     48- Java SDK (optional) (  http://java.sun.com )
     49- SpiderMonkey (optional) (  http://www.mozilla.org/js/spidermonkey/ )
     50
     51Compile libcgic
     52---------------
     53
     54The first step is to compile libcgic from the ``zoo-project/thirds`` directory. For such a task, please use
     55the following command:
     56
     57::
     58
     59  cd thirds/cgic206
     60  make
     61
     62Make sure that a ``libcgic.a`` is created in your ``zoo-project/thirds/cgic206`` directory. If yes, then
     63you can go to the next step.
     64
     65On Windows, rather than using the make command, please use:
     66
     67::
     68
     69  nmake /f makefile.vc.
     70 
     71.. warning::
     72   If you don't compile libcgic first, and try to compile the ZOO Kernel, you will get an error such as *cannot find -lcgic*
    1173
    1274Unix
    1375----
    1476
    15 For Unix users, ZOO-Kernel comes with a GNU autoconf "configure" script that should take care of (hopefully!)
     77For Unix users, the ZOO Kernel comes with a GNU autoconf "configure" script that should take care of (hopefully!)
    1678all compilation issues for you.
    1779
    18 The configure script won't work on Windows. See section WIN32 for details on compiling on Windows systems.
     80The configure script won't work on Windows. See section :ref:`WIN32 <win32>` for details on compiling
     81on Windows systems.
    1982
    2083For the impatient
    2184*****************
    2285
    23 To build zoo_loader.cgi CGI program with the default options, go to the default options, go to the directory
    24 where you extracted the ZOO-Kernel source code package and use the following command:
     86To build the ``zoo_loader.cgi`` CGI program with the default options, cd to the directory
     87where you extracted the ZOO Kernel source code package and use the following commands:
    2588
    2689::
    2790
    2891  $ cd zoo-kernel
     92  $ autoconf 
    2993  $ ./configure
    3094  $ make
    3195
    32 Unless something went wrong, you should have executables in the current directory for the zoo_loader.cgi
    33 CGI program. You can copy the zoo_loader.cgi program and the main.cfg file to your HTTP server's CGI
     96Unless something went wrong, you should have executables in the current directory for the ``zoo_loader.cgi``
     97CGI program. You can copy the ``zoo_loader.cgi`` program and the ``main.cfg`` file to your HTTP server's CGI
    3498directory and start using it.
    3599
    36100At this step your ZOO-Kernel should work. Nevertheless, don't forget to correct the main.cfg settings
    37 to set tmpPath and tmpUrl to fit your web server configuration.
     101to set ``tmpPath`` and ``tmpUrl`` to fit your web server configuration.
    38102
    39103Configure Options
     
    46110  --with-gdal-config=FILE specify an alternative gdal-config file
    47111  --with-xml2config=FILE  specify an alternative xml2-config file
    48   --with-python=PATH      To enabled python support or specify an alternative
     112  --with-python=PATH      To enable python support or specify an alternative
    49113                          directory for python installation, disabled by
    50114                          default
    51   --with-php=PATH         To enabled php support or specify an alternative
     115  --with-php=PATH         To enable php support or specify an alternative
    52116                          directory for php installation, disabled by default
    53   --with-perl=PATH        To enabled perl support or specify an alternative
     117  --with-perl=PATH        To enable perl support or specify an alternative
    54118                          directory for perl installation, disabled by default
    55   --with-java=PATH        To enabled java support, specify a JDK_HOME,
     119  --with-java=PATH        To enable java support, specify a JDK_HOME,
    56120                          disabled by default
    57   --with-js=PATH          specify --with-js=path-to-js to enabled js support,
     121  --with-js=PATH          specify --with-js=path-to-js to enable js support,
    58122                          specify --with-js on linux debian like, js support
    59123                          is disabled by default
     
    65129
    66130If 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
     131``--with-gdal-config`` option to specify its location. For instance, let's suppose that your gdal-config
    68132was installed in /usr/local/bin and this directory is not in your PATH, then you can use
    69133the following command:
     
    77141
    78142If 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
    80 your xml2-config was installed in /usr/local/bin end this directory is not in you PATH,
     143``--with-xml2config`` option to specify its location. For instance, let's suppose that
     144your xml2-config was installed in /usr/local/bin and this directory is not in your PATH,
    81145then you can use the following command:
    82146
     
    88152^^^^^^^^^^^^^^^^^^^^^^^^^
    89153
    90 If 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
    92 don't have to specify the path where Python was installed, so using the following command:
     154If you want to activate Python support for the ZOO Kernel then you will have to use the
     155``--with-python`` option. If your python-config program is found in your PATH then you
     156don't have to specify the path where Python was installed, such as:
    93157
    94158::
     
    96160  $ ./configure --with-python
    97161
    98 This suppose that python-config is found in your PATH.
    99 
    100 In case your python-config is not found in your PATH, then you can set the Python installation
    101 directory you are using. For instance, let suppose that you installed Python in /usr/local,
    102 then you can use the following command:
     162This assumes that python-config is found in your PATH.
     163
     164In the case that your python-config is not found in your PATH, then you can specify the Python
     165installation directory you are using. For instance, let's suppose that you installed
     166Python in /usr/local, then you can use the following command:
    103167
    104168::
     
    106170  $ ./configure --with-python=/usr/local
    107171
    108 This suppose that /usr/local/bin/python-config exists.
     172This assumes that /usr/local/bin/python-config exists.
    109173
    110174(Optional) PHP Support
    111175^^^^^^^^^^^^^^^^^^^^^^
    112176
    113 To be able to activate PHP Support for ZOO-Kernel you'll need to get a local PHP Embedded
    114 installation, for more informations about configure options to use to get such kind of PHP
    115 installation you can refer to this page :
     177To be able to activate PHP support for the ZOO Kernel you'll need to get a local PHP Embedded
     178installation; for more information about the required configure options when compiling PHP you
     179can refer to this page :
    116180
    117181     http://zoo-project.org/trac/wiki/ZooKernel/Embed/PHP
    118182
    119 If 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
    121 to specify the path where PHP was installed, so using the following commnd:
     183If you want to activate the PHP support for the ZOO Kernel then you will have to use the
     184``--with-php`` option. If your php-config program is found in your PATH then you don't have
     185to specify the path where PHP was installed, then you can use the following commnd:
    122186
    123187::
     
    125189  $ ./configure --with-php
    126190
    127 This suppose that php-config is found in your PATH.
    128 
    129 In case your php-config is not found in your PATH, then you can set the PHP installation
    130 directory you are using. For instance, let suppose that you installed PHP in /usr/local,
     191This assumes that php-config is found in your PATH.
     192
     193In the case that your php-config is not found in your PATH, then you can specify the PHP installation
     194directory you are using. For instance, let's suppose that you installed PHP in /usr/local,
    131195then you can use the following command:
    132196
     
    135199  $ ./configure --with-php=/usr/local
    136200
    137 This suppose that /usr/local/bin/php-config exists.
     201This assumes that /usr/local/bin/php-config exists.
    138202
    139203(Optional) Perl Support
    140204^^^^^^^^^^^^^^^^^^^^^^^
    141205
    142 If 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
    144 be searched in your PATH. So in such case, you can use the following command:
     206If you want to activate Perl support for the ZOO Kernel then you will have to use the
     207``--with-perl`` option. If you do not set any value to this option, then the perl program will
     208be searched in your PATH. So in such a case, you can use the following command:
    145209
    146210::
     
    148212  $ ./configure --with-perl
    149213
    150 This suppose that perl is found in your PATH.
    151 
    152 In other case, for custom Perl installation, you can set the installation directory. For instance,
    153 let suppose that you installed Perl in /usr/local and /usr/local/bin is not in your PATH,
     214This assumes that perl is found in your PATH.
     215
     216In the other case, for custom Perl installations, you can set the installation directory. For instance,
     217let's suppose that you installed Perl in /usr/local and /usr/local/bin is not in your PATH,
    154218then you can use the following command:
    155219
     
    158222  $ ./configure --with-perl=/usr/local
    159223
    160 This suppose that /usr/local/bin/perl exists.
     224This assumes that /usr/local/bin/perl exists.
    161225
    162226(Optional) Java Support
    163227^^^^^^^^^^^^^^^^^^^^^^^
    164228
    165 If 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,
    167 let suppose that your Java SDK was installed in /usr/lib/jvm/java-6-sun-1.6.0.22/ directory,
     229If you want to activate Java support for the ZOO Kernel then you will have to use the
     230``--with-java`` option and set the installation path of your Java SDK. For instance,
     231let's suppose that your Java SDK was installed in the /usr/lib/jvm/java-6-sun-1.6.0.22/ directory,
    168232then you can use the following command:
    169233
     
    172236  $ ./configure --with-java=/usr/lib/jvm/java-6-sun-1.6.0.22/
    173237
    174 This suppose that the include/linux and jre/lib/i386/client/ subdirectories exist in
     238This assumes that the include/linux and jre/lib/i386/client/ subdirectories exist in
    175239/usr/lib/jvm/java-6-sun-1.6.0.22/, include/linux contains the jni.h headers file and
    176240jre/lib/i386/client/ contains the libjvm.so file.
    177241
    178 Note that on MacOS X you only have to set macos as value for the "*--with-java*" option
    179 to get the Java Support for ZOO-Kernel activated. So using the following command:
    180 
    181 ::
    182 
    183   $ ./configure --with-java=macos
     242.. note::
     243   With Mac OS X you only have to set ``macos`` as the value for the ``--with-java`` option
     244   to activate Java support. For example:
     245
     246   ::
     247
     248     $ ./configure --with-java=macos
    184249
    185250(Optional) JavaScript Support
    186251^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    187252
    188 If you want to activate the JavaScript Support for ZOO-Kernel then you will have to use
    189 the "*--with-js*" option. If you are using a "Debian-like" GNU/Linux distribution then
    190 dpkg will be used to detect if the required packages was installed and you don't have to
     253If you want to activate JavaScript support for the ZOO Kernel then you will have to use
     254the ``--with-js`` option. If you are using a "Debian-like" GNU/Linux distribution then
     255dpkg will be used to detect if the required packages are installed and you don't have to
    191256specify anything here, so you can use the following command:
    192257
     
    195260  $ ./configure --with-js
    196261
    197 This suppose that js_api.h and libmozjs.so are found in default directories.
    198 
    199 If you get a custom installation of SpiderMonkey or you are not using a Debian packaging
     262This assumes that js_api.h and libmozjs.so are found in default directories.
     263
     264If you have a custom installation of SpiderMonkey or you are not using a Debian packaging
    200265system, then you'll have to specify the directory where you installed it. For
    201 instance, let suppose that you installed your SpiderMonkey in /usr, then you'll
     266instance, let's suppose that you installed your SpiderMonkey in /usr, then you'll
    202267have to use the following command:
    203268
     
    206271  $ ./configure --with-js=/usr
    207272
    208 This suppose that the /usr/include/js exists and contains the js_api.h headers file and
     273This assumes that the /usr/include/js exists and contains the js_api.h headers file and
    209274/usr/lib contains libmozjs.so file.
     275
     276.. _win32:   
     277
     278OpenSUSE
     279********
    210280
    211281WIN32
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