コンテンツ転送ツール使用のガイドラインとベストプラクティス guidelines

ソース ​リポジトリに対してリビジョンのクリーンアップとデータストア整合性チェックを実行し、潜在的な問題を特定してリポジトリのサイズを小さくします。

取り込み段階では、ワイプ ​モードを有効にして取り込みを実行することをお勧めします。このモードでは、ターゲットとなる Adobe Experience Manager（AEM）Cloud Service 環境内の既存のリポジトリ（オーサーまたはパブリッシュ）を削除します。次に、移行セットデータで更新します。このモードは、現在のコンテンツの上に移行セットが適用される非ワイプモードより高速です。

コンテンツ転送アクティビティが完了したら、Cloud Service 環境でコンテンツが正常にレンダリングされるように、Cloud Service 環境で正しいプロジェクト構造を使用する必要があります。

コンテンツ転送ツールを実行する前に、ソース AEM インスタンスの crx-quickstart サブディレクトリに十分なディスク領域があることを確認する必要があります。これは、コンテンツ転送ツールによってリポジトリーのローカルコピーが作成され、後で移行セットにアップロードされるためです。必要な空きディスク容量を計算する一般的な式は次のとおりです。
data store size + node store size * 1.5

• data store size：実際のデータストアのサイズが大きい場合でも、コンテンツ転送ツールは 64 GB を使用します。
• node store size：セグメントストアディレクトリのサイズまたは MongoDB データベースのサイズ。
  したがって、セグメントストアのサイズが 20 GB の場合、必要な空きディスク容量は 94 GB になります。

コンテンツの追加をサポートするには、コンテンツ転送アクティビティ全体を通して移行セットを維持管理する必要があります。Cloud Acceleration Manager では、コンテンツ転送アクティビティ中に、プロジェクトあたり一度に最大 20 個の移行セットを作成および維持管理できます。移行セットが 21 個以上必要な場合は、Cloud Acceleration Manager で 2 つ目のプロジェクトを作成します。ただし、複数のユーザーがターゲット上のコンテンツを上書きしないようにするために、追加のプロジェクト管理と製品外のガバナンスが必要になります。

CTT ツールのインストールディレクトリを変更しないようにします。デフォルトでは、インストールは crx-quickstart/cloud-migration パスで実行されます。この特定の場所は、他のライブラリによって内部的に使用されます。このパスを変更すると、抽出の問題が発生する可能性があります。

コンテンツ転送ツールに必要なシステム構成は、AEM 6.3 以降と Java™ 8 です。使用している AEM のバージョンがこれより古い場合、コンテンツ転送ツールを使用するには、コンテンツリポジトリーを AEM 6.5 にアップグレードします。

AEM を開始するユーザーが java コマンドを実行できるように、AEM 環境上で Java™ を設定する必要があります。

コンテンツ転送ツールは、ファイルデータストア、S3 データストア、共有 S3 データストア、Azure Blob Store データストアと共に使用できます。

サンドボックス環境 ​を使用している場合は、環境が最新で最新のリリースにアップグレードされていることを確認してください。実稼動環境 ​を使用している場合、環境は自動的に更新されます。

取り込みを開始するには、コンテンツの転送先の Cloud Service インスタンスのローカル AEM 管理者 ​グループに属している必要があります。権限のないユーザーは、移行トークンを手動で指定しない限り、取り込みを開始できません。

「取得前にクラウドインスタンス上の既存のコンテンツを消去」オプションが有効な場合は、既存のリポジトリー全体が削除され、コンテンツの取り込み先となる新しいリポジトリーが作成されます。つまり、ターゲットの Cloud Service インスタンスに対する権限を含むすべての設定がリセットされます。これは、管理者 ​グループに追加された管理者ユーザーにも当てはまります。コンテンツ転送ツールのアクセストークンを取得するには、ユーザーを​ 管理者 ​グループに再び追加する必要があります。

2 つのソースのコンテンツがターゲット上の同じパスに移動された場合、取り込みでは、複数のソースのコンテンツをターゲット Cloud Service インスタンスに結合することはできません。複数のソースから単一のターゲット、Cloud Service インスタンスにコンテンツを移動するには、ソースからのコンテンツパスが重複しないようにします。

抽出キーは、作成または更新時点から 14 日間有効です。抽出キーはいつでも更新できます。抽出キーの有効期限が切れている場合は、抽出を実行できません。

コンテンツ転送ツール（CTT）は、ソースインスタンスからターゲットインスタンスにコンテンツを転送する前に、どのような種類のコンテンツ分析も実行しません。例えば、CTT では、コンテンツをパブリッシュ環境に取り込む際に、公開済みコンテンツと非公開コンテンツを区別しません。移行セットで指定されているコンテンツはすべて、選択したターゲットインスタンスに取り込まれます。ユーザーは、オーサーインスタンスとパブリッシュインスタンスのどちらか一方または両方に移行セットを取り込むことができます。コンテンツを実稼動インスタンスに移動する際に、ソースオーサーインスタンスに CTT をインストールして、コンテンツをターゲットオーサーインスタンスに移動することをお勧めします。同様に、ソースパブリッシュインスタンスに CTT をインストールして、コンテンツをターゲットパブリッシュインスタンスに移動します。詳しくは、パブリッシュインスタンスでのコンテンツ転送ツールの実行を参照してください。

コンテンツ転送ツールによって転送されるユーザーとグループは、権限を満たすためにコンテンツで必要なものに限られます。抽出 ​プロセスは、/home 全体を移行セットにコピーし、各ユーザーのメールアドレスから作成されたフィールドを追加して、ユーザーマッピングを実行します。詳しくは、ユーザーマッピングとプリンシパルの移行を参照してください。取り込み ​プロセスは、移行されたコンテンツ ACL で参照されているすべてのユーザーとグループをコピーします。クローズドユーザーグループ（CUG）ポリシーで使用されるグループに関するその他の考慮事項について詳しくは、クローズドユーザーグループの移行を参照してください。

抽出段階では、コンテンツ転送ツールはアクティブな AEM ソースインスタンスで実行されます。

オーサーの​ 取得段階 ​では、オーサーのデプロイメント全体がスケールダウンされます。つまり、オーサー AEM インスタンスが取り込みプロセス全体で使用できなくなります。また、取り込み ​段階の実行中に Cloud Manager パイプラインが実行されないようにする必要があります。

ソース AEM システム上のデータストアとして Amazon S3 または Azure を使用する場合は、保存された BLOB を削除（ガベージコレクション）できないように、データストアを設定する必要があります。これにより、インデックスデータの整合性が確保されます。このように設定しないと、このインデックスデータの整合性が欠落しているために抽出が失敗する可能性があります。

カスタムインデックスを使用する場合は、コンテンツ転送ツールを実行する前に、tika ノードでカスタムインデックスを設定する必要があります。詳しくは、新しいインデックス定義の準備を参照してください。

追加を行う場合は、最初の抽出を実行した時点から、追加抽出を実行する時点まで、既存コンテンツのコンテンツ構造が変わらないようにします。最初の抽出以降に構造が変更されたコンテンツに対しては、追加を実行できません。移行作業中には必ず制限するようにしてください。

バージョンを移行セットの一部に含める予定で、wipe=false を指定して追加を行う場合、コンテンツ転送ツールの現在の制限事項により、バージョンのパージを無効にする必要があります。バージョンのパージを有効にしたまま、移行セットへの追加を行う場合は、wipe=true を指定して取り込みを実行する必要があります。

移行セットは、無操作状態が長時間続くと有効期限が切れ、その後はデータが使用できなくなります。詳しくは、移行セットの有効期限を参照してください。