wiki:GIS/InstallationGuidelines/Linux

Version 23 (modified by Fran Boon, 14 years ago) ( diff )

--

Installation of GIS Tools on Linux

Suggest these CLI tools for data manipulation:

PostGIS

PostGIS adds Spatial storage to PostgreSQL

NB PostGIS in Debian Lenny is rather old - recommend using the version in Squeeze

apt-get install postgresql-8.4-postgis
su postgres
createdb gis
createlang plpgsql gis
psql -d gis -f /usr/share/postgresql-8.4-postgis/lwpostgis.sql
psql -d gis -f /usr/share/postgresql-8.4-postgis/spatial_ref_sys.sql
  • Add Spherical Mercator projection (900913. See http://www.cadmaps.com/gisblog/?p=81 for 54004):
    psql gis
    INSERT into spatial_ref_sys (srid, auth_name, auth_srid, srtext, proj4text) values (900913 ,'EPSG',900913,'GEOGCS["WGS 84", DATUM["World Geodetic System 1984", SPHEROID["WGS 84", 6378137.0, 298.257223563,AUTHORITY["EPSG","7030"]], AUTHORITY["EPSG","6326"]],PRIMEM["Greenwich", 0.0, AUTHORITY["EPSG","8901"]], NIT["degree",0.017453292519943295], AXIS["Longitude", EAST], AXIS["Latitude", NORTH],AUTHORITY["EPSG","4326"]], PROJECTION["Mercator_1SP"],PARAMETER["semi_minor", 6378137.0], PARAMETER["latitude_of_origin",0.0], PARAMETER["central_meridian", 0.0], PARAMETER["scale_factor",1.0], PARAMETER["false_easting", 0.0], PARAMETER["false_northing", 0.0],UNIT["m", 1.0], AXIS["x", EAST], AXIS["y", NORTH],AUTHORITY["EPSG","900913"]] |','+proj=merc +a=6378137 +b=6378137 +lat_ts=0.0 +lon_0=0.0 +x_0=0.0 +y_0=0 +k=1.0 +units=m +nadgrids=@null +no_defs');
    
  • Allow remote access:
    passwd postgres
    
    vim /etc/postgresql/8.4/main/postgresql.conf
    listen_addresses = '*'
    
    vim /etc/postgresql/8.4/main/pg_hba.conf
    host    all         all         my.ip.add.ress/24     md5
    
    /etc/init.d/postgresql restart
    
    vim /etc/iptables.rules
    -A INPUT -p tcp --dport 5432 -j ACCEPT
    
    reboot
    
    su postgres
    createuser -s -P gis
    

(Don't do remote access as 'postgres' - to do so means can't simply access psql via 'su postgres')

  • Adjust postgresql.conf for performance relative to resources available (http://wiki.postgresql.org/wiki/Tuning_Your_PostgreSQL_Server)
    vim /etc/sysctl.conf
    # Increase Shared Memory available for PostgreSQL
    # 512Mb
    kernel.shmmax = 279134208
    # 1024Mb (may need more)
    #kernel.shmmax = 536870912
    kernel.shmall = 2097152
    
    sysctl -w kernel.shmmax=58720256
    sysctl -w kernel.shmall=2097152
    
    vim /etc/postgresql/8.4/main/postgresql.conf
    
    # This default is probably ok
    # adjust upward _or_ add a connection pooling layer like pgpool if running out of connections for clients
    max_connections = 100
    
    # shared_buffers = 24MB
    # Ideal is if all frequently accessed indexes and table rows can fit in here - this is often unrealistic
    # setting too high relative to system resources can be detrimental to the system.
    # At the high end this should be no more than 1/4 to 1/3 the available memory (ie that which is not being used by the OS or other processes).
    # Values suggested are quite conservative, so you can push them up a bit if there are resources available for it
    # but absolutely no more than 1/3 available memory.
    # 512Mb system suggest starting at:
    shared_buffers = 56MB
    # 1024Mb system suggest starting at:
    #shared_buffers = 160MB
    
    # effective_cache_size = 128MB
    # 512Mb system suggest starting at:
    effective_cache_size = 256MB
    # 1024Mb system suggest starting at:
    #effective_cache_size = 512MB
    
    #work_mem = 1MB
    # This is a per sort setting, so setting this too high with a high number of max_connections can be bad.
    # If the database load turns out to have a lot of sorting and not a lot of separate connections, you should increase this
    # and drop the max_connections.
    # 512Mb system suggest starting at:
    work_mem = 2MB
    # 1024Mb system suggest starting at:
    #work_mem = 4MB
    
    # As you get more memory in the system, moving this up can be quite useful if you notice vacuum processes taking forever.
    maintenance_work_mem = 16MB
    
    /etc/init.d/postgresql restart
    

Java

vim /etc/apt/sources.list
# for sun-java packages in unstable
deb http://ftp.debian.org/debian/ unstable non-free
deb-src http://ftp.debian.org/debian/ unstable non-free

apt-get update
apt-get install sun-java6-jdk
vim /etc/profile
JAVA_HOME=/usr/lib/jvm/java-6-sun
export JAVA_HOME

or:

  • Download the JDK & install it:
    cd /usr/local
    sh ~/jdk-6u21-linux-i586.bin
    ln -sf /usr/local/jdk1.6.0_21 /usr/local/java
    vim /etc/profile
    JAVA_HOME=/usr/local/java
    export JAVA_HOME
    

Install the JAI extensions (improves performance for GeoServer WMS): 32-bit:

cd /usr/lib/jvm/java-6-sun
wget http://download.java.net/media/jai/builds/release/1_1_3/jai-1_1_3-lib-linux-i586-jdk.bin
wget http://download.java.net/media/jai-imageio/builds/release/1.1/jai_imageio-1_1-lib-linux-i586-jdk.bin
sh jai-1_1_3-lib-linux-i586-jdk.bin
# accept license
export _POSIX2_VERSION=199209
sh jai_imageio-1_1-lib-linux-i586-jdk.bin
# accept license
rm jai-1_1_3-lib-linux-i586-jdk.bin
rm jai_imageio-1_1-lib-linux-i586-jdk.bin

64-bit:

cd /usr/lib/jvm/java-6-sun
wget http://download.java.net/media/jai/builds/release/1_1_3/jai-1_1_3-lib-linux-amd64-jdk.bin
wget http://download.java.net/media/jai-imageio/builds/release/1.1/jai_imageio-1_1-lib-linux-amd64-jdk.bin
sh jai-1_1_3-lib-linux-amd64-jdk.bin
# accept license
export _POSIX2_VERSION=199209
sh jai_imageio-1_1-lib-linux-amd64-jdk.bin
# accept license
rm jai-1_1_3-lib-linux-amd64-jdk.bin
rm jai_imageio-1_1-lib-linux-amd64-jdk.bin

Apache Tomcat

Tomcat is the recommended way to deploy Java applications

  • Debian:
    apt-get install sun-java6-jdk tomcat5.5 libapache2-mod-jk
    a2enmod jk
    vim /etc/libapache2-mod-jk/workers.properties
    workers.java_home=/usr/lib/jvm/java-6-sun
    
    # Needed for GeoServer-2.1-beta1 (2.0.2 was fine, but maybe it's because of running both at once?)
    vim /etc/default/tomcat5.5
    JAVA_OPTS="-Djava.awt.headless=true -Xmx256M -XX:MaxPermSize=128m"
    
    vim /etc/init.d/tomcat5.5
    TOMCAT5_SECURITY=no
    
    /etc/init.d/tomcat5.5 restart
    

Enable access to GeoServer on Port 80:

a2enmod proxy
a2enmod proxy_ajp
a2enmod proxy_http
vim /etc/apache2/mods-enabled/proxy.conf
    Deny from all
    Allow from localhost

vim /etc/apache2/sites-available/geo
<VirtualHost *:80>
  ServerName geo.eden.sahanafoundation.org
  ServerAdmin webmaster@sahanafoundation.org
  DocumentRoot /var/www

  ProxyPreserveHost on
  RewriteEngine On
  # These 2 lines should be disabled in Production
  RewriteRule ^/geoserver/(.*)$ ajp://localhost:8009/geoserver/$1 [P]
  ProxyPassReverse /geoserver ajp://localhost:8009/geoserver/
  RewriteRule ^/geoserver/wfs ajp://localhost:8009/geoserver/wfs [P]
  ProxyPassReverse /geoserver/wfs ajp://localhost:8009/geoserver/wfs
  RewriteRule ^/geoserver/wms ajp://localhost:8009/geoserver/wms/ [P]
  ProxyPassReverse /geoserver/wms ajp://localhost:8009/geoserver/wms/
  RewriteRule ^/geowebcache/(.*)$ ajp://localhost:8009/geowebcache/$1 [P]
  ProxyPassReverse /geowebcache ajp://localhost:8009/geowebcache/

  ErrorLog /var/log/apache2/geo_error.log
  LogLevel warn
  CustomLog /var/log/apache2/geo_access.log combined
</VirtualHost>

a2ensite geo
/etc/init.d/apache2 restart

WMS/WFS

GeoServer

(recommended)

apt-get install unzip
wget http://downloads.sourceforge.net/project/geoserver/GeoServer/2.0.2/geoserver-2.0.2-war.zip

cd /var/lib/tomcat5.5/webapps
unzip ~/geoserver-2.0.2-war.zip

/etc/init.d/tomcat5.5 restart

vim /etc/iptables.rules
-A INPUT -p tcp --dport 8180 -j ACCEPT

reboot

http://geo.host.domain:8180/geoserver

or

wget http://downloads.sourceforge.net/project/geoserver/GeoServer/2.0.2/geoserver-2.0.2-bin.zip
cd /usr/local
unzip ~/geoserver-2.0.2-bin.zip
ln -sf /usr/local/geoserver-2.0.2 /usr/local/geoserver

vim /etc/profile
GEOSERVER_HOME=/usr/local/geoserver
export GEOSERVER_HOME

vim /etc/rc.local
/usr/local/geoserver/bin/startup.sh &

vim /etc/iptables.rules
-A INPUT -p tcp --dport 8080 -j ACCEPT

reboot

http://geo.host.domain:8080/geoserver

Configure:

MapServer

Printing

For Printing TMS layers, need to compile the Trunk version of the MapFish Print Module & then serve the resultant .war with Tomcat:

  1. Ensure that JAVA_HOME points to a JDK.
  2. Download & build source:
    svn checkout http://www.mapfish.org/svn/mapfish/print/trunk/
    cd trunk
    ./gradlew build
    
  3. Configure Tomcat
    vim /etc/tomcat5.5/policy.d/04webapps.policy
    permission java.io.FilePermission "/var/lib/tomcat5.5/webapps/print-servlet-1.2-SNAPSHOT/WEB-INF/classes/logging.properties", "read";
    
    /etc/init.d/tomcat5.5 restart
    
    vim /etc/apache2/sites-available/print
    
    
    ln -s /etc/apache2/sites-available/print /etc/apache2/sites-enabled/print
    /etc/init.d/apache2 restart
    
  4. Copy the WAR file to your %WEBAPPS% directory:
    cp trunk/build/libs/print-servlet-1.2-SNAPSHOT.war /var/lib/tomcat5.5/webapps
    
  5. (re)Start Tomcat
  6. Configure the Map URL for Eden to:
  7. Configure %WEBAPPS%\print-servlet-1.2-SNAPSHOT\config.yaml: http://www.mapfish.org/doc/print/configuration.html

Printing can also be done within GeoServer:

However this version doesn't yet support TMS layers, like OpenStreetMap.

wget http://geoserver.org/download/attachments/20938936/printing-2.0.x.zip
wget http://geoserver.org/download/attachments/20938936/printing-data-2.0.x.zip
cd /usr/local/geoserver-2.0.2/webapps/geoserver/WEB-INF/lib
unzip ~/printing-2.0.x.zip
cd /usr/local/geoserver-2.0.2/data_dir
unzip ~/printing-data-2.0.x.zip
/usr/local/geoserver/bin/shutdown.sh
/usr/local/geoserver/bin/startup.sh &
  • Configure by editing /usr/local/geoserver-2.0.2/data_dir/printing/config.yaml according to Documentation

Print to Image

Cache

  • http://mapproxy.org
    • http://mapproxy.org/docs/latest/install.html
      wget http://effbot.org/downloads/Imaging-1.1.7.tar.gz
      tar zxvf Imaging-1.1.7.tar.gz
      cd Imaging-1.1.7
      python setup.py install
      cd ..
      
      wget http://pyproj.googlecode.com/files/pyproj-1.8.6.tar.gz
      tar zxvf pyproj-1.8.6.tar.gz
      cd pyproj-1.8.6
      python setup.py install
      cd ..
      
      wget http://pyyaml.org/download/pyyaml/PyYAML-3.09.tar.gz
      tar zxvf PyYAML-3.09.tar.gz
      cd PyYAML-3.09
      python setup.py install
      cd ..
      
      wget http://pypi.python.org/packages/source/J/Jinja2/Jinja2-2.1.1.tar.gz
      tar zxvf Jinja2-2.1.1.tar.gz
      cd Jinja2-2.1.1
      python setup.py install
      cd ..
      
      wget http://pypi.python.org/packages/source/f/flup/flup-1.0.3.dev-20100525.tar.gz
      tar zxvf flup-1.0.3.dev-20100525.tar.gz
      cd flup-1.0.3.dev-20100525
      python setup.py install
      cd ..
      
      wget http://pypi.python.org/packages/source/P/Paste/Paste-1.7.4.tar.gz
      tar zxvf Paste-1.7.4.tar.gz
      cd Paste-1.7.4
      python setup.py install
      cd ..
      
      wget http://pypi.python.org/packages/source/P/PasteDeploy/PasteDeploy-1.3.3.tar.gz
      tar zxvf PasteDeploy-1.3.3.tar.gz
      cd PasteDeploy-1.3.3
      python setup.py install
      cd ..
      
      wget http://pypi.python.org/packages/source/P/PasteScript/PasteScript-1.7.3.tar.gz
      tar zxvf PasteScript-1.7.3.tar.gz
      cd PasteScript-1.7.3
      python setup.py install
      cd ..
      
      wget http://pypi.python.org/packages/source/M/MapProxy/MapProxy-0.8.4.tar.gz
      tar zxvf MapProxy-0.8.4.tar.gz
      cd MapProxy-0.8.4
      python setup.py install
      cd ..
      
      cd /home
      paster create -t mapproxy_conf mapproxy
      
    • http://code.google.com/p/modwsgi/wiki/IntegrationWithPylons
      wget http://pypi.python.org/packages/source/C/ConcurrentLogHandler/ConcurrentLogHandler-0.8.4.tar.gz
      tar zxvf ConcurrentLogHandler-0.8.4.tar.gz
      cd ConcurrentLogHandler-0.8.4
      python setup.py install
      cd ..
      
      mkdir /var/www/.python-eggs
      chown www-data /var/www/.python-eggs
      
      vim /home/mapproxy/mapproxy.py
      import os, sys
      from paste.script.util.logging_config import fileConfig
      BASEDIR = os.path.dirname(__file__)
      INIFILE = os.path.join(BASEDIR, 'etc', 'config.ini')
      LOGFILE = os.path.join(BASEDIR, 'etc', 'log_deploy.ini')
      sys.path.append(BASEDIR)
      os.environ['PYTHON_EGG_CACHE'] = '/var/www/.python-eggs'
      fileConfig( LOGFILE )
      from paste.deploy import loadapp
      application = loadapp('config:%s' % INIFILE)
      
      vim /etc/apache2/sites-available/proxy
      <VirtualHost *:80>
        ServerName proxy.sahanafoundation.org
        ServerAdmin webmaster@sahanafoundation.org
        
        WSGIScriptAlias / /home/mapproxy/mapproxy.py
        WSGIDaemonProcess mapproxy user=www-data group=www-data home=/home/mapproxy processes=2 maximum-requests=100
        
        <Location "/">
          Order deny,allow
          Allow from all
          WSGIProcessGroup mapproxy
        </Location>
      
        ErrorLog /var/log/apache2/proxy_error.log
        LogLevel warn
        CustomLog /var/log/apache2/proxy_access.log combined
      </VirtualHost>
      
      cd /etc/apache2/sites-enabled
      ln -s ../sites-available/proxy
      /etc/init.d/apache2 force-reload
      
    • http://mapproxy.org/docs/latest/configuration.html

UserGuidelinesGISData

Attachments (2)

Download all attachments as: .zip

Note: See TracWiki for help on using the wiki.