Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Install Java

Before running Core, you will need to install Java.
Unimus Core is written in Java, and requires a JRE (Java Runtime Environment) to run.

How to install Java depends on your particular OS / distro.
However, please make sure you install Java 8 or 11 (as mentioned above, JRE is sufficient, Unimus does not need the JDK).

...

Download Unimus Core

Unimus Core is available in 2 as a platform-independent versions: .jar

...

distribution.

...

Download link:
https://unimus.net/download.html

The .jar

...

This binary is a standard Java application package.
You can run it on any OS / distro / architecture that support Java.

This could be considered a portable (standalone) deployment - you simply run Unimus and it will work.
There is nothing to install, Unimus will not install itself as a service, it will only run when you launch it yourself.

Running Unimus Core using the .

...

This packaging is used for deployments into Java application servers.
We currently support Tomcat and Jetty out of the box, but Unimus should run on any application server.

Since your application server will run as a service, this is the supported way to deploy Unimus as a service in Linux/Unix.

3a) Running Unimus using the .jar

...

jar

You can r

Before running the Core, you will need to create the config file manually.

Please create the file in: /etc/unimus-core/unimus-core.properties

Code Block
languagetext
unimus.address=some.server.address
unimus.port=5509
unimus.access.key=really_long_access_key_from_the_zone_of_this_core

After the config file is in place, you can run the .jar file directly. Open a terminal, and run:
java -jar unimus.jar

You should see Unimus the Core outputting its startup sequence into the terminal (stdout).

3b) Deploying Unimus using the .war

The deployment process of the .war into your application server will depend on which Java application server you use.

We have a guide to Tomcat deployment available here.

4) Start using Unimus

Unimus should now be running, you can access it using your browser.

(substitute 'localhost' for the address of your Unimus server)

If this is the first time you run Unimus, we recommend checking out the initial configuration guide hereThe Core should start, and you should see your Core online in Unimus.