Versions Compared

Key

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

...

The preflight checks are available when the Jira Cloud Migration Assistant is installed and a version of Xray supporting the migration to Cloud is also installed. The page can be found in the Administration → Manage Apps → Xray → Cloud Migration. Here you should add all the projects for your migration and then press Validate. If there are no errors, you can leave this page and proceed with your migration through the Jira Migration Assistant. If there are any errors you can see the details and steps to fix the issues. 


Image Modified

Example: Project XT was selected for migration. The preflight checks found that there is a link to another project which is not part of the migration (XDTP).

We'll add the missing project to the preflight checks and validate.

Image Modified



There are no more errors, meaning that these two projects can be migrated together safely.  We can now go back to the Jira Migration Assistant and plan our migration with both projects.

...

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


Image RemovedImage Added

Xray Cloud also provides a page on the app administration section with all the migration plans in progress and done. Here the Jira administrator could see the history of migration and the ongoing migration plans. Learn more about this here.

Image RemovedImage Added



Unsuccessful Migrations

...