Restoration fails due to Structure plugin

Platform Notice: Cloud and Data Center - This article applies equally to both cloud and data center platforms.

Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

Problem

Restoration fails with the following error thrown in the logs

  • The following appears in the atlassian-jira.log

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 /secure/admin/StructureRestore.jspa [structure.web.actions.StructureRestore] structure restore operation problem java.lang.NullPointerException: null value at com.google.common.base.Preconditions.checkNotNull(Preconditions.java:204) at com.google.common.collect.ImmutableMap.entryOf(ImmutableMap.java:139) at com.google.common.collect.ImmutableMap.of(ImmutableMap.java:85) at com.almworks.jira.structure.services.backup.BackupXMLReader2x.resolveIssue(BackupXMLReader2x.java:126) at com.almworks.jira.structure.services.backup.BackupXMLReader2x.access$400(BackupXMLReader2x.java:23) at com.almworks.jira.structure.services.backup.BackupXMLReader2x$1.endElement(BackupXMLReader2x.java:90) at com.almworks.jira.structure.services.backup.SectionReader.read(SectionReader.java:31) at com.almworks.jira.structure.services.backup.BackupXMLReader2x.readItemForest(BackupXMLReader2x.java:111) at com.almworks.jira.structure.services.backup.BackupXMLReader2x$2.element(BackupXMLReader2x.java:167) at com.almworks.jira.structure.services.backup.SectionReader.read(SectionReader.java:24) at com.almworks.jira.structure.services.backup.BackupXMLReader2x.readHistoryEntry(BackupXMLReader2x.java:220) at com.almworks.jira.structure.services.backup.BackupXMLReader$10.element(BackupXMLReader.java:668) at com.almworks.jira.structure.services.backup.SectionReader.read(SectionReader.java:24)

Diagnosis

Environment

Cause

There's a known problem in Structure 3.3.0 that sometimes causes a NullPointerException during restore.

Solution

Workaround

Install version 3.2.1 (appropriate for your JIRA – 3.2.1.jira6), then perform the restore / migration from Structure 2.11, then upgrade to Structure 3.3.0 (which will not involve doing the Restore)

Resolution

Upgrade to Structure - The Issue Organizer plugin (v3.3.1)

Updated on April 2, 2025

Still need help?

The Atlassian Community is here for you.