Last updated Jun 13, 2023

Rate this page:

Understanding app assessment

To make a decision about migrating their current Marketplace Partner apps to cloud, your customers use the following Assess your apps screen in the Cloud Migration Assistant (CMA).

Assess your apps screen

Customers can only migrate app data automatically using the Cloud Migration Assistant (CMA) when you've developed an automated migration path using the App migration platform, and marked your app versions to be compatible with the Cloud Migration Assistant on Atlassian Marketplace.

Status combinations

Statuses appear under the Exists in cloud and Can be migrated columns. These inform customers about your cloud app availability, migration path and documentation.

Possible combinations of these statuses are listed in the table below, along with suggested solutions to accurately surface your app's status in the CMA. To learn where each status links to, see Status links below.

ColumnAssessment criteria & suggested action
Exists in cloudCan be migrated
This combination shows if:
  • You have a cloud app listing in Marketplace
  • Your customers can migrate data to your cloud app
  • Your customers can use the CMA to migrate data to your cloud app
  • You have linked to your migration instructions documentation
  • Your app is placed in Stage 1 based on its migration success rate

  • Note, if you haven't linked to your feature differences documentation, the View differences label links to your Marketplace listing instead. To link your feature differences documentation, use the Marketplace API endpoint’s featureDifferenceDocumentation parameter.

    This combination shows if:
  • You have a cloud app listing in Marketplace
  • Your customers can migrate data to your cloud app
  • Your customers can use the CMA to migrate data to your cloud app
  • You have linked to your migration instructions documentation
  • Your app is placed in Stage 2 based on its migration success rate

  • Note, if you haven't linked to your feature differences documentation, the View differences label links to your Marketplace listing instead. To link your feature differencesdocumentation, use the Marketplace API endpoint’s featureDifferenceDocumentation parameter.

    This combination shows if:
  • You have a cloud app listing in Marketplace
  • Your customers can migrate data to your cloud app
  • Your customers only need to use the CMA to install the cloud app, and app data migration occurs with core product migration.
  • You have linked to your migration instructions documentation

  • Note, if you haven't linked to your feature differences documentation, the View differences label links to your Marketplace listing instead. To link your feature differences documentation, use the Marketplace API endpoint’s featureDifferenceDocumentation parameter.

    This combination shows if:
  • You have a cloud app listing in Marketplace
  • Your customers can migrate data to your cloud app
  • Your customers can use the CMA to migrate data to your cloud app
  • You haven't linked to your migration instructions documentation

  • Note, if you haven't linked to your feature differences documentation, the View differences label links to your Marketplace listing instead. To link your feature differences documentation, use the Marketplace API endpoint’s featureDifferenceDocumentation parameter.

    Recommended action:
  • Surface links to your migration instructions documentation using the Marketplace API endpoint's migrationDocumentation parameter.
  • This combination shows if:
  • You have a cloud app listing in Marketplace
  • Your customers can migrate data to your cloud app
  • Your customers can't use the CMA to migrate data to your cloud app
  • You have linked to your migration instructions documentation

  • Note, if you haven't linked to your feature differences documentation, the View differences label links to your Marketplace listing instead. To link your feature differences documentation, use the Marketplace API endpoint’s featureDifferenceDocumentation parameter.

    Recommended action:
  • Use the Marketplace API endpoint’s cloudMigrationAssistantCompatibility parameter to allow the CMA to change the status from View path to Automated path when applicable.
  • Surface links to your migration instructions documentation using the Marketplace API endpoint's migrationDocumentation parameter.
  • This combination shows if:
  • You have a cloud app listing in Marketplace
  • Your customers can migrate data to your cloud app
  • Your customer is using a server app version that is not compatible with the CMA. The customer must upgrade to a server app version that supports the CMA

  • Note, if you haven't linked to your feature differences documentation, the View differences label links to your Marketplace listing instead. To link your feature differences documentation, use the Marketplace API endpoint’s featureDifferenceDocumentation parameter.

    Recommended action:
  • Use the Marketplace API endpoint’s cloudMigrationAssistantCompatibility parameter to allow the CMA to identify if the customer is using a server app version that supports the CMA. The Upgrade app status is displayed if the customer's server app isn't compatible with the CMA and needs upgrade. The status will change from Upgrade app to Automated path when the customer upgrades their app version.
  • Surface links to your migration instructions documentation using the Marketplace API endpoint's migrationDocumentation parameter. Note, the CMA won't surface your migration instructions documentation if customers aren't using a CMA-supported server app version.
  • This combination shows if:
  • You have a cloud app listing in Marketplace
  • Your customers can't migrate data to your cloud app

  • Note, if you haven't linked to your feature differences documentation, the View differences label links to your Marketplace listing instead. To link your feature differences documentation, use the Marketplace API endpoint’s featureDifferenceDocumentation parameter.

    Recommended action:
    Provide key dates and/or roadmaps in your support section documentation of your Marketplace listing that informs customers about the availability of your app data migration path.
    This combination shows if your app does not exist in cloud, and hence customers cannot migrate their app data to cloud.
    This combination shows if the CMA can't retrieve information from the server app due to technical reasons.

    Each status links your customers to documentation or support:

    • View differences links to your feature differences documentation (or, if you haven't linked to this documentation, your Marketplace listing).
    • Automated path links to your documentation about migrating app data using the App migration platform.
    • View path links to your documentation that explains your migration workaround instructions that does not use the CMA.
    • Upgrade app label links to upgrade options in the ‘Manage your apps’ section within their server instance.
    • Contact vendor links customers to your support section.

    Rate this page: