Migration from server/DC to cloud

Description

Before migrating Excel for Confluence macro content from server/DC to cloud, we recommend reading this Atlassian article to plan your migration.

Administrators must ensure that the following feature flag is enabled in the server/DC instance as a part of the pre-migration setup:

  • migration-assistant.app-migration.feature: <Confluence_URL>/admin/darkfeatures.action

Refer to the Getting started page from Atlassian for more information about the prerequisites for the migration.

This page explains:

  • Migration process
  • Differences between the server/DC and cloud version of the app

Migration process

  • Confluence instance migration - Use the Confluence Cloud Migration Assistant app to migrate everything you need from Confluence server/DC to Atlassian cloud. Confluence Cloud Migration Assistant explains in detail the step-by-step procedure to migrate the required content. As mentioned in the previous section, Atlassian does this job for you in most cases.
  • App installation - Install the app from Marketplace.

On completion of migration from version 7.0.0:

  • All global configuration data in the Configuration page are transferred from the server instance to the cloud instance.
  • If multiple migrations are performed on the same cloud instance, the latest migration takes precedence.
  • Any subsequent migrations performed on the same cloud instance only adds or merges the data, but does not delete any existing data.

Important information:

  • The migration of data from server to cloud is an independent process from app installation or configuration in your cloud instance. We recommend that administrators verify that all your data (configuration as well as your Confluence pages) are displayed properly after the migration process is completed. Please report any issues immediately after looking through the Known issues section.
  • We capture certain details, excluding private user data or any personally identifiable information, during the migration process to help us improve our app continually. Refer to Analytics data to know more about the what information is collected.

Differences between server/DC and cloud versions

The Excel macro features available in the server/DC versions are mostly supported in the cloud version as well. The following table lists the macro's parameters and features that work differently in server/DC and cloud:

Parameter/FeatureServer/DCCloudNotes
URL whitelistingSupported natively by ConfluenceAdministrators must manually whitelist the URLs in the Global Configuration page, because Confluence Cloud does not natively support URL whitelisting.For more information, refer to CLOUD-2636.
Blacklist domainsSupportedNot supportedDue to certain technical restrictions, the feature is not available with the app's cloud version.
ProfilesNot supportedSupportedAdministrators configure some parameters, such as the base URL of the location, user name and password and so on, required to access Excel files from external locations. Users can provide the relative path that points to the actual location of the files through a relevant profile. To know more about profiles, read the documentation
Stop encoding of HTML charactersSupportedNot supported

Due to certain technical restrictions, the feature is not available with the app's cloud version.

Refer to  XL-361 - Getting issue details... STATUS  for more updates.

File encodingSupportedNot supported

Due to certain technical restrictions, the feature is not available with the app's cloud version.

For more updates, refer to  XL-387 - Getting issue details... STATUS .

Name of attachment in the pathSupportedNot supportedConfluence cloud does not support access of files from disk or folder.

Default process with Legacy and Current options

SupportedNot availableThe app implicitly takes care of this process and thus, does not provide this parameter in the Cloud app.
Use column information from excel sheet check boxSupportedNot supportedConfluence cloud does not support this parameter.

Language for number and date formats

Country for number and date formats

SupportedNot supported

Due to certain technical restrictions, these parameters are not available with the app's cloud version.

For updates on the Language parameter, refer to XL-386 - Getting issue details... STATUS .

For updates on the Country parameter, refer to XL-385 - Getting issue details... STATUS .

Table Filter, Pivot Table, and Chart from Table macrosSupportedNot supportedConfluence cloud does not support use of inline macros.
Ignoring trailing blank rows and columnsSupportedNot supported

Due to certain technical restrictions, the feature is not available with the app's cloud version.

Table class and table widthSupportedNot supported

Confluence cloud does not support these parameters.

Refer to  XL-383 - Getting issue details... STATUS  and  XL-382 - Getting issue details... STATUS  for more updates.

Please note that all the other parameters function the same in both versions of the app.

Problem reporting

If you experience any problems or behavior changes that are unexpected, refer to Help and open a ticket with us. This helps us identify and prioritize fixes and improvements.

Known issue

If the server app is installed and if the latest version of Confluence Cloud Migration Assistant is installed or an older version is upgraded, certain app modules are disabled. Refer to  XL-500 - Getting issue details... STATUS for more updates.