Troubleshooting Server/Data Center migration issue for HTML for Confluence app stuck at 0%

Issue Description

Migrating Confluence from a server or data center to the Cloud can be complex, particularly when the migration stalls at 0%. Here’s a detailed guide to resolving this issue using the Confluence Cloud Migration Assistant (CCMA).

Solution

Follow the steps below to troubleshoot the migration issues.

Pre-migration checks

Pre-migration steps: Ensure all pre-migration steps are completed. This includes preparing the environment and validating the prerequisites.

Handling large data loads: If the pre-migration stalls, especially with large data loads, consider updating the database as a workaround. Execute the recommended queries and reindex Confluence to resolve potential stalling issues.

Macro update status: If the macro update status does not reflect the changes, you need to disable and re-enable the HTML for confluence and verify the status again.

Migration preparation

Update CCMA: You must ensure the Confluence Cloud Migration Assistant is up-to-date before migrating.

Install the ‘HTML for Confluence’ app: Ensure that the HTML for Confluence app is installed on the cloud instance.

Warnings and errors: Address all warnings and errors during the preparation phase to ensure a smooth migration.

Migration

Stalled Migration at 0%

If the migration appears stuck at 0% on the Migration Assistance page, perform the following checks:

• Data verification: Compare the data between the server and cloud instances using HTML data to confirm if the migration is progressing despite the UI showing 0%.

• Profile configuration: Ensure that profiles are migrated and configured correctly on the global configuration page.

Macro Usage verification

You must check the macro usage on the server and cloud to confirm data migration, even if the UI shows 0%. To learn about macro usage, log in as Confluence Admin > Settings > Administration > Macro usage. Another way is to use the Advanced Search option in Confluence to find the pages where the particular macro is used.

Handling Specific Issues

No profile configured: If profiles are not configured in the Data Center, you must perform a migration specifically for the HTML for Confluence app data. Reinstall the app on the Cloud and migrate only the app without migrating the spaces again.

Persistent issues: If issues persist despite following these steps, contact the support team. Provide them with debug logs and a screenshot of the migration page for further assistance.