On this page:
Introduction
The 'Project with Issues' snapshot type includes all issues and related data - comments, work log entries, issue links, issue history, and of course, attachments.
The attachment metadata (filename, creator, create date, etc.) is small enough to always be included in the snapshot. However, including the attachment files can make the snapshot grow very large, which is why Configuration Manager allows two ways of handling attachments.
Include attachment files in the snapshot. This is the preferred option for moving projects with fewer attachments (roughly less than 100 MB). A local copy of each file will be made during export regardless of their storage location (local or in Amazon S3). Therefore, you need to have sufficient space available during the export. Once the snapshot is created, these local copies will be deleted.
Do not include attachment files in the snapshot. With this option, the attachment files for the exported projects will need to be manually copied and moved to a temporary folder on your local system or in your Amazon S3 storage. During the snapshot deployment, Configuration Manager will ask for the path to the files' directory. It will copy the files and transfer them to their correct place in Jira’s attachments directory using the metadata in the snapshot. With this option, the snapshot size will be considerably smaller and will be deployed faster.
Jira stores the attachment files in separate directories by project key.
An example of a local directory - $Jira_Home/data/attachments/
An example of an Amazon S3 directory - $AWS_bucket/attachments
Create a Project Snapshot with Issues
Choose the cog icon at the top right of the screen, then choose Configuration Manager:
Select Snapshots to open the Configuration Snapshots page and click on the Add Snapshot button.
Select the Project with Issues button and enter a name for the snapshot. Here, you can select as many projects as you need to include in the snapshot. Optionally enter a description. The following screen will appear:
Deploying a Snapshot with Issues
When deploying a snapshot with issues, if the attachment files are not included in the snapshot, you can provide a path where the files reside. Configuration Manager will pick the files from there and attach them to their relevant issues. After the deployment is complete, Configuration Manager will store the files in the Jira attachment directory.
Note that the option to import attachment files from the file system will appear in the deployment wizard only when:
At least one issue in the snapshot has an attachment, and
The attachment files are not included in the snapshot.
To provide attachment path during deployment:
Choose the cog icon at the top right of the screen, then choose Configuration Manager:
Select Deploy on the left menu to open the Deploy Configuration Snapshot page.
Choose a snapshot with issues from the current instance/linked Jira/snapshot file and click the Deploy button. (Read more about deploying snapshots)
There is an option “Do not import issue attachments” in the Advanced Options on the deployment wizard’s Select Deployment Mode.
Either provide a path to import the attachment files or enable the option to skip importing attachment files.
Store the attachment files in a temporary folder on your local system or in your Amazon S3 storage. Avoid using Jira’s attachment directory.
The attachment path should look like this:
C:\temp\attachments (on Windows);
/somewhere/attachments (on Linux or Solaris)
/attachments (on Amazon S3)
Configuration Manager expects the attachment directories to follow the same structure as Jira’s attachment directory.
For example, when exporting projects PRA and PRB on the source server, copy the directories $Jira_Home/data/attachments/PRA and $Jira_Home/data/attachments/PRB, and move them to a temporary directory on the target server, as in the screenshot below:
When prompted by Configuration Manager, provide the path to the temporary directory.
After the deployment, the temporary directory is not needed anymore and can be deleted.
Potential Errors
The provided path does not contain an accessible subdirectory for the project.
If the temporary directory does not contain sub-directories for some of the projects in the snapshot, Configuration Manager will show the following warning:
There was an unexpected error related to Amazon S3.
If Configuration Manager fails to authenticate your Amazon S3 storage account, the following error will appear:
