Plan your server to cloud migration
Documents to help you prepare to migrate your Atlassian server products.
Assess apps with the Jira Cloud Migration Assistant
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.
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.
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. We've listed a breakdown (by column) of the symbols and terms on this screen.
There are 5 columns on this screen:
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.
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 next be prompted to select the app alternatives you need. See screenshots below.
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.
More information
For a simplified, step-by-step overview of app assessment and migration, see the assess and audit apps and integrations section on the Server to cloud migration guide.
Auditing apps on your server, assessing them and choosing alternative apps (if required) for your cloud site before migration removes the risk of your apps blocking your migration at a crucial time.
Was this helpful?