Page History
With the recent announcement from Atlassian regarding the end of life of Jira server, clients might consider either upgrading to Jira Data Center or migrating to Jira Cloud.
This page describes the migration path that clients our customers can follow in order to migrate the Xray data from Jira Server / Data Center to Jira Cloud.
Jira Cloud Migration Assistant
| Status | ||||||
|---|---|---|---|---|---|---|
|
Atlassian provides an app called Jira Cloud Migration Assistant which will help users assess and migrate all the information from Jira on-premises to Jira Cloud. Jira Apps can also integrate with this assistant, making it easier to migrate all the data at once.
Currently, Xray does not yet provide an integration with support the Jira Cloud Migration Assistant. We plan to provide this integration until April in early 2021.
Xray Cloud Migration Scripts - Temporary Solution
| Status | ||||
|---|---|---|---|---|
|
Although there isn't support for the Jira Cloud Migration Assistant yet, the Xray team has created some scripts that can help you migrate even before we add support for this assistantyour data today.
These scripts are using the Xray REST and Jira REST GraphQL APIs to fetch the Xray information from Xray Server/DC, and then import this information into Xray Cloud.
...
There is a specific order in which these scrips must be executed.
| Info |
|---|
The scripts will not create new issues in Jira Cloud. The Xray issues must have already been migrated. Therefore, you first need to migrate the issues using the Jira Cloud Migration Assistant. |
| Message Box | ||||
|---|---|---|---|---|
| ||||
The scripts will not create new issues in Jira Cloud. The Xray issues must have already been migrated. Therefore, you first need to migrate the issues using the Jira Cloud Migration Assistant. |
The scripts will fill the gaps, namely:
- Test specifications
- Test Repository folders
- Relations between Xray issues/entities, e.g. Tests in Test Plans, Tests in Test Sets, Preconditions, etc.
- Test Runs
| Note |
|---|
The Depending on the number of issues, the migration scripts can take a considerable amount of time to execute and migrate all the data. Please plan ahead and do Proof-Of-Concept into a Test Jira instance first. |
| Info | ||
|---|---|---|
| ||
These scrips are publicly available and free to use in our Github: https://github.com/Xray-App/xray-cloud-mig Please clone the repository and make any changes needed. |