文件AEMAEM Screens 指南

在AEM Screens中設定作者和發佈執行個體 configuring-author-and-publish-in-aem-screens

Last update: Mon Apr 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • User

本頁面主要說明下列主題：

  • 設定作者和發佈執行個體
  • 設定發佈拓撲
  • 管理出版物：將內容更新從作者傳送到發佈到裝置

先決條件 prerequisites

開始使用作者和發佈伺服器之前，您應該具備以下預先知識：

  • AEM拓撲
  • 建立和管理AEM Screens專案
  • 裝置註冊程式
NOTE
此AEM Screens功能僅在您已安裝AEM 6.4 Screens Feature Pack 2時可用。 若要存取此Feature Pack，請聯絡Adobe支援並要求存取權。 取得許可權後，即可從「封裝共用」下載。
IMPORTANT
如果您想要搭配Dispatcher使用多個發佈執行個體，請更新Dispatcher。 另請參閱 啟用粘性工作階段.

設定作者和發佈執行個體 configuring-author-and-publish-instances

NOTE
若要深入瞭解作者與發佈架構概覽，以及如何在AEM Author執行個體上製作內容，然後轉送復寫至多個Publish執行個體，請參閱 製作與發佈架構概覽.

以下章節說明如何在製作和發佈拓撲上設定復寫代理程式。

您可以設定一個簡單範例，在此範例中託管「作者」和兩個「發佈」例項：

  • 作者> localhost：4502
  • 發佈1 (pub1) > localhost：4503
  • 發佈2 (pub2) > localhost：4504

在作者上設定復寫代理 setting-replication-agents

若要建立復寫代理，請瞭解如何建立標準復寫代理。

Screens需要三個復寫代理：

  1. 預設復寫代理 ​(指定為​** 標準復寫代理**)
  2. Screens復寫代理
  3. 反向復寫代理

步驟1：建立預設復寫代理程式 step-creating-a-default-replication-agent

請依照下列步驟建立預設的復寫代理程式：

  1. 導覽至您的AEM執行個體> hammer圖示> 作業 > 設定.

    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
    使用者必須檢查 已啟用 以啟用復寫代理。 在「預設」、「畫面」和「反向復寫代理」上核取此選項。

    screen_shot_2019-02-25at30134pm

  8. 導覽至 傳輸 標籤並輸入 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復寫代理程式。 現成可用的有一個名為Screens的復寫代理程式指向連線埠4503。 啟用它。

  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型探索 step-configure-apache-sling-oak-based-discovery

為拓撲中的所有發佈執行個體設定Apache Sling Oak型探索

對於每個發佈執行個體：

  1. 瀏覽至 https://<host>:<port>/system/console/configMgr

  2. 選取 Apache Sling Oak型探索服務 設定。

  3. 更新拓朴聯結器URL：新增符合以下條件的所有參與發佈執行個體的URL：

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

  4. 拓撲聯結器 Whitelist 清單：調整成涵蓋所有發佈執行個體的IP或子網路。 確定您 whitelist 所有沒有連線埠號碼的發佈執行個體的IP/主機名稱。

  5. 啟用 自動停止本機回圈

每個Publish例項的設定應該相同，而且自動停止Local-loop可防止無限回圈。

步驟2：驗證發佈拓撲 step-verify-publish-topology

對於任何Publish執行個體，請瀏覽至 https://:/system/console/topology. 您應該會看到拓撲中代表的每個發佈執行個體，在 傳出拓撲聯結器.

步驟3：設定ActiveMQ Artemis叢集 step-setup-activemq-artemis-cluster

此步驟可讓您為ActiveMQ Artemis叢集建立加密密碼。
拓撲中所有發佈執行個體的叢集使用者和密碼必須相同。 必須加密ActiveMQ Artemis設定的密碼。 因為每個執行個體都有自己的加密金鑰，所以必須使用「加密支援」來建立加密的密碼字串。 接著，加密密碼便可用於ActiveMQ的OSGi設定。

在每個發佈執行個體上：

  1. 在OSGi主控台，導覽至 主要 > Crypto支援 (https://<host>:<port>/system/console/crypto)。
  2. 在中輸入所需的純文字密碼（所有執行個體都相同） 純文字
  3. 選取 Protect.
  4. 複製值 受保護的文字 至記事本或文字編輯器。 此值可用於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提供者 設定

  3. 更新下列專案：

    • 叢集密碼：針對各個執行個體使用先前步驟的加密值
    • 主題： {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. 在「叢集資訊>拓撲>節點=2，成員=2」下驗證並檢查以檢視其他執行處理的連線埠。

  3. 傳送測試訊息（畫面頂端的「代理人資訊」下方）

  4. 在欄位中輸入下列變更：

    1. 目的地： /com.adobe.cq.screens/devTestTopic
    2. 文字： Hello World
    3. 檢視 error.log 每個執行個體的ID，讓您檢視該訊息是透過叢集傳送和接收的。
NOTE
在上一步中儲存設定後，導覽至OSGi控制檯可能需要幾秒鐘的時間。 您也可以檢查error.log以取得詳細資料。

例如，下列影像會顯示在ActiveMQ Artemis伺服器的成功設定上。

如果您沒有從看到下列設定 /system/console/mq，然後導覽至 /system/console/mq 並選取 重新啟動 以重新啟動Broker。

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

移除反向連結標題要求 remove-referrer-header-requirement

請依照每個Publish執行個體上的步驟操作：

  1. 導覽至 OSGi控制檯 > 組態管理員
  2. 選取 Apache Sling查閱者篩選器
  3. 更新設定和 勾選允許空白

設定作者和發佈例項 configuring-author-and-publish-instance

設定發佈拓撲後，請設定Author和Publish執行個體以檢視實作的實際結果：

NOTE
必備條件
若要開始使用此範例，請建立AEM Screens專案，接著在您的專案中建立位置、顯示和頻道。 新增內容至您的頻道，並將頻道指派給顯示區。

步驟1：啟動AEM Screens播放器（裝置）

  1. 啟動個別的瀏覽器視窗。
  2. 前往Screens播放器，使用 網頁瀏覽器，也就是https://localhost:4502/content/mobileapps/cq-screens-player/firmware.html 或啟動AEM Screens應用程式。 開啟裝置時，請注意裝置狀態為「已取消註冊」。
NOTE
您可以使用下載的AEM Screens應用程式或網頁瀏覽器來開啟AEM Screens播放器。

步驟2：在作者上註冊裝置 step-registering-a-device-on-author

  1. 前往 https://localhost:4502/screens.html/content/screens/we-retail 或選取您的專案，並導覽至「裝置>裝置管理員」。
  2. 選取 註冊裝置.
  3. 選取 裝置註冊.
  4. 選取您要註冊的裝置，然後選取 註冊裝置.
  5. 驗證註冊代碼，然後選取 驗證.
  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. 以滑鼠右鍵按一下群組並選取「 」 啟動.
CAUTION
請勿啟動author-publish-screens-service，因為它是作者工作使用的系統使用者。

您也可以從「裝置管理主控台」啟動裝置。 請遵循下列步驟：

  1. 導覽至您的畫面專案> 裝置.
  2. 選取 裝置管理員 從動作列移除。
  3. 選取裝置，然後選取 啟動 從動作列中，如下圖所示。

screen_shot_2019-02-21at111036am

NOTE
或者，在啟動裝置後，您也可以編輯或更新伺服器URL。 選取 編輯伺服器URL 之後，您的變更會從動作列傳播至AEM Screens播放器，如下圖所示。

screen_shot_2019-02-21at105527am

發佈檢查清單 publishing-check-list

下列幾點為「發佈檢查」清單的摘要：

  • 熒幕裝置使用者 — 這會儲存為AEM使用者，並且可從以下位置啟用： 工具 > 安全性 > 使用者. 使用者會以含有長序列化字串的「畫面」為前置詞。

  • 專案 - AEM Screens專案。

  • 位置 — 裝置所連線的位置。

  • 頻道 — 此位置顯示的一或多個色版

  • 排程 — 如果使用排程，請確保已發佈此排程

  • 位置、時程表和頻道資料夾 — 如果對應的資源在資料夾內。

請依照下列步驟操作，確認編寫和發佈行為：

  1. 更新Author例項上的部分管道內容。
  2. 執行 管理發布 以發佈對所有Publish執行個體的新變更。
  3. 按下 啟動 以從啟動裝置 裝置管理員.
  4. 編輯URL 從製作執行個體URL至其中一個發佈執行個體URL。
  5. 驗證AEM Screens播放器上是否顯示更新的頻道內容。
  6. 使用不同的Publish例項重複這些步驟。

步驟5：在管理面板中將裝置指向發佈執行個體 step-pointing-the-device-to-publish-instance-in-the-admin-panel

  1. 從Screens播放器檢視Admin UI，長按左上角，就能在已啟用觸控功能的AEM Screens播放器上或使用滑鼠開啟Admin功能表。
  2. 選取 設定 選項。
  3. 在中將作者執行個體變更為發佈執行個體 伺服器.

在AEM Screens播放器中檢視變更。

或者，您也可以使用下列步驟，從裝置管理主控台更新/編輯伺服器URL：

  1. 導覽至您的AEM Screens專案，然後選取 裝置 資料夾。
  2. 選取 裝置管理員 從動作列移除。
  3. 選取裝置，然後選取 編輯伺服器URL 從動作列中（如下圖所示），您的變更會傳播至AEM Screens播放器。

screen_shot_2019-02-07at31028pm

此 管理發布 功能可讓您傳遞從「作者」到「發佈至裝置」的內容更新。 您可以為整個AEM Screens專案或僅限其中一個管道、位置、裝置、應用程式或排程發佈/取消發佈內容。 若要深入瞭解此功能，請參閱 隨選內容更新.

疑難排解提示 troubleshoot-tips

請依照以下章節取得與作者/發佈設定相關的常見問題解答。

如何在初始註冊和指派後新增從https到http的重新導向？ add-redirect

解決方案
設定啟用 Proxy/Load Balancer Connection in the Jetty configuration 至 true.

如何更新離線內容及播放器下載問題，以及外部資產的問題 /content/dam/projects/<project>？ update-offline-content

解決方案
為大量離線更新畫面服務使用者提供讀取許可權，並 screens-devices-master 所有對象的群組 /content/dam 或您想要使用的特定資產（如果您想限制較嚴格）。

如何解決Screens復寫代理錯誤？ replication-agent

解決方案
請確定您尚未在代理程式設定中勾選「使用反向復寫」選項。 Screens復寫代理程式無法當作反向復寫代理程式使用，此功能的範圍是將裝置命令從製作轉送至發佈。

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