Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


On this page:

Table of Contents

Introduction

The 'Project with Issues' snapshot type includes all issues and related data - attachments, comments, work log entries, issue links, history, and many more.

Including the attachment files can make the snapshot grow very large, which is why Configuration Manager allows two ways of handling attachments. The attachment metadata (filename, creator, create date, etc.) is small and is always included in the snapshot.

  1. Include attachment files in the snapshot. This is the preferred option for moving projects with fewer attachments (roughly less than 100 MB).

  2. Do not include attachment files in the snapshot. This is the only viable way to go for moving projects with many (or large) attachments. The attachment files for the exported projects need to be copied and moved to a temporary folder on the target system separately. During the snapshot deployment, Configuration Manager will ask for the path to the directory where the files reside on the target system. It will pick the files from the temp location and copy them to their right places 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.

(info) Jira stores the attachment files in separate directories by project key - $Jira_Home/data/attachments/.

Create a Project Snapshot with Issues

  1. Choose the cog icon at the top right of the screen, then choose Configuration Manager:

  2. Select Snapshots to open the Configuration Snapshots page and click on the Add Snapshot button.

  3. 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

...

To provide attachment path during deployment:

  1. Choose the cog icon at the top right of the screen, then choose Configuration Manager:

  2. Select Deploy on the left menu to open the Deploy Configuration Snapshot page.

  3. Choose a snapshot with issues from the current instance/linked Jira/snapshot file and click the Deploy button. (Read more about deploying snapshots)

  4. There is an option “Do not import issue attachments” in the Advanced Options on the deployment wizard’s Select Deployment Mode.

  5. Either provide a path to import the attachment files or enable the option to skip importing attachment files.

Info

Store the attachment files in a temporary folder on the target Jira's file system. Avoid using Jira’s attachment directory.

...