Last updated May 17, 2021

Rate this page:

Guidelines for Marketplace Partner migration documentation

As customers make the decision to move their Confluence or Jira core data from Data Center/server to cloud, it is important to give them information on migrating their app data. This page provides guidelines to Marketplace Partners who would like to do the following:

  • create and publish app data migration documentation for customers
  • surface a helpful URL to their app data migration documentation from within the Atlassian Cloud Migration Assistants

Atlassian does provide general recommendations to admins about what they should consider when migrating apps from server to cloud.

However, as each Marketplace Partner app is unique, we have made it possible for you to surface links in the Atlassian Cloud Migration Assistants to the URL of your choice, to point Confluence and Jira administrators to the migration documentation you've published.

Use the Marketplace APIs to surface 2 kinds of migration documentation in the app assessment tool of the Jira/Confluence Cloud Migration Assistant:

  • feature differences between your Data Center/server and cloud app, and
  • migration documentation that includes migration instructions

Things to consider before creating your migration documentation

  • Clear migration documentation avoids customer confusion
    If they can't see the relevant documentation, your customers may assume you have no way to migrate their on-premise data to a cloud app. Provide clear information on how to migrate app data to remove any confusion about the availablity of a migration path to cloud.

    Provide migration path documentation for your app regardless of whether your customers decide to use the Cloud Migration Assistants for app data migration.

  • Consider your customer's migration path options
    There may be multiple migration path options available to customers depending on how your app's migration path works, and the decision your customer makes to handle app data migration.
    Think about the use cases below while you create your migration documentation, to see which ones are applicable to your app.

    • The customer wants to automatically migrate app data using Atlassian’s Cloud Migration Assistant (CMA).
    • App data can be migrated with core data. For certain apps, a separate app data migration may not be required as the app data migrates along with the core Confluence/Jira product data. If your app enables such a migration, you must surface this capability to your customer in the Cloud Migration Assistant.
    • The customer partially migrates app data using the Cloud Migration Assistant.
    • The customer has no app data to be migrated.
    • The customer prefers to manually migrate their app data.

What to include in your migration documentation

Rate this page: