Migrate Security & Encryption Server to Security & Encryption Cloud

On this page:

This page outlines the steps to migrate your Security & Encryption data from Confluence Server or Data Center to Confluence Cloud. 

Prework

Before you start, read and understand the following information:

  • Understand the macro differences and feature differences between the Security and Encryption for Confluence Server and Confluence Cloud.
  • Action the following limitations if needed.
    • Restricted pages are not supported currently. Depending on the sensitivity of the data, we suggest users manually migrate these secrets or remove any restrictions on related pages.
    • Rich text content used to create secrets does not appear correctly when migrated. Ensure secrets are in plain text before migration.

  • Administrators using the CCMA tool to allow partial user migration should review the product access of the users before attempting steps related to the Server Migration tab (This is a part of .Step 2 - Secure Macro Transformation to Secrets (Security & Encryption). 
  • Perform a test migration to understand the steps required to migrate data and reconfigure the migrated data.
  • This guide assumes you have successfully migrated your Confluence Server data into Confluence Cloud, per Atlassian's Server to Cloud migration guide.

Guide

At the end of this guide, you will have: 

Depending on how large your Confluence data is, these may take a few hours to complete.  

Step 1 - Run CCMA

Follow through with the steps in Step 1 - Run CCMA (Security & Encryption)

Overview:

  • (Optional) prepare a set of test data and a staging instance to perform a pre-migration environment test before production migration. 
  • Upgraded Security and Encryption for Confluence Server to version 3.6.0 or above.  
  • Find and identify the spaces that are using the Security and Encryption macros. 
  • Perform the migration using the Confluence Cloud Migration Assistant(CCMA) tool. 
  • Schedule the migration window.

Step 2 - Secure Macro Transformation to Secrets

Follow through with the steps in Step 2 - Secure Macro Transformation to Secrets (Security & Encryption)

Overview:

  • Have your Confluence cloud instance ready. 
  • Select which secrets you want to migrate from the Server Migration Beta tab
  • Generate the migration key and passphrase from the Confluence server. 
  • Perform the transformation of the server Secure Macro to its cloud equivalent Secret.

Step 3 - Troubleshooting Steps

Follow through with the steps in Step 3 - Troubleshooting Steps (Security & Encryption)

Overview

  • Ensure the Security and Encryption add-on is given the appropriate permission in space permissions.
  • Understand the type of error messages and what non-transformed secrets look like. 



Next Steps: 

To go back to the migration hub, click here.