Last updated Nov 20, 2023

How app assessment works

Customers use the Assess your apps screen in the Cloud Migration Assistant (CMA) to choose the apps they're migrating to cloud. Once they've assessed an app, they use the menu in the Status column to mark whether the app is needed in cloud.

Here's an example from the Confluence version of the migration assistant (for a comprehensive walkthrough, check out Assess and migrate apps with the Cloud Migration Assistant):

Assess your apps screen

You can help customers choose your app by ensuring that the information in the Exists in cloud and Can be migrated columns is accurate.

Exists in cloud column

When a cloud version of your app is listed on the Marketplace, the Exists in cloud column of the assessment table displays a green check icon. A link below the icon lets customers visit your documentation to learn about feature differences between your server and cloud app.

To display a link to your feature difference documentation, use the Marketplace Migrations REST API to submit a value for the featureDifferenceDocumentation parameter. When you don't provide a value, the CMA displays links to your cloud app listing on the Marketplace.

This table summarizes possible values for the Exists in cloud column:

ValueDisplayed when

A server and cloud version of your server app are listed on the Marketplace.

You've used the Marketplace REST API to provide a URL to your feature difference documentation.

A server and cloud version of your server app are listed on the Marketplace.

You haven't provided a URL for feature difference documentation, so the CMA displays a link to the overview tab of your cloud app's listing instead.

A server and cloud version of your server app are listed on the Marketplace.

You haven't used the API to provide any migration info for your app, so the CMA displays a link to the support tab of your cloud app's listing.

Either your server app or cloud app is not listed on the Marketplace.

Can be migrated column

The Can be migrated column of the assessment table lets customers know whether they can automatically migrate your app using the CMA. Customers can only migrate apps using the CMA when:

  • you implement an automated migration path via the platform or declare that your app doesn't need to migrate app data to the cloud (an "install-only" migration)
  • the installed version of your server app is compatible with the CMA

Most values also include a link so that customers can learn more about your migration path.

To ensure that the info in this column is accurate, use the Marketplace Migrations REST API to declare:

  • the type of migration path your cloud app supports — automated, install-only, or manual
  • the versions of your server/data center app that are compatible with migration using the CMA
  • links to your
    • migration documentation
    • migration roadmap

To learn more about these these values and how to declare them using the Migrations API, check out Manage your app info.

The following table summarizes possible values for the Can be migrated column:

ValueDisplayed when

You have declared your migration path type as AUTOMATED.

The installed version of the server/data center app meets the CMA compatibility requirements you declared using the Migrations API.

Your automated path is rated stage 2 based on its high rate of migration success (for details, see Migration success ratings).

(Automated path links to your migration documentation.)

You have declared your migration path type as AUTOMATED.

The installed version of the server/data center app meets the CMA compatibility requirements you declared.

Your automated path is rated stage 1 based on its low or unproven rate of migration success (for details, see Migration success ratings).

(Automated path links to your migration documentation.)

You have declared your migration path type as AUTOMATED, but the installed version of your server app doesn't satisfy the CMA compatibility requirements you declared.

The customer must upgrade the server app before migrating using the CMA.

(Upgrade app links to the Universal Plugin Manager.)

You have declared your migration path type as INSTALL-ONLY, indicating that your app only requires access to core product data and doesn't need to migrate its own app data. As a result, customers can migrate your app automatically via the CMA.

(Automated path links to your migration documentation.)

Customers can't use the CMA to migrate their app data, because you have declared a MANUAL migration path.

This value also displays when you have provided a link to migration documentation but haven't declared CMA compatibility info for your server/data center app.

(View path links to your migration documentation.)

You have provided a link to your migration roadmap, but you haven't declared a migration path type for your cloud app or CMA compatibility info for your server/data center app.

(Track request links to your migration roadmap.)

You haven't declared any migration info via the Migrations API, or the app migration platform isn't able to find your server/data center or cloud app on the Marketplace.

(Contact vendor links to the support tab in the Marketplace listing for your app.)

Your server/data center and cloud app are listed on the Marketplace, but you declared your migration path as DISCARDED and haven't provided a link to your migration roadmap.

Rate this page: