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

Skip to end of metadata
Go to start of metadata

Structure data is backed up and restored separately from other JIRA data. Structure data includes structures, hierarchies, synchronizers - everything added to JIRA by the Structure plugin. Structure backup does not include issue data (except for some issue attributes that are added just in case).

Structure is backed up separately due to technical limitations of the supported versions of JIRA platform. In the future we plan to merge Structure backup with the main JIRA backup.

You need the JIRA System Administrators global permission to back up and restore Structure data.

Proper Backup and Restore Sequence

To back up your JIRA with structure:

  1. Perform the standard JIRA backup.
  2. Back up Structure.

Of course you can back up structure separately if all you need to copy is the hierarchies and structure configuration. 

To restore your JIRA with structure:

  1. Restore JIRA data first.
  2. Restore structure from backup.

Structure backup files refer to issues by their IDs, so JIRA needs to have those issues restored before structure restore is commenced.

File-Based Backup

You can also back up and restore the whole structure directory in the JIRA home (see Structure Files Location) manually - but only when JIRA is not running or when Structure plugin is disabled. When restoring structure data backed up this way, make sure you're using the same version of the Structure Plugin that was there when the backup was created.

Detailed Instructions: