On this page:
Related pages:
Overview
A 'Project snapshot with issues' packages all the configuration and issue data of a single project (or multiple projects). The snapshot can then be used to move the project(s) and their issues to a different Jira instance for archiving or project backup while maintaining the issue history, links, ranking, and agile data.
Important
Since version 5.0, you can create a snapshot that includes project issues as well as the project configuration(s).
Create Snapshots of Projects with Issues
To create a new Project snapshot with issues
Log in as a user with the Jira System Administrators global permission.
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.
Adding projects to the snapshot:
To add all projects from a Jira instance to a snapshot, you can use the Select all projects button.
To select projects by listing them by their keys, first type the keys like KEY1, KEY2, KEY3, etc. in the Project(s) field, and then use the Bulk select by key button.
To clear the current selection of projects, use the Clear selected projects button.
You can enter a JQL query to include only a subset of the project issues in the snapshot. Read more about filtering issues.
When this option is selected will include issue attachment files for all selected projects. If not selected, Configuration Manager will offer an option to provide the path where the attachment files reside on the target system during snapshot deployment.
If a snapshot with that name already exists, you will see a warning. The snapshot always includes the attachment metadata. However, attachment files are not included in the snapshot by default, as the snapshot grows very large. If the attachment files are not included in the snapshot, during the deployment, you will be presented with an option to provide the path where the files reside on the target system. Learn more about including attachments in a snapshot in the Move Attachments tutorial. Note that issue data can be deployed into projects that already contain issues. In this case, issues are compared based on the issue number. Existing issues are not modified. Example: Snapshot contains issues with numbers X, Y, and Z. The target project includes issues X and Y. During the deployment, only issue Z is created; issues X and Y are skipped.
Click Next to add filters in the snapshot, Agile boards, and Dashboards.
If you want to see a preview of the snapshot, click Next.
Click the Create button and wait while the snapshot of your Jira instance configuration is being created.
A message will be displayed, confirming that Configuration Manager for Jira has successfully created the snapshot or if there were any warnings that you may want to review in CMJ's audit log:
Snapshot Options
Include selected Filters
When you create project snapshots, on the "Filters" page of the snapshot wizard, you can select Jira Filters to be included in the snapshot so they can be deployed along with the rest of the configuration. See step 4. in the snapshot creation process.
Include selected Agile boards
When you create project snapshots, on the "Boards" page of the snapshot wizard, you can select Jira Agile (Jira Software) Boards to be included in the snapshot so they can be deployed along with the rest of the configuration. See step 5. in the snapshot creation process.
Include selected dashboards
When you create project snapshots, on the "Dashboards" page of the snapshot wizard, you can select Jira Dashboards to be included in the snapshot so they can be deployed along with the rest of the configuration. See step 6. in the snapshot creation process.