Structure Plugin for JIRA - Version 2.11

Index

Page tree

This documentation relates to an older version 2.11 of the Structure Plugin for JIRA. View the current documentation home.

Skip to end of metadata
Go to start of metadata

Upgrading

General upgrade procedure is simple:

  1. Create backup of Structure data. Use Administration | Structure | Backup Structure. See Backing Up Structure for details.

  2. Install the new version of the plugin.

  3. Monitor catalina.out or jira-application.log for warnings or errors.

For more specific instructions, please check the Release Notes for the version to which you wish to upgrade. 

Downgrading

Reverting the plugin to an older version is not always possible because newer versions can modify the database so it becomes incompatible with older versions. If you need to revert to an older version, the most reliable way is as follows:

  1. Choose a structure backup file that was made before upgrading to a newer version.
  2. If possible, create backup of your current Structure data in the new version. Use Administration | Structure | Backup Structure. See Backing Up Structure for details.
  3. Uninstall the plugin via the Universal Plugin Manager.
  4. If Structure backup on step 2 was not possible, create a backup copy of the structure folder in your JIRA home directory.
  5. Remove the structure folder from your JIRA home directory. (You can move it away to a backup location.)
  6. Install the older version of the plugin.
  7. If no significant changes were made while the new version was running, restore from the previously chosen backup file. See Restoring Structure from Backup for details. 
  8. If you'd like to keep changes that were made during the time that the new version was running, and you have the backup file from step 2:
    1. Try restoring from the backup taken at step 2.
    2. If that fails, try restore from the older backup, and then try using Administration | Structure | Migrate Structure to additionally restore the structures that were changed since the old backup was made.