Migration from Confluence Server/Data Center to Confluence Cloud

This guide includes steps that require some technical knowledge. If possible, we recommend you try the migration process in a staging system first. 

Please, contact us if you run into problems with the migration or have any questions. You can raise a support request and we will assist you.

Preconditions

The Subspace Navigation for Confluence app has to be installed and licensed in Confluence Cloud.

Migrate the Navigation configuration

Extract data from Confluence Server/Data Center

To migrate the navigation structure, first you should extract the Subspace configuration data from the database of your Confluence Server/Data Center instance.

The following query should be used. Note that it is written for a PostgreSQL database and should be adjusted for other databases.

SELECT bandanavalue FROM BANDANA WHERE BANDANAKEY = 'de.communardo.confluence.plugins.subspace.navigationstructure';


The data should be transformed into the correct format before migrating it to cloud. Copy the value you got from executing the query to a text editor of your choice and follow the steps below:

  • Remove <string> and </string>
  • Replace &quot; with a normal double quote character (")
  • Decode unicode entities present in the data. For this step you can use an online tool. (Example: Decode/Unescape Unicode Entities)

Example of the Subspace configuration data transformed in the correct format for migration to cloud:

[{"title":"Metadata","link":"327693","type":"internallink","id":"d764d033-5887-411a-b88f-6a31caa04a97","permitted":true,"attributes":{"alternativetitle":"Metadata"},"children":[]},{"title":"test space","link":"TS","type":"space","id":"3203407d-6773-48e6-a8d3-3a3d45805bbc","permitted":true,"attributes":{"alternativetitle":""},"children":[]},{"title":"Subspace navigation for Confluence","link":"","type":"folder","id":"326b1311-e549-432e-a31a-4f7fc84ddaea","permitted":true,"attributes":{},"children":[{"title":"Documentation","link":"https://support.communardo.de/display/cssp","type":"externallink","id":"b644ba37-5fa0-47b6-b15c-3d7f14c218f8","permitted":true,"attributes":{},"children":[]}]},{"title":"Personal","link":"space = DEV","type":"cql","id":"ae4c09bb-2858-44bc-a0a2-62e3049d5a84","permitted":true,"attributes":{},"children":[]}]

Migrate data to Confluence Cloud

Now that we have prepared the data, we are ready to continue with the migration process: 

  • On your cloud instance, go to the space with key "COMMUNARDOPRODUCTS" and find the page titled "Navigation Configuration" within this space.
  • Edit the page, you will see a Page Properties hidden macro. Save the transformed configuration data inside this macro.
  • Save the page and the Subspace configuration will have been migrated to your confluence cloud instance.

Known Limitations

Internal links in the Navigation Structure

Internal links might not be successfully migrated. This is a known issue and you need to manually edit your navigation and include the internal links.


We are working on improving this migration process, to reduce the number of manual steps. Watch our app to get notified of future releases.

(To add yourself as a watcher, visit the app's page in the Atlassian Marketplace. Click the link "Watch app" on the right under "Resources".)



Back to Top

Page Content