Structure for Jira - Version 5.5
 

Index

Page tree

You are viewing documentation for Structure Server and Data Center version 5.5 and patch releases. For other versions, see Version Index or [Structure Cloud].

Skip to end of metadata
Go to start of metadata

Restoring structure from backup brings back the structures, synchronizers, views and other data created at the moment of backup.

Restoring structure will not affect issues in any way or restore them. The issues that make up the hierarchy should already exist in JIRA. If you do full restore, then you need to run the standard JIRA data restore first - see Structure Backup, Restore and Migration. 

The issues and other items in the structures are identified by their internal numeric ID. If you have transferred issues via JIRA's Project Import, issue IDs have changed and so you need to use Structure Migration.

Use Restore Structure when:

  • the backup was made on this JIRA instance or on its predecessor,
  • and, you need to fully restore structure data,
  • and, you can lose the current structure data stored on this JIRA instance (issues are not affected, only their organization into structures).

To restore the structure from backup:

  1. Navigate to Administration | Structure | Restore Structure.
  2. Enter the full path to the structure backup file (either .xml or .zip).
  3. Click Restore.
  4. If Structure currently has any data, it will ask you to confirm the restore operation. Restoring from backup clears all Structure data, and it cannot be undone! If you have data that you're overwriting, you might want to perform Backup first.

  5. You will see the Process Status page that will show you the progress of the restore operation. You can abort the process by clicking the Abort button on the status page.

    If you abort the restore operation, Structure data will be left in a partially restored state. You may see some of your structures, but not all of them, and auxiliary data like synchronizers, views, favorites and perspectives may be completely lost. You can revert to the original state only by fully restoring Structure from another backup.

  6. Once the process is finished, the Show Result button will take you to the result page, where you'll be able to see the result and possibly some warning messages.

After the structure has been restored, open Structure | Manage Structure page to see if the structures are there.

You also can restore structure data from backup files made with the earlier versions of the Structure plugin, including Structure 2. 

Downgrading from Structure 5.0 or Later

The introduction of Manual Adjustments in Structure 5.0 required changes to our backup file format, which makes previous versions of Structure unable to restore data from backup files created by Structure 5.0 and later.

To downgrade to an earlier version, you first need to restore Structure data from a 5.0 backup file:

  1. Unpack the XML backup file from the ZIP archive created by Structure.
  2. Change the version attribute in the <structure-backup> element from "5.0" to "3.3".
  3. Delete all <manualAdjustments> elements from the XML.

Once completed, you can restore directly from the modified XML file using the procedure above. You do not have to pack it into a ZIP archive.