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

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

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

先決條件 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

請依照每個發佈執行個體中的步驟操作:

  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 Player。

步驟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 Player。

screen_shot_2019-02-21at105527am

發佈檢查清單 publishing-check-list

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

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

  • 專案 - AEM Screens專案。

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

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

  • 排程 — 如果使用排程,請確定此排程已發佈。

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

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

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

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

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

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

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

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

screen_shot_2019-02-07at31028pm

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

疑難排解提示 troubleshoot-tips

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

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

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

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

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

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

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

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