Page History
...
This tool has some limitations though; it cannot transfer apps/add-ons related data between instances unless apps are prepared for it.
Fortunately, Xray is now ( since v3.2) 3, Xray is able of taking advantage of this mechanism; on previous versions, issues would be restored but the testing data wouldn't.
Overview
Since Xray v3.2.03, you can use Jira's "Project Import" tool in a seamless manner to import projects containing Xray related data. As simple as that.
...
Requirements and Limitations
| Notes | Additional information |
|---|---|
Your backup file must have been created using Jira's backup tool. You cannot import a project from a backup using your native database tools. | |
The version of Jira in which the backup was created must be identical to the target Jira instance. It is recommended to have also the same version of the apps on the target JIRA instance. | |
If the instance of Jira had any app/add-on having their own custom field installed when the backup file was created, and the custom field was used in your project, then your target instance of Jira must have the same version of the app installed for the Project Import tool to automatically work. | |
The Project Import tool will lock out your instance of Jira during the actual data import (not during the validations). Ensure that your instance does not need to be accessible during this time. | |
| You cannot import a project directly from Jira Cloud to Jira Server. The importer will display errors about version mismatches. | More information on migrating information from Xray Cloud to Xray server soon. |
How to backup a project
Jira does not provide a project level backup utility; instead, it provides a global backup utility available in System > Import & Export > Backup System.
...
Specify the backup file, select a project to restore and proceed to the "Import Validation" step.
| Info | ||
|---|---|---|
| ||
Make sure you have done a backup of the attachments in the origin Jira instance and moved it to the restore attachments directory in the target Jira instance. Jira uses this to import the issue attachments, Xray will use it as well but to restore Test Run evidence and step attachments. The Import Tool will tell you where the restore attachments directory is located. |
...
Afterward, when the import of “REQ” is finished, we need to import “XTP2”. Xray then imports the entities of “XTP2” and rebuilds all the dependencies between “REQ” and “XTP2”.
Import Project & Summary
After proceeding and finishing the Import Project step, you finally get to the Summary step where alongside with a sum up of Jira generic information, Xray will also display how many entities were imported.
