Migrate LaTeX math formula from Confluence DC/Server to Cloud
If you have an LaTeX based app for math formula in Confluence Server or Data Center (DC), you can seamlessly migrate the data to cloud app LaTeX Math for Confluence - Math Formula & Equations
These apps are supported out of the box:
Mathjax by Keysight Technologies
These apps can be migrated following the migration process:
LaTeX and Mathjax by The Plugin People
LaTeX Math by Appfire
Other apps are also supported using advanced migration feature, please contact our support team 💌 support@narva.net for quick assessment.
Migration Steps
The migration process involves two steps.
Migrate Confluence DC/Server to Cloud
Migrate LaTeX based formula to our app LaTeX Math for Confluence
1. Migrate DC/Server to Confluence Cloud
You can use Atlassian Migration Assistant to migrate all data from DC/Server to Cloud. Atlassian has extensive documentation about this tool here: Confluence Cloud Migration Assistant
The important thing in this step is to NOT include LaTeX app in the migration. That is because these apps store data in the page itself and when a space is migrated, app data is also migrated to cloud.
You can mark these apps as 'Not needed in the cloud' on assessment window. Again, this is because macro data from these apps is part of the page where they are inserted and will be included in the parent space migration.
![Migration-Apps-Assessment-I.png](../__attachments/2487451649/Migration-Apps-Assessment-I.png?inst-v=638df6b5-1ae9-43fc-bf83-0f4f960e9937)
Migration to cloud app assessment
![Migration-Sellect-Apps.png](../__attachments/2487451649/Migration-Sellect-Apps.png?inst-v=638df6b5-1ae9-43fc-bf83-0f4f960e9937)
Migration to cloud app selection
These are the only important parameters in the migration process. Once migration is run, you can go to the cloud site, and it should display 'unknown macro' message in the pages where formula were included.
![Migration-unknown-macro.png](../__attachments/2487451649/Migration-unknown-macro.png?inst-v=638df6b5-1ae9-43fc-bf83-0f4f960e9937)
Confluence page migrated from DC/Server
This is expected as the apps are not included. You can now proceed to next step in the migration process.
2. Migrate LaTeX based formula to LaTeX Math for Confluence
You can migrate these formulas to LaTeX Math for Confluence using the built-in migration feature. This feature can also be used to migrate from another cloud app.
Install the app from Marketplace: LaTeX Math for Confluence - Math Formula & Equations
Go to Confluence Administration → LaTeX Math for Confluence → Migration from other apps
Select the source app and macro types to migrate them one by one
![Migration-from-other-apps.png](../__attachments/2487451649/Migration-from-other-apps.png?inst-v=638df6b5-1ae9-43fc-bf83-0f4f960e9937)
Migrate LaTeX formula to LaTeX Math for Confluence
You can find all the pages and spaces where formula are included in Confluence Administration → Data Management → Macro Usage
If you need any help before, during and after the migration, please feel free to reach out to us at 💌 support@narva.net