1. Upgrade Dependencies

A releases may require dependency upgrades (such as a new Java or Tomcat version). You'll need to manually apply those upgrades to your system before installing the new version of the application.

Warning

Because in-place upgrades are destructive, it is very important that you follow the steps in the "plan" phase for taking backups of your database and configuration before proceeding any further with the upgrade. Without a proper rollback strategy it will be incredibly difficult to revert any changes if the upgrade fails.

Bring down the app server

Before you start installing dependency upgrades, you need to stop your application server.

Note

This is where your downtime begins.

Using command line

1. SSH into the server

ssh <database-server-ip>

For example:

ssh app.openboxes.com

2. Stop Tomcat

sudo service tomcat stop

Upgrade All Dependencies

Make sure to check if there are version-specific instructions for the version that you're upgrading to. Those instructions will typically inform you of what dependencies need to be upgraded and how.