Attachment not imported during backup restoration in Jira Data Center

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. 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

After performing full backup restoration, none of the attachments are shown in issue pages even after verifying that the attachments are restored to right directory before the restoration started.

Diagnosis

Diagnostic Steps

  • Verify that Restore System option is used to restore XML backup.

  • Verify that the attachment from source instance is restored to <JIRA_HOME>/data/attachment directory before backup is imported.

  • Extract the XML backup and run the following grep command to verify whether there are any attachment entries in entities.xml:

    1 2 megatron:~/Downloads/XMLBackup$ grep -i "fileattachment" entities.xml megatron:~/Downloads/XMLBackup/$

Cause

From the grep command, we can see that there are no attachment related entries in the entities.xml. This shows that when the backup was generated, attachment data was either removed or not exported.

Solution

Resolution

To fix this problem, please generate a new backup from the source JIRA instance and verify using the same grep command from diagnostic steps to verify that the attachment related entries are available inentities.xml. Once this has been verified, please use the backup to restore it in target JIRA instance.

Updated on April 2, 2025

Still need help?

The Atlassian Community is here for you.