General App Documentation
Breadcrumbs

Migrate Communardo apps to Cloud with the Cloud Migration Assistant

https://communardo.atlassian.net/wiki/s/626371833/6452/634cf7c37efa7b4eab54b193b5c882fc93d0b2af/_/images/icons/emoticons/information.png General notes:

  • This document is to give you additional information specific to migrating Communardo apps.

  • All Communardo apps that are Cloud-ready (consult our list) have an automated app data migration path.

  • Migrating from Server to Data Center? Consult Migrate Communardo apps to DC.


🛠️ Atlassian Tools:


Cloud Migration Assistant: Process to migrate apps

App Assessment

Mark all Communardo apps available in the cloud as "Needed in cloud" and tap "Continue.”

Notes on Viewtracker - Analytics for Confluence

The app Viewtracker - Analytics for Confluence has separate modules listed separately. Please select “Viewtracker” as “Needed in cloud” and mark the others as “Not needed in cloud”. See Migrate Viewtracker - Analytics for Confluence to Cloud for all details.

Note:We recommend updating Viewtracker to the latest version for your Confluence prior to the migration. For versions earlier than Viewtracker Version 8.4.0, the migration requirements differ. If you are unable to update to a new version, please contact our support team for more information about the process.

Notes on "bitvoodoo Registration for Confluence"

If your company ever used a free Communardo app, chances are that the app “bitvoodoo Registration for Confluence” is still listed in the “Manage Apps” list. This app is not necessary for Communardos Cloud-ready apps. You can safely delete the app or mark it as “Not needed in cloud”.


image-20240305-124817.png


Make sure you have installed all selected Communardo apps in your Cloud instance. Tap "Continue".

image2021-4-21_12-3-3.png

Agree to the app migration and tap "Continue".


image-20240305-125053.png


Migration Process

Under "Users and Groups", select "Only users related to the selected spaces" to avoid migrating too many users.

2021-04-21_11-43-17-20210713-072944.png


Under "Apps", select "All".

image2021-4-21_11-49-44.png


Check for errors. If everything looks fine, tap "Continue".

image2021-4-21_12-7-11.png


Review all settings. If everything looks fine, tap "Run now".

image2021-4-21_12-14-38.png


If everything went well, you will be presented with this success screen:

image2021-4-21_12-19-42.png



The migration is complete. Pat yourself on the back!

We hope the app migration for the Communardo apps was a complete success. If you encounter any problem, please read below and contact us if the content is not displayed as expected.


Error in the migration process

Some customers have encountered the error message “Migration has failed as the migration path of this app could not be determined” during the migration process of the Commuanrdo apps Navitabs and Translations for Confluence.

2022-06-27_11-55-09-20220627-095724.png

We don’t know why Atlassian will sometimes display this error. Navitabs and Translations macros are all stored within the Confluence content and are, therefore, migrated with the normal content migration.
If you encounter the error above, please check the content on various migrated pages containing Navitabs or Translations macros. The content should appear as you'd expect.

  • If the macro content is displayed, you can safely ignore the error message.

  • If this is not the case, please create a support ticket.


Search Analytics and Attachment Tracking

The apps “Search Analytics” and “Attachment Tracking” are bundled with Viewtracker - Analytics for Confluence. You can ignore the two apps in the migration process and simply select Viewtracker.

⚠️ However, please note that search queries will not be migrated to the Cloud. Please consider exporting and saving this information as a CSV for future reference. We are working on a solution to migrate this data in the future.

Please refer to the Viewtracker migration guide for all details.


Specific migration paths of Communardo apps

We have additional migration information for each Communardo app that is cloud-ready: