Rolling Back a JIRA Upgrade

The 'roll back' procedures on this page describe how to restore your previous version of JIRA in the unlikely event that you encounter an issue with your JIRA upgrade. Please follow the procedure below that relates to the upgrade procedure you used. Note that any data changed since the last backup will not be present after rolling back.

(info) If you upgraded JIRA using the Migrating JIRA to Another Server procedure, your previous JIRA installation should still be 'intact' (assuming you haven't deleted it) and there should not be a need to perform any 'roll back'.

Rolling Back a JIRA Upgrade Conducted Using the Upgrade Wizard

Use this procedure to roll back a JIRA upgrade conducted using the upgrade wizard.

(info) Prior to rolling back your JIRA upgrade, ensure that you have the following backups from your previous JIRA version:

  • The JIRA database (generated by your database's own backup tools).
  • The JIRA Home Directory.
  • The JIRA Installation Directory.

To roll back your JIRA upgrade conducted using the upgrade wizard:

  1. Stop the JIRA upgrade or the upgraded JIRA server if it is running.
  2. Use your database server's tools to restore the JIRA database backup you had created.
  3. Delete the contents of the JIRA Installation Directory.
  4. Restore the backed-up JIRA Installation Directory to the same location in the previous step.
  5. Delete the contents of the JIRA Home Directory.
  6. Restore the backed-up JIRA Home Directory to the same location in the previous step.
  7. Start JIRA (by running the start-jira.sh or start-jira.bat file in the bin subdirectory of your restored JIRA installation directory).
    (info) On Windows based systems if JIRA was installed as a service, restart the Atlassian JIRA service from the Control Panel. The JIRA service entry will be retained even if there is an error during upgrade in order to facilitate the rollback.

Rolling Back a JIRA Upgrade Conducted Manually

Use this procedure to roll back a JIRA upgrade conducted using the manual JIRA upgrade procedure (involving an 'in-place' database upgrade). The intended result of this procedure is to restore your previous JIRA installation to its original state (consisting of the restored database as well as the JIRA Installation and Home directories in their original locations).

(info) Prior to rolling back your JIRA upgrade, ensure that you have the following backups from your previous JIRA version:

  • The JIRA database (generated by your database's own backup tools).
  • The JIRA Home Directory.
  • The JIRA Installation Directory.

To roll back your JIRA upgrade conducted manually with an 'in-place' database upgrade:

  1. Stop the JIRA upgrade or the upgraded JIRA server if it is running.
  2. Use your database server's tools to restore the JIRA database backup you had created.
  3. If you had deleted the JIRA Installation Directory of your previous JIRA version, restore the backed-up JIRA Installation Directory to its original location.
  4. Delete the contents of the JIRA Home Directory.
  5. Restore the backed-up JIRA Home Directory to the same location in the previous step.
  6. Start JIRA (by running the start-jira.sh or start-jira.bat file in the bin subdirectory of your restored JIRA installation directory).
Last modified on May 21, 2013

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.