Changeset 409 for trunk/docs/kernel


Ignore:
Timestamp:
Mar 29, 2013, 12:41:53 PM (12 years ago)
Author:
lucadelu
Message:

update debian/ubuntu installation

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/docs/kernel/install-debian.txt

    r348 r409  
    1515   (root: ZOO.test)
    1616
    17 The following instructions were tested on Debian Squeeze, Ubuntu 10.04 and Ubuntu 10.10
     17Ubuntu 12.04 dependencies
     18--------------------------------------
     19
     20- install default dependencies
     21
     22::
     23
     24  sudo apt-get install flex bison libfcgi-dev libxml2 libxml2-dev curl openssl autoconf apache2 python-software-properties subversion libmoz185js-dev python-dev build-essential
     25
     26- add ubuntugis repository to obtain the newer GIS libraries
     27
     28::
     29
     30  sudo add-apt-repository ppa:ubuntugis/ppa
     31  sudo apt-get update
     32
     33
     34- install geographic library
     35
     36::
     37
     38  sudo apt-get install libgdal1-dev
     39
     40- download ZOO  source
     41
     42Debian 7.0 dependencies
     43--------------------------------------
     44
     45- install dependencies
     46
     47::
     48
     49  apt-get install flex bison libfcgi-dev libxml2 libxml2-dev curl openssl autoconf apache2 python-software-properties subversion python-dev libgdal1-dev build-essential libmozjs185-dev
     50
    1851
    1952Installation Workflow
    20 ---------------------
    21 
    22 - install some dependencies
    23 
    24 ::
    25 
    26   sudo apt-get install flex bison libfcgi-dev libxml2 libxml2-dev curl openssl autoconf checkinstall
    27 
    28 - download ZOO  source
     53--------------------------------------
     54
     55.. note :: In the following lines you will find ``as administrator user`` note,
     56           on Ubuntu you have to add ``sudo`` at the beginning of line, on Debian
     57           you can use ``su -c COMMAND``)
    2958
    3059::
     
    4473  make
    4574
     75- if you want use Mapserver (optional) for WMS, WFS and WCS output read :ref:`mapserver`
    4676
    4777- go to kernel path
     
    4979::
    5080
    51   cd ../../zoo-kernel/
     81  cd ../../zoo-project/zoo-kernel/
    5282
    5383- create configure file
     
    6191::
    6292
    63   ./configure --with-java=/path/to/java
    64   ./configure --with-python
    65 
    66 .. note::
    67    In Ubuntu 10.04 libmozjs-dev does not exist, so to use JavaScript you can compile SpiderMonkey (remember to put /usr/local/lib in a file inside /etc/ld.so.conf.d/).
    68    For PHP, you must make sure to compile PHP with `--enable-embed <http://www.zoo-project.org/trac/wiki/ZooKernel/Embed/PHP#ConfigureandInstallPHPEmbedlibrary>`__.
    69 
    70 - to use JavaScript with compiled SpiderMonkey.
    71 
    72 ::
    73    
    74   sudo echo "/usr/local/lib" > /etc/ld.so.conf.d/libmoz185.conf
    75   sudo ldconfig
    76   ./configure --with-js=/usr/local
    77 
    78 
    79 - to use JavaScript with Xulrunner .
    80 
    81 ::
    82    
    83   sudo echo "/usr/lib/xulrunner-dev" > /etc/ld.so.conf.d/libmoz185.conf
    84   sudo ldconfig
    85   ./configure --with-js=/usr/lib/xulrunner-dev
    86 
     93  ./configure --with-js --with-python
     94
     95.. note:: For PHP, you must make sure to compile PHP with `--enable-embed <http://www.zoo-project.org/trac/wiki/ZooKernel/Embed/PHP#ConfigureandInstallPHPEmbedlibrary>`__.
     96
     97.. note:: To use MapServer add the option ``--with-mapserver=/path/to/mapserver/source``
    8798
    8899- compile
     
    90101::
    91102
    92   make zoo_loader.cgi
    93 
    94 - copy necessary files into your cgi-bin
    95 
    96 ::
    97 
    98   sudo cp main.cfg /usr/lib/cgi-bin
    99   sudo cp zoo_loader.cgi /usr/lib/cgi-bin
    100 
    101 - install ZOO ServiceProvider (in this case we try Python service)
    102 
    103 ::
    104 
    105   sudo cp ../zoo-services/hello-py/cgi-env/*.zcfg /usr/lib/cgi-bin
    106   sudo cp ../zoo-services/hello-py/*.py /usr/lib/cgi-bin/
    107 
    108 - change some paths in the main.cfg
    109 
    110 ::
    111 
    112   sudo nano /usr/lib/cgi-bin/main.cfg
    113     - serverAddress = http://127.0.0.1
    114     - providerSite = http://127.0.0.1
     103  make
     104
     105- copy necessary files into your cgi-bin (as administrator user)
     106
     107
     108::
     109
     110  cp main.cfg /usr/lib/cgi-bin
     111  cp zoo_loader.cgi /usr/lib/cgi-bin
     112
     113- install ZOO ServiceProvider, in this case we try Python service (as administrator user)
     114
     115::
     116
     117  cp ../zoo-services/hello-py/cgi-env/*.zcfg /usr/lib/cgi-bin
     118  cp ../zoo-services/hello-py/*.py /usr/lib/cgi-bin/
     119
     120- change some information in the main.cfg (as administrator user)
     121
     122::
     123
     124  nano /usr/lib/cgi-bin/main.cfg
     125  - serverAddress = http://127.0.0.1
    115126
    116127
     
    128139     [env]
    129140     PYTHONPATH=<YOUR_PYTHONPATH>
     141
     142
     143Rewrite rule configuration
     144-----------------------------
     145
     146- for better readability and fully functional ZOO Kernel, you have to modify the default
     147  Apache configuration in order to be able to use the http://localhost/zoo/ url directly.
     148  Run (as administrator user)
     149
     150::
     151
     152    nano /usr/lib/cgi-bin/main.cfg
     153    - serverAddress = http://localhost/zoo
     154
     155- first, please create a ``zoo`` directory in ``/var/www/`` which is used by Apache as the
     156  DocumentRoot (as administrator user)
     157
     158::
     159
     160  mkdir /var/www/zoo
     161
     162- Then, please edit the ``/etc/apache2/sites-available/default`` configuration file and add the following
     163  lines after the Directory block related to /var/www directory (as administrator user)
     164
     165::
     166
     167  <Directory /var/www/zoo/>
     168      Options Indexes FollowSymLinks MultiViews
     169      AllowOverride All
     170      Order allow,deny
     171      allow from all
     172  </Directory>
     173
     174- now create a small .htaccess file in the ``/var/www/zoo`` containing the following lines (as administrator user)
     175
     176::
     177
     178  RewriteEngine on
     179  RewriteRule call/(.*)/(.*) /cgi-bin/zoo_loader.cgi?request=Execute&service=WPS&version=1.0.0&Identifier=$1&DataInputs=sid=$2&RawDataOutput=Result [L,QSA]
     180  RewriteRule (.*)/(.*) /cgi-bin/zoo_loader.cgi?metapath=$1 [L,QSA]
     181  RewriteRule (.*) /cgi-bin/zoo_loader.cgi [L,QSA]
     182
     183
     184- for this last file to be taken into account by Apache, you must activate the
     185  rewrite Apache module by copying a load file as bellow (as administrator user)
     186
     187::
     188
     189  cp /etc/apache2/mods-available/rewrite.load /etc/apache2/mods-enabled/
     190
     191- or using the a2enmod tool this way (as administrator user)
     192
     193::
     194
     195  a2enmod rewrite
     196
     197- now you should be able to access the ZOO Kernel using a simplified by restarting
     198  your Apache Web server (as administrator user)
     199
     200::
     201  /etc/init.d/apache2 restart
     202
     203- now you can try:
     204
     205  - http://localhost/zoo/?Service=WPS&Request=GetCapabilities&Version=1.0.0
     206  - http://localhost/zoo/?Service=WPS&Request=DescribeProcess&Version=1.0.0&Identifier=HelloPy
     207  - http://localhost/zoo/?Service=WPS&Request=Execute&Version=1.0.0&Identifier=HelloPy&DataInputs=a=myname
     208
     209.. _mapserver:
     210
     211Compile MapServer
     212------------------
     213
     214- install MapServer dependencies (as administrator user)
     215
     216::
     217
     218  apt-get install git libfreetype6-dev libproj-dev libkml-dev libcairo-dev libxml2-dev libgd2-xpm-dev libxslt1-dev
     219
     220- extract MapServer from git repository
     221
     222::
     223
     224  git clone https://github.com/mapserver/mapserver.git
     225  cd mapserver
     226  git checkout branch-6-2
     227  git pull
     228
     229- now compile MapServer
     230
     231::
     232
     233  ./configure --with-ogr --with-gdal --with-wfsclient --with-wmsclient --with-tiff --with-jpeg --with-gd --with-wcs --with-sos --with-xml2-config --with-wfs --with-fastcgi --with-proj --with-cairo --with-kml=yes --with-xslt --with-threads --with-geos
     234  make
     235
     236- now install MapServer (as administrator user)
     237
     238::
     239
     240  make install
     241
     242- now add path to libraries path (as administrator user)
     243
     244::
     245
     246  nano /etc/ld.so.conf.d/mapserver.conf
     247  - /usr/local/lib/
     248
     249- run as administrator
     250
     251::
     252
     253  ldconfig
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