This page will guide you through your LucidChart migration. We start with a few basic settings and recommendations before we actually perform the switch to draw.io. The guide is sequential, so just go through it step by step.
Migrating from LucidChart to draw.io is fairly easy; you can switch with one mouse click. However, we do recommend that you take care of a few things in advance in order to save time and so the converter can run smoothly.
1.1 We highly recommend that you perform the mass import on a test instance first
LucidChart diagrams with custom shapes or non-standard formatting may not convert to draw.io diagrams correctly at first. This is fixable, don’t worry, but migration on a test instance is always best (follow Atlassian's instructions to create a test instance from your production instance).
1.2 Re-index Confluence so all LucidChart diagrams can be found
In order to avoid partial or failed conversions, please rebuild the search index (see Atlassian documentation) so the converter can find all LucidChart diagrams later on.
1.3 Check if you have the latest version of draw.io
If you already have a staging environment and have tested draw.io before, please make sure to update draw.io to the latest version before you start the migration.
1.4 Do you have full permission to access all LucidChart diagram pages?
The administrator that carries out the LucidChart mass import must have write-permission for every Confluence page containing a LucidChart diagram. Otherwise, the mass importer won't be able to save the draw.io diagram to that page.
If no such user exists, you will need to temporarily promote a user to administrator status in order to have those permissions during the import.
2. Import Test
2.1 Install the draw.io app
Firstly, access the general configuration area of your Confluence administration panel and install the draw.io app in the Atlassian Marketplace section. After installation, apply the 30-day trial license and select Configuration, which you will find under in the navigation panel under draw.io add-on. Then, click LucidChart import on the draw.io configuration page.
If you've already purchased draw.io for Confluence Server, use your license key together with your Confluence developer license.
2.2 Import the LucidChart diagrams
Click on the Start Import button to import all of the LucidChart diagrams in your instance. The duration of the import depends on the number and the complexity of the existing diagrams, and doesn't normally take longer than a few minutes. With just one click, all of your LucidChart diagrams within a Confluence instance can be imported into draw.io.
Important! During the import your browser needs to be open all the time and your computer will not switch to sleep mode!
2.3 Copy/paste the report
Wait until the import has finished, and have a look at the web report. Use the report to see whether all diagrams were converted successfully, and which diagrams were unable to be imported.
Things didn't go as planned? No problem, we just need to adjust the script. Just copy the web report and contact us - we will take care of everything else.
Run the LucidCHart importer again for individual diagrams
If there are only a few LucidChart diagrams that haven’t been converted the way they should, you can take a shortcut to run the mass importer again. Of course this only applies if we enhanced the mass importer after you contacted us and issued a new version of draw.io. After you updated draw.io, just open the Confluence pages that contain the specific LucidChart diagrams, go to the attachment section and delete the comment convertedtodrawiofrom the attached LucidChart diagram. After removing the comment, you can run the converter another time.
3. Live Migration
3.1 Outside of working hours
If the report didn’t show any issues with complex LucidChart diagrams you can perform the conversion on your live instance. We recommend that you perform the conversion outside of your company's normal Confluence usage hours. It is possible during normal working hours, but it's best to carry out the whole operation whilst the minimum number of changes are being made to the relevant pages.
3.2 Remove LucidChart license
The recommendation of removing the LucidChart license is so that users do not start editing LucidChart diagrams while the process is running, effectively making LucidChart diagrams read-only. It is worthwhile communicating with users that you are carrying out the migration, and when you expect to start the process.