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

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.

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

Read our docs to find 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 to understand, plan, schedule and prepare for the size and complexity of your app migration.

Provide the Marketplace Partner with your planned migration schedule, 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.

 

Frequently asked questions

This section provides information about problems you may experience when migrating app data using the Cloud Migration Assistant.

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: Read our docs for information about whether your app has built or intends to build a Cloud app and migration path to Cloud.

Who to contact for support: The app vendor / Marketplace Partner

More information: Read our docs for a list of alternatives to your existing Jira Marketplace 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.

 

Additional Help