ドキュメントExperience Cloud KCS

TAR ファイルが破損しているため、AEM コンテンツ転送ツールの取り込みに失敗する

最終更新日： 2026年10月3日

この記事では、AEM オンプレミスからAEM as a Cloud Serviceへの移行中にソースセグメントストアで破損したTAR ファイルが原因で発生する、AEM Content Transfer Toolの取り込みエラーを解決する方法について説明します。

説明 description

環境

  • Adobe Experience Manager（AEM）オンプレミス
  • AEM as a Cloud Service
  • コンテンツ転送ツール（CTT）

問題/症状

  • 移行中に数時間が経過すると、取り込みプロセスが失敗します。
  • セグメントアーカイブファイルの処理中にログに繰り返しInvalidBinaryReferencesIndexException: Unrecognized magic number個のエラーが表示されます。
  • 抽出は、破損したTAR ファイルに関する警告で完了し、FINISHED ステータスを報告する場合がありますが、同じエラーで異なるTAR ファイルに対して繰り返し取り込みが失敗します。
  • この問題は、ネットワークまたはプロキシ設定とは関係ありません。
  • セグメントストアのコピーフェーズでは、圧縮されたセグメントストア全体がソース環境から転送されるため、小規模な移行セットでも問題が発生する可能性があります。

解決策 resolution

問題を解決するには、次の手順に従います。

  1. oak-run check --deep コマンドを使用して、ソースセグメントストアの完全なリポジトリー整合性チェックを実行します。

  2. TAR ファイルで報告された破損の出力を確認します（例：data02490a.tarとdata69802a.tar）。

  3. 破損が検出された場合は、次のいずれかの方法でソースリポジトリを修復します。

    • ジャーナルのロールバックとオフラインのコンパクションを実行すると、すべての破損の前に最後に確認された正常なリビジョンが存在する場合に実行されます。
    • 正常なバックアップからのリストア（クリーンリビジョンがない場合、または破損が古い場合）。

  4. 修復後、修復されたソース環境から移行セットの新しい抽出を作成します。

  5. 新しい抽出パッケージが次の取り込み試行に使用されていることを確認します。

  6. 取り込み中に、事前コピーを使用して取り込みを高速化 オプションを無効にします。

  7. 取り込みを開始し、エラーを監視します。

  8. 修復が不可能な場合（クリーンバックアップやリビジョンが存在しない場合など）、移行を進める前にソースリポジトリの破損に対処することが唯一のオプションです。 ソースセグメントストアに破損したTAR ファイルが含まれている場合、移行を成功させることはできません。

解決を確認するには、TAR ファイルの破損に関する警告なしで抽出が完了し、InvalidBinaryReferencesIndexException エラーなしで取り込みが正常に完了することを確認します。

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