Skip to main content
Skip table of contents

Migrating Data from Structure 2 to Structure 3

Unlike previous versions, Structure 3.0 uses the main Jira database to store its data. You need to migrate the data from Structure 2 in order to continue working with it in Structure 3. Additionally, this feature can be used to restore structures from a backup made with Structure 2.

Structure 2 had a separate Backup / Restore functionality, because Structure data was kept separately. With Structure 3, all data is backed up with the usual Jira backup.

However, we plan to reinstate Backup / Restore / Migrate feature in future versions of Structure 3.

Creating a Backup of Structure 2.x Data

  • If you still have Structure 2.x installed, create a backup of the current Structure data. You can either use Administration | Structure | Structure Backup menu or do a cold backup by copying the entire structure/ sub-directory under Jira home while Structure is disabled. See Backing Up Structure for details.
  • If you already have Structure 3.x installed, use the Administration | Structure | Export Structure 2.x Data page. It allows you to create a backup zip with all Structure 2.x data and then opens the Restore Structure page, allowing you to immediately import the backup into the Structure 3.x database.

Restoring Structure Data from 2.x Backup

  1. Use the Administration | Structure | Restore Structure menu and use any Structure 2.x backup made earlier. Note that it should be placed in the import/ directory on your server.
  2. If you used the "Export Structure 2.x Data" menu, you will be taken to the restore automatically.

After Data Migration

Upgrade Testy

If you have Structure.Testy installed, download and install the latest version of Structure.Testy, compatible with Structure.

Upgrading "Global Structure"

If you're using a "Global Structure" structure, which was created by default in Structure 2.x, you need to make sure that there's an "owner" of that structure. Otherwise, Generators will not work there.

  1. Open Structure | Manage Structure.
  2. Find Global Structure and check if it has an Owner assigned.
  3. If it doesn't have an owner, click Configure and set yourself as the owner.
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.