Rolling back a JIRA application upgrade
You can roll back JIRA to its previous version if you encounter any issues with the upgrade. Any data changed since the last backup will not be present after rolling back.
Before you begin
Make sure you have the following backups from your previous version:
- The JIRA database (created with the database's native tools)
- The JIRA home directory
- The JIRA installation directory
Rolling back the upgrade
To roll back the upgrade, you simply need to restore the database from the backup and copy the installation and home directories to their original locations, like it was in your previous JIRA setup. Once you do it and restart JIRA, your old environment will be restored.
- Stop the upgrade or the upgraded JIRA instance.
- Use your database tools to restore the JIRA database from the backup.
- Restore the JIRA installation directory to its original location. In the case of a manual upgrade, the original installation directory should be intact.
- Restore the JIRA home directory to its original location.
Start JIRA by running the
start-jira.batfile in the
binsubdirectory of your restored JIRA application installation directory.Have you installed JIRA as a service on Windows?
If that's the case, you also need to restart the
Atlassian JIRAservice from the Control Panel. No need to create a new one, since the JIRA service entry is retained even if there's an error during the upgrade to facilitate the rollback.
Well done! You've rolled back JIRA to its previous version.