DocumentazioneExperience Cloud KCS

L’acquisizione dello strumento Content Transfer (Trasferimento contenuti) di AEM non riesce a causa di file TAR danneggiati

Ultimo aggiornamento: 3 ottobre 2026

Questo articolo spiega come risolvere gli errori di acquisizione nello strumento AEM Content Transfer (Trasferimento contenuti) causati da file TAR danneggiati nell’archivio dei segmenti di origine durante la migrazione da AEM on-premise ad AEM as a Cloud Service.

Descrizione description

Ambiente

  • Adobe Experience Manager (AEM) on-premise
  • AEM as a Cloud Service
  • Strumento Content Transfer (CTT)

Problema/Sintomi

  • Il processo di acquisizione non riesce dopo diverse ore durante la migrazione.
  • I registri mostrano InvalidBinaryReferencesIndexException: Unrecognized magic number errori ripetuti durante l’elaborazione dei file di archivio dei segmenti.
  • L’estrazione può essere completata con avvisi sui file TAR danneggiati e segnalare lo stato FINISHED, ma l’acquisizione non riesce ripetutamente su file TAR diversi con lo stesso errore.
  • Il problema non è correlato alla configurazione di rete o proxy.
  • Il problema può verificarsi anche con set di migrazione di piccole dimensioni, perché la fase di copia dell’archivio segmenti trasferisce l’archivio segmenti compattato completo dall’ambiente di origine.

Risoluzione resolution

Per risolvere il problema, segui i passaggi seguenti:

  1. Eseguire un controllo completo dell’integrità dell’archivio nell’archivio dei segmenti di origine utilizzando il comando oak-run check --deep.

  2. Esaminare l’output per individuare eventuali danneggiamenti segnalati nei file TAR (ad esempio, data02490a.tar e data69802a.tar).

  3. Se viene rilevato un danneggiamento, correggere l’archivio di origine:

    • Esecuzione di un rollback del diario e di una compattazione offline se esiste un’ultima revisione valida nota precedente a tutti i danneggiamenti.
    • Ripristino da un backup valido se non è disponibile alcuna revisione pulita o se il danneggiamento è vecchio.

  4. Dopo la correzione, crea una nuova estrazione del set di migrazione dall’ambiente di origine riparato.

  5. Assicurati che il nuovo pacchetto di estrazione venga utilizzato per il prossimo tentativo di acquisizione.

  6. Durante l’acquisizione, disabilita l’opzione Usa pre-copia per velocizzare l’acquisizione.

  7. Avvia l’acquisizione e monitora la presenza di errori.

  8. Se non è possibile risolvere il problema (ad esempio, se non esiste un backup o una revisione puliti), l’unica opzione consiste nell’affrontare il danneggiamento dell’archivio di origine prima di procedere con la migrazione. Impossibile eseguire la migrazione perché l’archivio dei segmenti di origine contiene file TAR danneggiati.

Per verificare la risoluzione, verifica che l’estrazione venga completata senza avvisi relativi ai file TAR danneggiati e che l’acquisizione venga completata correttamente senza errori InvalidBinaryReferencesIndexException.

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