Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This step will contain all page includes details of a number of known issues of secure macros that are not migrated to Cloud, along together with possible solutions and workarounds.

Symptom in Confluence Cloud after migration

Cause

Solution/Workaround

Secure macros appear on their relevant pages as

 

  • Unknown macro:'secure'

 

or

 

  • Error loading the extension! 

on their relevant pages

These are Secure macros that are yet to be transformed.

Go to the Secrets 
  • go to the Secrets page on the left-hand side menu

, then
  • navigate to the Server Migration

 tab
  •  tab to complete the transformation steps highlighted in the previous step

Secure macros appear innested macros as

 

  • Error loading the extension!

innested macros.

Confluence Cloud currently does not support nested macros (See CONFCLOUD-68323) which means integration with other apps by way of nesting will be limited.

In the example below, a Secret macro is nested within an Expand macro (a standard Confluence macro).

This Secret would not be migrated unless it is moved out of the Expand macro.

Image Removed
Image Added

 

As
  • as a workaround

,
  • move the secrets outside of the nested macros in server before performing the migration

.

Failed migration

The 

The Security & Encryption for Confluence app user

has to

must have permission at space settings for the migration to be successful. 

Check
  • check the permission of the Security & Encryption for Confluence app user

, see

In the example below

. This

, the app user should exist and have sufficient permissions. 

Image Removed
Image Added

Migration is incomplete

Secure macros belonging to owners with no product access to Confluence Cloud will not be transformed correctly to Cloud - this will result in the error Migration is incomplete.

.Image Removed
Image Added

Run through the steps below

:

In
  • in server

-
    • find the owner of the Secure data of the failed secrets

.
In
  • in Cloud

-
    • navigate to Settings > General Configuration > User Management

Navigate
    • navigate to Product access

Ensure
    • ensure the user has Site access

Expand
titleHere is an example ..

Image Removed

Image Added

Secure macros cannot be transformed if the Confluence administrator does not have Add page access to the target page where the Secret will be transformed to.

This

This too will result in the error Migration is incomplete.

.Image Removed
Image Added

Run through the steps below

:

In
  • in server

-
    • find the original page of the Secure data of the failed secrets

.
In
  • in Cloud

-
    • navigate to the same page hierarchy as previous

. Enable Add page 
    • enable Add page permission at Space settings for the user performing the migration

.