Home
This is the official website for the OpenHistoricalDataMap project.
In case you haven't - please read our README first to get a brief idea, what this website is about.
In this little Wiki you are going to get a step-by-step manual on how to deploy this project.
Disclaimer: The following guide is for installing and configuring a tomcat server on a debian, which is a Linux distribution. If you wish to use a different operating system, please search for the proper installation guide.
Install and configure Tomcat on Debian
1. Also see step 1 of the installation guide: before installing Tomcat, please assure that you have Java(openjdk 11) installed on your system
$ java -version
2. In step 2: please note, that hereby a user/group named tomcat is created
$ sudo groupadd tomcat
$ sudo useradd -s /bin/false -g tomcat -d /opt/tomcat tomcat
In step 4 you are adding permissions for that user(tomcat).
Ideally you should use your username for the debian server as your tomcat group and username to avoid trouble later on.
If you have a different user, repeat the 4th step.
Example:
You have a user and a group named "ohdm-user". Then you should do the following commands:
$ cd /opt/tomcat
$ sudo chgrp -R ohdm-user /opt/tomcat
$ sudo chmod -R g+r conf
$ sudo chmod g+x conf
$ sudo chown -R ohdm-user webapps/ work/ temp/ logs/
3. In step 7 you can/should add a user in the tomcat-users.xml file, who has access to the tomcat manager app, which you can see in the image below. By default the username is "admin" and the password "password". We recommend to change the username and password to something more secure.
In the manager app you can also deploy the WAR-file from the Beta-Release very easily in the section, which you can find in the following image.
4. If this case occurs that the port 8080 is already in use, you can modify it in the conf folder and in the server.xml-file.
If done correctly and once tomcat is successfully installed, the default tomcat website should appear in your browser.