Please enable JS

Migrate Prolaborate Content from Confluence Server to Cloud

    Jan 05, 2023

Overview

This guide shows the steps involved in migrating Prolaborate model content to Atlassian Confluence Cloud from following sources

  1. Confluence Server
  2. Confluence Data Centre
Note:
The steps mentioned below is applicable for
  1. Prolaborate V3 with Prolaborate Macro in Confluence
  2. Prolaborate V4 with Prolaborate 4 Macro in Confluence
Related Content
  • Migrate Prolaborate Content from Atlassian Confluence Cloud to Confluence Server or Data Centre – Read More here
  • After Upgrading Prolaborate to the latest version (V4.x) from V3, please configure the compatible Confluence Macro for Prolaborate – Read More here

Steps to follow

Migration of Prolaborate content in Atlassian Confluence is a four-step process.

The steps involved in the migration process are explained below in detail.

Select Data to Migrate in Confluence Server

The first step is to select the required data for migration from Confluence Server/Data Center.

Open your Confluence Server or Data Center. Click the Settings icon from the top right corner and select Manage apps.

Scroll down the page and select Migration Assistant under Atlassian Cloud.

In the Migrations dashboard, click on Create new migration.

A popup window will appear. Click Continue without assessing to continue the migration process without assessing the apps or click Access apps to complete the assessment.

Once completed, a window appears showing step by steps on how to migrate data to cloud. Click Connect to cloud to start the process.

Enter a name for migration and select cloud site from the list available. Once completed, click on Choose what to migrate.

Here, one can choose what data needs to migrated. After selecting required information, click Next.

Next, it shows the list of spaces available, if they are selected in Choose what to migrate in the previous step. Select all the spaces or choose a specific space using the search field to select.

After selecting the spaces, click on Add to migration.

Once the spaces are added, Confluence checks for errors. If everything is satisfactory, click on Review Migration.

Review the migration details and click Run now if all the details are correct.

Clicking the Run Now initiates the migration process.

Once the process is complete, click Go to cloud site to open the Confluence Cloud.

Establish Connection in Confluence Cloud

In the Confluence cloud site, click View all spaces under Spaces.

It lists all the spaces available in the cloud. Search for a Space using the search field and click on it to open.

After navigating to the space, click on a page in the space to open.

Opening the page shows Unknown macro and the migrated data is not rendered.

Now establish the connection in the Confluence Cloud with Prolaborate. Click on Settings in the top right corner.

Select Manage Apps under Atlassian Marketplace.

Under User-installed apps, Prolaborate 4 is listed. Click Configure to open the configurations with Prolaborate.

Click Edit to the edit the configuration, if required. To know more about configuring Prolaborate Macro in Confluence, click here.

Once the details are reconfigured, click on Connect to establish the connection.

Connection Successful alert appears if it is successful along with the list of repositories which the user has access.

Click to Save to save the configurations. Saved Successful appears once it is successful.

Run Confluence Migrator

Once the connections are established in Confluence Cloud, run the ConfluenceMacro.DataMigration.exe as Administrator. Click here to download the Confluence Migrator.

Enter the following details,

Field Description
Choose Migration Type Choose Server → Cloud (V4) from the dropdown
Confluence URL URL of the Confluence Cloud site
Port (Optional) Port of Prolaborate site
UserName Email address of the user
Password/ API Token Paste the created API token. click here to know more
Space Key Enter the Space Key of the space to be migrated

After entering the details, click on Validate Connection. Connection Success popup appears if the entered details are correct.

After validating the connection, click Migrate to initiate the migration process.

A popup alert appear after the data is migrated successfully.

Validate the Migrated Data in Confluence Cloud

Open the spaces which is migrated in Confluence Cloud. All the pages in the migrated space renders properly.

Get Space Key to Migrate the Spaces

The next step is to get the space key for the migrated spaces from the Cloud Site.

In the Confluence cloud site, click View all spaces under Spaces.

Click on the ellipses of a space and choose Space Settings.

The Space Key is listed under Space details section as shown in the image below and copy the key as it is required to complete the migration process.