Troubleshoot migration with Jira Cloud Migration Assistant

If your Jira Server site is highly customized, you may face additional issues when migrating. For example, if you have any required field with a null value the migration will fail because this is not supported on your Cloud site. We recommend cleaning up your instance data before migrating.

An incomplete status means that some things have been migrated but there was at least 1 entity that we couldn’t migrate. For example, we might be able to migrate a project but 1 issue fails because there is a null value in a custom field. In this case, the project will show up as incomplete even though all the actual data is complete. Many times this status will not be a problem for your migration. Download the error logs to determine what is causing the failure. 

If you make any changes on your Server site, wait at least 10 minutes before migrating to allow all data to be updated. 

If you choose to change a project key on your Server before or during migration, make sure that all configuration, filters and boards are updated with the new project key before attempting a new migration. 

If you have chosen to migrate in smaller batches, links to projects or issues that haven't yet been migrated will be missing until that linked item is migrated. 

If a history entry refers to a missing link or attachment, the history entry won't be migrated. If a linked issue or project is migrated at a later date, the history entry will be updated. 

The migration assistant does not check that  the JQL issue filters on boards are returning the correct results after migration. If a board has a filter that mentions a project or field that is not yet migrated, the board may not return the same results after it is migrated. To fix this issue, edit the board's JQL filter after migrating. Learn more about board filters

If you use Jira Align, you need to complete additional steps before, during, and after the migration. If you’re having problems, see the linked page or contact Atlassian Support. Learn how to migrate Jira Align

The check has passed. You can proceed with your migration.

You can proceed with your migration, but you need to be aware of a potential issue. Expand the warning messages to view details.

You can’t proceed with your migration until you resolve the error. Expand the error messages to view details.

The check wasn’t completed due to an unexpected error. Refresh the checks or contact Atlassian support.

The Jira Cloud Migration Assistant authentication token might have expired.

Learn how to renew your authentication token

The Jira Cloud Migration Assistant authentication token might have expired.

Learn how to renew your authentication token

The Jira Cloud Migration Assistant authentication token might have expired.

Learn how to renew your authentication token

It’s possible that your cloud site is unavailable for migration. Here are the reasons and fixes:

Reason 1: Your sandbox has been deleted.

Fix:

1. Check if your sandbox is deleted:

   1. Go to admin.atlassian.com, and then select your organization if you have more than one.

   2. Select Products > Sandbox.

2. If deleted, contact support for further assistance.

Reason 2: Your cloud site couldn’t be found or your Jira Cloud subscription has been deactivated due to inactivity.
Fix:

1. Check if your cloud site subscription is canceled:

   1. Go to admin.atlassian.com, and then select your organization if you have more than one.

   2. Select Billing.

2. If canceled, recover the canceled site.

Project Name and Project Key Conflict When Migrating Using Jira Cloud Migration Assistant (JCMA)

Fix duplicated email addresses

Fix invalid email addresses

This check is shown when the number of email aliases related to a single primary email exceeds the limit of 10. An alias is a variation of the primary email, for example charlie+suffix@atlassian.com vs. charlie@atlassian.com.

The limit exists on the cloud side and allows to create only 10 aliases per hour.

Download CSV file

When viewing the check, you can download a CSV file to help you resolve the issue. The file:

• Lists all email aliases (including the first 10) for cases where the limit was exceeded. It might include aliases related to multiple primary emails.

• Doesn’t include the primary email itself.

Goal

Your goal is to change the aliases into individual emails or delete the corresponding users. It’s enough if you do it for aliases that exceed the limit. However, since cloud subscriptions are billed per user, you might want to delete or deactivate these extra users.

Solve the issue

To solve this issue, use the CSV file to identify the corresponding users and either update or delete them:

• If you manage users in Jira, you can update them in Administration > User management.

• If you manage users in an external directory, we recommend that you update users in the directory so the aliases aren’t provisioned to cloud.

ERROR [JCMA 124] <project key> project-export: The board ‘<board name>’ is assigned invalid administrators: ‘<group name>’.

To assign valid administrators to your board:

1. Open the board for which you want to assign administrators.

2. Go to Board > Configure.

3. In the Administrators field, hover over to click the edit icon.

4. Remove the invalid groups mentioned in the error log.

5. Enter the names of the users or groups. If you start typing the name, a list of users and groups will be suggested.

6. Press the Enter key when finished.

ERROR [JCMA 149] <project key> project-export: The issue type ‘<issue type name>’ with issue key ‘<issue key>’ has no ‘<issue status>’ status in workflow ‘<workflow name>’.

To assign valid status:

1. Select Settings > Issues. 

2. Under WORKFLOWS, click Workflow Schemes.

3. In the Workflow column, look for the affected workflow.

4. Open the workflow to view the list of valid statuses in the Linked Status column.

5. Open the issue for which the invalid status was assigned.

6. From the Workflow list, select a valid status.

ERROR [JCMA 510] <projectKey> project-export Couldn't migrate Request Type with id <requestTypeId> linked to Issue Type with id <issueTypeId>

Add the Issue Type with id <issueTypeId> to the Issue type Scheme of the project with id <projectId> to resolve

You can perform step A and step B to fix this error.

Step A: Make a list of issue types used for the request types of the Jira Service Management project.

To make a list:

1. In Jira Server or Data Center go to Settings > Projects.

2. Search for the Jira Service Management project for which the error was found.

3. Click to open Project settings screen.

4. Select Request types.

5. From the Issue type column, list down all the issue types. For example, Task, Service request etc.

Step B: Check and add the issue types that are missing from the Issue Types for Current Scheme list based on the issues types list from step A.

To add the missing issue types:

1. Go to Settings > Issues.

2. From the left panel, select Issue type schemes.

3. For the relevant issue type scheme of the Jira Service Management project, select Edit.

4. Drag the missing issue type from Available Issue Types to Issue Types for Current Scheme.

5. Click Save.

After step A and step B, you can retry your migration.

ERROR [JCMA 147] <project key> project-export: The Kanban / Scrum board '<board name>’ cannot be linked to the Business project ‘<project name>’ on cloud.

ERROR XXX project-export KANBAN/ SCRUM board [XXXX] cannot be linked to business project [XXX] on Cloud.

ERROR [JCMA 151] <project key> project-export: The workflow ‘<workflow name>' with transition '<transition name>’ is linked to an invalid screen.

To assign a valid screen to the workflow transition:

1. Select Settings > Issues. 

2. Under WORKFLOWS, select Workflows.

3. Look for the affected workflow name, and select Edit.

4. In the diagram, select the affected transition.

5. On the right-hand side of the screen, select Edit to change the screen name.

6. Select Save.

7. Repeat steps 4 through 6 to fix multiple transitions.

ERROR CROSS-PROJECT-DATA project-export Exception Message generated on executing query for fetching arPlanPermissions -> <exception message>
Exception Cause -> <exception cause>

Use the following KB articles to resolve the error:

• How to fix the collation of the Microsoft SQL Server database for Jira manually

• Plans missing in Advanced Roadmaps for Jira after updating SQL Server Collation

ERROR <project key> project-export Issue <issue type> has invalid issue type.

To assign an issue type:

1. Go to Projects.

2. Open the project for which you want to add the issue type.

3. Select Project Settings.

4. Under Issue types, select the issue type scheme.

5. Go to Actions > Use a different scheme.

6. Select Create a new scheme and associate with current projects.

7. Add all the relevant issue types from available issue types.

8. Select OK.

9. Select Re-index project, and then select Start project re-index to save the changes.

10. Select Refresh, and then select Acknowledge to complete the process.

ERROR <project key> project-export: The filter ‘<filter name>’ has no owner assigned or no longer exists.

Refer the Filters owned by deleted users section in the KB article to resolve the error:

How to migrate all boards and filters with the Jira Cloud Migration Assistant

 ERROR <Project_Key> project-import
We couldn't import Project Component <Project_Component_Name>.
Reason: name: A component with the name <Project_Component_Name> already exists in this project...
This caused <Number_of_Items> other items to fail.

We couldn't import Project Component - JCMA Error

ERROR <Project_Key> project-import We couldn't import Project Version <Version_Name> because of <Number_of_Occurrences> missing dependencies: Project <Project_Key>.
This caused <Number_of_Issues> other items to fail. Check the reasons for the missing dependencies on your server site.

We couldn't import Project Version because of missing dependencies: Project - JCMA Error

 <Project Key> project-import
We couldn't import Issue <Project Key>-<Issue Number> because of 1 missing dependencies:
Custom Field 'Sprint'. This caused <Number of Ocurrences> other items to fail.
Check the reasons for the missing dependencies on your server site.

We couldn't import Issue because of 1 missing dependencies: Custom Field 'Sprint'

 com.atlassian.jira.migration.orchestratorclient.OrchestratorClientErrorException: request to Migration Orchestrator failed
com.atlassian.jira.migration.orchestratorclient.OrchestratorServerErrorException: failed to send a request to server

Request to server or Migration Orchestrator failed in JCMA

 ERROR <Project_Key> project-export
The workflow: [Workflow_Name] transition [Transition_Name] Missing config [Config_Name] value refence [Value_Reference_Name] in workflow rule condition/validator or post-function [Workflow_Rule_Name].
Double-check the workflow rule for missing config values or references.

Workflow missing config values or references - JCMA Error

ERROR <project-key> project-import We couldn't import Comment <comment-id> (on Issue <issue-key> by '<user>' on <timestamp>). Reason: CommentBodyCharacterLimitExceededException: No message.

ERROR <project-key> project-import We couldn't import Issue <issue-key>. Reason: description: The entered text is too long. It exceeds the allowed limit of 32,767 characters..

"CommentBodyCharacterLimitExceededException: No message" or "The entered text is too long. It exceeds the allowed limit of 32,767 characters.." error message in JCMA

 ERROR <Project_Key> project-import
We couldn’t import Issue <Issue_Key> because of 1 missing dependencies: Project <Project_Dependency_Key>.
This caused <Number_of_Items> other items to fail.
Check the reasons for the missing dependencies on your server site.

We couldn't import Issue because of missing dependencies: Project - JCMA Error

ERROR <Project_Key> project-export
The workflow: [Workflow_Name] transition: [Transition_Name]
has unsupported custom field reference in config hidFieldsList
for workflow rule validator [Validator_Name].
Double-check the workflow rule for missing config values or references.

Workflow rules migrated via Jira Cloud Migration Assistant

ERROR <Project_Key> project-export
We couldn't export Issue <Issue_ID>.
Reason:
com.atlassian.greenhopper.manager.lexorank.LexoRankIntegrityException:
Expected exactly <X> rows; the maximum marker row and the lowest
ranked row for rank field[id=<Field_ID>].

List of all known Agile Lexorank error

Jira server throws LexoRankIntegrityException error during reindexing or reranking operations

sun.security.validator.ValidatorException:
PKIX path building failed:
sun.security.provider.certpath.SunCertPathBuilderException:
unable to find valid certification path to requested target

Unable to connect to SSL services due to "PKIX Path Building Failed" error

java.net.UnknownHostException: <AMAZON_S3_URL>
java.net.ConnectException: Connection refused (Connection refused)

Preparing your firewall to migrate using the Jira Cloud Migration Assistant

We couldn't import Issue ABCD-12345. Reason: DataAccessException: java.sql.SQLException: PSQL_TOO_MANY_CONNECTIONS Exception already occurred in this workcontext, skipping next getConnection. This caused X other items to fail

'FATAL too many connections' error when using PostgreSQL database due to user-specific connection limit

java.lang.OutOfMemoryError: Java heap space

Jira server crashes with OutofMemory Java heap space error

ERROR <Project_Key> project-export
We couldn't export Issue <Issue_ID>.
Reason: com.querydsl.core.QueryException:
Caught SQLServerException for <SQL_QUERY>

How to fix the collation of Microsoft SQL Server database for Jira manually | Jira | Atlassian Documentation

Exception occurred in the server app

An error has most likely occurred in the server app. This may stop further migration operations in the server app, and could cause a timed-out app migration.

If the app’s migration does not settle, contact the Marketplace Partner and provide the following information:

• the app migration status and a clear description of the warning of the server exception

• your cloud site url

• entire progress logs of the app

• details on how Marketplace Partners can handle server exceptions

The Marketplace Partner may direct you to contact Atlassian Support if they need Atlassian to help with server exception.

Failed to notify Cloud app about start of app migration

An failure error occurred when attempting to notify with the Cloud app that app migration has started. Multiple retries to notify the cloud app has not returned as successful response.

Notifying the cloud app is needed to allow Marketplace Partners to begin app migration. Potentially, this error can lead to a timed-out app migration.

If the cloud app does not get updated, contact the Marketplace Partner and provide the following information:

• the app migration status and a clear description of this warning

• your cloud site url

• entire progress logs of the app

• details on how Marketplace Partners can handle server exceptions