Before migrating your HTML for Confluence app content from server to cloud, we recommend reading this Atlassian article to plan your migration.
This page explains:
- Migration process
- Differences between the server and cloud version of the app
On completion of migration from version 5.8.0:
All global configuration and profile data in the Configuration page are transferred from the server instance to the cloud instance as specified in the Cloud Migration Assistant wizard.
If multiple migrations are performed on the same cloud instance, the latest migration takes precedence.
Any subsequent migrations performed on the same cloud instance only adds or merges the data, but does not delete any existing data.
- Points to note about profile data migration:
- For profiles with distinct names on the server/DC and cloud instances, the profiles from both server/DC and cloud instances are combined and listed under Configuration > Profiles as-is.
For profiles with the same name in both server/DC and cloud instances, the profile configurations available on the server/DC overwrites the profile configuration on the cloud instance. Thus, only one copy of the profile configuration, taken from the server/DC, is available on the cloud, and the original configuration details on the cloud are overwritten.
Consider an example that if:
- Profiles in server/DC: A, B, and D
- Profiles in cloud: A (profile with the same name as in server, and has the same or different configuration), and X
After migration is completed, the Configuration page of the cloud instance now contains the A (with configuration details as in server/DC), B, D, and X profiles.
Administrators, installing the HTML for Confluence cloud app for the first time, can begin the installation and configuration process for both macros as given in the Installation and Configuration guides.
- The migration of data from server to cloud is an independent process from app installation or configuration in your cloud instance. We recommend that administrators verify that all your data is displayed properly after all processes are completed successfully. Please report any issues immediately after looking through the known problem list.
- We capture certain details, excluding private user data or any personally identifiable information, during the migration process to help us improve our app continually. Refer to Analytics guide to know more about the information that is collected.
For existing HTML macro content
Due to restrictions in the Confluence cloud, the HTML macro name was changed to HTML-bobswift causing HTML content display issues in pages and templates using the HTML macro of the HTML for Confluence app. For this purpose, an update process is now available in Migrate to Confluence Cloud on the HTML for Confluence Configuration page. This option allows you to initiate a process that automatically updates the macro name to prepare your HTML content for migration. Refer to this article for the HTML macro name update process instructions.
Administrators must run the HTML macro name update process before migrating content to cloud. Once the process is completed, the Confluence Migration Assistant must be run to migrate all content to Confluence cloud.
For XSLT macro
The migration process for this macro is quite straightforward. Administrators must use the Migration Assistant in the Confluence instance to start the migration.
Use the Confluence Cloud Migration Assistant app to migrate everything you need from Confluence server to Atlassian cloud. Confluence Cloud Migration Assistant explains in detail the step-by-step procedure to migrate the required content. As mentioned in the previous section, Atlassian does this job for you in most cases.
Differences between server and cloud versions
All the macros available in the server are supported in the cloud version as well. The following table lists the macros' parameters and features that work differently in server and cloud:
Please note that all the other parameters function the same in both the versions of the app.
If you experience any problems or behavior changes that are unexpected, refer to Help and open a ticket with us. This helps us identify and prioritize fixes and improvements.