Page Comparison

These pre-migration steps in this article are crucial for avoiding clashes with similarly-named macros on Confluence Cloud. On Cloud, there are currently Confluence-native macros which are also called Deck and Card (these are not ServiceRocket macros). More details are available in this bug report.

As part of the migration process, a ServiceRocket pre-migration tool is available which can rename all Deck and Card macros to Tab Group and Tab macros. On Confluence server, Tab Group and Tab macros behave exactly the same way as Deck and Card macros previously do, but with a different name.

Once this process is completed, administrators can then run the Confluence Cloud Migration Assistant to migrate all their content to Confluence cloud.

What happens during this process?

All content that contains Deck and Card macros, including pages and comments, will be updated to the new macro names, Tab Group and Tab.

Before 

Before	After

Image Removed

Image Added

Image Removed

Image Added

After the macros are renamed, your content will be displayed as it was previously. You can still view, edit and use your updated tabbed content as before on this site.

Info
icon false
If If new Deck and Card macros are created on your server after the rename process, you will need to run the pre-migration tool again before migrating to Confluence Cloud. For example, If you have completed this process for migration test purposes, but your users continue to add new content with Deck and Card macros, you will need to run the tool again before doing the production migration.

Step 1 - Check how many content pages need the macro name update

1. Go to Confluence Administration Console. Search for the Macro Usage menu.

2. Search for Composition. You will see the number of contents that contain Deck and Card macros. This will be the number of contents that require the macro name change. 
   Image Modified

Step 2 - Run the pre-migration tool

1. Go to Confluence Admin console.

2. Under Composition Configuration, select Composition Cloud Pre-migration Tool.
   Image Modified

3. On the pre-migration page, the following information can be seen:
   Image Modified
   

   • Number of contents to update - A count of all content pages that still use the Deck and Card naming convention.

   • After a first run of this process , the page will be updated with the following info

     • Previous run - The date and time of the last run. 

     • Number of contents updated - Accumulated total number of content pages with renamed macros (refer to the screenshot in step 5)

4. Click Run update. The button will be greyed out, and there will be a spinner to indicate that the macro rename process is in progress.

...

...

...

5. The button is disabled when the process is completed. The page is updated with details such as Previous run  and Number of contents updated.
   

...

5. Image Added

6. All pages that have been updated will have a new entry under Page History with the comment "Composition Migrator: Move Deck & Card macros to Tab & Tab Group Macros".
   Image Modified

7. The number of pages that contain Deck and Card macros in the Macro Usage menu will be updated

Step 3 - Proceed with Cloud migration

Your content is now ready for migration with the Confluence Cloud Migration Assistant (CCMA). Follow the instructions that come with the migration tool to bring all your Confluence data to the Cloud.
Image Modified

Step 4 - After migration

After the migration with CCMA, you should see migrated content on Cloud pages that uses the Tab Group and Tab  Tabmacros. 

Need more information?

Get in touch with us via /wiki/spaces/GENSUPP/pages/483297254 our support team.