コンテンツ転送ツールの基本を学ぶ getting-started-content-transfer-tool

入手方法 availability

コンテンツ転送ツールは、ソフトウェア配布ポータルから zip ファイルとしてダウンロードできます。パッケージマネージャーを使用して、このパッケージをソース AEM(Adobe Experience Manager)インスタンスにインストールできます。最新バージョンをダウンロードしてください。最新バージョンについて詳しくは、リリースノートを参照してください。

サポートされるのはバージョン 2.0.0 以降のみで、最新バージョンを使用することをお勧めします。

NOTE
ソフトウェア配布ポータルからコンテンツ転送ツールをダウンロードします。

ソース環境の接続性 source-environment-connectivity

NOTE
移行セットが Cloud Acceleration Manager から削除されている場合も、接続エラーが発生する可能性があります。

ソース AEM インスタンスがファイアウォールの内側で動作していて、許可リストに追加された特定のホストにしか到達できない場合があります。抽出を正常に実行するには、AEM を実行しているインスタンスから、次のエンドポイントにアクセスできる必要があります。

  • Azure BLOB ストレージサービス:casstorageprod.blob.core.windows.net
NOTE
エラー: 「javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX パスのビルドに失敗しました: sun.security.provider.certpath.SunCertPathBuilderException: リクエストされたターゲットへの有効な証明書パスが見つかりません」が原因で抽出に失敗した場合は、関連する CA 証明書を読み込むことで問題を解決できます。

SSL ログを有効にする enable-ssl-logging

SSL/TLS 接続の問題の理解は困難な場合があります。 抽出プロセス中に接続の問題をトラブルシューティングするには、次の手順に従って、ソース AEM 環境のシステムコンソールで SSL ログを有効にします。

  1. ツール/操作/Web コンソール ​に移動するか、https://serveraddress:serverport/system/console/configMgr の URL に直接アクセスして、ソースインスタンスの Adobe Experience Manager web コンソールに移動します。

  2. Content Transfer Tool Extraction Service Configuration を検索します。

  3. 鉛筆アイコンボタンを使用して、設定値を編集します。

  4. を有効にします。 抽出用の SSL ログを有効にする 設定してから、 保存:

    画像

NOTE
このフラグは、SSL の問題のデバッグにのみ使用されます。抽出を実行する前に、フラグが無効になっていることを確認してください。これには大量のディスク領域が必要になる場合があります。これにより、ドライブ容量がいっぱいになり、抽出プロセスが失敗する可能性があります。

コンテンツ転送ツールの実行 running-tool

次の節は、コンテンツ転送ツールの新しいバージョンに適用されます。この節では、コンテンツ転送ツールを使用してコンテンツを AEM as a Cloud Service に移行する方法について説明します。

抽出設定フェーズ extraction-setup-phase

  1. Cloud Acceleration Manager(CAM)にログインし、以前に作成した CAM プロジェクトをクリックして、AEM as a Cloud Service への移行に対する準備状況を評価します。CAM プロジェクトをまだ作成していない場合は、CAM でのプロジェクトの作成と管理を参照してください。

  2. コンテンツ転送 ​カードをクリックして、移行セットリスト表示を開きます。

    画像

  3. 移行セットを作成」をクリックして移行セットを作成します。

    note note
    NOTE
    Cloud Acceleration Manager で、プロジェクトごとに最大 10 個(期限切れセットを含む)の移行セットを作成できます。

    画像

    次のダイアログボックスが表示されます。移行セットは、無操作状態が長時間続くと有効期限が切れます。警告がプロジェクトカードおよび移行ジョブテーブルの行に一定期間表示された後、移行セットは期限切れになり、そのデータは使用できなくなります。詳しくは、移行セットの有効期限を参照してください。

    画像

    note note
    NOTE
    名前は、AEMノードと同じ規則に従う必要があるので、次の文字を含めることはできません。. / : [ ] | *
  4. これで、リスト表示に移行リストが表示されます。3 つのドット記号()をクリックして、ドロップダウンを開き、「抽出キーをコピー」を選択します。このキーは、抽出段階で必要になります。この抽出キーをコピーします。

    note note
    NOTE
    抽出キーを使用すると、移行元の AEM 環境から移行セットに安全に接続できます。この鍵は、パスワードと同じ注意を払って扱ってください。また、メールのような安全でないメディアでは、鍵を共有しないでください。

    画像

移行セットへの入力 populating-the-migration-set

Cloud Acceleration Manager で作成した移行セットを設定するには、最新バージョンのコンテンツ転送ツールをソースの Adobe Experience Manager(AEM)インスタンスにインストールします。移行セットの設定方法については、この節に従ってください。

  1. 移行元の Adobe Experience Manager インスタンスに最新バージョンのコンテンツ転送ツールをインストールしたら、運用 - コンテンツ移行 ​に移動します。

  2. 移行セットを作成」をクリックします。

    画像

  3. 先ほど CAM からコピーした抽出キーを、移行セットを作成 ​フォームの抽出キー入力フィールドに貼り付けます。これを実行すると、「移行セット名」フィールドと「Cloud Acceleration Manager(CAM)プロジェクト名」フィールドに自動的に値が入力されます。これらは、CAM の移行セット名と、作成した CAM プロジェクト名に一致する必要があります。コンテンツのパスを追加できるようになりました。コンテンツのパスを追加したら、移行セットを保存します。抽出は、含めるバージョンまたは除外するバージョンで実行できます。

    note note
    NOTE
    抽出キーが有効で、有効期限に近づいていないことを確認します。抽出キーを貼り付けた後、この情報は、移行セットを作成 ​ダイアログに表示されます。接続エラーが発生した場合は、ソース環境の接続性を参照してください。

    画像

  4. 次に、移行セットを作成するには、次のパラメータを選択します。

    1. バージョンを含める: 必要に応じて選択します。バージョンが含まれる場合は、監査イベントを移行するために、パス /var/audit が自動的に含まれます。

      画像

      note note
      NOTE
      バージョンを移行セットの一部に含める予定で、wipe=false を指定して追加を行う場合、コンテンツ転送ツールの現在の制限事項により、バージョンのパージを無効にする必要があります。バージョンのパージを有効にしたまま、移行セットへの追加を行う場合は、wipe=true を指定して取り込みを実行する必要があります。
    2. 含めるパス: パスブラウザーを使用して、移行する必要があるパスを選択します。パスピッカーは、キーボード入力または選択による入力を受け付けます。

      note important
      IMPORTANT
      移行セットの作成時には、次のパスは制限されます。
      • /apps
      • /libs
      • /home
      • /etc/etc の一部のパスは CTT で選択できます)
  5. 移行セットを作成 ​画面のすべてのフィールドに値を入力したら、「保存」をクリックします。

移行セットのサイズの決定 migration-set-size

移行セットを作成した後、抽出プロセスを開始する前に、移行セットに対してサイズ確認を実行することを強くお勧めします。
移行セットに対してサイズ確認を実行すると、以下が可能になります。

  • 抽出を正常に完了できるだけの十分なディスク容量が crx-quickstart サブディレクトリにあるかどうかを確認します。
  • 移行セットのサイズが製品の制限内に収まるかどうかを判断し、コンテンツの取り込みに失敗しないようにします。

サイズ確認を実行するには、次の手順に従います。

  1. 移行セットを選択し、「サイズを確認」をクリックします。

    画像

  2. サイズを確認 ​ダイアログが開きます。

    画像

  3. サイズを確認」をクリックして、プロセスを開始します。移行セットリスト表示に戻り、サイズ確認 ​が実行中であることを示すメッセージが表示されます。

    画像

  4. サイズ確認 ​プロセスが完了したら、ステータスが​ 完了 ​に変わります。同じ移行セットを選択し、「サイズを確認」をクリックして結果を表示します。以下は、警告を含まない​ サイズ確認 ​結果の例です。

    画像

  5. サイズ確認 ​の結果、空きディスク容量が不足しているか、移行セットが製品の制限を超えていることがわかった場合は、警告 ​ステータスが表示されます。

次の手順 whats-next

移行セットの作成方法を理解したら、コンテンツ転送ツールでの抽出プロセスと取り込みプロセスについて学ぶ準備が整います。これらのプロセスを学ぶ前に、コンテンツを AEM as a Cloud Service に移行するコンテンツ転送アクティビティの抽出段階と取り込み段階を大幅に短縮する大規模なコンテンツリポジトリの処理を参照する必要があります。

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab