Before starting, Unimus performs a startup health-check - called internally as Boot or Starter.
The Starter checks if all conditions required for properly running Unimus are met.
If not, it presents an error message describing the problem.
This article offers suggestions on solving the most common first-run issues:
Unimus logs to logging files located in these directories:
Linux - /var/log/unimus Windows - C:\ProgramData\Unimus\log |
These directories must be accessible to the user running Unimus.
Please fix the permissions and restart Unimus.
Unimus uses a configuration file located in:
Linux - /etc/unimus/unimus.properties Windows - C:\ProgramData\Unimus\unimus.properties |
The user running Unimus must have access to these directories, and must have a read-write access to the config file.
Please fix the permissions and restart Unimus.
Unimus must be able to communicate with the licensing server to successfully start.
Please ensure connectivity with https://licensing.unimus.net/.
You can check if licensing responds using:
curl 'https://licensing.unimus.net/status' && echo |
Or simply try to visit https://licensing.unimus.net/status in a web browser on your Unimus server.
If proxying is required for HTTP(S) connectivity in your environment, please see this article for help.
In some cases, you might see that Unimus doesn't properly show special / national characters (they are shown as a question mark).
This can be solved by properly setting the DB charset / collation:
After setting tables in the DB to this, any new special characters written to the DB should be displayed properly.
(this will not change data already existing in the DB)
When finishing the Deployment Wizard, you might see an error saying "Unable to upgrade database" when using a MySQL DB.
On some older versions of MySQL using the "utf8mb4" charset, the DB only support VARCHARs of max size 191.
Unimus requires multiple DB columns to be VARCHAR(255).
You can solve this by creating your database using the "utf8" charset:
CREATE DATABASE `dbname` DEFAULT CHARACTER SET utf8; or CREATE DATABASE dbname CHARACTER SET utf8; |
This issue is most usually caused by the scheduler itself running in the wrong timezone, but to the user, all jobs results / logs, etc. are shown as if in wrong timezone.
This is usually caused by a wrong timezone configuration in Linux.
cat /etc/timezone timedatectl |
Both outputs should show correct timezone.
If one (or both) are not correct, here is how to fix this:
(please substitute your actual TZ in the echo command)
systemctl stop unimus echo "Europe/Rome" | sudo tee /etc/timezone sudo dpkg-reconfigure --frontend noninteractive tzdata systemctl start unimus |
The above commands are for Ubuntu / Debian - please check for proper commands if using a different Linux distribution.