Preparing for an upgrade

1. Review the release notes and upgrade guide

Check the release notes for anything you think would impact your users.

Tip: Use the Component column in the release notes to easily identify which parts of the application will have most impact on your work processes, so that you can focus quick checks in the features your users frequently use.

Hotfix releases almost never contain breaking changes.

The table below lists R4J versions that require preparation. Versions not listed here are safe to upgrade or downgrade as needed.

R4J version

Upgrade guide

Supporting articles / Important notes

2. Test the R4J version upgrade using a test or staging instance

Based on your reviews done, do a quick check how the plugin works on your test and/or staging instance.

We strongly recommend to have a test or staging instance setup, which is as similar as possible to your production instance. This includes server and database configuration and properties, user/admin permissions, as well as a copy of the production data.

3. Plan tasks for the upgrade outside of business hours

Third-party plugins may have some effect to other plugins or Jira itself. For any upgrade, it’s safest to always plan outside of business hours in case anything goes wrong.

4. Backup your instance data

You should have an up-to-date backup to allow you to roll back the database in the very unlikely event that some sort of data corruption results from the upgrade.

5. Perform the R4J version upgrade in your production instance

It is important to do a quick test of the upgrade on your production instance. Based on the results, finalize your decision to remain with the version or roll back to a backward compatible version.