Zephyr Squad Server-to-Cloud Migration Guides

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 start migrating their Jira instances and apps from Server to Cloud (or Data Center).

There are two approaches to migrating Zephyr data from Jira Server to Jira Cloud:

• Jira Cloud Migration Assistant (JCMA) – a primarily recommended application provided by Atlassian.

• Zephyr Migration Tool - an open-source tool offered by SmartBear which works with Jira Site Import and requires more technical steps.

We recommend using the JCMA as the primary migration method unless there are important limitations that forbid its use. Please note that no support is provided for customization of Zephyr Migration Tool.

The migration methods are mutually exclusive, it is not possible to combine them. You cannot use JCMA after a Jira site import or vice versa. Also, it is not possible to use JCMA for Jira data, and Zephyr Migration Tool for Zephyr Squad data.

At SmartBear, we are committed to facilitating a smooth transition for all our customers, so we have created the guides to help you migrate your instances and Zephyr app data. Please follow the links below to view the guides:

We offer automated tools only for Server to Cloud migrations. The following migrations are not supported:

• Merging multiple Server/DC instances into a single Cloud instance

  This is possible with the JCMA if project keys do not match. There may be other conflicts with duplicate data.

• Cloud to Cloud migrations

  Atlassian has not yet made it possible to migrate application data from Cloud to Cloud. The only option is to manually export and import the test cases via Excel. You can explore our API to migrate other Zephyr objects, such as Steps, and Cycles.

• Zephyr Squad to Zephyr Scale Cloud migrations

  In Server, it is possible to migrate Test Cases. Test cycles and executions can be recreated in Zephyr Scale using both Zephyr Squad/Scale APIs to read and write data from the source Jira project to the target Zephyr Scale project. To access the API documentation, click the link below:

  • Zephyr Scale: Zephyr Scale Server API (v1)
  • Zephyr Squad:Zephyr for JIRA API