DocumentationExperience Cloud KCS

L’ingestion de l’outil de transfert de contenu AEM échoue en raison de fichiers TAR corrompus

Dernière mise à jour : 3 octobre 2026

Cet article explique comment résoudre les échecs d’ingestion dans l’outil de transfert de contenu AEM causés par des fichiers TAR corrompus dans le magasin de segments source lors de la migration d’AEM On-premise vers AEM as a Cloud Service.

Description description

Environnement

  • Adobe Experience Manager (AEM) On-premise
  • AEM as a Cloud Service
  • Outil de transfert de contenu (CTT)

Problème/Symptômes

  • Le processus d’ingestion échoue après plusieurs heures pendant la migration.
  • Les journaux affichent des erreurs InvalidBinaryReferencesIndexException: Unrecognized magic number répétées lors du traitement des fichiers d’archive de segments.
  • L’extraction peut se terminer avec des avertissements concernant des fichiers TAR corrompus et signaler un statut FINISHED, mais l’ingestion échoue à plusieurs reprises sur différents fichiers TAR avec la même erreur.
  • Le problème n’est pas lié à la configuration du réseau ou du proxy.
  • Le problème peut se produire même avec de petits jeux de migration, car la phase de copie de l’entrepôt de segments transfère l’entrepôt de segments compacté complet de l’environnement source.

Résolution resolution

Suivez les étapes ci-dessous pour résoudre le problème :

  1. Exécutez une vérification complète de l’intégrité du référentiel sur le magasin de segments source à l’aide de la commande oak-run check --deep.

  2. Consultez la sortie pour toute corruption signalée dans les fichiers TAR (par exemple, data02490a.tar et data69802a.tar).

  3. Si une corruption est détectée, remédiez au référentiel source en effectuant l’une des opérations suivantes :

    • L’exécution d’une restauration de journal et d’un compactage hors ligne s’il existe une dernière révision correcte connue antérieure à toute corruption.
    • Restauration à partir d’une sauvegarde, dont le fonctionnement a été vérifié, si aucune révision propre n’est disponible ou si la corruption est ancienne.

  4. Après la remédiation, créez une nouvelle extraction du jeu de migration de l’environnement source réparé.

  5. Assurez-vous que le nouveau package d’extraction est utilisé pour la prochaine tentative d’ingestion.

  6. Lors de l’ingestion, désactivez l’option Utiliser la précopie pour accélérer l’ingestion .

  7. Démarrez l’ingestion et surveillez les erreurs.

  8. Si la correction n’est pas possible (par exemple, s’il n’existe aucune sauvegarde ou révision propre), la seule option est de corriger la corruption du référentiel source avant de poursuivre la migration. La migration ne peut pas réussir tant que le magasin de segments source contient des fichiers TAR corrompus.

Pour vérifier la résolution, vérifiez que l’extraction se termine sans avertissements concernant les fichiers TAR corrompus et que l’ingestion se termine correctement sans erreurs InvalidBinaryReferencesIndexException .

recommendation-more-help
experience-cloud-kcs-help-kbarticles