Troubleshooting

Sometimes the tile server may not respond as expected. If you are experiencing issues with the tile server, follow these steps to troubleshoot.

In the event that http://localhost:80/sample_leaflet times out, or fails to respond, perform the following checks.

Confirm that the web server is running

service apache2 status

You should see a response similar to the following:

● apache2.service - The Apache HTTP Server
    Loaded: loaded (/usr/lib/systemd/system/apache2.service; enabled; preset: enabled)
    Active: active (running) since Wed 2024-12-11 10:43:14 AWST; 23min ago
    Docs: https://httpd.apache.org/docs/2.4/
    Process: 152 ExecStart=/usr/sbin/apachectl start (code=exited, status=0/SUCCESS)
Main PID: 233 (apache2)
    Tasks: 55 (limit: 38320)
    Memory: 31.4M ()
    CGroup: /system.slice/apache2.service
            ├─233 /usr/sbin/apache2 -k start
            ├─235 /usr/sbin/apache2 -k start
            └─237 /usr/sbin/apache2 -k start

If the web server is not running correctly then restart it

sudo service apache2 restart

If tiles are not being rendered check the status of the renderd daemon

service renderd status

You should see a response similar to the following:

● renderd.service - Daemon that renders map tiles using mapnik
    Loaded: loaded (/usr/lib/systemd/system/renderd.service; enabled; preset: enabled)
    Active: active (running) since Wed 2024-12-11 10:43:14 AWST; 31min ago
    Docs: man:renderd
Main PID: 166 (renderd)
    Tasks: 6 (limit: 38320)
    Memory: 1.6G ()
    CGroup: /system.slice/renderd.service
            └─166 /usr/bin/renderd -f

If the renderd daemon is not running correctly then restart it, followed by restarting apache2

sudo service renderd restart

sudo service apache2 restart