Plan your Cloud migration
Documents to help you prepare to migrate your Atlassian Server products.
Assess apps with the Jira Cloud Migration Assistant
Prevent migration failure by upgrading to Jira Cloud Migration Assistant 1.7.3 or higher
We are ending support for all older versions of Jira Cloud Migration Assistant.
You won’t be able to use the following versions:
Jira Cloud Migration Assistant 1.7.1 and lower
We are improving our migration tooling and expanding their existing capabilities. For a smoother and more stable migration experience, we recommend upgrading to the latest version of Jira Cloud Migration assistant within six weeks of it release.
Learn more about this announcement and how to upgrade.
For any further details or technical concerns, contact us.
This page shows you how to assess your apps before testing and running your migration. During this process you can streamline your decision making process about whether the apps you have installed in server are needed cloud, or whether you prefer to choose and install an alternative app for cloud.
Perform Cloud app security assessments with your Marketplace Partners
If you have critical data managed by apps on your Server, be sure to check with the Marketplace Partner (app vendor) about the best process to migrate that data.
The Cloud Migration Assistant does not perform a security assessment for app data migration to Cloud. It is important that you check with individual Marketplace Partners about whether their Cloud apps meet your security, legal and regulatory standards.
Begin assessing your apps
On the ‘Migration Assistant home’ screen, select Assess your apps.
This takes you to the ‘Assess your apps’ screen where you can see all the apps you have installed on your server.
Understand the ‘Assess your apps’ screen
The ‘Assess your apps' screen can be complex if you're new to migrating apps. The sections that follow explains the symbols and terms within the columns on this screen.
Columns
User installed apps: Lists all the apps installed on your server application.
Status: Displays the current status of the app. Details about the options in this column are given in the table that follows.
Exists in cloud: Displays whether a cloud version of the app is available. Details about the options in this column are given in the table that follows.
Can be migrated: Displays whether a migration path exists for the app data to be migrated to cloud. Details about the options in this column are given in the table that follows.
Privacy & Security: Displays links to the privacy and security information in Atlassian Marketplace for each app.
App usage: Displays links to app’s usage information in the App usage for Jira plug-in. This column only appears if App Usage for Jira is installed and enabled. Learn more
Notes: Allows you to add notes related alongside each app row.
Understand the ‘Status’ column
The options in this column allow you to assign a status to each app based on how you want to proceed the migration for the app.
The Jira Cloud Migration Assistant also allows you to return to the ‘Assess your apps’ screen and change the status you have assigned to an app.
Status options | Description |
|---|---|
No decision made | Each app in the table will start in this state. If you're unsure or haven't yet made a decision, you can leave an app in this state until you're ready. If you leave an app in this state and continue, the assistant won't move it forward for migration. |
Needed in cloud | You can use this status when you know you need to migrate an app and its data to a cloud instance. |
Not needed in cloud | You can use this status, if an app doesn't need to be migrated to your cloud instance. This could be because:
During your audit, you should get an idea from your end-users if an app is useful and necessary. You can look at columns in the table such as appears on and viewed by, to get an idea of what the usage is. |
Use alternative | Not every Marketplace Partner (previously known as app vendor) with a server app available on the Atlassian Marketplace has created a cloud version, or your requirements around a particular functionality may shift. In these cases, you may wish to use a different app in cloud, than the one you have installed on your server. Assigning this status to an app will allow you to select an alternative app later in the flow. Read more about using alternative apps towards the end of this page. |
Understand the ‘Exists in cloud’ column
This column shows you if the Marketplace Partner has built a cloud version of the app installed on your server.
Status options | Description |
|---|---|
Symbol: The green tick indicates that a cloud version of the app exists. View differences: This text link takes you to the relevant Marketplace Partner (app vendor) page where you can review the differences between the cloud and server version of the app. | |
Symbol: The green tick indicates that a cloud version of the app exists. View listing: This text link takes you to app listing on Atlassian Marketplace. | |
Symbol: The grey question mark indicates that Jira Cloud Migration Assistant cannot retrieve information from the server app about whether a cloud app exists. This is most likely due to technical reasons. Contact vendor: This text link takes you to the Marketplace Partner support page where you can contact them directly regarding the availability of a cloud app. | |
Symbol: The red cross indicates that a cloud version of the app does not exist. |
Understand the ‘Can be migrated’ column
This column displays whether the Marketplace Partner (app vendor) has a migration path that customers can use to migrate their app data from server to cloud.
Status options | Description |
|---|---|
This status is for apps in Stage 1. Symbol: The grey tick indicates that you can migrate this app to cloud using an automated path that the Marketplace Partner (app vendor) has built with the Jira Cloud Migration Assistant. Note that apps in Stage 1 have unknown or demonstrated low migration success rates. If you choose to migrate Stage 1 apps and the app data migration fails, you will need to contact the respective Marketplace Partner (app vendor) for support. Automated path: This text link takes you to the respective Marketplace Partner documentation to read about their available automated migration path.
| |
This status is for apps in Stage 2. Symbol: The green tick indicates that you can migrate this app to cloud using an automated path that the Marketplace Partner (app vendor) has built with the Jira Cloud Migration Assistant. Apps in Stage 2 have demonstrated high migration success rates. Automated path: This text link takes you to the respective Marketplace Partner documentation to read about their available automated migration path. | |
This status is for Install-only apps. Symbol: The green tick indicates that you can migrate this app to cloud. However, since this is an install-only app, you will only need to install the cloud version of the app using the Jira Cloud Migration Assistant. Data of these apps is embedded in ‘core product data’ like projects and issues, which is migrated when the ‘core product data’ is migrated. Automated path: This text link takes you to the respective Marketplace Partner migration documentation. | |
Symbol: The grey tick indicates that you can migrate this app to cloud using a migration path developed by the Marketplace Partner, and not using the Jira Cloud Migration Assistant. View path: This text link takes you to the Marketplace Partner’s migration instructions. | |
Symbol: This symbol indicates that although this app has an equivalent cloud app, you are using a server app version that is not compatible with the Jira Cloud Migration Assistant (JCMA).
Upgrade app: This text link takes you to upgrade options in the ‘Manage your apps’ section within your server instance. | |
Symbol: This symbol indicates that although the app has an equivalent cloud app, the Marketplace Partner probably has not yet built a migration path to migrate your app data to their cloud app. Note: This status can also appear if the Jira Cloud Migration Assistant is unable to retrieve information from the server app for technical reasons. The Contact vendor label links you to the support section of the Marketplace Partner listing. | |
Symbol: The red cross indicates that a cloud version of the app does not exist. This means that you cannot migrate your app data to cloud for this app, until the Marketplace Partner builds a cloud app and migration path. |
Use app alternatives
If you have assigned the Use alternative status to any of your apps in the Status column, you can select the app alternatives you need on the next screen.
If you no longer need an app on your cloud instance, go back a screen and change the status to Not needed in cloud. This removes the app from the list of apps that will require an alternative.
Learn more about alternatives to your existing apps
Inform your Marketplace Partners
After completing your app assessment in the Cloud Migration Assistant, the next important step is to inform individual Marketplace Partners/app vendors of your migration decision. More specifically, ensure that you have contacted the Marketplace Partners of all the apps that you’ve marked as ‘Needed in Cloud’ in the Assess your apps screen of the Cloud Migration Assistant.
Informing Marketplace Partners early about your intention to migrate their app helps them understand, plan, schedule, and prepare for the size and complexity of your app migration.
Provide the Marketplace Partner with:
your planned migration schedule (including updates about changes to your migration plans)
security considerations
the level of support you require, and
any other app specifics that would be valuable for them to know before you continue to install, test, and migrate the app to Cloud.
The migration of app data is highly dependent on the Marketplace Partner (vendors/app developers) of each app, as they will need to provide a migration path to move app data to the cloud. We recommend you work with Marketplace Partners of the apps you intend to migrate to review their documentation and determine the best way to migrate each app.
Apps do not need to be disabled or uninstalled from Server before migrating. If your apps are still active when the migration occurs, the migration will still be successful.
Learn more in the Cloud migration guide
Frequently asked questions
This section provides information about problems you may experience when migrating app data using the Cloud Migration Assistant.
If you’re not able to fix the problem using this page, contact the Atlassian Support team.
For a quicker response from the support team:
share your Support Zip file. Learn how to create a Support ZIP file
provide as much context as possible in your request
Pre-migration issues
Problem: Your server app is unavailable in cloud
Likely cause: Your Marketplace Partner/app vendor has either not developed a Cloud app, or does not have a migration path to move your Server app data to Cloud.
If you’re on the ‘Asses your apps’ screen of the Jira or Confluence Cloud Migration Assistant:
the ‘Exists in cloud’ column will display a red cross if your server app does not have a Cloud app version available
the ‘Can be migrated’ column will display a red cross if your Marketplace Partner has not built a path to migrate their app data to Cloud
Marketplace Partners may choose not to build a cloud version of their Data Center and Server apps because:
the app may not be technically feasible for Cloud
the app’s features are now native features in the Atlassian Cloud platform
the Marketplace Partner has made a business decision to not build a Cloud app
Solution: Learn more about apps with migration paths
Who to contact for support: The app vendor / Marketplace Partner
More information: Learn more about alternatives to your existing apps
Problem: You server app version does not support migration using the Cloud Migration Assistant
Likely cause: The Cloud Migration Assistant may display an ‘Upgrade app’ warning in the ‘Can be migrated’ column of the Assess your apps screen. This means that you will need to upgrade your Server app to the version supported by the Cloud Migration Assistant.
Solution: Contact your app vendor / Marketplace Partner to identify the server app version that supports app migration using the Cloud Migration Assistant. Next, install the supported version of the server app, and then perform the app assessment again.
Was this helpful?