Problem& Diagnosis

When starting a migration plan with Jira Cloud Migration Assistant, if a Business project uses an Agile board ( Scrum or Kanban), the Data Preparation pre-flight check will throw an error:

If you download the generated ZIP file, you will see errors like the below:

2023-01-01 20:06:59.220 ERROR XXXX project-export KANBAN board [YYYY] cannot be linked to business project [XXXX] on Cloud.

Cause

Jira Cloud does not support linking Agile boards to Business Projects. In the past, migrations with this setup would go through but boards would be orphaned in the Cloud. This preflight check was introduced starting with Jira Cloud Migration Assistant version 1.7.7 to identify the business projects that are using Agile boards and avoid the aforementioned issue by blocking the migration.
For more details about the the problem this pre-flight check helps to avoid, see MIG-948 - Getting issue details... STATUS  

Resolution

To be able to clear the errors in the data preparation check, you will have to apply one of the two resolutions below:

1. Convert the project from Business to Software if the Agile board is a necessity for the mentioned business projects, as explained in the following article: https://support.atlassian.com/jira-cloud-administration/docs/convert-a-project-to-a-different-template-or-type/;
2. If the board is not a necessity to the project:

• To view the boards, go to the global navigation bar and click on "Boards" or go to <JIRA_BASE_URL>/secure/ManageRapidViews.jspa
• Based on if the board is multi project or single project:

• • If the board is only designed for the specific business project you can simply delete it;

• • If the board is multi project and other projects need it: Go to Boards → Identify the board -> Click the three dots on the right -> Hit Configure -> modify the JQL query to not include the business project ;

By taking the above actions the data preparation check will be marked as successful and the migration plan can be executed.