Rolling back a JIRA application upgrade

The 'roll back' procedures on this page describe how to restore your previous JIRA application version in the unlikely event that you encounter an issue with your application 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 applications using the Migrating JIRA applications to another server procedure, your previous JIRA application 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 application upgrade conducted using the upgrade wizard

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

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

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

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

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

Rolling back a JIRA application upgrade conducted manually

Use this procedure to roll back a JIRA application 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 application Installation and Home directories in their original locations).

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

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

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

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

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport