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
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.
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)
Was this helpful?