...
Migrating Confluence from a server or Data Center data center to the Cloud can sometimes be complex, particularly when the migration stalls at 0%. Here’s a detailed guide to troubleshooting and resolving this issue using the Confluence Cloud Migration Assistant (CCMA).
Solution
Steps 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.
...
| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Before proceeding with the migration process on the production emvironment, always perform migrationtest the process on the staging/test environment. If you face any issues then feel free to reach out to us by openingfurther issues, raise a ticket with us from appfire/supportour support team. |