Structure 6.3.2 Release Notes

18^th of November, 2020

Structure 6.3.2 is a patch release for 6.3. It adds Jira Cloud Migration Assistant support and fixes a problem with custom fields.

Download the latest version of Structure and its Extensions

Try It: Structure Sandbox Server (no installation required)

Patch Release

Structure 6.3.2 is a patch release for Structure 6.3. It provides:

Migration assistance to migrate structures from Server/Data Center to Jira Cloud
Fix to an issue that prevented Structure from reading the values of some custom fields

Upgrade from Structure 6.3 is highly recommended.

Changes in Detail

Migration Assistance

It is now possible to add Structure data to a migration when using the Jira Cloud Migration Assistant (JCMA).

Structure Migration Configurations allow you to associate specific structures with JCMA migrations. When you run JCMA, those structures will be recreated in Structure Cloud, based on:

Manually added issues and folders
Items added and organized through Generators
The default view and associated views for each structure

Please note the following restrictions:

Structure can only add issues from projects that have been migrated to cloud using the JCMA.
At this time, some features are not available in Structure Cloud, including:
- Certain types of Automation, including Effectors
- Memos – any existing memos will be converted to folders in Structure Cloud
For more information see: Comparison to Structure for Jira Server, Data Center and Service Management.

The Structure Cloud portion of the migration tool is still under development, and will be released shortly. At this time, it is only possible to prepare migration sets. As soon as the Structure Cloud update is released, any sets you’ve created can then be used to migrate to Structure Cloud.

Documentation: Migrate to Cloud

Additional Updates

Fixed: Structure was unable to read the values of some custom fields. See 2023-05-31_14-14-10_.Structure 6.3.2 Release Notes v8.3#Enterprise Deployment Notes.

Supported Versions

Structure 6.3 and all extensions support Jira versions 7.13 or later. This release is for customers using Jira Server or Data Center (Jira Core, Jira Software, or Jira Service Management/Service Desk).

Compatible plugins versions:

Cloud customers can learn more about our products on the “Cloud” tab of our marketplace listing.

Installation and Upgrade

Pick a Time

We strongly recommend that you install and upgrade your apps during off-peak hours or scheduled maintenance windows. There are known issues in the Jira plugin infrastructure that may cause performance degradation and impede app installation when your Jira instance is under heavy load.

Installing Structure

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

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

Upgrading Structure

The upgrade procedure from versions 3.0–6.3.1 is simple:

Consider backing up Jira data. Use Administration | System | Backup System. (If you have a large instance and a proper backup strategy in place, you may skip this step.)
Back up Structure data. Use Administration | Structure | Backup Structure menu item. If you have a lot of structures and a large Jira, consider turning off the "Backup History" option to avoid a long backup process.
Install the new version of the plugin.
Monitor catalina.out or jira-application.log for warnings or errors.

Upgrading from Structure 2.9–2.11

If you have a Structure version older than 2.9, please upgrade to Structure 2.11.2 version first.

Starting with version 6.0, Structure is no longer able to access the old Structure 2.x database, but old backup files are still supported. Therefore, you'll need to back up your Structure 2.x data before upgrading. The recommended upgrade procedure is as follows:

While still running the old version of Structure, go to Administration | Structure | Structure Backup and create a backup of the current Structure data.
Download and install Structure 6.0, either from the Atlassian Marketplace or our Download page.
When the Add-on Manager reports the successful installation, click Get Started to visit a page with important guidance for the Jira administrator. You may want to also check out the Getting Started with Structure.
To transfer your data, go to Administration | Structure | Restore Structure and use the Structure 2.x backup made earlier.
Monitor catalina.out or jira-application.log for log messages from Structure.

Enterprise Deployment Notes

Structure 6.3 introduced an optimization in the attribute system, which used the Lucene index to quickly read the values of numeric, date, and date-time custom fields. We have since seen a few support cases where the optimized code didn't work as expected, which resulted in Structure being unable to read the values of certain custom fields. We are working on resolving the problem, but in the meantime Structure 6.3.2 disables this optimization by default, and reads all custom field values from the database. If needed, the optimization can be enabled by setting a dark features.

Otherwise, there are no particular special areas of interest for load testing and stress testing Structure 6.3.2. We advise running the same testing procedures as you've done for previous upgrades.

Need help or have questions? Contact Tempo Support.