現在表示中:

概要

デプロイメントがパブリッシュファームであるとき、メンバーはすべてのパブリッシュノードにログインしてその中のデータを閲覧できる必要があります。

パブリッシュ環境で作成されたユーザーとユーザーグループ(ユーザーデータ)は、オーサー環境では必要ありません。  

オーサー環境で作成されたほとんどのユーザーデータはオーサー環境に残るものと想定されており、パブリッシュインスタンスにはコピーされません。

他のパブリッシュインスタンスが同じユーザーデータにアクセスするには、1 つのパブリッシュインスタンスに加えられた登録と変更をそれらのパブリッシュインスタンスに同期する必要があります。

 AEM 6.1 では、ユーザー同期を有効にすると、ユーザーデータがファーム内のパブリッシュインスタンス全体に自動的に同期され、オーサー環境には作成されません。

Sling 配布

ユーザーデータは ACL と共に Oak JCR の下のレイヤーの Oak Core に格納され、Oak API を使用してアクセスできます。 アップデートの頻度が少ない場合は、Sling コンテンツ配布(Sling 配布)を使用してユーザーデータを他のパブリッシュインスタンスに同期するのが適切です。

従来のレプリケーションと比較して、Sling 配布を使用してユーザーを同期する利点は次のとおりです。

  • パブリッシュインスタンスで作成されたユーザー、ユーザープロファイルおよびユーザーグループがオーサー環境に作成されません
  • Sling 配布により JCR イベントにプロパティが設定されることで、レプリケーションが無限に繰り返されることなく、パブリッシュ側のイベントリスナーで実行できます
  • Sling 配布は派生元でないパブリッシュインスタンスにのみユーザーデータを送信するので、不要なトラフィックが発生しません
  • ユーザーノードで設定された ACL が同期に含まれます

注意:

セッションが必要な場合は、SSO ソリューションか定着セッションを使用して、別のパブリッシャーに切り替わった際にはお客様にログインしてもらうことをお勧めします。

警告:

ユーザー同期が有効化されている場合でも、administrators グループの同期はサポートされません。 代わりに、「差分の読み込み」が失敗した旨を示すログがエラーログに記録されます。

このため、デプロイメントがパブリッシュファームであるとき、administrators グループに対してユーザーが追加または削除された場合、変更は各パブリッシュインスタンスに対して手動で実行する必要があります。

ユーザー同期の有効化

注意:

デフォルトでは、ユーザー同期は無効になっています。

ユーザー同期を有効にするには、OSGi の既存の設定を変更する必要があります。

ユーザー同期を有効にした結果、新しい設定が追加されることはありません。

ユーザー同期では、オーサー環境で作成されていないユーザーデータでもその配布の管理はオーサー環境に依存します。 すべてではありませんが、設定の大多数はオーサー環境にあり、それをオーサー環境またはパブリッシュ環境で実行するかどうかは各手順で明確に識別します。

次にユーザー同期の有効化に必要な手順と、トラブルシューティングの節を示します。

前提条件

1)1 つのパブリッシャーでユーザーおよびユーザーグループが既に作成されている場合は、ユーザー同期を設定して有効にする前に、ユーザーデータをすべてのパブリッシャーと手動で同期することをお勧めします。

ユーザー同期を有効にすると、新規に作成されたユーザーおよびグループのみが同期されるようになります。

2)最新のコードがインストールされていることを確認します。

1. Apache Sling Distribution Agent - Sync Agents Factory

ユーザー同期の有効化

  • オーサー環境で
    • 管理者権限でログインします
    • Web コンソールにアクセスします
    • Apache Sling Distribution Agent - Sync Agents Factory を探します
      • 編集する既存の設定を選択します(鉛筆アイコン)
           「Name」:socialpubsync
      • Enabled」チェックボックスをオンにします
      • Save」を選択します

 

chlimage_1

2. 承認済みユーザーの作成

権限の設定
この承認済みユーザーが手順 3 のオーサー環境での Sling 配布の設定に使用されます。

警告:

新しいユーザーを作成する必要があります。

  • デフォルトで割り当てられるユーザーは admin です。
  • communities-user-admin ユーザーを使用しないでください。

ACL の追加方法

  • CRXDE Lite にアクセスします
  • /home ノードを選択します
  • 右側のペインで、「アクセス制御」タブを選択します
  • +」ボタンを選択して、ACL エントリを追加します
    • プリンシパル:ユーザー同期用に作成されたユーザーを検索
    • 種類許可
    • 権限jcr:all
    • 制限 rep:glob:*/activities/*
    • OK」を選択します
  • すべて保存」を選択します
  •  

chlimage_1

次のページも参照してください。

3. Adobe Granite Distribution - Encrypted Password Transport Secret Provider

権限の設定

administrators ユーザーグループのメンバーである承認済みユーザーがすべてのパブリッシュインスタンスで作成されたら、ユーザーデータをオーサー環境からパブリッシュ環境に同期する権限があるその承認済みユーザーをオーサー環境で識別する必要があります。

  • オーサー環境で
    • 管理者権限でログインします
    • Web コンソールにアクセスします
    • Adobe Granite Distribution - Encrypted Password Transport Secret Provider を探します
    • 編集する既存の設定を選択します(鉛筆アイコン)
         「Property name」を確認します:socialpubsync-publishUser
    • 手順 2 でパブリッシュ環境で作成した承認済みユーザーのユーザー名とパスワードを設定します
      • 例:usersync-admin
chlimage_1

4. Apache Sling Distribution Agent - Queue Agents Factory

ユーザー同期の有効化

  • パブリッシュ環境で
    • 管理者権限でログインします
    • Web コンソールにアクセスします
    • Apache Sling Distribution Agent - Queue Agents Factory を探します
      • 編集する既存の設定を選択します(鉛筆アイコン)
           「Name」:socialpubsync-reverse
      • Enabled」チェックボックスをオンにします
      • Save」を選択します
    • 各パブリッシュインスタンスで繰り返します
chlimage_1

5. Adobe Granite Distribution - Diff Observer Factory

グループ同期の有効化

  • 各パブリッシュインスタンスで
    • 管理者権限でログインします
    • Web コンソールにアクセスします
    • Adobe Granite Distribution - Diff Observer Factory を探します
      • 編集する既存の設定を選択します(鉛筆アイコン)
           「agent name」を確認します:socialpubsync-reverse
      • Enabled」チェックボックスをオンにします
      • Save」を選択します
chlimage_1

6. Apache Sling Distribution Trigger - Scheduled Triggers Factory

(オプション)ポーリング間隔の変更

デフォルトでは、オーサー環境では 30 秒ごとに変更をポーリングします。 この間隔を変更するには、次の手順を実行します。

  • オーサー環境で
    • 管理者権限でログインします
    • Web コンソールにアクセスします
    • Apache Sling Distribution Trigger - Scheduled Triggers Factory を探します
      • 編集する既存の設定を選択します(鉛筆アイコン)
        • Name」:socialpubsync-scheduled-trigger
      • Interval in Seconds」に任意の間隔を指定します。
      • Save」を選択します
chlimage_1

複数のパブリッシュインスタンスの設定

デフォルトの設定は、単一のパブリッシュインスタンス用の設定です。 ユーザー同期を有効にする理由は、複数のパブリッシュインスタンス(パブリッシュファーム用になど)を同期することであるので、追加のパブリッシュインスタンスを Sync Agents Factory に追加する必要があります。

7. Apache Sling Distribution Agent - Sync Agents Factory

パブリッシュインスタンスを追加するには:

  • オーサー環境で
「Enabled」がオンになっていないデフォルト設定
  • Exporter Endpoints
    各パブリッシャーにエクスポーターエンドポイントが必要です。例えば、パブリッシャーが localhost:4503 と 4504 の 2 つの場合、次の 2 つのエントリが必要です。
    • http://localhost:4503/libs/sling/distribution/services/exporters/socialpubsync-reverse
    • http://localhost:4504/libs/sling/distribution/services/exporters/socialpubsync-reverse
  • Importer Endpoints
    各公開者にインポーターエンドポイントが必要です。例えば、パブリッシャーが localhost:4503 と 4504 の 2 つの場合、次の 2 つのエントリが必要です。
    • http://localhost:4503/libs/sling/distribution/services/importers/socialpubsync
    • http://localhost:4504/libs/sling/distribution/services/importers/socialpubsync 
  • Save」を選択します

8. AEM Communities User Sync Listener

(オプション)追加の JCR ノードの同期

複数のパブリッシュインスタンス間で同期するカスタムデータがある場合は、次のようにします。

  • 各パブリッシュインスタンスで
chlimage_1
  • Node Types
    同期するノードタイプのリストです。sling:Folder 以外のすべてのノードタイプがここにリストされます(sling:folder は別個に処理されます)。
    同期されるノードタイプのデフォルトのリストは次のとおりです。
    • rep:User
    • nt:unstructured
    • nt:resource
  • Ignorable Properties
    何らかの変更が検出された場合に無視されるプロパティのリストです。これらのプロパティに対する変更は、他の変更の副作用として同期される場合がありますが(同期は常にノードレベルでおこなわれるので)、これらのプロパティに対する変更そのものが同期をトリガーすることはありません。
    無視されるデフォルトのプロパティは次のとおりです。
    • cq:lastModified
  • Ignorable Nodes
    同期中に完全に無視されるサブパスです。このサブパスの下にあるものはどのタイミングでも同期されません。
    無視されるデフォルトのノードは次のとおりです。
    • .tokens
    • system
  • Distributed Folders
    同期が不要であるのでほとんどの sling:Folders は無視されます。数少ない例外を次に示します。
    同期されるデフォルトのフォルダーは次のとおりです。
    • segments/scoring
    • social/relationships
    • activities

9. 一意の Sling ID

警告:

 2 つ以上のパブリッシュインスタンスで Sling ID が一致すると、ユーザーグループの同期が失敗します。

Sling ID がパブリッシュファームの複数のパブリッシュインスタンスで同じである場合、ユーザーグループは同期されません。

すべての Sling ID の値が異なることを確認するには、各パブリッシュインスタンスで次の手順を実行します。

  1. http://host:port/system/console/status-slingsettings に移動する
  2. Sling ID の値を確認する
chlimage_1

あるパブリッシュインスタンスの Sling ID が他のパブリッシュインスタンスの Sling ID と一致する場合は、次のようにします。

  1. Sling ID が一致するパブリッシュインスタンスの一方を停止する
  2. crx-quickstart/launchpad/felix ディレクトリで
    • sling.id.file という名前のファイルを検索して削除する
      • Linux システムの場合:
          rm -i $(find . -type f -name sling.id.file)
      • Windows システムの場合:
          Windows エクスプローラーを使用して sling.id.file を検索する
  3. パブリッシュインスタンスを開始する
    • スタートアップ時に新しい Sling ID が割り当てられる
  4. Sling ID が一意であることを確認する

すべてのパブリッシュインスタンスの Sling ID が一意になるまでこの手順を繰り返します。

Vault Package Builder Factory

更新が適切に同期されるようにするには、ユーザー同期用に Vault Package Builder を変更する必要があります。

  • 各 AEM パブリッシュインスタンスで
  • Web コンソールにアクセスします。
  • Apache Sling Distribution Packaging - Vault Package Builder Factory を探します
    • ビルダー名:socialpubsync-vlt
  • 編集アイコンを選択します
  • 次の 2 つのパッケージフィルターを追加します。
    • /home/users|-.*/.tokens
    • /home/users|-.*/rep:cache
  • ポリシーの処理:
    • 既存の rep:policy ノードを新しいノードで上書きするには、3 つ目のパッケージフィルターを追加します
      • /home/users|+.*/rep:policy
    • ポリシーが配布されないようにするには、次のように設定します
      • Acl Handling:IGNORE
chlimage_1

特定状況での動作

ユーザーがパブリッシュ環境でプロファイルを自身で登録または編集する場合

仕様上、パブリッシュ環境で作成されたユーザーとプロファイル(自己登録)は、オーサー環境では表示されません。 

トポロジがパブリッシュファームであり、ユーザー同期が正しく設定されると、Sling 配布を使用してユーザーとユーザープロファイルがパブリッシュファーム間で同期されます。

セキュリティコンソールを使用してユーザーやユーザーグループが作成される場合

仕様上、パブリッシュ環境で作成されたユーザーデータは、オーサー環境では表示されません。その反対も同様です。

ユーザー管理およびセキュリティコンソールを使用してパブリッシュ環境で新しいユーザーを追加すると、ユーザーの同期機能により、新しいユーザーとそのグループメンバーシップがその他のパブリッシュインスタンスに同期されます(必要な場合)。 ユーザー同期により、セキュリティコンソールによって作成されたユーザーグループも同期されます。

トラブルシューティング

ユーザー同期をオフラインにする方法

パブリッシャーを削除したり、データを手動で同期したりするためにユーザー同期をオフラインにするには、配布キューが空であり、静止している必要があります。

配布キューの状態をチェックするには:

  • オーサー環境で:
    • CRXDE Lite を使用する場合
      • /var/sling/distribution/packages 内で次のエントリを探します
        • distrpackage_* という名前パターンを持つフォルダー名
    • パッケージマネージャーを使用する場合
      • (まだインストールされていない)保留中のパッケージを探します
        • socialpubsync-vlt* という名前パターンを持つもの
        • communities-user-admin によって作成されたもの

配布キューが空である場合は、ユーザー同期を無効にします。

タスク完了後にユーザー同期を再び有効にするには:

ユーザー同期診断

ユーザー同期診断は、設定をチェックして問題の特定を試みるツールです。

オーサー環境で、メインコンソールからツール/運営/診断/ユーザー同期診断の順に移動します。

結果はユーザー同期診断コンソールに表示されます。

ユーザー同期が有効になっていない場合は、次のように表示されます。

chlimage_1

パブリッシャーに対する診断の実行方法

診断がオーサー環境から実行された場合は、成否の結果に [情報] セクションが含まれています。このセクションには、設定済みのパブリッシュインスタンスのリストが確認用に表示されます。

このリストには、診断が実行される各パブリッシュインスタンスの URL が記載されています。URL パラメーター syncUser が診断の URL に追加され、その値が手順 2 で作成した承認済み同期ユーザー に設定されています。

注意:URL を起動するには、承認済み同期ユーザーがそのパブリッシュインスタンスに既にログインしている必要があります。

chlimage_1

正しく追加されていない設定

ユーザー同期が正しく機能しないのは、主に余分な設定が追加されていることが原因です。 代わりに、デフォルトの既存の設定を編集する必要があります。

Web コンソールに表示される、編集されたデフォルトの設定は次のとおりです。 複数のインスタンスが表示される場合は、追加の設定を削除してください。

(オーサー)Apache Sling Distribution Agent - Sync Agents Factory 1 つ

chlimage_1

(オーサー)Adobe Granite Distribution - Encrypted Password Transport Secret Provider 1 つ

chlimage_1

(パブリッシュ)Apache Sling Distribution Agent - Queue Agents Factory 1 つ

chlimage_1

(パブリッシュ)Adobe Granite Distribution - Diff Observer Factory 1 つ

chlimage_1

(オーサー)Apache Sling Distribution Trigger - Scheduled Triggers Factory 1 つ

chlimage_1

応答処理中の操作の例外の変更

ログに次の内容が表示される場合:

org.apache.sling.servlets.post.impl.operations.ModifyOperation Exception during response processing.

java.lang.IllegalStateException: This tree does not exist

節 2. 承認済みユーザーの作成に正しく従っていることを確認してください。

この節では、すべてのパブリッシュインスタンスに存在する承認済みユーザーを作成し、それらをオーサー環境の「秘密鍵プロバイダー」OSGi 設定で特定する方法について説明します。 デフォルトでは、ユーザーは admin です。

承認済みユーザーは administrators ユーザーグループのメンバーにして、そのグループの権限は変更しないでください。

承認済みユーザーは、すべてのパブリッシュインスタンスに対する次の権限および制限を明示的に保持している必要があります。

パス jcr:all rep:glob
/home X */activities/*
/home/users X */activities/*
/home/groups X */activities/*

承認済みユーザーは、administrators グループのメンバーであるので、すべてのパブリッシュインスタンスに対する次の権限があります。

パス jcr:all jcr:read rep:write
/etc/packages/sling/distribution     X
/libs/sling/distribution   X  
/var     X
/var/eventing   X X
/var/sling/distribution   X X

ユーザーグループ同期の失敗

2 つ以上のパブリッシュインスタンスで Sling ID が一致すると、ユーザーグループの同期が失敗します。

9. 一意の Sling ID の節を参照してください

ユーザーおよびユーザーグループの手動同期

ユーザー同期を設定したり、有効にしたりするには、手順 1(Apache Sling Distribution Agent - Sync Agents Factory)に進みます。

パブリッシャーが使用不能になった場合

パブリッシュインスタンスが使用不能になっても、今後オンラインに戻る場合は削除しないでください。パブリッシャーに対する変更はキューに入れられ、パブリッシャーがオンラインに戻った時点で処理されます。

パブリッシュインスタンスがオンラインに戻ることがない場合や永続的にオフラインのままである場合は、削除する必要があります。そのままにしておくと、キューの蓄積によってオーサー環境のディスク使用量が著しく増加します。

パブリッシャーが停止した場合、オーサー環境のログに次のような例外が記録されます。


28.01.2016 15:57:48.475 ERROR
[pool-12-thread-34-org_apache_sling_distribution_queue_socialpubsync_endpoint1
(org/apache/sling/distribution/queue/socialpubsync/endpoint1)]
org.apache.sling.distribution.agent.impl.SimpleDistributionAgent [agent][socialpubsync] could not deliver package distrpackage_1454014575838_a2b45ec8-0400-42f3-bed8-ae09b66381cb
org.apache.sling.distribution.packaging.DistributionPackageImportException: failed in importing package ...

パブリッシャーの削除方法

Apache Sling Distribution Agent - Sync Agents Factory からパブリッシャーを削除するには、配布キューが空であり、静止している必要があります。

本作品は Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License によってライセンス許可を受けています。  Twitter™ および Facebook の投稿には、Creative Commons の規約内容は適用されません。

法律上の注意   |   プライバシーポリシー