• Products
  • Documentation
  • Resources

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.

screenshot-JCMA-home-Assess-your-apps-highlight
screenshot_JCMA-assess-your-apps

 

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:

  • it's already installed on an existing cloud site 

  • there is native functionality in cloud that replaces the need for the app, or 

  • your end users are not engaging with the app on server, and you see no need for it to be migrated.   

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

screenshot_view-differences

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.

screenshot_view-listing

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.

screenshot_contact-vendor

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.

screenshot_red-cross

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

screenshot_stage1-app

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.

 

screenshot_stage2-app

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.

screenshot_automated-path-linked

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.

screenshot_view-path-greytick

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.

screenshot_upgrade-path

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).

Recommended action:

  • You will need to upgrade to a server app version that supports JCMA.

  • After you have upgraded to a supported server app version, you must redo this app assessment. At that point, the Upgrade app status of this column should change to Automated path.

Upgrade app: This text link takes you to upgrade options in the ‘Manage your apps’ section within your server instance.

screenshot_contact-vendor

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.

screenshot_red-cross

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.

screenshot_use-alternative-screen1
screenshot_use-alternative-screen2

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.

Last modified on Sep 23, 2021
Cached at 1:43 AM on Oct 16, 2021 |

Additional Help