AEM Screens でのオーサーとパブリッシュの設定 configuring-author-and-publish-in-aem-screens
ここでは、以下のトピックについて重点的に説明します。
- オーサーインスタンスとパブリッシュインスタンスの設定
- パブリッシュトポロジのセットアップ
- 公開の管理:オーサーからパブリッシュ経由でデバイスにコンテンツの更新を配信
前提条件 prerequisites
オーサーサーバーとパブリッシュサーバーの使用を開始する前に、以下に関する事前の知識が必要です。
- AEM トポロジ
- AEM Screens プロジェクトの作成と管理
- デバイス登録プロセス
オーサーインスタンスとパブリッシュインスタンスの設定 configuring-author-and-publish-instances
次の節では、オーサーおよびパブリッシュトポロジにレプリケーションエージェントをセットアップする方法について説明します。
次のような 1 つのオーサーインスタンスと 2 つのパブリッシュインスタンスをホストする簡単な例を示します。
- オーサー --> localhost:4502
- パブリッシュ 1(pub1) --> localhost:4503
- パブリッシュ 2(pub2) --> localhost:4504
オーサー環境へのレプリケーションエージェントのセットアップ setting-replication-agents
レプリケーションエージェントを作成するには、標準のレプリケーションエージェントの作成方法を習得する必要があります。
AEM Screens には次の 3 つのレプリケーションエージェントが必要です。
- デフォルトレプリケーションエージェント*(*標準レプリケーションエージェント として指定)
- Screens レプリケーションエージェント
- リバースレプリケーションエージェント
手順 1:デフォルトレプリケーションエージェントの作成 step-creating-a-default-replication-agent
以下の手順に従って、デフォルトレプリケーションエージェントを作成します。
-
AEM インスタンス/ハンマーアイコン/運営/設定 に移動します。
-
左側のナビゲーションツリーから「レプリケーション」を選択します。
-
レプリケーション フォルダーから「作成者のエージェント」を選択し、「新規作成」をクリックして新しい標準レプリケーションエージェントを作成します。
-
作成するレプリケーションエージェントの「タイトル」と「名前」を入力し、「作成」をクリックします。
-
レプリケーションエージェントを右クリックし、「開く」をクリックして設定を編集します。
-
「編集」をクリックして エージェントの設定 ダイアログボックスを開き、詳細を入力します。
note note NOTE レプリケーションエージェントを有効にするには、「有効」をオンにする必要があります。このオプションは、デフォルトレプリケーションエージェント、Screens レプリケーションエージェント、リバースレプリケーションエージェントでオンにする必要があります。 -
「トランスポート」タブに移動し、「URI」、「ユーザー」、「パスワード」を入力します。
note note NOTE また、既存のデフォルトレプリケーションエージェントをコピーして名前を変更することもできます。
標準レプリケーションエージェントの作成 creating-standard-replication-agents
- pub1 の標準レプリケーションエージェントを作成します(すぐに使用できるデフォルトエージェントは既に設定されている必要があります)(例:https://<hostname>:4503/bin/receive?sling:authRequestLogin=1)。
- pub2 の標準レプリケーションエージェントを作成します。pub1 のレプリケーションエージェントをコピーし、トランスポート設定でポートを変更することで、トランスポートを pub2 に使用するように更新できます。(例:https://<hostname>:4504/bin/receive?sling:authRequestLogin=1)。
Screens レプリケーションエージェントの作成 creating-screens-replication-agents
-
pub1 の Screens レプリケーションエージェントを作成します。標準では、ポート 4503 を指す名前付きの Screens レプリケーションエージェントが 1 つ用意されています。これを有効にする必要があります。
-
pub2 の Screens レプリケーションエージェントを作成します。pub1 の Screens レプリケーションエージェントをコピーし、pub2 の 4504 を指すようにポートを変更します。
note note NOTE Screens レプリケーションエージェントの設定方法については、Screens レプリケーションエージェントの設定を参照してください。
Screens リバースレプリケーションエージェントの作成 creating-screens-reverse-replication-agents
- pub1 のリバースレプリケーションエージェントを作成します。
- 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 をセットアップします。
パブリッシュインスタンスごとに以下をおこないます。
-
https://<host>:<port>/system/console/configMgr
に移動します。 -
「Apache Sling Oak-Based Discovery Service」の設定を選択します。
-
トポロジコネクタ URL の更新:参加するすべてのパブリッシュインスタンスの URL を追加します。
https://publish:4503/libs/sling/topology/connector
https://publish:4504/libs/sling/topology/connector
-
Topology Connector 許可リストのリスト:すべてのパブリッシュインスタンスをカバーする IP またはサブネットに適応します。ポート番号なしで、すべてのパブリッシュインスタンスの IP/ホスト名を、許可リストに登録してください。
-
「ローカルループの自動停止」をオンにします。
各パブリッシュインスタンスの設定は同じにする必要があり、ローカルループの自動停止は無限ループを防ぎます。
手順 2:パブリッシュトポロジの確認 step-verify-publish-topology
任意のパブリッシュインスタンスについて、https://:/system/console/topology
に移動します。各パブリッシュインスタンスは、送信トポロジコネクタ の下に表示されているはずです。
手順 3:ActiveMQ Artemis クラスターのセットアップ step-setup-activemq-artemis-cluster
この手順では、ActiveMQ Artemis クラスターの暗号化パスワードを作成できます。
トポロジ内のすべてのパブリッシュインスタンスについて、クラスターユーザーおよびパスワードは共通でなければなりません。ActiveMQ Artemis 設定のパスワードは暗号化する必要があります。インスタンスごとに専用の暗号化キーがあるので、Crypto Support を使用して、暗号化されたパスワード文字列を作成する必要があります。こうして暗号化されたパスワードは、ActiveMQ の OSGi 設定で使用されることになります。
各パブリッシュインスタンスで以下をおこないます。
- OSGi コンソールで、Main/Crypto Support(
https://<host>:<port>/system/console/crypto
)に移動します。 - 目的のプレーンテキストパスワード(すべてのインスタンスに共通)を「Plain Text」に入力します。
- 「Protect」をクリックします。
- 「Protected Text」の値をメモ帳またはテキストエディターにコピーします。この値は、ActiveMQ の OSGi 設定で使用されることになります。
デフォルトでは、パブリッシュインスタンスごとに一意の暗号キーが存在するので、この手順を各パブリッシュインスタンスで実行し、次回の設定用にこの一意のキーを保存する必要があります。
{1ec346330f1c26b5c48255084c3b7272a5e85260322edd59119828d1fa0a610e}
手順 4:ActiveMQ Artemis クラスターのアクティブ化 step-activate-activemq-artemis-cluster
各パブリッシュインスタンスで以下をおこないます。
-
OSGi 設定マネージャー(
https://<host>:<port>/system/console/configMgr
)に移動します。 -
「Apache ActiveMQ Artemis JMS Provider」の設定を選択します。
-
以下を更新します。
- Cluster Password:(インスタンスごとに前の手順の暗号化された値を使用)
- トピック:
{name: 'commands', address: 'com.adobe.cq.screens.commands', maxConsumers: 50}
ActiveMQ Artemis クラスターの確認 verify-activemq-artemis-cluster
各パブリッシュインスタンスで次の手順に従います。
-
OSGi コンソールで、Main/ActiveMQ Artemis(
https://localhost:4505/system/console/mq
)に移動します。 -
Cluster Information/Topology でノード数 2、メンバー数 2 を選択し、他のインスタンスのポートを確認します。
-
テストメッセージを送信します(画面上部の「Broker Information」の下)。
-
各フィールドを次のように変更します。
- Destination:/com.adobe.cq.screens/devTestTopic
- Text:Hello World
- 各インスタンスの error.log を表示して、メッセージがクラスター全体で送受信されたことを確認します。
例えば、次の画像は、ActiveMQ Artemis サーバーの設定が正常におこなわれた場合に表示されます。
次の設定が /system/console/mq に表示されない場合は、/system/console/mq に移動し、「Restart」をクリックしてブローカーを再起動します。
リファラーヘッダー要件の削除 remove-referrer-header-requirement
各パブリッシュインスタンスで次の手順に従います。
- OSGi コンソール を開いて Configuration Manager に移動します。
- 「Apache Sling Referrer Filter」を選択します。
- 設定を更新し、「Allow Empty」をオンにします。
オーサーインスタンスとパブリッシュインスタンスの設定 configuring-author-and-publish-instance
パブリッシュ環境のトポロジをセットアップしたら、実装の実際の結果を表示するようにオーサーインスタンスとパブリッシュインスタンスを設定する必要があります。
手順 1:AEM Screens Player(デバイス)の起動 step-starting-an-aem-screens-player-device
- 別のブラウザーウィンドウを起動します。
- Web ブラウザーを使用して Screens Player(
https://localhost:4502/content/mobileapps/cq-screens-player/firmware.html
)に移動するか、AEM Screens アプリを起動します。デバイスを開くと、デバイスの状態が未登録であることがわかります。
手順 2:オーサー環境へのデバイスの登録 step-registering-a-device-on-author
https://localhost:4502/screens.html/content/screens/we-retail
に移動するか、プロジェクトを選択してデバイス/デバイスマネージャーに移動します。- 「デバイスを登録」をクリックします。
- 「デバイスの登録」をクリックして、デバイスを表示します。
- 登録するデバイスを選択して、「デバイスを登録」をクリックします。
- 登録コードを確認し、「検証」をクリックします。
- デバイスのタイトルを入力し、「登録」をクリックします。
手順 3:ディスプレイへのデバイスの割り当て step-assigning-the-device-to-display
- 前の手順のダイアログボックスで、「ディスプレイを割り当て」をクリックします。
- ロケーション フォルダーから、チャネルのディスプレイのパスを選択します。
- 「割り当て」をクリックします。
- 「完了」をクリックしてプロセスを完了すると、デバイスが割り当てられます。
プレーヤーを確認すると、チャネルに追加したコンテンツが表示されます。
手順 4:パブリッシュインスタンスへのデバイス設定の公開 step-publishing-device-configuration-to-publish-instances
デバイスの確認
次の手順に従って、デバイスユーザーをレプリケートします。
- ユーザー管理ページ(例:
https://localhost:4502/useradmin
)に移動します。 - screens-devices-master グループを検索します。
- このグループを右クリックし、「アクティブ化」をクリックします。
また、デバイス管理コンソールからデバイスをアクティブ化することもできます。次の手順に従います。
- Screens プロジェクト/デバイス に移動します。
- アクションバーの「デバイスマネージャー」をクリックします。
- 次の図に示すように、デバイスを選択し、アクションバーの「アクティブ化」をクリックします。
チェックリストの公開 publishing-check-list
チェックリストの公開の要点は次のとおりです。
-
Screens デバイスユーザー - AEM ユーザーとして保存され、ツール/セキュリティ/ユーザー でアクティブ化できます。ユーザー名の先頭には、「screens」とシリアル化された長い文字列が付けられます。
-
プロジェクト - AEM Screens プロジェクト。
-
ロケーション - デバイスの接続先となるロケーション。
-
チャネル - ロケーションに表示されている 1 つ以上のチャネル。
-
スケジュール - スケジュールを使用する場合は、スケジュールを必ず公開します。
-
ロケーション、スケジュール、チャネルの各フォルダー - 対応するリソースがフォルダー内にある場合。
次の手順に従って、オーサーとパブリッシュの動作を確認します。
- オーサーインスタンスのチャネルコンテンツの一部を更新します。
- 「公開を管理」を実行して、すべてのパブリッシュインスタンスに新しい変更を公開します。
- 「アクティブ化」をクリックして、デバイスマネージャー からデバイスをアクティブ化します。
- オーサーインスタンス URL からパブリッシュインスタンス URL の 1 つに URL を編集 します。
- AEM Screens Player に更新されたチャネルコンテンツが表示されることを確認します。
- 別のパブリッシュインスタンスを使用して、これらの手順を繰り返します。
手順 5 :パブリッシュインスタンスを指すように管理パネルでデバイスを設定 step-pointing-the-device-to-publish-instance-in-the-admin-panel
- Screens Player から Admin UI を表示します。それには、タッチ操作対応の AEM Screens Player またはマウスを使用して左上隅を長押しして、Admin メニューを開きます。
- サイドパネルの「設定」オプションをクリックします。
- 「サーバー」のオーサーインスタンスをパブリッシュインスタンスに変更します。
AEM Screens Player で変更結果を表示します。
または、次の手順に従って、デバイス管理コンソールでサーバー URL を更新または編集することもできます。
- AEM Screens プロジェクトに移動し、デバイス フォルダーを選択します。
- アクションバーの「デバイスマネージャー」をクリックします。
- デバイスを選択し、アクションバーの「サーバー URL を編集」をクリックします(下図を参照)。変更内容が AEM Screens Player に反映されます。
「公開を管理」機能を使用すると、コンテンツの更新をオーサーからパブリッシュ経由でデバイスに配信できます。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
解決策
より制限する必要がある場合は、すべての /content/dam
または使用する特定のアセットの bulk-offline-update-screens-service ユーザーと screens-devices-master グループに読み取り権限を付与します。
Screens レプリケーションエージェントのエラーを解決する方法について教えてください。 replication-agent
解決策
エージェント設定で「リバースレプリケーションに使用」オプションがオンになっていないことを確認してください。Screens レプリケーションエージェントは、リバースレプリケーションエージェントとして使用できません。この機能の範囲は、デバイスコマンドを作成者からパブリッシュに転送することです。