ドキュメントAEMAEM Screens ガイド

AEM Screensでのオーサーインスタンスとパブリッシュインスタンスの設定 configuring-author-and-publish-in-aem-screens

Last update: Tue Apr 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • User

ここでは、以下のトピックについて重点的に説明します。

  • オーサーインスタンスとパブリッシュインスタンスの設定
  • パブリッシュトポロジのセットアップ
  • 公開の管理：オーサーからパブリッシュ経由でデバイスにコンテンツの更新を配信

前提条件 prerequisites

オーサーサーバーとパブリッシュサーバーを使用するには、事前に次の知識が必要です。

  • AEM トポロジ
  • AEM Screens プロジェクトの作成と管理
  • デバイス登録プロセス
NOTE
このAEM Screens機能は、AEM 6.4 Screens 機能パック 2 をインストールしている場合にのみ使用できます。 この機能パックへのアクセス権を取得するには、Adobeサポートに連絡してアクセス権をリクエストします。 権限を取得したら、Package Share からダウンロードできます。
IMPORTANT
Dispatcher で複数のパブリッシュインスタンスを使用する場合は、Dispatcher を更新します。 参照： スティッキーセッションの有効化.

オーサーインスタンスとパブリッシュインスタンスの設定 configuring-author-and-publish-instances

NOTE
オーサーとパブリッシュのアーキテクチャの概要、およびAEM オーサーインスタンスでコンテンツをオーサリングし、複数のパブリッシュインスタンスに転送レプリケートする方法について詳しくは、を参照してください。 オーサーとパブリッシュのアーキテクチャの概要.

次の節では、オーサートポロジとパブリッシュトポロジでレプリケーションエージェントを設定する方法について説明します。

1 つのオーサーインスタンスと 2 つのパブリッシュインスタンスをホストする簡単な例を設定できます。

  • オーサー/ localhost:4502
  • パブリッシュ 1 （pub1） > localhost:4503
  • パブリッシュ 2 （pub2） > localhost:4504

オーサー環境へのレプリケーションエージェントのセットアップ setting-replication-agents

レプリケーションエージェントを作成するには、標準レプリケーションエージェントの作成方法を参照してください。

Screens には、次の 3 つのレプリケーションエージェントが必要です。

  1. デフォルトレプリケーションエージェント​*（*標準レプリケーションエージェント ​として指定）
  2. Screens レプリケーションエージェント
  3. リバースレプリケーションエージェント

手順 1：デフォルトレプリケーションエージェントの作成 step-creating-a-default-replication-agent

以下の手順に従って、デフォルトレプリケーションエージェントを作成します。

  1. AEM インスタンス/ハンマーアイコン/に移動します。 運用 > 設定.

    screen_shot_2019-02-25at24621pm

  2. 「」をクリックします 複製 左側のナビゲーションツリーから。

    screen_shot_2019-02-25at24715pm

  3. 「」をクリックします オーサー環境のエージェント から 複製 フォルダーをクリックし、 新規 新しい標準レプリケーションエージェントを作成するには、次の手順に従います。

    screen_shot_2019-02-25at25400pm

  4. を入力 タイトル および 名前 レプリケーションエージェントを作成したら、 作成.

    screen_shot_2019-02-25at25737pm

  5. レプリケーションエージェントを右クリックし、 開く をクリックして設定を編集します。

    screen_shot_2019-02-25at30018pm

  6. 「編集」をクリックします。

  7. が含まれる エージェント設定 ダイアログボックスに、詳細を入力します。

    note note
    NOTE
    確認が必要 Enabled をクリックしてレプリケーションエージェントを有効にします。 デフォルト、Screens、リバースレプリケーションエージェントでこのオプションをオンにします。

    screen_shot_2019-02-25at30134pm

  8. に移動します。 0.48181894 tab キーを押して、 URI, ユーザー、および パスワード.

    screen_shot_2019-03-04at34955pm

    note note
    NOTE
    また、既存のデフォルトレプリケーションエージェントをコピーして名前を変更することもできます。

標準レプリケーションエージェントの作成 creating-standard-replication-agents

  1. pub1 の標準レプリケーションエージェントを作成します（標準のデフォルトエージェントは既に設定されている必要があります）。 例えば、https://<hostname>:4503/bin/receive?sling:authRequestLogin=1 のように指定します。
  2. pub2 の標準レプリケーションエージェントを作成します。pub1 のレプリケーションエージェントをコピーし、トランスポート設定でポートを変更することで、トランスポートを pub2 に使用するように更新できます。例えば、https://<hostname>:4504/bin/receive?sling:authRequestLogin=1 のように指定します。

Screens レプリケーションエージェントの作成 creating-screens-replication-agents

  1. pub1 のAEM Screens レプリケーションエージェントを作成します。 標準では、ポート 4503 を指す名前付きの Screens レプリケーションエージェントが 1 つ用意されています。有効にします。

  2. pub2 のAEM Screens レプリケーションエージェントを作成します。 pub1 の Screens レプリケーションエージェントをコピーし、pub2 の 4504 を指すようにポートを変更します。

    note note
    NOTE
    Screens レプリケーションエージェントの設定方法については、Screens レプリケーションエージェントの設定を参照してください。

Screens リバースレプリケーションエージェントの作成 creating-screens-reverse-replication-agents

  1. pub1 のリバースレプリケーションエージェントを作成します。
  2. pub2 のリバースレプリケーションエージェントを作成します。pub1 のリバースレプリケーションエージェントをコピーし、トランスポート設定のポートを変更することで、トランスポートを pub2 に使用するように更新できます。

パブリッシュトポロジのセットアップ setting-up-publish-topology

手順 1：Apache Sling Oak-Based Discovery の設定 step-configure-apache-sling-oak-based-discovery

トポロジ内のすべてのパブリッシュインスタンスに、Apache Sling Oak-Based Discovery をセットアップします。

各パブリッシュインスタンスに対して、次の手順を実行します。

  1. https://<host>:<port>/system/console/configMgr に移動します。

  2. クリック Apache Sling Oak-Based Discovery Service 設定。

  3. Topology Connector URL を更新：次の条件を満たすすべてのパブリッシュインスタンスの URL を追加します。

    • https://publish:4503/libs/sling/topology/connector
    • https://publish:4504/libs/sling/topology/connector

  4. Topology コネクタ Whitelist リスト：すべてのパブリッシュインスタンスをカバーする IP またはサブネットに適応します。 以下を確実に実行します whitelist ポート番号のないすべてのパブリッシュインスタンスの IP/ホスト名。

  5. 「ローカルループの自動停止」をオンにします。

設定は各パブリッシュインスタンスで同一である必要があり、自動停止ローカルループは無限ループを防ぎます。

手順 2：パブリッシュトポロジの確認 step-verify-publish-topology

どのパブリッシュインスタンスについても、に移動します。 https://:/system/console/topology. トポロジ内のの下に各パブリッシュインスタンスが表示されます。 発信トポロジ コネクタ.

手順 3：ActiveMQ Artemis クラスターのセットアップ step-setup-activemq-artemis-cluster

この手順では、ActiveMQ Artemis クラスターの暗号化されたパスワードを作成できます。
トポロジ内のすべてのパブリッシュインスタンスのクラスターユーザーとパスワードは同じである必要があります。 ActiveMQ Artemis 構成のパスワードを暗号化する必要があります。 各インスタンスには独自の暗号化キーがあるので、暗号化されたパスワード文字列を作成するには、暗号サポートを使用する必要があります。 暗号化されたパスワードは、ActiveMQ の OSGi 設定で使用できます。

各パブリッシュインスタンスで以下をおこないます。

  1. OSGi コンソールで、に移動します。 メイン > 暗号のサポート （https://<host>:<port>/system/console/crypto）に設定します。
  2. 目的のプレーンテキストパスワード（すべてのインスタンスに共通）を「Plain Text」に入力します。
  3. 「Protect」をクリックします。
  4. 「Protected Text」の値をメモ帳またはテキストエディターにコピーします。この値は、ActiveMQ の OSGi 設定で使用できます。

各パブリッシュインスタンスはデフォルトで一意の暗号鍵を持つので、この手順を各パブインスタンスで実行し、次の設定のために一意の鍵を保存します。

NOTE
パスワードは波括弧（{}）で囲んでください。次に例を示します。
{1ec346330f1c26b5c48255084c3b7272a5e85260322edd59119828d1fa0a610e}

手順 4：ActiveMQ Artemis クラスターのアクティブ化 step-activate-activemq-artemis-cluster

各パブリッシュインスタンスで以下をおこないます。

  1. OSGi 設定マネージャー（https://<host>:<port>/system/console/configMgr）に移動します。

  2. クリック Apache ActiveMQ Artemis JMS Provider 設定

  3. 以下を更新します。

    • Cluster Password：（インスタンスごとに前の手順の暗号化された値を使用）
    • トピック：{name: 'commands', address: 'com.adobe.cq.screens.commands', maxConsumers: 50}

ActiveMQ Artemis クラスターの確認 verify-activemq-artemis-cluster

各パブリッシュインスタンスで次の手順に従います。

  1. OSGi コンソール/メイン/ActiveMQ Artemis に移動します。 https://localhost:4505/system/console/mq.

  2. Cluster Information／Topology でノード数 2、メンバー数 2 を選択し、他のインスタンスのポートを確認します。

  3. テストメッセージを送信します（画面上部の「Broker Information」の下）。

  4. 各フィールドを次のように変更します。

    1. Destination：/com.adobe.cq.screens/devTestTopic
    2. Text：Hello World
    3. を表示する error.log （各インスタンスの）。メッセージがクラスター全体で送受信されたことがわかります。
NOTE
前の手順で設定を保存してから、OSGi コンソールへの移動に数秒かかる場合があります。 詳しくは、error.log を確認することもできます。

例えば、次の画像は、ActiveMQ Artemis サーバーの設定が正常におこなわれた場合に表示されます。

次の設定が /system/console/mq に表示されない場合は、/system/console/mq に移動し、「Restart」をクリックしてブローカーを再起動します。

image-2018-06-18-18-14-55-449

リファラーヘッダー要件の削除 remove-referrer-header-requirement

各パブリッシュインスタンスで次の手順に従います。

  1. OSGi コンソール ​を開いて Configuration Manager に移動します。
  2. クリック Apache Sling Referrer Filter
  3. 設定を更新し、「Allow Empty」をオンにします。

オーサーインスタンスとパブリッシュインスタンスの設定 configuring-author-and-publish-instance

パブリッシュトポロジを設定したら、オーサーインスタンスとパブリッシュインスタンスを設定して、実装の実際の結果を表示します。

NOTE
前提条件
この例を使い始めるには、AEM Screens プロジェクトを作成したあと、プロジェクトで場所、ディスプレイ、チャネルを作成します。 チャネルにコンテンツを追加し、このチャネルをディスプレイに割り当てます。

手順 1：AEM Screens Player（デバイス）の起動

  1. 別のブラウザーウィンドウを起動します。
  2. Web ブラウザーを使用して Screens Player（https://localhost:4502/content/mobileapps/cq-screens-player/firmware.html）に移動するか、AEM Screens アプリを起動します。デバイスを開くと、デバイスの状態が未登録になっています。
NOTE
AEM Screens Player を開くには、ダウンロードした AEM Screens アプリか Web ブラウザーを使用します。

手順 2：オーサー環境へのデバイスの登録 step-registering-a-device-on-author

  1. に移動 https://localhost:4502/screens.html/content/screens/we-retail または、プロジェクトをクリックし、デバイス / デバイスマネージャーに移動します。
  2. クリック デバイスの登録.
  3. クリック デバイスの登録.
  4. 登録するデバイスをクリックし、 デバイスの登録.
  5. 登録コードを確認し、 Validate.
  6. デバイスのタイトルを入力し、 登録.

手順 3：ディスプレイへのデバイスの割り当て step-assigning-the-device-to-display

  1. 前の手順のダイアログボックスで、「ディスプレイを割り当て」をクリックします。
  2. からチャネルのディスプレイパスをクリックします 場所 フォルダー。
  3. 「割り当て」をクリックします。
  4. 「完了」をクリックしてプロセスを完了すると、デバイスが割り当てられます。

プレーヤーを確認し、チャネルに追加したコンテンツに注目してください。

手順 4：パブリッシュインスタンスへのデバイス設定の公開 step-publishing-device-configuration-to-publish-instances

デバイスの確認

次の手順に従って、デバイスユーザーをレプリケートします。

  1. ユーザー管理者ページに移動します。 例えば、https://localhost:4502/useradmin のように指定します。
  2. を検索 screens-devices-master グループ。
  3. グループを右クリックし、 Activate.
CAUTION
author-publish-screens-service は、オーサージョブで使用されるシステムユーザーなので、アクティベートしないでください。

また、デバイス管理コンソールからデバイスをアクティブ化することもできます。次の手順に従います。

  1. Screens プロジェクトに移動します。 デバイス.
  2. アクションバーの「デバイスマネージャー」をクリックします。
  3. デバイスをクリックし、 Activate アクションバーから移動します（下図を参照）。

screen_shot_2019-02-21at111036am

NOTE
または、デバイスをアクティブにした後で、サーバー URL を編集または更新することもできます。 クリック サーバー URL を編集 次の図に示すように、アクションバーから、変更内容がAEM Screens player に反映されます。

screen_shot_2019-02-21at105527am

チェックリストの公開 publishing-check-list

次のポイントは、発行チェック リストの概要を示しています。

  • Screens デバイスユーザー - AEM ユーザーとして保存され、ツール／セキュリティ／ユーザー ​でアクティブ化できます。ユーザーの先頭には、シリアル化された長い文字列を含む「screens」が付きます。

  • プロジェクト - AEM Screens プロジェクト。

  • ロケーション - デバイスの接続先となるロケーション。

  • チャネル – その場所に表示されている 1 つ以上のチャネル

  • スケジュール - スケジュールを使用する場合は、スケジュールを必ず公開します。

  • ロケーション、スケジュール、チャネルの各フォルダー - 対応するリソースがフォルダー内にある場合。

オーサリングと公開の動作を確認するには、次の手順に従います。

  1. オーサーインスタンスで一部のチャネルコンテンツを更新します。
  2. 実行 公開を管理 をクリックして、新しい変更をすべてのパブリッシュインスタンスに公開します。
  3. 押す Activate からデバイスをアクティブにするには デバイスマネージャ.
  4. URL を編集 オーサーインスタンスの URL から、パブリッシュインスタンスの URL のいずれかに移動します。
  5. 更新されたチャネルコンテンツがAEM Screens Player に表示されることを確認します。
  6. 別のパブリッシュインスタンスを使用してこれらの手順を繰り返します。

手順 5 ：パブリッシュインスタンスを指すように管理パネルでデバイスを設定 step-pointing-the-device-to-publish-instance-in-the-admin-panel

  1. Screens Player で管理 UI を表示します。左上隅を長押しして、「管理」メニューを開いたり、タッチ操作対応AEM Screens Player で開いたり、マウスを使用したりします。
  2. サイドパネルの「設定」オプションをクリックします。
  3. オーサーインスタンスをパブリッシュインスタンスに変更する場所 サーバー.

AEM Screens Player で変更結果を表示します。

または、次の手順に従って、デバイス管理コンソールでサーバー URL を更新または編集することもできます。

  1. AEM Screens プロジェクトに移動し、 デバイス フォルダー。
  2. アクションバーの「デバイスマネージャー」をクリックします。
  3. デバイスをクリックし、 サーバー URL を編集 アクションバーから（下図を参照）、変更内容がAEM Screens player に反映されます。

screen_shot_2019-02-07at31028pm

この 公開を管理 機能を使用すると、オーサーからパブリッシュ経由でデバイスにコンテンツのアップデートを配信できます。 AEM Screens プロジェクト全体のコンテンツを公開/非公開にすることも、チャネル、場所、デバイス、アプリケーション、スケジュールのいずれか 1 つのコンテンツを公開/非公開にすることもできます。 この機能について詳しくは、 オンデマンドのコンテンツ更新.

トラブルシューティングのヒント troubleshoot-tips

以下の節に従って、作成者や公開の設定に関連したよくある質問に対する回答を入手します。

最初の登録と割り当ての後に https から http へのリダイレクトを追加する方法について教えてください。 add-redirect

解決策
Proxy/Load Balancer Connection in the Jetty configuration の有効化を true に設定します。

/content/dam/projects/<project> 外部のアセットでオフラインコンテンツとプレーヤーダウンロードの問題を更新する方法について教えてください。 update-offline-content

解決策
bulk-offline-update-screens-service ユーザーに読み取り権限を付与し、 screens-devices-master グループのすべて /content/dam または、より制限する必要がある場合は、使用する特定のアセットを選択します。

Screens レプリケーションエージェントのエラーを解決する方法について教えてください。 replication-agent

解決策
エージェント設定で「リバースレプリケーションに使用」オプションがオンになっていないことを確認してください。Screens レプリケーションエージェントは、リバースレプリケーションエージェントとして使用できません。この機能の範囲は、デバイスコマンドをオーサーからパブリッシュに転送することです。

recommendation-more-help
adce462a-f916-4dbe-9ab5-0b62cfb0f053