Use the steps on this page to plan for complete migration from Scaffolding Server to Scaffolding Cloud:
- You have reviewed everything on the previous page, Migrating from Scaffolding Server to Scaffolding Cloud.
- You have reviewed the feature differences document and now understand
Macro differences between Scaffolding for Confluence Server and Confluence Cloud
- Unsupported scenarios in Cloud as compared to Scaffolding for Confluence Server
1. Upgrade the Scaffolding app
- Update the Scaffolding app to at least version 8.25.0 through the UPM inside Confluence administration console.
- Go to > Manage apps
- Search for Scaffolding. Make sure that the app is updated.
2. Find all the Scaffolding macros
- Make sure that the site search indexes are up to date
- Complete the steps below to assess data compatibility between Scaffolding Server and Cloud.
- Upon completion, you will know which data will not be compatible with Scaffolding Cloud after migration.
- Choose one of the 2 options below:
Option 1: Use the Macro Usage details page
- The Macro Usage page will give you the number of Scaffolding macros on your site, and also the pages that contain those macros.
- Go to Administration > Macro Usage. Or access it via the shortcut <base-url>/admin/pluginusage.action .
- Look under Scaffolding. Take note of how many Scaffolding macros that are on your site, and how many of them cannot be migrated. In this example, the ones marked will not be migrated to Cloud.
- Clicking on the macro links will show you all pages that contain those macros.
Option 2: Use the SQL query below
The sample SQL query below to help you gather all pages and templates that contains unsupported Scaffolding macros
This SQL will provide a list of impacted page authors and the relevant page titles which currently contain Scaffolding macros that are unavailable in CloudSQL query to find impacted pages...
This SQL will provide a list of impacted page authors and the relevant template titles which currently contain Scaffolding macros that are unavailable in Cloud.SQL query to find impacted templates...
3. Prepare the Scaffolding data in Server
Know your Scaffolding structure and data in server, to anticipate incompatibilities in Cloud after migration
- As Scaffolding server is more versatile than Scaffolding Cloud, it is important that admins understand what's inside their scaffolding structure, and anticipate what are not migratable.
- It's worth the time to check the main templates that others are using, and removing the structures that are incompatible in Cloud. The following documentations can help you with this decision
Take note that Global templates will not be migrated automatically and has to be manually migrated instead.
- Due to CCMA limitations, Global templates will not be automatically migrated (Bug report: MIG-190 - Consider making the Confluence Assistant migrating Global Templates).
- As a workaround, copy all Global Templates manually into Space Templates before the migration, in order to migrate them to Cloud. You may copy the migrated templates back to Global templates after the successful migration.
- Detailed step-by-step instructions are available on this page - Global Template is not automatically migrated to Cloud.
4. Create a staging instance, and perform a test migration on sample data. (This is a recommended best practice step)
- Identify a Space that contains
- Space templates that are widely used in your organization and uses Scaffolding macros.
- Pages with Live Templates that are using the Space templates.
- Clone the contents of that space to a new space
- Now you are ready to migrate, prepare a migration window as highlighted below
- Go through the Test migration as highlighted in Steps 2 & 3
5. Schedule the migration window
To estimate the time you will need for the migration steps, we recommend reviewing all of the steps before executing. Depending on the size of the data and the complexity of the existing template configuration, it may take a few hours to complete these steps. We advise you to schedule a maintenance window in your organization to perform the migration.