Migrating TeamRhythm with JCMA
Easy Agile TeamRhythm data migrates with the Jira Cloud Migration Assistant (JCMA).
If you're migrating from an on-premise (Server or Data Center) Jira site to Cloud, Atlassian recommends using JCMA.
When Easy Agile TeamRhythm is included in a JCMA migration, app data for migrated Jira projects (including Saved Views, Issue Hierarchy and Card Configuration) will automatically be migrated.
Migrating to Cloud? Learn more about how Easy Agile keeps your data secure here.
Pre-requisites
To include Easy Agile TeamRhythm in a JCMA migration, you’ll need:
Easy Agile TeamRhythm updated to the latest version on the origin Server / Data Center site
Easy Agile TeamRhythm installed on the destination Cloud site
Expired app license on Jira Server? You can still download the latest (Data Center) version of the app from the Atlassian Marketplace, and upload this to your Jira Server site.
The app will show an “Unlicensed” page when using a version your license does not include access to. However, the JCMA integration will still work without an eligible license.
How does it work?
Update the Easy Agile TeamRhythm and JCMA apps to the latest version.
Using earlier versions reduces the chance of a successful migration.
Easy Agile TeamRhythm versions prior to v9.1.0 do not migrate Retrospective data.
During the Assess your apps stage, select “Needed in Cloud” for Easy Agile TeamRhythm.
Follow the steps on how to use the Jira Cloud Migration Assistant to migrate data to your Cloud instance.
App data associated with your migrated Jira data will be migrated as one of the last steps in the JCMA migration.
When running a JCMA migration, you’ll choose which Jira projects will be migrated. Easy Agile TeamRhythm will migrate all app data associated with the Jira data that is now on the Jira Cloud site.
For example, Retrospectives will be migrated when the Jira board they were created on have been migrated.
When an additional level of hierarchy is configured for the User Story Map on a migrated Jira board, it can only be migrated when the other Project selected in that hierarchy has also been migrated.
Limitations
JCMA currently does not support migrating references to Quick Filters.
Retrospective data can be only migrated to Jira Cloud with Easy Agile TeamRhythm app v9.1.0 or higher on installed on the origin Jira Server or Jira Data Center site at the time of the JCMA migration.
App data cannot be migrated if the associated Jira data is not found on the destination Jira Cloud site.
As of 18 Jan 2024, customers have been able to initiate a cancellation of an app migration with version 1.10.10 of JCMA. This is currently not supported by Easy Agile TeamRhythm.
Staged migrations
If you are planning a staged migration, we recommend enabling Easy Agile TeamRhythm for all migrations. This allows it to migrate the app data associated with the Jira projects in each migration. The app does not need a separate migration.
It’s safe to include Easy Agile TeamRhythm in every migration. It will not create duplicates, and will automatically skip already-migrated data.
Easy Agile TeamRhythm will migrate app data associated with any Jira data now on the destination Jira Cloud site. This includes Jira data/boards migrated in the current or previous migrations.
Troubleshooting a TeamRhythm JCMA migration
Check what version of Easy Agile TeamRhythm was installed on the origin Jira Server / Data Center site during the migration. If you’re not using the latest version, this may cause problems with the migration.
App migration logs on Cloud
You can review the results of a migration of Easy Agile TeamRhythm data on the destination Jira Cloud site. This is available for Jira Administrators by navigating to:
Jira Cloud’s global settings → “Manage Apps”
Then, in the left navigation pane under “Easy Agile TeamRhythm” → “Migration Assistant”
Here, you can view the list of ongoing and past JCMA migrations. Click on “View Log” to access detailed logs for each migration.
Our support team may ask for a copy of these logs while troubleshooting a migration.
We are here for you!
Our team is here to help with your JCMA migration. If you have any questions or concerns, please contact our support team!