Skip to content

RenderingOSMDataOnUbuntuv2

Jump to bottom Edit New page
jlarouche edited this page Aug 13, 2012 · 1 revision

This page provides step by step instructions to setup a Ubuntu 12.04 LTS server from scratch to render OSM data with MapServer 6.x.

The following instructions assume that we start with a brand new Ubuntu 12.04 server with Apache installed but none of the MapServer related packages installed.

The setup will include:

Create working directory

  • All the steps that follow assume that the data and mapfiles will be installed in a directory called "osm-demo" in your home directory
  • Commands:
    mkdir ~/osm-demo
    cd ~/osm-demo/

Install UbuntuGIS MapServer and PostGIS packages

  sudo apt-get install python-software-properties
  sudo add-apt-repository ppa:ubuntugis/ubuntugis-unstable
  sudo apt-get update
  sudo apt-get install cgi-mapserver mapserver-bin

  sudo apt-get install postgresql-9.1-postgis postgresql-server-dev-9.1
  • Install other non-GIS packages that will be required later on:
  sudo apt-get install mercurial subversion git
  sudo apt-get install zip unzip

Download OSM data

  • You can download data for your region of interest from http://downloads.cloudmade.com/. The rest of these instructions assume that we work with the data for the state of Alabama.
  • Commands:
  cd ~/osm-demo/
  wget http://downloads.cloudmade.com/americas/northern_america/united_states/rhode_island/rhode_island.osm.bz2

Install imposm, using virtualenv

  cd ~/osm-demo/
  sudo apt-get install build-essential python-dev protobuf-compiler \
                      libprotobuf-dev libtokyocabinet-dev python-psycopg2 \
                      libgeos-c1

  sudo apt-get install python-virtualenv
  virtualenv venv
  source venv/bin/activate
  • Install shapely speedups: (shapely 1.2.11 has bugs, do not use it)
  sudo apt-get install libgeos-dev
  pip install Shapely
  • Install imposm: Note that up until recently imposm did not create the generalized tables used by the basemaps mapfile. Since version 2.3.0 this is not the case anymore, so there is no need to install a forked version of imposm as was the case in the first versions of this document
  pip install imposm

Create database

  imposm-psqldb > create-db.sh
  vi ./create-db.sh # cross check if all path are set properly
... remove the following line:
-------------------8<--------------
createlang plpgsql osm
------------------->8--------------

  sudo su postgres
  sh ./create-db.sh
  exit
  sudo service postgresql restart

Load data using imposm

  cd ~/osm-demo/
  imposm --proj=EPSG:3857 --read rhode_island.osm.bz2
  imposm --proj=EPSG:3857 --write --database osm --host localhost --user osm
  (... if prompted for db password, the default is osm)
  imposm  --optimize -d osm
  • Note: multiple .osm.pbf files can be loaded in separate commands using the --merge-cache argument.

Install basemaps mapfile generator

Using the Official release from Github:

  cd ~/osm-demo/
  git clone https://github.com/mapserver/basemaps.git
  cd basemaps

... Update basemaps' osmbase.map and Makefile as follows:
  vi osm-base.map
-------------------8<------------------------
  WEB
...
    IMAGEPATH "/tmp/ms_tmp/"
    IMAGEURL "/ms_tmp/"
 END
...
-------------------->8-----------------------

  vi Makefile
-------------------8<------------------------
OSM_SRID=3857
OSM_UNITS=meters
OSM_EXTENT=-20000000 -20000000 20000000 20000000
...
STYLE=google
-------------------->8-----------------------
  • With trunk, the '''STYLE''' parameter possible values are the keys of the style_aliases hash, which can be found in the generate_style.py file. For example: google
  • Create MapServer temp dirs (required by mapserv CGI for testing with openlayers template)
  mkdir /tmp/ms_tmp
  chmod 777 /tmp/ms_tmp
  • Initialize the data and generated folder. You only need to do this once. It may take a while to download everything.
  cd basemaps
  mkdir generated
  cd data
  make
  • Execute the basemaps makefile to generate the mapfile.
  cd basemaps
  make

Using the Mapgears release from Github:

  cd ~/osm-demo/
  git clone https://github.com/mapgears/basemaps.git
  cd basemaps
  • With trunk, the '''STYLE''' parameter possible values are the keys of the style_aliases hash, which can be found in the generate_style.py file. For example: google
  • Create MapServer temp dirs (required by mapserv CGI for testing with openlayers template)
  mkdir /tmp/ms_tmp
  chmod 777 /tmp/ms_tmp
  • Initialize the data and generated folder. You only need to do this once. It may take a while to download everything.
  cd basemaps
  mkdir generated
  cd data
  make
  • Execute the basemaps makefile to generate the mapfile.
  cd basemaps
  make

Setup MapCache

  sudo apt-get install libgdal-dev
  sudo apt-get install autoconf apache2-dev libpixman-1-dev libcurl4-openssl-dev libpng-dev libjpeg-dev libgeos-dev
  • Checkout and build source:
  git clone https://github.com/mapserver/mapcache mapcache-git
  cd mapcache-git
  autoconf
  ./configure
  make

  sudo make install-module
  sudo apache2ctl restart
  mkdir ~/osm-demo/mapcache
  cp ~/osm-demo/mapcache-git/mapcache.xml ~/osm-demo/mapcache/mapcache-osm.xml
  vi ~/osm-demo/mapcache/mapcache-osm.xml
... make required changes to template to make it work with our installation:

<?xml version="1.0" encoding="UTF-8"?>

<!-- see the accompanying mapcache.xml.sample for a fully commented configuration file -->

<mapcache>
   <cache name="disk" type="disk">
      <base>/path/to/osm-demo/mapache/cache</base> <!-- Change Path here -->
      <symlink_blank/>
   </cache>

   <source name="osm" type="wms">
      <getmap>
         <params>
            <FORMAT>image/png</FORMAT>
            <LAYERS>default</LAYERS>
	<MAP>/path/to/osm-demo/basemaps/osm-google.map</MAP> <!-- Change Path here -->
         </params>
      </getmap>

      <http>
         <url>http://localhost/cgi-bin/mapserv?/path/to/osm-demo/basemaps/osm-google.map</url> <!-- Change Path here -->
      </http>
   </source>

   <tileset name="osm">
		<metadata>
			<title>OSM MapServer served map</title>
			<abstract>see https://github.com/mapserver/mapserver/wiki/RenderingOsmDataUbuntu</abstract>
		</metadata>
      <source>osm</source>
      <cache>disk</cache>
      <grid>WGS84</grid>
      <grid>g</grid>
      <format>PNG</format>
      <metatile>5 5</metatile>
      <metabuffer>10</metabuffer>
      <expires>10000</expires>
      <auto_expire>86400</auto_expire>	
   </tileset>


   <default_format>JPEG</default_format>

   <service type="wms" enabled="true">
      <full_wms>assemble</full_wms>
      <resample_mode>bilinear</resample_mode>
      <format>JPEG</format>
      <maxsize>4096</maxsize>
   </service>
   <service type="wmts" enabled="true"/>
   <service type="tms" enabled="true"/>
   <service type="kml" enabled="true"/>
   <service type="gmaps" enabled="true"/>
   <service type="ve" enabled="true"/>
   <service type="demo" enabled="true"/>

   <errors>report</errors>
   <lock_dir>/tmp</lock_dir>

</mapcache>
  • Create 'cache' directory writable by Apache (www-data) user
  mkdir ~/osm-demo/mapcache/cache
  sudo chown www-data ~/osm-demo/mapcache/cache/
  • Add directives to Apache config:
  sudo vi /etc/apache2/sites-available/default
... add the following lines to the end of the default VirtualHost (update the '/path/to/' directory name):

  <IfModule mapcache_module>
    MapCacheAlias /mapcache "/path/to/osm-demo/mapcache/mapcache-osm.xml"
  </IfModule>
  • And restart apache for the changes to take effect:
  sudo apache2ctl restart
Add a custom footer
Add a custom sidebar
Clone this wiki locally