24th of January 2020

Structure 5.6.3 provides performance improvements for Jira 8+ and the Portfolio Extender.

Download from Archive 
Structure on the Atlassian Marketplace

1. Patch Release

This is a patch release based on Structure 5.6.2. It provides performance improvements for Jira 8+ and the Portfolio Extender.

Upgrade is recommended for all customers using Structure 5.6.x.

2. Installation

If your Jira server does not have Structure yet, the installation is simple:

  1. Download and install the Structure add-on, either from Atlassian Marketplace or from our Download page. Pick the correct version based on your Jira version!
  2. When the Add-on Manager reports a successful installation, click Get Started to visit a page with important guidance for the Jira administrator. You may also want to check out the user's Get Started page, available under the "Structure" top-level menu.
  3. Monitor catalina.out or jira-application.log for log messages from Structure.

3. Upgrade

If you're upgrading from version 2.11.2 or earlier, please read Structure 3.0.0 Release Notes.

The upgrade procedure for versions 3.x to 5.6 is simple:

  1. Consider backing up Jira data. Use Administration | System | Backup System. Starting from version 3.0.0, Structure data can be backed up together with Jira data. (If you have a large instance and have a proper backup strategy in place, you may skip this step.)

  2. Install the new version of the plugin.

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

4. Enterprise Deployment Notes

Structure 5.6.3 significantly increases Lucene index reading operation performance on Jira 8+. The new version of Lucene in Jira 8 introduced major changes to index data structures, which made its traditional read APIs significantly slower on large amounts of data. Structure 5.6.3 compensates for this, providing overall performance on Jira 8.x comparable with Jira 7.x, or even faster. We have also improved the performance of the Portfolio children extender, which now batches Lucene queries in some cases and should work faster on Jira 8+. We advise you to run Structure 5.6.3 tests on your slowest structures pre-update (for example, structures using the Child Issues (Portfolio) Extender) and compare the new times against your current Structure version.