Versions Compared

Key

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

...

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  


Note
titleBefore you begin

Before attempting a test or production migration, ensure you've signed up for the Jira Cloud Migration Assistant EAP. If you did not yet, please do it here. If you are not registered on EAP the Xray cloud migration won't happen. This step is mandatory to have successful migrations.


Atlassian provides the Jira Cloud Migration Assistant to help Jira users assess and migrate from an on-premise Jira instance (Server or Data Center) to Jira Cloud. However, Atlassian has not yet included apps like Xray in this tool. 

Our team has worked with Atlassian to make Xray available within the official Migration Assistant tool and we hope Atlassian will launch this expanded version of the Migration Assistant.

...

Note

A valid Xray app license is required to migrate Xray data, otherwise, Xray data won't be migrated to the cloud.


Edit Issue Type Names

...

These checks are meant to help you plan your migration by taking into consideration Xray related constraints. The checks will let you know if:

  • the migrated Projects have the required permissions.
  • the group of Projects that you are migrating contain any Xray links to data outside of these Projects. 

If there are any such links, Xray will let you know which projects should be added to the migration to avoid ending up with missing links in the Cloud instance. This check should be done before any migration begins.

...

Info
titleTemporary Feature

The preflight checks feature was created on Xray app to help customers understand what must be migrated based on the project that they want to migrate. The cloud migration assistant will provide this feature after the EAP, and by that time, Xray will move the feature to be fully integrated with the assistant itself. As a consequence of this, the preflight check option will be removed from the Xray administration section menu.

Migrate all users

It is recommended that you select the option "All users and groups from the Jira directory" when choosing which users to migrate in the Jira Migration Assistant. This is due to the way that Jira checks which users are related to a project which will not consider users assigned to Test Runs.

Image Added

The Migration Process

The Xray migration starts right after the Jira migration. While Xray is migrating projects, the Xray app screens/actions will be disabled until the end of the migration. Those screens will show a warning and an action to allow the user to see the current progress of the migration. This progress shows details about what is being done.

...