Measuring app migration success in app assessment

This page explains how apps are presented to customers in stages on the Cloud Migration Assistant user interface, based on demonstrated app migration success rates.

Background

Atlassian is committed to offering customers a stable and predictable experience to migrate users and groups, Jira/Confluence data and app data. Customers can only migrate app data automatically using the Cloud Migration Assistants when a Marketplace Partner has:

• developed an automated migration path using the App migration platform, and
• marked their app versions to be compatible with the Cloud Migration Assistant on Atlassian Marketplace

How stages work

Atlassian continually monitors migration path success rates for apps that have built automated migration paths using the App migration platform. Based on their demonstrated migration success rate, apps are placed in the following stages:

• Stage 1: The Cloud Migration Assistant gives apps with new or experimental automated migration paths the ‘Stage 1’ label on the following screens:

  • 'Assess your apps' screen: Informs customers that apps in this stage have unknown or low migration success rates.
  • 'Check' screen: If customers have selected one or more ‘Stage 1’ apps for migration, this screen displays a preflight check message informing them that choosing ‘Stage 1’ apps can impact the outcome of their migration. We encourage customers to vigorously test migrations with ‘Stage 1’ apps before proceeding to a production run migration.

• Stage 2: The Cloud Migration Assistant gives apps with a demonstrated high migration success rate the ‘Stage 2’ label on the the following screens:

  • 'Assess your apps' screen: Informs customers that apps in this stage have demonstrated high migration success rates.
  • 'Check' screen: If customers have selected ‘Stage 2’ apps only for migration, this screen informs them that all selected apps have met the migration success criteria.

How to move your app from Stage 1 to Stage 2

If you are looking to have your app moved from ‘Stage 1’ to 'Stage 2', ensure that you have done the following:

• Implemented the Status API
• Written clear and actionable error messaging
• Investigated and fixed causes for migration failure

Getting support

Read more about channels you can use to get support.