The Content Transfer Tool is a tool developed by Adobe that can be used to move existing content over from a source AEM instance (on-premise or AMS) to the target AEM Cloud Service instance.
This tool also transfers principals (users or groups) automatically.
There are two phases associated with content transfer:
Extraction: Extraction refers to extracting content from the source AEM instance into a temporary area called migration set. A migration set is a cloud storage area provided by Adobe to temporarily store the transferred content between the source AEM instance and the Cloud Service AEM instance.
Refer to Extraction Process in Content Transfer for more details.
It is recommended to run the User Mapping Tool as part of the Extraction phase. Refer to Using User Mapping Tool for more details.
Ingestion: Ingestion refers to ingesting content from the migration set into the target Cloud Service instance.
Refer to Ingestion Process in Content Transfer for more details.
A migration set has the following attributes:
The Content Transfer Tool has a feature that supports differential content top-up where it is possible to transfer only changes made since the previous content transfer activity.
After the initial content transfer, it is recommended to do frequent differential content top-ups to shorten the content freeze period for the final differential content transfer before going live on Cloud Service.
In the extraction phase, to top-up an existing migration set, the overwrite option must be disabled. Refer to Top Up Extraction for more details.
In the ingestion phase, to apply the delta content on top of the current content, the wipe option must be disabled. Refer to Top Up Ingestion for more details.
Follow the section below to understand guidelines and best practices to use the Content Transfer Tool:
If the AEM Cloud Author Content Delivery Network (CDN) config is configured to have a whitelist of IPs then it should be ensured that the source environment IPs are also added to the allowlist so that the source environment and AEM Cloud environment can communicate with each other.
In the ingestion phase, it is recommended to run the ingestion using the wipe mode enabled where the existing repository (author or publish) in the target AEM Cloud Service environment will be completely deleted and then updated with the migration set data. This mode is much faster than the non-wipe mode, where the migration set is applied on top of the current content.
After the content transfer activity is completed, the correct project structure is required in the Cloud Service environment to ensure that the content renders successfully in the Cloud Service environment.
Before running the Content Transfer Tool, you must ensure that there is enough disk space in the
crx-quickstart subdirectory of the source AEM instance. This is because the Content Transfer Tool creates a local copy of the repository that is later uploaded to the migration set.
The general formula to calculate the require free disk space is as follows:
data store size + node store size * 1.5
A migration set needs to be maintained throughout the content transfer activity to support content top-ups. Since a maximum of ten migration sets can be created and maintained at a time during the content transfer activity, it is recommended to break up the content repository accordingly to ensure that you do not run out of migration sets.