Skip to content

Deploy Application

Stop Tomcat service

We recommend stopping the Tomcat service to allow you to have full control over the deployment process and to avoid partial downloads causing deployment issues.

sudo service tomcat stop

Download the latest stable release

Download the latest nightly build into the Tomcat webapps directory.

Note

As of January 2025, OpenBoxes 0.9.x is only available through our Bamboo CI/CD pipeline. This is a stable release of version 0.9.3 that has been thoroughly tested and deployed to production environments. However, we would like to publish a draft version of our Upgrade Guide before making the official release available to the public via GitHub Releases.

sudo wget --directory-prefix=/opt/tomcat/webapps \
    https://bamboo-ci.pih-emr.org/browse/OPENBOXES-OBNR/latestSuccessful/artifact/G3JOB/Latest-WAR/openboxes.war

Important

Once we have officially released OpenBoxes 0.9.x to the community, the latest official release will be available from our GitHub Release page along with Release Notes.

Change ownership

chown -R tomcat:tomcat /opt/tomcat

Start Tomcat instance

sudo service tomcat start

Monitor Tomcat logs

The deployment should take a few minutes (5-10 minutes at most). The majority of that time will be spent executing Liquibase database migrations (DDL statements) that create and update the OpenBoxes data model.

We highly recommend that you monitor the Tomcat stdout logs during deployment in order to catch any unexpected errors. You should keep an eye out for any exception stacktraces that occur in the logs, but be aware that some exceptions are normal. Check the Troubleshooting section for details on how to handle these issues.

To tail the log

journalctl -u tomcat.service -f
Or
sudo tail -f /opt/tomcat/logs/catalina.out

Note

If you run into an error that's not covered in the Troubleshooting Guide don't hesitate to contact support.

If you post to our community forum or GitHub issues, please describe the problem in as much detail as you can and include the catalina.out log from your Tomcat instance.