Prerequisites for Content Transfer Tool prerequisites

The following table summarizes the prerequisites for using Content Transfer Tool.

Review all the considerations listed below:

Considerations
What is Currently Supported
AEM Version
Content Transfer Tool can be run on AEM 6.3 or higher versions only.
Size of Segment Store
An existing repository that has less than 750 million JCR nodes and up to 500 GB (online compacted size) on Author and 50 GB on Publish are currently supported. Create a support ticket with Adobe Customer Care so you can discuss options for segment store size above these limits.
Total Size of Content Repository
(segment store + data store)
Content Transfer Tool is designed to transfer content up to 20 terabytes for File Data Store type of data store. Anything higher than 20 terabytes is not currently supported. Create a support ticket with Adobe Customer Care so you can discuss options for content larger than 20 terabytes.
To significantly speed up the content transfer process for large repositories, an optional pre-copy step can be used. This process applies to File Data Store, Amazon S3, and Azure Data Store types of data store. For Amazon S3 and Azure Data Store, repository sizes greater than 20 terabytes is supported.
Total Lucene Index Size
Total Lucene Index size of 25 GB maximum, excluding /oak:index/lucene and /oak:index/damAssetLucene is supported. Create a support ticket with Adobe Customer Care so you can discuss options for index size above this limit.
Node Name Length
Length of a node name must be 150 bytes or less when the node parent path is >= (equal or larger than) 350 bytes. These node names must be shortened to <= 150 bytes to be supported by the Document node store in AEM as a Cloud Service. Ingestions fail if these long node names are not fixed.
Content in Immutable Paths
Content Transfer Tool cannot be used to migrate content in immutable paths. To transfer content from /etc, you can select certain /etc paths, but only to support AEM Forms to AEM Forms as a Cloud Service. For all other use-cases, see Common Repository Restructuring to learn more about repository restructuring.
Node property value in MongoDB
Node property values stored in MongoDB cannot exceed 16 MB. This rule is enforced by MongoDB. Ingestions fail if there are property values larger than this limit. Before running an extraction, run this oak-run script. Review all large property values and validate if they are needed. The ones that exceed 16 MB must be converted to Binary values.

What’s Next whats-next

Once you have reviewed the prerequisites and have determined whether you can use the Content Transfer Tool in your migration project, see Guidelines and Best Practices for using Content Transfer Tool.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab