VladPolskiy/openstreetmap-mod_tile-python-implementation
1
0
Fork 0
mirror of https://github.com/openstreetmap/mod_tile.git synced 2025-08-01 07:43:30 +00:00
Code Issues Packages Projects Releases Wiki Activity

Easier installation instructions

Browse Source
This commit is contained in:
Felix Delattre
2021-07-27 17:16:05 +00:00
parent a14924a999
commit f28cda9920
1 changed files with 36 additions and 27 deletions
Download Patch File Download Diff File Expand all files Collapse all files

63
README.rst
View File

@ -18,7 +18,8 @@ As an alternative to ``renderd`` its drop-in replacement
`Tirex <https://github.com/openstreetmap/tirex>`__ can be used in `Tirex <https://github.com/openstreetmap/tirex>`__ can be used in
combination with ``mod_tile``. combination with ``mod_tile``.
Requirements
Dependencies
------------ ------------
* `GNU/Linux` Operating System (works best on Debian or Ubuntu) * `GNU/Linux` Operating System (works best on Debian or Ubuntu)
@ -29,12 +30,33 @@ Requirements
* `Iniparser library <https://github.com/ndevilla/iniparser>`__ * `Iniparser library <https://github.com/ndevilla/iniparser>`__
* `GLib library <https://gitlab.gnome.org/GNOME/glib>`__ * `GLib library <https://gitlab.gnome.org/GNOME/glib>`__
Installation
------------
Starting from the following operation systems and their versions:
* Debian 11 (Bullseye)
* Ubuntu 21.04 (Hirsute Hippo)
the software and all dependencies can be installed simply with:
::
$ apt install libapache2-mod-tile renderd
These packages for **Debian** and **Ubuntu** are being maintained by
the `Debian GIS Team <https://wiki.debian.org/DebianGis>`__ in the respective
`repository <https://salsa.debian.org/debian-gis-team/libapache2-mod-tile>`__.
Compilation Compilation
----------- -----------
On Debian or Ubuntu systems the following packages are needed to start You may want to compile this software for developing on it or when using
compiling. On other systems the name of the libary might differ on operating systems this is not being packaged for. On Debian or Ubuntu
slightly. systems the following packages are needed to start compiling. On other systems
the name of the libary might differ slightly.
:: ::
@ -61,24 +83,9 @@ mod_tile and renderd:
$ sudo make install $ sudo make install
$ sudo make install-mod_tile $ sudo make install-mod_tile
Packages Be aware that you have to add configuration files that are adjusted to your
-------- environment before you can run it all.
If you don't want to compile the software yourself. Precompiled
software packages for **Debian** and **Ubuntu** are being maintained by
the `Debian GIS Team <https://wiki.debian.org/DebianGis>`__ in the respective
`repository <https://salsa.debian.org/debian-gis-team/libapache2-mod-tile>`__.
Starting from the following operation systems and their versions:
* Debian 11 (Bullseye)
* Ubuntu 21.04 (Hirsute Hippo)
the software can be installed simply with:
::
$ apt install libapache2-mod-tile renderd
Configuration Configuration
------------- -------------
@ -99,9 +106,9 @@ Copy the configuration files to their place:
:: ::
$ cp etc/renderd.conf.dist /etc/renderd.conf $ cp examples/config/renderd.conf.dist /etc/renderd.conf
$ cp etc/apache2/renderd.conf.dist /etc/apache2/conf-available/renderd.conf $ cp examples/config/apache2/renderd.conf.dist /etc/apache2/conf-available/renderd.conf
$ cp etc/apache2/renderd-example-map.conf.dist /etc/apache2/conf-available/renderd-example-map.conf $ cp examples/config/apache2/renderd-example-map.conf.dist /etc/apache2/conf-available/renderd-example-map.conf
Enable the configuration: Enable the configuration:
@ -140,8 +147,6 @@ mapnik style sheet and the uri you wish to use to access it. You may
configure up to 10 (by default) mapnik style sheets - simply give each configure up to 10 (by default) mapnik style sheets - simply give each
section a unique name and enter the uri and style sheet path. section a unique name and enter the uri and style sheet path.
The render daemon should have produce a message like: The render daemon should have produce a message like:
Got incoming connection, fd 7, number 1 Got incoming connection, fd 7, number 1
@ -167,6 +172,7 @@ For an OSM type setup, OSM map data imported into
Together with the Mapnik renderer along with the OSM.xml file and map Together with the Mapnik renderer along with the OSM.xml file and map
symbols, world_boundaries shapefiles. symbols, world_boundaries shapefiles.
Tile Rendering Tile Rendering
-------------- --------------
@ -188,6 +194,7 @@ queues are limited to a short 32 metatile size to minimize latency.
The size of the main background queue is determined The size of the main background queue is determined
at compile time, see: render_config.h at compile time, see: render_config.h
Tile serving Tile serving
------------ ------------
@ -231,6 +238,7 @@ Apache serves the files as if they were present
under "/[TileSetName]/Z/X/Y.png" with the path being under "/[TileSetName]/Z/X/Y.png" with the path being
converted automatically. converted automatically.
Performance Performance
----------- -----------
@ -243,10 +251,11 @@ however renderd tries to make sure it uses underlying hardware as efficiently
as possible and scales well on multi core systems. Renderd also provides as possible and scales well on multi core systems. Renderd also provides
built-in features to scale to multi server rendering set-ups. built-in features to scale to multi server rendering set-ups.
Copyright and copyleft Copyright and copyleft
---------------------- ----------------------
Copyright (c) 2007 - 2020 by mod_tile contributors (see `AUTHORS <./AUTHORS>`__) Copyright (c) 2007 - 2021 by mod_tile contributors (see `AUTHORS <./AUTHORS>`__)
This program is free software: you can redistribute it and/or modify it This program is free software: you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the under the terms of the GNU General Public License as published by the