Restoration fails due to Structure plugin
Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server 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
Platform Notice: Server, Data Center, and Cloud By Request - This article was written for the Atlassian server and data center platforms but may also be useful for Atlassian Cloud customers. If completing instructions in this article would help you, please contact Atlassian Support and mention it.
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
Platform Notice: Cloud Only - This article only applies to Atlassian products on the cloud platform.
Problem
Restoration fails with the following error thrown in the logs
- The following appears in the atlassian-jira
.log
/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
- Structure - The Issue Organizer plugin (v2.11.x - v3.3.0) installed in JIRA
Cause
There's a known problem in Structure 3.3.0 that sometimes causes a NullPointerException during restore.
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)