Project Configurator for Jira Server and DC

How to Manually Migrate Attachments

If you have a large project with a lot of issues and attachments, migrating the project can be a very resource intensive process. This resource intensive process can cause the export to take a long time to complete or it can cause the export to fail because of a lack of storage space and the possibility of becoming corrupted.

To avoid this happening when migrating projects that contain a lot of issues and attachments, we advise manually migrating attachments by following the instructions below.

Exports without attachments will be smaller in size and will be easier to transfer between the source and target server.

Step-by-Step Guide

  1. Set the Attachment Mode dropdown to Manual on the export screen to generate an export without attachments.

  2. Copy the attachments over to the /tmp directory on the target server using a tool such as SCP or WinSCP. Usually, the attachments are stored in the location of <JiraHomeDirectory>/data/attachments but you should check what the attachment directory for your server has been configured to.

  3. Specify the path to the copied attachments in the Attachments Path box on the import screen.

  4. Run the import, and Project Configurator will copy in the attachments as part of the import process.

After copying the attachments over to the /tmp directory on the target server, you should ensure their permissions are set to be owned by the same operating system user and group that Jira is running under before running the import.