13.1.1 Symptom ¶

systemctl status ownsona.service shows the service failed, or the servlet refuses to load.

13.1.2 Look in ¶

journalctl -u ownsona.service -e
journalctl -u ownsona.service | grep -i exception

13.1.3 Common causes ¶

Missing required application.ini key

The static initializer fails fast on Required application.ini key X is not set. Fix the ini in the source tree, rebuild, redeploy.

Database unreachable

Connection refused or authentication failed during pool init. Verify with psql -U ownsona -d ownsona from the same host.

Auto-migrator can’t CREATE TABLE

migrator bootstrap failed: permission denied for schema public. The ownsona role lacks CREATE ON SCHEMA public. Run sql/migrator_prep.sql as the postgres superuser (see Upgrading an existing install).

Auto-migrator refuses to start

Database is at version N but code expects M --- refusing. The DB is newer than the code (rollback scenario, or someone deployed an older WAR). Either upgrade the code or restore the DB from a snapshot at version M.