レプリケーション

レプリケーションエージェントは、次の目的で使用されるメカニズムとして Adobe Experience Manager（AEM）の中核を成すものです。

• オーサー環境からパブリッシュ環境へコンテンツを公開（アクティベート）
• Dispatcher キャッシュからコンテンツを明示的にフラッシュ
• ユーザー入力（フォーム入力など）をパブリッシュ環境からオーサー環境（オーサー環境の制御下）に戻す。

要求は適切なエージェントに登録され、処理を待機します。

オーサーからパブリッシュへのレプリケーション

パブリッシュインスタンスまたは Dispatcher へのレプリケーションは、いくつかの段階を踏んで実行されます。

• 作成者が特定のコンテンツの公開（アクティベート）を要求します。これは、手動の要求または設定済みの自動トリガーによって開始できます。

• デフォルトの適切なレプリケーションエージェントに要求が渡されます。このようなアクションのために選択されるデフォルトエージェントを、1 つの環境にいくつか用意することができます。

• レプリケーションエージェントがコンテンツを「パッケージ化」して、レプリケーションキューに配置します。

• 「Web サイト」タブで、個々のページに対して色付きのステータスインジケーターが設定されます。

• 設定されたプロトコル（通常は HTTP）を使用して、コンテンツがキューから取り出されて、パブリッシュ環境に移されます。

• パブリッシュ環境内のサーブレットが要求を受信し、受信したコンテンツを公開します。デフォルトのサーブレットは https://localhost:4503/bin/receive です。

• 複数のオーサー環境とパブリッシュ環境を設定できます。

パブリッシュ環境からオーサー環境へのレプリケーション

一部の機能は、ユーザーに対してパブリッシュインスタンス上でのデータ入力を許可します。

状況によっては、このデータをオーサー環境に返してそこから別のパブリッシュ環境へ再分配するために、リバースレプリケーションという種類のレプリケーションが必要になることがあります。セキュリティ上の問題を考慮し、パブリッシュ環境からオーサー環境へのトラフィックは厳密に制御する必要があります。

リバースレプリケーションでは、オーサー環境を参照するパブリッシュ環境内のエージェントを使用します。このエージェントが、データをアウトボックスに配置します。このアウトボックスは、オーサー環境のレプリケーションリスナーに対応付けられています。リスナーはアウトボックスをポーリングして、入力されているすべてのデータを収集し、必要に応じて配布します。これにより、オーサー環境がすべてのトラフィックを確実に制御できるようになります。

その他の場合、例えばフォーラム、ブログ、コメント、レビューなどのコミュニティ機能では、パブリッシュ環境に入力されるユーザー生成コンテンツ（UGC）の量が多いので、AEM インスタンス間の効率的な同期をレプリケーションで実現することは難しくなります。

AEM Communities では、UGC にレプリケーションを使用しません。その代わりに、Communities のデプロイメントでは UGC 用の共通ストアが必要になります（コミュニティコンテンツのストレージを参照）。

レプリケーション（デフォルト）

AEM の標準インストールに含まれている we-retail web サイトを使用して、レプリケーションの仕組みを見ていきましょう。

この例に従ってデフォルトのレプリケーションエージェントを使用するには、次の環境を使用して AEM をインストールする必要があります。

• オーサー環境（ポート 4502）
• パブリッシュ環境（ポート 4503）

レプリケーション（オーサー環境からパブリッシュ環境へ）

1. オーサー環境でサポートページに移動します。
   https://localhost:4502/content/we-retail/us/en/experience.html <pi>
2. ページを編集して、新しいテキストをいくつか追加します。
3. ページをアクティベート​して変更内容を公開します。
4. パブリッシュ環境でサポートページを開きます。
   https://localhost:4503/content/we-retail/us/en/experience.html
5. オーサー環境で入力した変更内容を確認できます。

このレプリケーションは、次のエージェントによってオーサー環境から実行されます。

• デフォルトエージェント（publish）
  このエージェントは、デフォルトのパブリッシュインスタンスにコンテンツをレプリケーションします。
  この設定およびログの詳細には、オーサー環境のツールコンソールまたは次の URL からアクセスすることができます。 あるいは以下のようにしてください。

  https://localhost:4502/etc/replication/agents.author/publish.html

レプリケーションエージェント（デフォルト）

次に示すエージェントは標準の AEM インストールで使用できます。

• デフォルトエージェントオーサー環境からパブリッシュ環境へのレプリケーションに使用します。

• Dispatcher フラッシュDispatcher キャッシュの管理に使用します。詳しくは、オーサリング環境からの Dispatcher キャッシュの無効化およびパブリッシュインスタンスからの Dispatcher キャッシュの無効化を参照してください。

• リバースレプリケーションパブリッシュ環境からオーサー環境へのレプリケーションに使用します。リバースレプリケーションは、フォーラム、ブログ、コメントなどのコミュニティ機能には使用されません。アウトボックスが有効化されていないので、事実上、この機能は無効になっています。リバースレプリケーションを使用するには、カスタム設定が必要になります。

• 静的エージェント
  これは、「ノードの静的な表現をファイルシステムに格納するエージェント」です。例えば、デフォルト設定では、コンテンツページと DAM アセットが /tmp に HTML または適切なアセット形式として格納されます。設定については、Settings タブと Rules タブを参照してください。これは、ページがアプリケーションサーバーから直接要求される場合に、コンテンツを確認できるようにするためのエージェントです。これは特殊なエージェントであり、（おそらく）ほとんどのインスタンスでは必要ありません。

レプリケーションエージェント - 設定パラメーター

ツールコンソールからレプリケーションエージェントを設定する場合は、ダイアログ内の 4 つのタブを使用できます。

設定

• 名前

  レプリケーションエージェントの一意の名前です。

• 説明

  このレプリケーションエージェントの用途の説明です。

• Enabled

  現在レプリケーションエージェントが有効かどうかを示します。

  エージェントが​有効​な場合は、キューが次のように表示されます。

  • アクティブ：項目が処理されています。
  • 待機中：キューが空です。
  • ブロック：項目がキュー内にありますが、処理できません。例えば、受信側のキューが無効な場合などです。

• シリアル化の種類

  シリアル化の種類です。

  • デフォルト：エージェントを自動選択する場合に設定します。
  • Dispatcher フラッシュ：エージェントを使用して Dispatcher キャッシュをフラッシュする場合に選択します。

• 再試行遅延

  問題が発生した場合の、2 回の再試行の間の遅延（ミリ秒単位の待機時間）です。

  デフォルト: 60000

• エージェントユーザー ID

  環境に応じて、エージェントはこのユーザーアカウントを使用して次の処理をおこないます。

  • オーサー環境からのコンテンツの収集とパッケージ化
  • パブリッシュ環境でのコンテンツの作成と書き込み

  システムユーザーアカウント（sling で管理者ユーザーとして定義したアカウント。デフォルトでは、admin です）を使用するには、このフィールドを空白のままにします。

  注意

  オーサー環境におけるエージェントの場合、このアカウントには、レプリケーションしたすべてのパスに対する読み取りアクセス権が必要です​*。*

  注意

  パブリッシュ環境におけるエージェントの場合、このアカウントでコンテンツをレプリケーションするには、作成／書き込みアクセス権が必要です。

  メモ

  これは、レプリケーション用の特定のコンテンツを選択するためのメカニズムとして使用できます。

• ログレベル

  ログメッセージに使用する詳細レベルを指定します。

  • Error：エラーだけがログに記録されます。
  • Info：エラー、警告およびその他の情報メッセージがログに記録されます。
  • Debug：主にデバッグを目的として、高いレベルの詳細がメッセージで使用されます。

  デフォルト: Info

• リバースレプリケーションに使用

  このエージェントをリバースレプリケーションに使用するかどうかを示します。パブリッシュ環境からオーサー環境にユーザーの入力を戻します。

• エイリアスの更新

  このオプションを選択すると、Dispatcher へのエイリアスまたはバニティーパスの無効化要求が有効になります。Dispatcher フラッシュエージェントの設定 も参照してください。

トランスポート

• URI

  ターゲットの場所にある受信側のサーブレットを指定します。具体的には、ホスト名（またはエイリアス）とターゲットインスタンスのコンテキストパスを指定できます。

  次に例を示します。

  • デフォルトエージェントによるレプリケーション先：https://localhost:4503/bin/receive
  • Dispatcher フラッシュエージェントによるレプリケーション先：https://localhost:8000/dispatcher/invalidate.cache

  ここで指定するプロトコル（HTTP または HTTPS）によってトランスポート方法が決まります。

  Dispatcher フラッシュエージェントの場合、「URI」プロパティは、パスに基づく virtualhost エントリを使用してファームを区別する場合にのみ使用されます。このフィールドを使用して、無効にするファームをターゲット設定してください。例えば、ファーム #1 の仮想ホストは www.mysite.com/path1/* で、ファーム #2 の仮想ホストは www.mysite.com/path2/* です。この場合、/path1/invalidate.cache の URL を使用して最初のファームをターゲット設定し、/path2/invalidate.cache を使用して 2 つ目のファームをターゲット設定できます。

• ユーザー

  ターゲットへのアクセスに使用するアカウントのユーザー名です。

• パスワード

  ターゲットへのアクセスに使用するアカウントのパスワードです。

• NTLM ドメイン

  NTML 認証用のドメインです。

• NTLM ホスト

  NTML 認証用のホストです。

• 緩和された SSL を有効にする

  自己証明 SSL 証明書を受け取る場合に有効にします。

• 期限切れの証明書を許可する

  期限切れ SSL 証明書を受け取る場合に有効にします。

プロキシ

以下の設定は、プロキシが必要な場合にのみおこないます。

• プロキシホスト

  トランスポートに使用するプロキシのホスト名です。

• プロキシポート

  プロキシのポートです。

• プロキシユーザー

  使用するアカウントのユーザー名です。

• プロキシパスワード

  使用するアカウントのパスワードです。

• プロキシ NTLM ドメイン

  プロキシの NTLM ドメインです。

• プロキシ NTLM ホスト

  プロキシの NTLM ドメインです。

拡張

• インターフェイス

  ここでは、バインド先のソケットインターフェイスを定義できます。

  接続の作成時に使用するローカルアドレスを設定します。設定しない場合は、デフォルトのアドレスが使用されます。これは、マルチホームシステムやクラスターシステムで使用するインターフェイスを指定する場合に役立ちます。

• HTTP メソッド

  使用する HTTP メソッドです。

  Dispatcher フラッシュエージェントでは、ほとんどの場合 GET です。この設定を変更しないでください（有効なもう 1 つの値は POST です）。

• HTTP ヘッダー

  Dispatcher フラッシュエージェントで使用されます。フラッシュする必要のある要素を指定します。

  Dispatcher フラッシュエージェントの場合、次の 3 つの標準エントリを変更する必要はありません。

  • CQ-Action:{action}
  • CQ-Handle:{path}
  • CQ-Path:{path}

  必要に応じてこれらを使用して、ハンドルまたはパスのフラッシュ時に使用するアクションを指定します。サブパラメーターは動的です。

  • {action} はレプリケーションアクションを示します

  • {path} はパスを示します

  これらは、要求に関連するパスまたはアクションで置き換えられるので、ハードコーディングする必要はありません。

  メモ

  推奨されるデフォルトのコンテキスト以外のコンテキストに AEM をインストールした場合は、「HTTP ヘッダー」にそのコンテキストを登録する必要があります。次に例を示します。
  CQ-Handle:/<*yourContext*>{path}

• 接続を閉じる

  各要求の後に接続を閉じられるようにします。

• 接続タイムアウト

  接続の確立の試行時に適用するタイムアウト（ミリ秒単位）です。

• Socket Timeout

  接続の確立後のトラフィックの待機時に適用するタイムアウト（ミリ秒単位）です。

• プロトコルのバージョン

  プロトコルのバージョンです。例えば、HTTP/ の場合は 1.01.0 です。

トリガー

以下の設定を使用して、自動化されたレプリケーションのトリガーを定義します。

• デフォルトを無視

  オンにすると、デフォルトのレプリケーションからエージェントが除外されます。つまり、コンテンツの作成者がレプリケーションのアクションを実行しても、そのエージェントは使用されません。

• 変更時

  ページが変更されると、このエージェントによるレプリケーションが自動的にトリガーされます。これは主に Dispatcher フラッシュエージェントに使用されますが、リバースレプリケーションにも使用されます。

• 配布時

  オンにすると、配布用にマークされたコンテンツの変更時に、エージェントがそのコンテンツを自動的にレプリケーションします。

• オン / オフタイムに達しました

  ページに対して定義されたオンタイムまたはオフタイムになると、自動レプリケーションをトリガーします（必要に応じて、ページをアクティベート／アクティベート解除します）。これは主に Dispatcher フラッシュエージェントに使用されます。

• 受信時

  オンにすると、レプリケーションイベントを受信するたびにエージェントがチェーンレプリケーションをおこないます。

• ステータス更新がありません

  オンにすると、エージェントはレプリケーションステータスの更新を強制しません。

• バージョン管理がありません

  オンにすると、エージェントはアクティベートされたページのバージョン管理を強制しません。

レプリケーションエージェントの設定

MSSL を使用してレプリケーションエージェントをパブリッシュインスタンスに接続する方法については、相互 SSL を使用したレプリケーションを参照してください。

オーサー環境からのレプリケーションエージェントの設定

オーサー環境の「ツール」タブから、オーサー環境（作成者のエージェント）またはパブリッシュ環境（発行のエージェント）にあるレプリケーションエージェントを設定できます。次の手順は、オーサー環境用のエージェントの設定方法を示していますが、どちらの環境にも使用できます。

1. AEM の「ツール」タブにアクセスします。

2. 「レプリケーション」（フォルダーを開くための左側のウィンドウ）をクリックします。

3. 「作成者のエージェント」（左側または右側のウィンドウ）をダブルクリックします。

4. 適切なエージェント名（リンク）をクリックして、そのエージェントの詳細情報を表示します。

5. 「編集」をクリックして設定ダイアログを開きます。

   

6. デフォルトのインストールに適した値を指定する必要があります。値を変更したら、「OK」をクリックして値を保存します（個々のパラメーターについて詳しくは、レプリケーションエージェント - 設定パラメーターを参照してください）。

リバースレプリケーションの設定

リバースレプリケーションは、パブリッシュインスタンスで生成されたユーザーコンテンツをオーサーインスタンスに戻すために使用されます。この機能は、通常はアンケート調査や登録フォームなどで使用されます。

ほとんどのネットワークトポロジは、セキュリティ上の理由により、「非武装地帯（DMZ）」（インターネットなどの信頼できないネットワークに外部サービスを公開するサブネットワーク）からの接続を許可しません。**

通常、パブリッシュ環境は DMZ にあるので、コンテンツをオーサー環境に戻すには、オーサーインスタンスから接続を開始する必要があります。そのためには、次のものを使用します。

• コンテンツが配置されているパブリッシュ環境の​アウトボックス
• 新しいコンテンツ用のアウトボックスを定期的にポーリングする、オーサー環境のエージェント（publish）

そのためには、次のものが必要です。

オーサー環境のリバースレプリケーションエージェント これは、パブリッシュ環境のアウトボックスから情報を収集するアクティブなコンポーネントとして機能します。

リバースレプリケーションを使用する場合は、このエージェントをアクティベートします。

パブリッシュ環境（アウトボックス）のリバースレプリケーションエージェント これは「アウトボックス」として機能する受動的な要素です。オーサー環境でエージェントが収集する場所から、ユーザー入力がここに配置されます。

複数のパブリッシュインスタンス用のレプリケーションの設定

インストール時には、localhost のポート 4503 で実行されているパブリッシュインスタンスにコンテンツをレプリケートするデフォルトエージェントが既に設定されています。

その他のパブリッシュインスタンスへのコンテンツレプリケーションを設定するには、新しいレプリケーションエージェントを作成し、設定する必要があります。

1. AEM の「ツール」タブを開きます。

2. 「レプリケーション」を選択し、左側のパネルで「作成者のエージェント」を選択します。

3. 「新規」を選択します。

4. 「タイトル」と「名前」を設定し、「レプリケーションエージェント」を選択します。

5. 「作成」をクリックして新しいエージェントを作成します。

6. 新しいエージェント項目をダブルクリックして、設定パネルを開きます。

7. 「編集」をクリックします。エージェントの設定​ダイアログが開きます。「シリアル化の種類」には既に「デフォルト」が定義されているので、そのままにしてください。

   • 「設定」タブで、次のように設定します。

     • 「有効」をアクティブにします。

     • 「説明」を入力します。

     • 「再試行遅延」を 60000 に設定します。

     • シリアル化のタイプ​はDefaultのままにします。

   • 「トランスポート」タブで、次のように設定します。

     • 新しいパブリッシュインスタンスに必要な URI を入力します。次に例を示します。

       https://localhost:4504/bin/receive.

     • レプリケーションに使用する、サイト固有のユーザーアカウントを入力します。

     • 必要に応じて、その他のパラメーターを設定できます。

8. 「OK」をクリックして設定を保存します。

次に、オーサー環境でページを更新および公開して操作をテストできます。

更新された内容は、前述の手順で設定したすべてのパブリッシュインスタンスに表示されます。

問題が発生した場合は、オーサーインスタンスでログを確認できます。必要な詳細レベルに応じて、前述の エージェント設定 ダイアログを使用して、ログレベル を Debug に設定することもできます。

Dispatcher フラッシュエージェントの設定

デフォルトエージェントはインストールに付属しています。ただし、一部の設定については調整が必要です。新しいエージェントを定義する場合も同様です。

1. AEM の「ツール」タブを開きます。

2. 「導入」をクリックします。

3. レプリケーション​を選択した後、パブリッシュ環境のエージェント​を選択してください。

4. Dispatcher フラッシュ​項目をダブルクリックして、概要を開きます。

5. 「編集」をクリックします。エージェントの設定​ダイアログが開きます。

   • 「設定」タブで、次のように設定します。

     • 「有効」をアクティブにします。

     • 「説明」を入力します。

     • シリアル化のタイプ​を Dispatcher Flush のままにするか、またはエージェントを新規作成する場合に同様の設定を行います。

     • （オプション）エイリアスの更新​を選択して、Dispatcher に対するエイリアスまたはバニティーパスの無効化要求を有効にします。

   • 「トランスポート」タブで、次のように設定します。

     • 新しいパブリッシュインスタンスに必要な URI を入力します。次に例を示します。

       https://localhost:80/dispatcher/invalidate.cache.

     • レプリケーションに使用する、サイト固有のユーザーアカウントを入力します。

     • 必要に応じて、その他のパラメーターを設定できます。

   Dispatcher フラッシュエージェントの場合、「URI」プロパティは、パスに基づく virtualhost エントリを使用してファームを区別する場合にのみ使用されます。このフィールドを使用して、無効にするファームをターゲット設定してください。例えば、ファーム #1 の仮想ホストは www.mysite.com/path1/* で、ファーム #2 の仮想ホストは www.mysite.com/path2/* です。この場合、/path1/invalidate.cache の URL を使用して最初のファームをターゲット設定し、/path2/invalidate.cache を使用して 2 つ目のファームをターゲット設定できます。

   メモ

   推奨されるデフォルトのコンテキスト以外のコンテキストに AEM をインストールした場合は、「拡張」タブで HTTP ヘッダー​を設定する必要があります。

6. 「OK」をクリックして、変更を保存します。

7. 「ツール」タブに戻ります。ここから Dispatcher フラッシュ​エージェント（発行のエージェント）を​アクティベート​できます。

Dispatcher フラッシュ​レプリケーションエージェントは、オーサーではアクティブではありません。同等の URI（例：https://localhost:4503/etc/replication/agents.publish/flush.html）を使用すると、パブリッシュ環境で同じページにアクセスできます。

レプリケーションエージェントへのアクセスの制御

etc/replication ノードに対するユーザーまたはグループのページの権限を使用して、レプリケーションエージェントの設定に使用するページへのアクセスを制御できます。

CRXDE Lite からのレプリケーションエージェントの設定

CRXDE Lite を使用して、レプリケーションエージェントの様々なパラメーターを設定できます。

/etc/replication に移動すると、次の 3 つのノードがあります。

• agents.author
• agents.publish
• treeactivation

2 つの agents は、適切な環境に関する設定情報を保持し、その環境が実行中の場合にのみアクティブになります。例えば、agents.publish は、パブリッシュ環境でのみ使用されます。次のスクリーンショットは、AEM WCM に含まれる、オーサー環境のパブリッシュエージェントを示しています。

レプリケーションエージェントの監視

レプリケーションエージェントを監視するには：

1. AEM の「ツール」タブにアクセスします。

2. 「レプリケーション」をクリックします。

3. 適切な環境のエージェントへのリンクをダブルクリックします（左右いずれかのウィンドウ）。例えば、「オーサーのエージェント」などです。

   ウィンドウが開き、オーサー環境のすべてのレプリケーションエージェントの概要が、それぞれのターゲットとステータスを含めて表示されます。

4. 適切なエージェント名（リンク）をクリックして、そのエージェントの詳細情報を表示します。

   

   ここでは、以下のことができます。

   • エージェントが有効かどうかを確認。

   • レプリケーションのターゲットを確認。

   • レプリケーションキューが現在アクティブ（有効）かどうかを確認。

   • キュー内に項目が含まれているかどうかを確認。

   • 更新​または​消去​して、キューエントリの表示を更新。これは、キューに出入りする項目の確認に役立ちます。

   • ログを表示​して、レプリケーションエージェントによるアクションのログにアクセス。

   • ターゲットインスタンスへの​接続をテスト。

   • 必要に応じて、任意のキュー項目で​強制的に再試行。

   注意

   パブリッシュインスタンスのリバースレプリケーションアウトボックスには、「接続をテスト」リンクは使用しないでください。

   アウトボックスクエリ用にレプリケーションテストが実行されると、リバースレプリケーションのたびに、テストレプリケーションより古い項目がすべて再処理されます。

   そのような項目がキュー内に既に存在する場合は、次の XPath JCR クエリを使用して検索し、削除する必要があります。

   /jcr:root/var/replication/outbox//*[@cq:repActionType='TEST']

バッチレプリケーション

バッチレプリケーションは、個々のページやアセットをレプリケートしませんが、時間やサイズに基づいて、2 つの最初のしきい値がトリガーされるのを待ちます。

次に、すべてのレプリケーション項目を 1 つのパッケージに圧縮し、単一のファイルとしてパブリッシャーにレプリケートします。

パブリッシャーは、すべての項目を展開し、保存して作成者に報告します。

バッチレプリケーションの設定

1. http://serveraddress:serverport/siteadmin に移動します。
2. 画面の上側にある​ツール​アイコンを押します。
3. 左側のナビゲーションレールから、レプリケーション - 作成者のエージェント​に移動し、「デフォルトエージェント」をダブルクリックします。
   • また、直接 http://serveraddress:serverport/etc/replication/agents.author/publish.html に移動して、デフォルトのパブリッシュレプリケーションエージェントに到達することもできます。
4. レプリケーションキューの上にある「編集」ボタンを押します。
5. 次のウィンドウで、「 バッチ」タブに移動します。
   
6. エージェントを設定します。

パラメーター

• Enable Batch Mode - バッチレプリケーションモードを有効または無効にします
• Max Wait Time - バッチリクエストが開始されるまでの最大待機時間（秒単位）。デフォルト値は 2 秒です。
• Trigger Size - このサイズの上限に達したときにバッチレプリケーションを開始します

その他のリソース

トラブルシューティングの詳細については、レプリケーションのトラブルシューティングページを参照してください。

Business.Adobe.com リソース

Asset Collections Personalized Communications Responsive Forms Content As A Service Content Management Digital Rights Management