Setup of Taginfo Test Server

The files in this directory are used to set up a Taginfo test server. You will need an Hetzner cloud account and the hcloud command line tool.

Setting up the server

Here are the steps needed to install the master server:

• Go to the Hetzner Cloud console and log in.
• Add a new project taginfo.
• Add one or more of your ssh public keys. Name one admin.
• Add a new API token to the project. Put the API token somewhere safe.
• Create a hcloud context on your own machine: hcloud context create taginfo. It will ask you for the token you have just created.
• Create a new cloud server. (You can use the --ssh-key option multiple times if you have several keys to add.) On your own machine run:

hcloud server create \
    --name taginfo \
    --location nbg1 \
    --type cx21 \
    --image debian-11 \
    --ssh-key admin

or

hcloud server create \
    --name taginfo \
    --location nbg1 \
    --type cx21 \
    --image ubuntu-22.04 \
    --ssh-key admin

(Depending an what you want to do, you might need a smaller or bigger virtual machine. For updating from a planet file you probably need a cx51 with 32 GB RAM. If you are just running the UI, a smaller machine is fine.)

• You should now be able to log into the server as root (hcloud server ssh taginfo).
• Copy the script init.sh to the new server and run it as root user:

IP=$(hcloud server ip taginfo)
echo $IP
scp init.sh root@$IP:/tmp/
ssh -t root@$IP /tmp/init.sh

• If his script runs through without errors, you are done with the update of the server and you can now log in as the robot user:

hcloud server ssh -u robot taginfo

Using

There are basically two different use cases for this test server:

• You want to test or work on the taginfo update mechanism
• You want to test or work on the taginfo user interface

Test or work on the update mechanism

• Run compile-tools.sh once to download and compile the C++ tools that a taginfo update needs.
• Run download-planet.sh to download the current planet PBF file into the right place or download some other OSM file.
• Check that the config file /srv/taginfo/taginfo-config.json is correct.
• Run run-update.sh to do an update cycle at least once. For all stats to be updated correctly you have to run it twice.

Test or work on the user interface

• Run download-databases.sh to download all databases from the main OSMF server to get you set up quickly.