---
title: "[Xray] Migration from the Data Center to Cloud:Failures: Diagnosis and Resolution"
canonical: "https://docs.getxray.app/space/ProductKB/854065153/%5BXray%5D%20Migration%20from%20the%20Data%20Center%20to%20Cloud%3AFailures%3A%20Diagnosis%20and%20Resolution"
format: markdown
---
| **Problem** | **Diagnosis** | **Solution** | **KB article reference** |  |
| --- | --- | --- | --- | --- |
| **Data was modified during the migration process, new issues being created, edited or deleted from projects being added to the migraiton. ** | Check internally with the teams that work with the Projects being migrated to ensure no new data is created, and no existing data is changed. | There are two options:<br>**First: **<br>1. Delete the already migrated projects on the Cloud.
2. Create a new migration plan, and add the projects to the migration<br>**Second: **<br>1. Create a new migration plan, and add the projects you have migrated.** (It's important that Xray is not included in this plan; the project should be migrated only with Jira)**
2. Access the failed migration plan, then re-run the Xray migration using the **Re-run feature** in JCMA on the original plan; it should indeed work.<br>> ⚠️ The second option does not work in all cases, so we need to review each case individually. Please contact the Xray Support team for guidance. |  | <u>[[Xray] Can I continue to create tests, test plans, test executions or any other Xray entity while doing a migration from Server to Cloud?](https://docs.getxray.app/space/ProductKB/46269187)</u> |
| ** Test Issue Linkage/ missing issues. ** | > ℹ️ This does not cause the Xray migration to fail. But, on the Xray Cloud, the Test Coverage will be missing/broken.<br>In Jira Cloud, *go to Jira Settings → Work Items → Work item features → Work Item Linking *and check the link Name: **Test** with the Outward and Inward Description: **tests/is tested by.**<br>Then, go to Jira Data Center, go to *Jira Administration → Issues → Issue Features → Issue Linking, *and* *you´ll see a link Name: **Tests** with the Outward and Inward Description: **tests/tested by. **<br>This should have been changed to match its counterpart in the Jira Cloud. Both the Name and the Outward and Inward Description. | > ℹ️ This does not cause the Xray migration to fail. But, on the Xray Cloud, the Test Coverage will be missing/broken.<br>**To fix it: **<br>- Compare both instances of the issue linking for the Test:  compared both instances of Jira Cloud and Server/DC
  - In the Server/DC instance, you can check the Issue Links on the following path: **Configuration > Issues > Issue linking**:
  - On the Cloud instance, you can check the Issue Links on the following path: **Work Items >Work Item linking**:
- Take screenshots from the Jira Data Center and the Cloud, contact the Xray Support team for guidance.<br>The process that the Xray will be<br>- Perform a quick test on the Xray Cloud, create a new project/space, and add the Xray to this project. On the Test Coverage, add the issue type Story.
- Create an issue for the Story, and add some tests to it. Check which issue Xray is looking for.
- Then, access the **Work Items >Work Item linking**, delete the issue linking migrated from the Data Center, and migrate all the issues to the correct issue linking.<br>> ⚠️ Please do not perform the process if you have some doubts; contact the Xray Support team. |  |  |
| Migration failed due to archived projects | In Jira Data Center, go to *Jira Administration → Projects → Archived Projects*, and check if any of the Projects included in the migration are present here. | There are two options:<br>**First: **<br>1. You can go to Jira Cloud, unarchive the migrated Archived Projects, and **re-run** the migration.<br>**Second: **<br>1. Unarchive the projects on the Jira Data Center.
2. Delete the already migrated projects on the Cloud.
3. Create a new migration plan, add the projects to the migration, including the ones that were unarchived, and add the Xray to the migration plan.<br>> ℹ️ The Xray Re-run option will work for this case. | <u>[[Xray] Server/DC to Cloud Migrations (JCMA) – Xray migration got failed due to archived projects.](https://docs.getxray.app/space/ProductKB/140804240)</u> |  |
| Migration failed due to Issue Security Schemes | In Jira Data Center, go to *Jira Administration → Issues → Issue Security Schemes* and check if there are any for the Projects included in the migration and if they have the **“Any logged-in user”** permission. | There are two options:<br>**FIRST option:**<br>- You can resolve the issue by adding "Any logged-in user" to the Issue Security Schemes directly on the Cloud site and then re-running the app migration from JCMA.<br>> ⚠️ For future migrations, the permission should be added on the Data Center side before running the Jira migration to prevent this issue from recurring.<br>**SECOND option:**<br>- Remove issue security schemes from projects before migrating, or set issue security to **“Any logged-in user”**.
- Create a new migration plan, and add the projects you have migrated.** (It's important that Xray is not included in this plan; the project should be migrated only with Jira)**
- Access the failed migration plan, then re-run the Xray migration using the **Re-run feature** in JCMA on the original plan; it should indeed work.<br>> ℹ️ The Xray Re-run option will work for this case. | ⁠⁠<u>[[Xray] Server/DC to Cloud Migrations (JCMA) – Xray migration failed due to issues with Security Schemes](https://docs.getxray.app/space/ProductKB/140574916)</u> |  |
| **Migration failed due to missing projects** | In Jira Data Center, go to *Jira Administration → Manage Apps → Xray → Cloud Migration. *Click **Download project dependency map,** then use the **Cloud Migration Pre Flight Checker.** The Project Dependency Map will create a file where you´ll be able to check, by Group, **which Projects have Xray dependencies**. Using the Cloud Migration Pre Flight Checker, you can verify the dependencies between them.<br>You´ll need to check the Projects included in the migration and whether the others in each corresponding Group were migrated together. | 1. Check the Xray Dependency Map, go to *Jira Administration → Manage Apps → Xray → Cloud Migration. *Click **Download project dependency map,** then use the **Cloud Migration Pre Flight Checker.**
2. Delete the already migrated projects on the Cloud.
3. Create a new migration plan, add the projects to it, including those that were missing, and add Xray to the plan.<br>> ⚠️ The Xray Re-run option will not work for this case. | <u>[[Xray] Can I migrate only certain projects from Server/DC to Xray Cloud?](https://docs.getxray.app/space/ProductKB/46268619)</u> |  |
| **Migration failed due to mismatched Xray issue types** | Check the list of Xray issue types in both Jira Data Center and Jira Cloud, ensuring that **Test, Test Execution, Test Set, Test Plan, Precondition, **and** Sub-Test Execution** are present and named consistently. | 1. The best option is to delete all migrated projects in Jira Cloud.
2. Rename the Xray issue types to match in both instances. Once this is done.
3. On the Jira Data Center, create a new migration plan, add the projects, and run the migration.<br>> ⚠️ There’s another process: contact the Xray Support team so we can remap the Xray Cloud to look for the issue types migrated from the Data Center. Then you can rerun the migration for Xray without creating a new plan or performing the Jira migration. 
> ⚠️ 
> ⚠️ However, this does not work in all cases, so we need to review each case on a case-by-case basis. | <u>[[Xray] Migration from Server/DC to the Cloud Xray issues types MUST be equal in both instances](https://docs.getxray.app/space/ProductKB/141885510)</u> |  |
| **Xray Sub Test Execution is not installed on Xray Cloud** | In Jira Cloud, go to *Jira Settings → Marketplace Apps → Xray → Health Check *and check if Xray Issue Type Sub Test Execution is installed. | 1. Go to *Jira Settings → Work Items → Work types → Sub-Task* and ensure **Jira Sub-tasks** are enabled, then reinstall Xray using the **Health Check** in Jira Cloud.
2. For this, the best option is to delete all migrated projects in Jira Cloud.
3. On the Jira Data Center, create a new migration plan, add the projects, and run the migration.<br>> ⚠️ The Xray Re-run option will not work for this case. | <u>[Xray Cloud Health Check shows that the Xray Sub Test Execution issue type is not installed](https://docs.getxray.app/space/ProductKB/141590534)</u> |  |
| **Add-ons blocking or failing the migration** | In the Jira Data Center, go to *Jira Administration → Manage Apps* and check if the Checklist or Jira Misc Custom Fields (JMCF) apps are present. | > ⚠️ Pause or disable these add-ons until the Xray migration completes, then re-enable them. | <u>[[Xray] Add-ons that are currently incompatible with Xray data migration](https://docs.getxray.app/space/ProductKB/192380971)</u> |  |