Ticket #731: mapproxy-livedvd.patch

new file in/install_mapproxy.sh

@@ +1 @@
+#!/bin/sh
+#
+# Installation of MapProxy server
+#
+# Created by Oliver Tonnhofer <olt@omniscale.de>
+#
+# Copyright (c) 2010 The Open Source Geospatial Foundation.
+# Licensed under the GNU LGPL.
+
+
+USER_NAME="user"
+USER_HOME="/home/$USER_NAME"
+BIN="/usr/local/bin"
+TMP="/tmp/build_mapproxy"
+MAPPROXY_VERSION="1.1.0"
+MAPPROXY_DEB_FILE="mapproxy_${MAPPROXY_VERSION}_all.deb"
+MAPPROXY_DEB_URL="http://bogosoft.com/misc/${MAPPROXY_DEB_FILE}"
+MAPPROXY_DOCS_FILE="mapproxy-docs-${MAPPROXY_VERSION}.tar.gz"
+MAPPROXY_DOCS_URL="http://bogosoft.com/misc/${MAPPROXY_DOCS_FILE}"
+MAPPROXY_DIR="/usr/local/share/mapproxy"
+
+mkdir -p "$TMP"
+cd "$TMP"
+
+
+echo "Downloading: $MAPPROXY_DEB_URL"
+wget "$MAPPROXY_DEB_URL" -c
+if [ $? -ne 0 ] ; then
+   echo "ERROR: download failed"
+   exit 1
+fi
+
+echo "Downloading: $MAPPROXY_DOCS_URL"
+wget "$MAPPROXY_DOCS_URL" -c
+if [ $? -ne 0 ] ; then
+   echo "ERROR: download failed"
+   exit 1
+fi
+
+echo "Installing: $MAPPROXY_DEB_FILE"
+gdebi --non-interactive $MAPPROXY_DEB_FILE
+if [ $? -ne 0 ] ; then
+   echo "ERROR: package install failed"
+   exit 1
+fi
+
+mkdir -p $MAPPROXY_DIR/
+echo "Extracting docs: $MAPPROXY_DOCS_FILE"
+tar -xz -C $MAPPROXY_DIR -f $MAPPROXY_DOCS_FILE
+if [ $? -ne 0 ] ; then
+   echo "ERROR: docs install failed"
+   exit 1
+fi
+
+echo "Creating Scripts/Links"
+# Create startup script for MapProxy Server
+cat << EOF > $BIN/mapproxy_start.sh
+#!/bin/sh
+mapproxy-util serve-develop -b 0.0.0.0:8011 /usr/local/share/mapproxy/mapproxy.yaml
+EOF
+
+chmod 755 $BIN/mapproxy_start.sh
+
+
+## Create Desktop Shortcut for starting MapProxy Server in shell
+# Note: MapProxy when run with the 'mapproxy-util serve-develop'
+# script is in development  mode and is intended to be run within
+# a viewable terminal, thus 'Terminal=true'
+cat << EOF > /usr/share/applications/mapproxy-start.desktop
+[Desktop Entry]
+Type=Application
+Encoding=UTF-8
+Name=Start MapProxy
+Comment=MapProxy for LiveDVD WMS services
+Categories=Application;Geography;Geoscience;Education;
+Exec=mapproxy_start.sh
+Icon=gnome-globe
+Terminal=true
+StartupNotify=false
+EOF
+
+cp -a /usr/share/applications/mapproxy-start.desktop "$USER_HOME/Desktop/"
+chown -R $USER_NAME:$USER_NAME "$USER_HOME/Desktop/mapproxy-start.desktop"
+
+# Create Desktop Shortcut for Basic Intro page and Demo
+cat << EOF > /usr/share/applications/mapproxy-intro.desktop
+[Desktop Entry]
+Type=Application
+Encoding=UTF-8
+Name=MapProxy Introduction
+Comment=MapProxy Introduction
+Categories=Application;Geography;Geoscience;Education;
+Exec=firefox /usr/local/share/osgeolive-docs/en/overview/mapproxy_overview.html
+Icon=gnome-globe
+Terminal=false
+StartupNotify=false
+EOF
+
+cp -a /usr/share/applications/mapproxy-intro.desktop "$USER_HOME/Desktop/"
+chown -R $USER_NAME:$USER_NAME "$USER_HOME/Desktop/mapproxy-intro.desktop"
+
+echo "Creating Configuration"
+cat << EOF > ${MAPPROXY_DIR}/mapproxy.yaml
+services:
+  demo:
+  kml:
+  tms:
+    # needs no arguments
+  wms:
+    # srs: ['EPSG:4326', 'EPSG:900913']
+    # image_formats: ['image/jpeg', 'image/png']
+    md:
+      # metadata used in capabilities documents
+      title: MapProxy WMS Proxy
+      abstract: This is the fantastic MapProxy.
+      online_resource: http://mapproxy.org/
+      contact:
+        person: Your Name Here
+        position: Technical Director
+        organization: 
+        address: Fakestreet 123
+        city: Somewhere
+        postcode: 12345
+        country: Germany
+        phone: +49(0)000-000000-0
+        fax: +49(0)000-000000-0
+        email: info@omniscale.de
+      access_constraints:
+        This service is intended for private and evaluation use only.
+        The data is licensed as Creative Commons Attribution-Share Alike 2.0
+        (http://creativecommons.org/licenses/by-sa/2.0/)
+      fees: 'None'
+
+layers:
+  - name: tilelite
+    title: World population (Mapnik + TileLite TMS)
+    sources: [tilelite_cache]
+  - name: mapnik
+    title: World population (Mapnik, uncached)
+    sources: [mapnik]
+  # - name: mapserver
+  #   title: Mapserver (Itasca)
+  #   sources: [mapserver]
+  - name: geoserver
+    title: US Population (Geoserver WMS)
+    sources: [geoserver]
+  - name: mapnik_geoserver
+    title: World population (Mapnik) + US Population (Geoserver WMS)
+    sources: [mapnik, geoserver]
+
+caches:
+  tilelite_cache:
+    grids: [GLOBAL_MERCATOR]
+    sources: [tilelite]
+
+sources:
+  geoserver:
+    type: wms
+    wms_opts:
+      featureinfo: true
+    req:
+      url: http://localhost:8082/geoserver/wms?
+      layers: 'topp:states'
+      transparent: true
+    coverage:
+      bbox: -124.73142200000001,24.955967,-66.969849,49.371735
+      bbox_srs: 'EPSG:4326'
+  
+  tilelite:
+    type: tile
+    url: http://127.0.0.1:8012/%(z)d/%(x)d/%(y)d.png
+    origin: nw
+
+  mapnik:
+    type: mapnik
+    mapfile: /usr/local/share/mapnik/demo/population.xml
+
+  # TODO: MapServer example on LiveDVD does not as WMS
+  # mapserver:
+  #   type: wms
+  #   supported_srs: ['epsg:26915']
+  #   req:
+  #     url: http://localhost/cgi-bin/mapserv?
+  #     layers: airports,cities,lakespy2,dlgstln2,roads,twprgpy3
+  #     map: /usr/local/www/docs_maps/mapserver_demos/workshop/itasca.map
+  #   coverage:
+  #     bbox: 363016.590190,5148502.940313,588593.999470,5374080.349593
+  #     bbox_srs: 'epsg:26915'
+
+ # overlay_full_example:
+  #   type: wms
+  #   concurrent_requests: 4
+  #   wms_opts:
+  #     version: 1.3.0
+  #     featureinfo: true
+  #   supported_srs: ['EPSG:4326', 'EPSG:31467']
+  #   supported_formats: ['image/tiff', 'image/jpeg']
+  #   http:
+  #     ssl_no_cert_checks: true
+  #   req:
+  #     url: https://user:password@example.org:81/service?
+  #     layers: roads,rails
+  #     styles: base,base
+  #     transparent: true
+  #     # # always request in this format
+  #     # format: image/png
+  #     map: /home/map/mapserver.map
+    
+
+grids:
+  global_geodetic_sqrt2:
+    base: GLOBAL_GEODETIC
+    res_factor: 'sqrt2'
+  # grid_full_example:
+  #   tile_size: [512, 512]
+  #   srs: 'EPSG:900913'
+  #   bbox: [5, 45, 15, 55]
+  #   bbox_srs: 'EPSG:4326'
+  #   min_res: 2000 #m/px
+  #   max_res: 50 #m/px
+  #   align_resolutions_with: GLOBAL_MERCATOR
+  # another_grid_full_example:
+  #   srs: 'EPSG:900913'
+  #   bbox: [5, 45, 15, 55]
+  #   bbox_srs: 'EPSG:4326'
+  #   res_factor: 1.5
+  #   num_levels: 25
+
+globals:
+  # # coordinate transformation options
+  # srs:
+  #   # WMS 1.3.0 requires all coordiates in the correct axis order,
+  #   # i.e. lon/lat or lat/lon. Use the following settings to
+  #   # explicitly set a CRS to either North/East or East/North
+  #   # ordering.
+  #   axis_order_ne: ['EPSG:9999', 'EPSG:9998']
+  #   axis_order_en: ['EPSG:0000', 'EPSG:0001']
+  #   # you can set the proj4 data dir here, if you need custom
+  #   # epsg definitions. the path must contain a file named 'epsg'
+  #   # the format of the file is:
+  #   # <4326> +proj=longlat +ellps=WGS84 +datum=WGS84 +no_defs  <>
+  #   proj_data_dir: '/path to dir that contains epsg file'
+
+  # # cache options
+  cache:
+    # where to store the cached images
+    base_dir: '/tmp/mapproxy/cache_data'
+    # where to store lockfiles
+    lock_dir: '/tmp/mapproxy/cache_data/locks'
+  #   # request x*y tiles in one step
+  #   meta_size: [4, 4]
+  #   # add a buffer on all sides (in pixel) when requesting
+  #   # new images
+  #   meta_buffer: 80
+
+
+  # image/transformation options
+  image:
+      resampling_method: bicubic
+      # resampling_method: bilinear
+      # resampling_method: nearest
+  #     jpeg_quality: 90
+  #     # stretch cached images by this factor before
+  #     # using the next level
+  #     stretch_factor: 1.15
+  #     # shrink cached images up to this factor before
+  #     # returning an empty image (for the first level)
+  #     max_shrink_factor: 4.0
+
+EOF
+
+chown -R $USER_NAME:$USER_NAME ${MAPPROXY_DIR}/mapproxy.yaml

new file doc/en/overview/mapproxy_overview.rst

@@ +1 @@
+:Author: Oliver Tonnhofer
+:Version: osgeo-live5.0
+:License: Creative Commons Attribution 3.0 Unported License
+
+.. _mapproxy-overview:
+
+.. image:: ../../images/project_logos/logo-mapproxy.png
+  :alt: project logo
+  :align: right
+  :target: http://mapproxy.org/
+
+MapProxy
+========
+
+Swiss army knife for WMS and tile services
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+MapProxy is *the* swiss army knife for all WMS and tile services.
+It caches, accelerates and transforms data from existing map services and serves any desktop or web GIS client.
+
+.. image:: ../../images/screenshots/800x600/mapproxy.png
+  :alt: MapProxy diagram
+  :align: center
+
+MapProxy is not only a tile cache solution, but also offers many new and innovative features like full support for WMS clients. 
+
+MapProxy is actively developed and supported, it is released under the `Apache Software License 2.0 <asl2>`_, runs on Unix/Linux/Mac OS X and Windows and is easy to install and to configure. 
+
+Features of MapProxy
+--------------------
+
+.. image:: ../../images/screenshots/800x600/mapproxy_demo.png
+  :width: 796
+  :height: 809
+  :scale: 70 %
+  :alt: MapProxy demo
+  :align: right
+ 
+Input sources:
+  * WMS 1.0.0–1.3.0 (MapServer, GeoServer, etc.)
+  * TMS (TileCache, GeoWebcache, etc.)
+  * Mapserver and Mapnik (directly, without WMS)
+  * any TileCache, Google Maps or Bing compatible source
+
+Services:
+  * WMS (1.0.0-1.3.0)
+  * TMS
+  * WMTS
+  * KML SuperOverlays
+
+Tile cache:
+  * stores identical images just once (e.g. ocean tiles)
+  * add watermark to tiles
+
+Source options:
+  * limit sources to geometries (from Shapefile for example)
+  * add transparency to opaque layers
+  * merge multiple sources
+  * reproject to other SRS
+
+WMS Features:
+  * build layer trees from different sources
+  * create ``GetMap`` responses from cache with support for free-zooming and any projection (for any Desktop GIS)
+  * accelerates existing WMS 10 to 100 times
+  * respond to ``GetLegendGraphic`` requests
+  * cascade ``GetFeatureInfo`` requests with optional XSL transformations
+  * on-the-fly reprojection
+  * convert WMS versions and image formats
+
+Other features:
+  * add attribution lines to the images
+  * support for non-image raster data like DEMs
+  * support for custom authorization with fine-grained control over services and layers
+  * many more
+
+Implemented Standards
+---------------------
+
+MapProxy implements the following open specifications:
+
+* OGC WMS 1.0.0, 1.1.0, 1.1.1, 1.3.0
+* OGC WMTS 1.0.0
+* OSGeo TMS 1.0.0
+* OGC KML 2.2 SuperOverlays
+
+
+Demo
+----
+
+* Start MapProxy (*Geospatial* --> *Web Services* --> *Start MapProxy*)
+* `Open demo in Firefox <http://localhost:8012/demo>`_
+
+Documentation
+-------------
+
+* `MapProxy 1.1.0 Documentation <file:///usr/local/share/mapproxy/doc/index.html>`_
+
+
+Details
+-------
+
+**Website:** http://mapproxy.org/
+
+**Licence:** `Apache Software License 2.0 <asl2>`_
+
+**Software Version:** 1.1.0
+
+**Supported Platforms:** Linux, Mac, Windows
+
+**Support:** http://mapproxy.org/support.html
+
+.. _asl2:  http://www.apache.org/licenses/LICENSE-2.0.html
+
+Quickstart
+----------
+    
+* `Quickstart documentation <../quickstart/mapproxy_quickstart.html>`_

doc/en/overview/overview.rst

@@ -67 +67 @@
 * :doc:`deegree_overview` - [`QuickStart <../quickstart/deegree_quickstart.html>`_]
 * :doc:`mapguide_overview` - [`QuickStart <../quickstart/mapguide_quickstart.html>`_]
 * :doc:`qgis_mapserver_overview` - [`QuickStart <../quickstart/qgis_mapserver_quickstart.html>`_]
+* :doc:`mapproxy_overview` - [`QuickStart <../quickstart/mapproxy_quickstart.html>`_]
 * :doc:`geonetwork_overview` - [`QuickStart <../quickstart/geonetwork_quickstart.html>`_] - Metadata Catalog and Catalog Services for Web
 * :doc:`52nWPS_overview` - [`QuickStart <../quickstart/52nWPS_quickstart.html>`_] - Web Processing Service
 * :doc:`52nSOS_overview` - [`QuickStart <../quickstart/52nSOS_quickstart.html>`_] - Sensor Observation Service

new file doc/en/quickstart/mapproxy_quickstart.rst

@@ +1 @@
+:Author: Oliver Tonnhofer
+:Version: osgeo-live5.0
+:License: Creative Commons Attribution 3.0 Unported License
+
+.. _mapproxy-quickstart:
+ 
+.. image:: ../../images/project_logos/logo-mapproxy.png
+  :alt: project logo
+  :align: right
+  :target: http://mapproxy.org/
+
+MapProxy Quickstart
+~~~~~~~~~~~~~~~~~~~
+
+MapProxy is *the* swiss army knife for all WMS and tile services.
+It caches, accelerates and transforms data from existing map services and serves any desktop or web GIS client.
+
+.. image:: ../../images/screenshots/800x600/mapproxy.png
+  :alt: MapProxy diagram
+  :align: center
+
+MapProxy is not only a tile cache solution, but also offers many new and innovative features like full support for WMS clients.
+
+Start demo service
+------------------
+
+MapProxy has flexible deployment options and you can integrate it in Apache for example. But you can also start MapProxy as a standalone service, which is the best option to get started.
+
+To start MapProxy as a standalone service click on *Geospatial* --> *Web Services* --> *Start MapProxy*.
+
+
+View MapProxy Demo
+------------------
+
+The MapProxy demo page contains a rudimentary WMS and tile client for each configured layer. You can't select the projection for WMS layers for example, but it is enough to quickly verify that your installation works.
+
+You can open the demo in Firefox: `<http://localhost:8012/demo>`_
+
+View in Desktop GIS
+-------------------
+
+You can add MapProxy in any WMS Desktop GIS like uDig, QGIS or gvSIG. The service URL is: `<http://localhost:8012/service?>`_
+
+The MapProxy example configuration contains a few layers that use different map engines and map data. See below for more details about each layer. 
+
+.. figure:: ../../images/screenshots/800x600/mapproxy_udig.png
+  :alt: MapProxy example in uDig
+  :align: center
+  
+  Single WMS layer with data from two cascaded sources and `FeatureInformation` from one source.
+
+Available layers
+----------------
+
+**mapnik**:
+  The world population rendered by Mapnik. You don't need to start the Mapnik service, because this layer makes use of the integrated Mapnik support in MapProxy.
+
+**tilelite**:
+  TileLite is a simple server that delivers tiles from the Mapnik world population service. This layer demonstrates the ability to include existing tile services in MapProxy and to make them available as WMS.
+  You need to start TileLite with *Start Mapnik & TileLite* before accessing this layer.
+
+**geoserver**:
+  The US population rendered by the Geoserver WMS. This layer also supports ``GetFeatureInfo`` requests which are cascaded to the source WMS.
+  You need to start Geoserver with *Start Geoserver* before accessing this layer.
+
+**mapnik_geoserver**:
+  This layer demonstrates the ability to combine multiple sources into one layer. It combines the world population from Mapnik with the US population from Geoserver. The ``GetFeatureInfo`` support for the US population is still available.
+  
+  You need to start Geoserver with *Start Geoserver* before accessing this layer.
+
+
+Create you own configuration
+----------------------------
+
+You can use ``mapproxy-util`` to create new configuration templates and to start a test server.
+
+To create a new configuration::
+
+  mapproxy-util create -t base-config ~/mapproxy
+
+To start the test server on port 8012 with the created configuration::
+
+  mapproxy-util serve-develop ~/mapproxy/mapproxy.yaml -b 0.0.0.0:8012
+
+You can now visit the demo page at http://127.0.0.1:8012/demo/.
+MapProxy will automatically reload if you change your configuration file.
+
+
+What Next?
+----------
+
+* Read the documentation_ of MapProxy
+
+* Read the example configuration (``/usr/local/share/mapproxy/mapproxy.yaml``)
+
+.. _documentation: http://mapproxy.org/docs/latest/
+