Skip to content

Commit

Permalink
Added Debian 12 page. (switch2osm#228)
Browse files Browse the repository at this point in the history
I've also tidied the menu and the "serving tiles" index so that only
Debian 12, Ubuntu 22.04, Docker and Debian 11 remain on it.

I've changed the Debian 11 page to reflect that it has been
released for ome time now.

I've fixed some minor typos elsewhere, including in pages no longer
on the menu.

The changes for Debian 12 include:

* Changes for new versions of e.g. postgres.

* A workaround for the removal of a vanilla "etc/apache2/renderd.conf".
See openstreetmap/mod_tile#326

* Changes necessary to reflect other mod_tiles changes, including
debugging turned off by default.

* Changes necessary to reflect Debian changes, such as no
standard "/var/log/syslog".

Co-authored-by: Andy Townsend <[email protected]>
  • Loading branch information
2 people authored and Andygol committed Nov 6, 2023
1 parent 8974937 commit cd40eaa
Show file tree
Hide file tree
Showing 5 changed files with 301 additions and 10 deletions.
5 changes: 2 additions & 3 deletions _layouts/docs.html
Original file line number Diff line number Diff line change
Expand Up @@ -14,11 +14,10 @@ <h3>{{ page.title }}</h3>
</ul>
<br>
<ul><a href="{{ site.url }}/serving-tiles/"><b>Serving Tiles</b></a>
<li><a href="{{ site.url }}/serving-tiles/manually-building-a-tile-server-debian-11/">Manually building a tile server (Debian 11)</a></li>
<li><a href="{{ site.url }}/serving-tiles/manually-building-a-tile-server-debian-12/">Manually building a tile server (Debian 12)</a></li>
<li><a href="{{ site.url }}/serving-tiles/manually-building-a-tile-server-ubuntu-22-04-lts/">Manually building a tile server (Ubuntu 22.04 LTS)</a></li>
<li><a href="{{ site.url }}/serving-tiles/manually-building-a-tile-server-20-04-lts/">Manually building a tile server (Ubuntu 20.04 LTS)</a></li>
<li><a href="{{ site.url }}/serving-tiles/using-a-docker-container/">Using a Docker container</a></li>
<li><a href="{{ site.url }}/serving-tiles/manually-building-a-tile-server-18-04-lts/">Manually building a tile server (Ubuntu 18.04 LTS)</a></li>
<li><a href="{{ site.url }}/serving-tiles/manually-building-a-tile-server-debian-11/">Manually building a tile server (Debian 11)</a></li>
<br>
<li><a href="{{ site.url }}/serving-tiles/monitoring-using-munin/">Monitoring using Munin</a></li>
<br>
Expand Down
4 changes: 2 additions & 2 deletions serving-tiles/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,11 +12,11 @@ Tiles from a third-party provider are the simplest way to make the switch to Ope

Both generating and serving tiles incur significant hardware requirements, especially if you need global coverage and regular updates.

If you are setting up your own tile server, we recommend that you use [Ubuntu Linux](https://ubuntu.com/) or [Debian 11](https://www.debian.org/releases/testing/).
If you are setting up your own tile server, we recommend that you use [Ubuntu Linux](https://ubuntu.com/) or [Debian](https://www.debian.org/releases/).

# The options

1. Install locally on [Debian 11](manually-building-a-tile-server-debian-11), [Ubuntu 22.04](manually-building-a-tile-server-ubuntu-22-04-lts/), [Ubuntu 20.04](manually-building-a-tile-server-20-04-lts/) or [Ubuntu 18.04](manually-building-a-tile-server-18-04-lts/).
1. Install locally on [Debian 12](manually-building-a-tile-server-debian-12), [Ubuntu 22.04](manually-building-a-tile-server-ubuntu-22-04-lts/), or [Debian 11](manually-building-a-tile-server-debian-11).

2. Use [docker](using-a-docker-container/).

Expand Down
8 changes: 4 additions & 4 deletions serving-tiles/manually-building-a-tile-server-debian-11.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ title: Manually building a tile server (Debian 11)
permalink: /serving-tiles/manually-building-a-tile-server-debian-11/
---

This page describes how to install, setup and configure all the necessary software to operate your own tile server. These step-by-step instructions were written for [Debian Linux](https://www.debian.org/) 11 testing (bullseye), and were tested in November 2020.
This page describes how to install, setup and configure all the necessary software to operate your own tile server. These step-by-step instructions were written for [Debian Linux](https://www.debian.org/) 11 (bullseye), and were tested in November 2020.

# Software installation

Expand All @@ -14,7 +14,7 @@ It consists of 5 main components: mod_tile, renderd, mapnik, osm2pgsql and a pos

Thanks to the work done by the Debian maintainers to incorporate the latest versions of these packages into Debian 11, these instructions are somewhat shorter than previous versions.

These instructions are have been written and tested against a newly-installed Debian 11 Testing server. Debian 11 hasn't been released yet, so of course things may change. If you have got other versions of some software already installed (perhaps you upgraded from an earlier version, or you set up some PPAs to load from) then you may need to make some adjustments.
These instructions are have been written and tested against a newly-installed Debian 11 server. If you have got other versions of some software already installed (perhaps you upgraded from an earlier version, or you set up some PPAs to load from) then you may need to make some adjustments.

In order to build these components, a variety of dependencies need to be installed first. Debian doesn't come with "sudo" by default, so we'll need to log on as root to do the first part:

Expand Down Expand Up @@ -237,15 +237,15 @@ In syslog you should see a message like:

Nov 14 14:24:55 servername apachectl[19119]: [Sat Nov 14 14:24:55.526717 2020] [tile:notice] [pid 19119:tid 140525098995008] Loading tile config s2o at /hot/ for zooms 0 - 20 from tile directory /var/lib/mod_tile with extension .png and mime type image/png

Next, point a web browser at "http://yourserveripaddress/index.html" (change yourserveripaddress to your actual server address). You should see "Debian Logo Apache2 Debian Default Page".
Next, point a web browser at "http://yourserveripaddress/index.html" (change yourserveripaddress to your actual server address). You should see "Apache2 Debian Default Page".

If you don't know what IP address it will have been assigned you can likely use "ifconfig" to find out - if the network configuration is not too complicated it'll probably be the "inet addr" that is not "127.0.0.1"). If you're using a server at a hosting provider then it's likely that your server's internal address will be different to the external address that has been allocated to you, but that external IP address will have already been sent to you and it'll probably be the one that you're accessing the server on currently.

Note that this is just the "http" (port 80) site - you'll need to do a little bit more Apache configuration if you want to enable https, but that's out of the scope of these instructions. However, if you use "Let's Encrypt" to issue certificates then the process of setting that up can also configure the Apache HTTPS site as well.

Next, point a web browser at: http://yourserveripaddress/hot/0/0/0.png

You'll need to edit that of course if you changed "URI=/hot/" above. You should see a small map of the world. If you don't, ivestigate the errors that it displays. These will most likely be permissions errors or perhaps related to accidentally missing some steps from the instructions above. If you don't get a tile and get other errors again save the full output in a pastebin and ask a question about the problem somewhere like help.openstreetmap.org.
You'll need to edit that of course if you changed "URI=/hot/" above. You should see a small map of the world. If you don't, investigate the errors that it displays. These will most likely be permissions errors or perhaps related to accidentally missing some steps from the instructions above. If you don't get a tile and get other errors again save the full output in a pastebin and ask a question about the problem somewhere like help.openstreetmap.org.

# Viewing tiles

Expand Down
Loading

0 comments on commit cd40eaa

Please sign in to comment.