Introduction

This article assumes that you already have Java (JRE) installed on your machine. For instructions on installing Java, please see other "Installing on ..." articles.
Please note Unimus requires Java 8 or 11 for Unimus version 2.5.0 or older. Earlier versions of Java are not supported. Java 17 is supported starting from version 2.5.1. 

We support any Java Application Server, not just Tomcat. This guide uses Tomcat, but a similar deployment procedure can be used for other application server as well.

Tomcat Compatibility list

Installing Tomcat

You can install Tomcat directly from:
https://tomcat.apache.org/download-90.cgi

Many Linux distributions contain Tomcat in their package repositories.
You can also install Tomcat from there.

Allowing access to required directories

Unimus creates /etc/unimus (C:\ProgramData\Unimus on Windows) directory to keep its configuration file in.
Please make sure that the user your Tomcat runs under has access to this directory.
You can create this directory manually and assign rights to your Tomcat user.

In the below code, substitute [tomcat:tomcat] for the user under which your Tomcat runs.

mkdir /etc/unimus
chown tomcat:tomcat /etc/unimus
mkdir /var/log/unimus
chown tomcat:tomcat /var/log/unimus

Deploying Unimus .war

After installing Tomcat (or your chosen application server), simply deploy the .war distribution of Unimus and navigate to the appropriate URL.
In Tomcat, you can deploy using the Manager app, or manually copy the .war into the "webapps" directory.
After deployment, you should also see in your Tomcat logs that Unimus started as is running.

Tomcat Manager .war size limit

If you are using the Tomcat Manager app, there is an additional step that needs to be performed.
By default, the Manager app has a limitation of 50MB .war files. You can change this in ".../webapps/manager/web.xml"

Change this section:

<multipart-config>
  <!-- 50MB max -->
  <max-file-size>52428800</max-file-size>
  <max-request-size>52428800</max-request-size>
  <file-size-threshold>0</file-size-threshold>
</multipart-config>