AEM as a Cloud Service: Cloud Manager pipeline fails with INDEXING_FAILED after Content Transfer Tool wipe
This article describes how to address Cloud Manager production pipeline failures due to index version conflicts that occur after running the Content Transfer Tool in wipe mode.
Description description
Environment
Adobe Experience Manager (AEM) as a Cloud Service (all versions)
Symptoms
- The production pipeline in Cloud Manager fails during deployment of the release branch.
- The failure occurs in the
aem-index-updatespre-job for both Author and Publish environments, with the error classificationINDEXING_FAILED. - After a recent Content Transfer Tool (CTT) operation in wipe mode, the Production environment contains a newer DAM base index:
/oak:index/damAssetLucene-14. - The deployment attempts to add a custom index:
/oak:index/damAssetLucene-13-custom-1. - The pipeline fails, because Oak rejects the older custom index when a newer base index already exists.
- Error log excerpt:
INDEXING_FAILED: Custom index /oak:index/damAssetLucene-13-custom-1 conflicts with existing base index /oak:index/damAssetLucene-14. - The issue doesn’t occur in Stage, as its repository and indexes weren’t rebuilt with CTT wipe mode.
- This problem blocks production deployments and impacts go-live timelines.
Cause
A Content Transfer Tool wipe rebuilt the repository and indexes, resulting in a newer DAM base index in Production. The deployment referenced an outdated custom index based on an older DAM index version, causing a version conflict and pipeline failure.
Resolution resolution
Follow the steps below to resolve the issue:
- Review the failed pipeline execution logs in Cloud Manager.
- Confirm that the error occurs in the
aem-index-updatespre-job and references a conflict between/oak:index/damAssetLucene-13-custom-1and/oak:index/damAssetLucene-14. - In your source control, update the custom DAM index definition to reference the latest base version present in Production (
damAssetLucene-14). - Ensure the custom index is compatible with the new base index structure.
- Commit and push the updated index definition to your repository.
- Trigger a new deployment via Cloud Manager to apply the changes.
- Monitor the pipeline execution to ensure the
aem-index-updatespre-job completes successfully. - Confirm that the deployment proceeds without the
INDEXING_FAILEDerror.
recommendation-more-help
experience-cloud-kcs-help-kbarticles