Versions Compared

Old Version 11

changes.mady.by.user Edward Stolyar

Saved on

compared with

New Version 12

changes.mady.by.user Helen Kosova

Saved on

Key

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

Important notice:

  • We strongly urge our customers to NOT migrate using the Jira Cloud Migration Assistant (JCMA) until Atlassian enables it for app migrations later in 2021. The JCMA does not enable app migrations at this time.

  • For more information about Atlassian’s app migration timelines, visit their blog and Cloud Roadmap.

Supporting your journey to Cloud

Atlassian’s shift in strategy to become a cloud-first company has accelerated the journey to cloud with next-level offerings. On this journey, customers will start migrating their Jira instances and Apps from Server to Cloud (or Data Center) later in 2021 when Atlassian updates the Jira Cloud Migration Assistant (JCMA) with support for Jira apps.

At SmartBear, we are committed to facilitate a smooth transition to all our customers, so we have created a step-by-step guide to help you migrate your test data from Jira Server to Jira Cloud by using JCMA.

...

On this

...

page:

...

Supported versions

...

Pre-migration steps

...

Migration steps

...

Post-migration steps

...

Known issues & limitations

Table of Contents
exclude^On this

Supported versions
Anchor
versions
versions

  • Jira Server 8.0.0 - 8.16.1

  • Jira Data Center 8.0.0 - 8.16.1

Pre-migration steps
Anchor
pre-migration
pre-migration

In Jira Server

  1. Install the Jira Cloud Migration Assistant plugin in your Jira Server instance.

    Note: In Jira Server 8.14, the migration assistant is installed by default.
    To install the plugin manually:

    • In Jira Server, go to Settings > Manage apps.

    • Choose Find new apps in the sidebar.

    • Enter Jira Cloud Migration Assistant in the search bar.

    • Once the plugin is found, click Install:

      Image Modified

  2. Upgrade Capture for Jira to the following version:

    • Server - 3.1.0.

    • Data

...

    • Center - 2.9.21.

In Jira Cloud

  1. Install Capture for Jira Cloud in your Jira Cloud instance.

  2. If you are already using Capture for Jira Cloud in some projects and the projects have the same name or project key as those they have in Jira Server, delete or rename those projects in Jira Cloud.

  3. Navigate to Apps > Manage apps > Capture for Jira Settings and click Register for Migration to register your Jira Cloud instance for migration:

    Image Modified

Migration steps
Anchor
migration
migration

To start migrating your test data:

1. Navigate to Settings > System > Migrate to cloud in your Jira Server instance:

Image Modified

2. Click on ASSESS AND INSTALL APPS:

Image Modified

3. On the Assess your apps page, select Needed in cloud from the dropdown next to Capture for Jira and click Continue:

Image Modified

4. Specify the URL of the Jira Cloud instance where you want to migrate your data and click Continue:

Image Modified

5. Click Continue on the Install your apps page:

Image Modified

6. Once the step above completes, go back to Settings > System > Migrate to cloud and select Manage your migration:

Image Modified

7. On the subsequent page, click Create new migration, and then click Connect to cloud:

Image Modified

8.  On the next page, specify a name for your migration, select the destination cloud site from the dropdown, and click Choose what to migrate:

Image Modified

9. On the subsequent page, select Projects to choose the projects you want to migrate or Users and Groups to specify which users to migrate:

Image Modified

Once done, click Apply Changes:

Image Modified

10. Select the applications you want to migrate and click Apply changes:

Image Modified

11. On the subsequent page, click Review migration:

Image Modified

12. If there are no warnings or errors, click Run:

Image Modified

13. Make sure to wait until the migration completes (the status must be Complete):

Image Modified

Post-migration steps
Anchor
post-migration
post-migration

Once the migration status is Success, you need to clear cache and reindex data in your Jira Cloud instance. To do that, navigate to Apps > Manage Apps > Capture for Jira Settings and click Clear Server Cache, and then Reindex:

Image Modified

Once done, you can open Capture for Jira in your Jira Cloud instance and validate the migrated data. If no issues are found, you can start working with it.

Known issues & limitations
Anchor
limitations
limitations

For the common JCMA issues and limitations, see the Atlassian documentation:

➡ JCMA known issues and troubleshooting
➡ What gets migrated with the Jira Cloud Migration Assistant

The following limitations are specific to the Zephyr Capture for Jira migration.

  • If you have issues linked to issues in another project, you need to migrate the dependent project before migrating the project in which Capture for Jira is used.
    Example: You have Project A used for development and Project B in which Capture for Jira is used. A Project B issue is linked to a Project A issue. In this case, you need to migrate Project A first.

  • The migrated Capture for Jira variables belong only to the project adminwho migrated the data from Capture for Jira Server to Capture for Jira Cloud.

  • The favorite templates flag is not migrated. You will have to mark favorite templates again after migration.

  • After migrating data to Jira Cloud, you will have to use an access token to log in Capture for Jira. For information about access tokens, see Manage API tokens for your Atlassian account.

Support and troubleshooting
Anchor
support
support

Should you have any questions, please visit our Support Portal where you can search for an answer or contact our Customer Care team.