We recommend you migrate your Scroll Documents using the Space Export and Space Import feature in Confluence.

Note that using Confluence's Cloud Migration Assistant to migrate your Scroll Documents will NOT work as custom content objects are currently not imported during a Server to Cloud migration. You will be able to use the Cloud Migration Assistant as soon as the bug is fixed.

This bug is known to Atlassian and we encourage you to watch and vote for the reported issue

Prerequisites

  • Confluence Server instance (contains the Scroll Documents you want to migrate)
  • Confluence Cloud instance with Scroll Documents installed
  • On the Server instance: Export space permissions (only needed for the spaces that contain Scroll Documents that you want to migrate)
  • On the Cloud instance: Confluence admin permissions (needed in order to import a space)
  • XML editor installed

Things to Keep in Mind

  • Space imports will not work if you are importing from Confluence Server version 6.13 or earlier.
  • The history of Read Confirmations for your documents will not be available on Cloud after a manual migration.
  • This approach will migrate all of the content in your space, not just your Scroll Documents. If you want to migrate only Scroll Documents (and its related pages), we recommend you copy all of your Scroll Documents to a dedicated, new space. Alternatively, when doing the space export select Custom Export to select only pages that are part of your Scroll Documents.
  • Make sure that the source spaces you select for migration don't have space keys that already exists in your Confluence Cloud destination site.

Migration Steps

Step-1: Export all spaces that contain Scroll Documents

To start, in your Server instance, find all the spaces containing the Scroll Documents that you want to migrate. For each of your spaces:

  1. Go to Space Tools → Content Tools → Export
  2. Select Export to XML
  3. Select Full Export or Custom Export
  4. Click Export
  5. Download the XML file

Step-2: Edit the exported files

  1. Unpack the .zip file that you just downloaded
  2. Find the file entities.xml
  3. Open the file in an XML editor
  4. Using the editor find the following custom content keys:

    k15t-scroll-document-versions-for-confluence:document
    CODE
    k15t-scroll-document-versions-for-confluence:document-read-request
    CODE
    k15t-scroll-document-versions-for-confluence:document-read-confirmation
    CODE
  5. In front of the each of the custom content keys, add the prefix:

    ac:
    CODE

    For the custom content key 'k15t-scroll-document-versions-for-confluence:document' the result will be:

    ac:k15t-scroll-document-versions-for-confluence:document
    CODE
  6. Save the file
  7. Zip the folder

Step-3: Import all spaces that contain Scroll Documents

Switch to your Confluence Cloud instance:

  1. Select Settings in the Confluence navigation (top right corner next to your user icon)
  2. From the left-hand sidebar, select Import Spaces under 'Administration' 
  3. Click Browse to find your zip file
  4. Select Import
  5. Select Import another space if you want to add more spaces
  6. Click Next
  7. Optional: Allow the Jira macro repair to fix any broken Jira macros
  8. Go to your space directory to find and open your new space
  9. Open the Document library from the space sidebar to view your documents

Step-4: Assign space and app permissions

Users of your Confluence destination site need sufficient space permissions to be able view, create and/or edit documents, as well as create read requests. You might need to assign any missing permissions to Confluence users and user groups. To check and assign permissions:

  1. For each imported space, go to Space Settings
  2. Select the tab Permissions
  3. For all users and user groups, assign any missing view space, add page and delete page permissions by clicking edit permissions
  4. Click save all
  5. Select the sub-tab Add-on

  6. For all users and user groups, assign any missing read confirmations and read requests permissions by clicking edit permissions
  7. Click save all


If you plan to use Scroll Documents' read request feature on Cloud, note that only users who have made their email accessible to the app will receive email notifications when they are added as readers to a request.

Troubleshooting

Problem

Solution

Space import fails: “Could not locate exportDescriptor.properties in the archive”

If you're on macOS, use the Terminal app to zip your folder. Use the 'cd' command to navigate to the directory where your zipped file is located, then enter the following command:

zip -r ../export.xml.zip .
CODE

Still Unclear? Reach Out to Us

If you need help with any of these migration steps, reach out to us via help@k15t.com.