Setup Guide

DISCLAIMER : This Guide is build to show how to set-up the Service on an Debian based Linux-Distribution. It has to be Linux, since some tools used by the service are currently not available for Windows. (Once there is a way, I'll update this Guide. ^^)

Before Setup:

• make sure you have openjdk-11 installed (of course, later versions work fine too, but it's at least this)
• make sure you have curl installed ( if not, it's easily available over the Advanced Packaging Tool (or short "apt"), just type sudo apt install curl )
• (please make sure before, that your chosen Port is not already in use or not open!!, more on that later)

Steps to set up the Service:

1. Download all the necessary files for the Server from here: https://github.com/OpenHistoricalDataMap/DownloadWebService/releases/tag/v1.0-beta
2. Put all the given Files in one location of your choosing ( this is where the service will dump all it's Data for now )
3. run the bash script osm2map.sh for the installation of "osmosis" and the "mapwriter plugin" (since this script installs packages on your system, you need to run it with the prefix "sudo") ( if you want to know more about that : https://wiki.openstreetmap.org/wiki/Osmosis) This will assure us that the service will use the right Tool.
4. configure the init.txt to your liking ( more on that on the wiki page : init.txt conf)
5. now run the runner-*.jar - the files and directories needed will be created and the service should run now ( the name should look something like this : "runner-0.9-SNAPSHOT.jar" )

(to run this Service as an Deamon, go on the "run as Deamon" Wiki page : https://github.com/OpenHistoricalDataMap/DowloadWebService/wiki/run-as-Daemon)

If the bash script, for any reason, can't be run, go to here

if any problems occur, please contact me over my student mail :

• Tino.Geissler@student.htw-berlin.de

thank you and have fun ^^