Introduction

To be able to install the 52°North SOS or 52°North STA the following software needs to be installed:

  • Java Runtime Enviroment (JRE) 8.0 or higher
  • Application server compatible to Java Servlet-API 2.5 or higher
  • Running database managment system

This tutorial shows you how to set up your Windows System to match the requirments. For this tutorial we use Apache Tomcat as the applicaition server and PostgreSQL/ PostGIS as the database managment system. If you want to use different software, have an other operating system or want to build the SOS from source you can find more information here: 52°North SOS 5.x Documentation

Installing Java

First you need to download and install a Java Runtime Enviroment (JRE) or Java Development Kit (JDK) with the version 8.0 or higher: Download

During the installation follow the instructions of the installer.

Installing Tomcat

After you installed Java you need to download and install an Apache Tomcat server version 8 or higher: Download

  • Do not use Tomcat version 8.0.8 because there is a known bug in these releases whereby the SOS installation fails
  • Do not use Tomcat version 10 because Tomcat has changed from javax to jakarta and the SOS installation does not yet work

During the installation follow the instructions of the installer.

After the installation Tomcat is added to the Windows autostart. You can deactived the autostart function of the application in the Taskmanager. If you want to start the application manually you can do this by navigating into the installation folder Apache Software Foundation/Tomcat 9.0/bin and executing Tomcat9w.exe. Mind that the names are different for other versions of Tomcat.

tomcatControl.PNG

This window will show up when Tomcat9w.exe is executed.

  1. Here you can start and stop the Tomcat server

If your Tomcat server is running you can check if it was succesfully set up by entering this URL in your internet browser except you choosed a different port for the installation: http://localhost:8080/

If the Tomcat server is running you should see this page:

tomcatStartpage.PNG

Installing PostgreSQL/ PostGIS

Now you need to download and install PostgreSQL version 9 or higher: Download

The installer includes the PostgreSQL server, pgAdmin which is a graphical tool for managing and developing your databases, and StackBuilder which is a package manager that can be used to download and install additional PostgreSQL tools and drivers. Follow the instructions of the installer.

In the next step you use the StackBuilder application to add the PostGIS extension to PostgreSQL.

stackBuilder.PNG

After that you need to create a new database which has the PostGIS template. You can use pgAdmin to create the database. With the command create extension postgis; you can add the PostGIS extension.

Now your Windows system is prepared to install the 52°North SOS or 52°North STA.