Upgrading Jira with an installer

For both Windows and Linux, Atlassian provides an installer package that can guide you through the upgrade process. The installer will detect your current Jira installation and perform all the necessary tasks to upgrade it to the target version.

In this recipe, we will show you how to upgrade your Jira instance with the standard Jira installer.

Getting ready

As the Jira installer is only available for standalone installations on Windows and Linux, we will run you through the installer on Windows in this recipe:

• Check the upgrade notes for any special instructions as well as the target Jira version to make sure you can perform a direct upgrade.
• Make sure you have a valid Jira license.
• Verify whether your current host environment is compatible with the target Jira version. This includes the Java version, database, and OS.
• Verify whether your operating environment is compatible with the target's Jira version, specifically, the browser requirements.
• Make sure that the add-ons you are using are compatible with the new version of Jira.
• Download the installer binary for your target Jira version.

You can use the Universal Plugin Manager's Jira update check utility to check for add-on compatibility.

How to do it...

Upgrade your Jira system with the installer using the following steps:

1. Take your current Jira offline, for example, by running the stop-jira.bat script.
2. Back up the Jira database with its native backup utility.
3. Launch the installer and select the Upgrade an existing JIRA installation option.
4. Now, select the directory where the current Jira is installed:

5. Check the backup JIRA home directory option and click on the Next button.

If your JIRA_HOME directory is big, you might want to manually back it up or remove some of the cache and tmp folders as it would take a long time for the installer to back these up.

6. Review the Upgrade checklist and click on the Upgrade button:

7. Wait for the installer to complete the upgrade process. Once the upgrade is complete, the installer will automatically launch Jira.
8. Update any add-ons once Jira starts successfully.

The installer will detect and provide you with a list of customized files in the JIRA_INSTALL directory, which you will need to copy manually after the upgrade.

See also

If you cannot use the installer to upgrade Jira, refer to the Upgrading Jira manually recipe.