Ingesting Content into Target

Ingestion Process in Content Transfer Tool

Follow the steps below to ingest your migration set from the Content Transfer Tool:

NOTE

You can run the optional pre-copy step to significantly speed up the ingestion phase. The pre-copy step is most effective for the 1st full extraction and ingestion. Refer to Ingesting with AzCopy for more details.

  1. Go to Cloud Acceleration Manager. Click on your project card and click on the Content Transfer card. Navigate to Ingestion Jobs and click on New Ingestion

    image

  2. Provide the required information to create a new ingestion.

    • Select the migration set that you just extracted as the Source
    • Select the destination environment. This is where the content of the migration set will be ingested. Select the tier. (Author/Publish).
    NOTE

    If the source was Author, it is recommended to ingest it into the Author tier on the target. Similarly, if source was Publish, target should be Publish as well.

    NOTE

    You can run the optional pre-copy step to significantly speed up the ingestion phase. Refer to Ingesting with AzCopy for more details.

    If ingesting with pre-copy is used (for S3 or Azure Data Store), it is recommended to run Author ingestion first alone. This will speed up the Publish ingestion when it is run later.

    IMPORTANT

    You will be able to kick-off an ingestion to the destination environment only if you belong to the local AEM administrators group on the destination Cloud Service author service. If you are unable to start an ingestion, refer to Unable to Start Ingestion for more details.

    IMPORTANT

    If the setting Wipe is enabled before ingestion, it deletes the entire existing repository and creates a new repository to ingest content into. This means that it resets all settings including permissions on the target Cloud Service instance. This is also true for an admin user added to the administrators group. You will need to be re-added to the administrators group in order to start an ingestion.

  3. Click on Ingest

    image

  4. You can then monitor the Ingestion phase from the Ingestion Jobs list view

    image

  5. Once Ingestion is completed, click on (i) button on the top right corner of the screen to get more information about the ingestion job.

Top Up Ingestion

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.

NOTE

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. If you have used the pre-copy step for the 1st full ingestion, you can skip pre-copy for subsequent top-up ingestions (if the top-up migration set size is less than 200GB) because it may add time to the entire process.

Once the ingestion process is complete, to ingest the delta content you will need to run a Top-Up Extraction and then use the top-up ingestion method.

You can do this by creating a new Ingestion Job and ensure that Wipe is disabled during the Ingestion phase, as shown below:

image

Troubleshooting

CAM Unable to Retrieve the Migration Token

The automatic retrieval of the migration token may fail for different reasons, including you setting up an IP allow list via Cloud Manager on the target Cloud Service environment. In such scenarios you will see the following dialog when you attempt to start an ingestion:

image

You will need to retrieve the migration token manually by clicking on the “Get token” link on the dialog. This will open another tab that displays the token. You can then copy the token and paste it into the Migration token input field. Now, you should be able to start the ingestion.

NOTE

The token will be available to users who belong to the local AEM administrators group on the destination Cloud Service author service.

Unable to Start Ingestion

You will be able to kick-off an ingestion to the destination environment only if you belong to the local AEM administrators group on the destination Cloud Service author service. If you don’t belong to the AEM administrators group, you will see an error as shown below when you try to start an ingestion. You can either ask your administrator to add you to the local AEM administrators or ask for the token itself, which you can then paste into the Migration token input field.

image

What’s Next

Once you have learned Ingesting Content into Target in Content Transfer Tool, you can view logs upon completion of each step (extraction and ingestion) and look for errors. See Viewing Logs for a Migration Set to learn more.

On this page