You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 16 Next »

This page describes the migration path that our customers can follow in order to migrate Xray data from Jira Server / Data Center to Jira Cloud.


Server/DC vs Cloud - Product Comparison


If you are looking to migrate from Jira Server/DC to Jira Cloud, you need to consider the differences between Xray Server/DC and Xray Cloud. These differences might affect how your users work and interact with Xray. 

The ideas, goals, and major features are the same, of course. However, while there is great similarity between them, there are a few subtle differences between the two versions mainly due to:

  • Jira architecture - The way apps work in Server and Cloud is completely different. In Server, apps can integrate with many aspects of Jira, while on Cloud, there are lot's of integration points missing, e.g. JQL functions, Project Templates, etc
  • Product Age - Xray Cloud is a newer product. Therefore, some of the features are not yet present (e.g. Automated Step Library, Historic Test Coverage report), although we plan to include these features in future releases. Also, we took the opportunity to improve some features (e.g. Project Level Settings). 

For a full comparison between the Server/DC and Cloud versions of Xray, please refer to Xray Server and Xray Cloud.


Jira Cloud Migration Assistant  IN PROGRESS


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 support the Jira Cloud Migration Assistant. We plan to provide this integration in early 2021.


Xray Cloud Migration Scripts AVAILABLE


Although there isn't support for the Jira Cloud Migration Assistant yet, the Xray team has created some scripts that can help you migrate your data today.

These scripts are written in Python and are using the Xray REST and GraphQL APIs to fetch the Xray information from Xray Server/DC, and then import this information into Xray Cloud.


Script Requirements

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:


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


Script Performance

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 a Proof-of-Concept into a Test Jira instance first.


Clone or Download

These scrips are publicly available and free to use in our GitHub:  


Clone or Download

https://github.com/Xray-App/xray-cloud-mig

Please clone or download the repository and make any changes as needed. 

Feel free to contribute and submit pull requests.


Instructions

This page only contains a brief description of how the script works. Don't forget to follow the instructions on the README file in the repository.




  • No labels