Manage migrations

Owned by
Rosen Marinkov
Last updated: May 22, 2024 by
Julver Petrova (Deactivated)
3 min read

On this page:

How to manage my migrations

The Manage Migrations page lists essential information for each migration. This page allows you to view the status and details of your past and ongoing migrations at a glance. In addition to that, you can return to a previously incomplete migration to review details or complete it. For failed and successful deployments, you can go back to their result page to review the outcome in more detail.

Migration states

Each migration you create can be in one of the following states:

  • CREated The migration is created. You can use the View action to resume and complete the migration.

  • Analysis The migration is being analyzed. You can use the View action to check the analysis progress and details.

  • failed The migration failed. You can open a support request and send us a support zip, which helps us identify the problem.

  • Completed The migration is completed. Use the View action to see the summary of the migrated projects, issues, and configuration changes.

Review or return to a migration

  1. Log in as a user with the Jira System Administrators global permission.

  2. Navigate to the top right of the screen and choose Jira Settings > Configuration Manager.

  3. In the Manage migrations section of the Move to Jira Cloud page, review the list of migrations.

  4. Choose a migration in any state and click View in the Actions section.

    The image shows an example list of migrations in created, analysis, running , completed and failed states.There's also a pointer to the Actions column containing the different actions for each migration.

  5. For the CREATED, ANALYSIS, and Running states, you resume the migration from where you left off.
    For COMPLETED migrations, you can see and review the migration result, as shown in the screenshot below.

    Image of the successful migration complete page after clicking View in the Manage migrations page.

    For FAILED migrations, you see an error page that suggests opening a support ticket with the migration ID and support zip file.

Download a support zip

You can download and send us a support zip to help us investigate the cause of a failed migration.

  1. Log in as a user with the Jira System Administrators global permission.

  2. Navigate to the top right of the screen and choose Jira Settings > Configuration Manager.

  3. From the left-side menu, select Move to Jira Cloud and review the list of migrations. Choose a failed migration and click Support zip in the Actions section. Contact us and attach the downloaded support zip file to our Support Portal.

View migrations when connectivity is lost

When a connection to the Jira Cloud site can’t be established for some reason, you won’t be able to return to or open an existing migration.

You need to connect or reconnect to the Jira site with valid credentials when:

  • you don’t have a cloud connection to the Jira site in Cloud Migration Tool’s UI,

  • your cloud credentials become obsolete, or

  • the cloud connection used for an existing migration isn’t working for some reason.

If you don’t have a connection to the Jira Cloud site in the migration, use the Connect action in the error message in the Actions column of the Manage migrations section (see the screenshot below). This way, you can create a connection to the Jira site with your credentials and review the migration.

Â