Upgrading Broker

This page describes how to upgrade the Broker application, the Tomcat application server, and the PostgreSQL database. It is recommended to take a backup before performing any upgrade.

Upgrading Tomcat and PostgreSQL is independent from upgrading OSLC Connect for Jira Cloud and is not required when deploying a new version of the Broker. Administrators should upgrade these components as needed, based on vulnerabilities or bugs reported for those tools.

Upgrading the WAR Deployment

Before upgrading, check the Upgrading Actions page for any additional actions required for your target version.

To deploy a new version of the broker WAR file:

  1. Stop Tomcat.
  2. Delete the old WAR file, its expanded directory, and the Tomcat work cache:
  3. Copy the new WAR file to $CATALINA_BASE/webapps/.
  4. Check the release notes for any configuration changes required in oslc-connect-jira.xml. Update the file if needed.
  5. Start Tomcat. The new WAR will be automatically extracted and deployed.
  6. Check the application logs to confirm that the broker started successfully.

Upgrading Tomcat

Tomcat provides documentation for upgrading version. Follow Deploying a WAR procedure to finish the upgrade.

Upgrading PostgreSQL

PostgreSQL provides documentation to upgrade a PostgreSQL database.