文档AEMAEM Screens 指南

在AEM Screens中配置创作和发布实例 configuring-author-and-publish-in-aem-screens

Last update: Wed Apr 10 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • User

本页重点介绍以下主题：

  • 配置作者和发布实例
  • 设置发布拓扑
  • 管理发布：将内容更新从作者发布到设备

先决条件 prerequisites

在开始使用创作和发布服务器之前，您应该事先了解以下知识：

  • AEM拓扑
  • 创建和管理AEM Screens项目
  • 设备注册流程
NOTE
此AEM Screens功能仅在您安装了AEM 6.4 Screens Feature Pack 2时才可用。 要访问此功能包，您必须联系Adobe支持部门并请求获取访问权限。 获得权限后，您可以从包共享下载它。
IMPORTANT
如果要将多个发布实例与Dispatcher一起使用，则必须更新Dispatcher。 请参阅 启用粘性会话 以了解更多详细信息。

配置作者和发布实例 configuring-author-and-publish-instances

NOTE
要了解有关创作和发布架构概述以及如何在AEM创作实例上创作内容并将其转发到多个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实例>锤子图标> 操作 > 配置.

    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：配置基于Oak的Apache Sling发现 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 列表：适应覆盖所有Publish实例的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. 在中键入所需的纯文本密码（所有实例均相同） 纯文本
  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控制台> Main > ActiveMQ Artemis https://localhost:4505/system/console/mq.

  2. 验证并检查“Cluster Information”（群集信息）>“Topology”（拓扑）>“nodes= 2”（节点= 2， members= 2）下的其它实例的端口。

  3. 发送测试消息（屏幕顶部“代理信息”下）

  4. 在字段中输入以下更改：

    1. 目标： /com.adobe.cq.screens/devTestTopic
    2. 文本： Hello World
    3. 查看 error.log ，以便您能够看到消息在整个群集中被发送和接收。
NOTE
在上一步中保存配置后，导航到OSGi控制台可能需要几秒钟。 您还可以查看error.log以了解更多详细信息。

例如，成功配置ActiveMQ Artemis服务器时将显示以下图像。

如果您没有从看到以下配置 /system/console/mq，然后导航到 /system/console/mq 并选择 重新启动 以重新启动代理。

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

删除反向链接标头要求 remove-referrer-header-requirement

按照每个发布实例上的步骤操作：

  1. 导航至 OSGi控制台 > 配置管理器
  2. 选择 Apache Sling引用过滤器
  3. 更新配置和 选中允许为空

配置作者和发布实例 configuring-author-and-publish-instance

设置发布拓扑后，配置创作实例和发布实例以查看实施的实际结果：

NOTE
前提条件
要开始使用此示例，请创建一个AEM Screens项目，然后在您的项目中创建位置、显示和渠道。 向渠道添加内容并分配渠道以进行显示。

步骤1：启动AEM Screens播放器（设备）

  1. 启动单独的浏览器窗口。
  2. 使用转到Screens播放器 Web浏览器，即，https://localhost:4502/content/mobileapps/cq-screens-player/firmware.html 或启动AEM Screens应用程序。 打开设备时，请注意设备的状态为“未注册”。
NOTE
您可以使用下载的AEM Screens应用程序或Web浏览器打开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用户存储，并且可从以下位置激活： 工具 > 安全性 > 用户. 该用户的前缀为“screens”，其中包含一个较长的序列化字符串。

  • 项目 - AEM Screens项目。

  • 位置 — 设备连接到的位置。

  • 渠道 — 此位置显示的一个或多个渠道

  • 计划 — 如果使用计划，请确保已发布计划

  • 位置、计划和渠道文件夹 — 如果相应的资源位于文件夹中。

执行以下步骤以验证创作和发布行为：

  1. 在创作实例上更新某些渠道内容。
  2. 执行 管理发布 以将新更改发布到所有发布实例。
  3. 按 激活 从激活设备 设备管理器.
  4. 编辑URL 从创作实例URL到其中一个发布实例URL。
  5. 验证更新的渠道内容是否显示在AEM Screens播放器上。
  6. 使用其他发布实例重复这些步骤。

步骤5：在“管理”面板中将设备指向“发布”实例 step-pointing-the-device-to-publish-instance-in-the-admin-panel

  1. 从Screens播放器查看管理员UI，长按左上角，以便：在支持触摸的AEM Screens播放器上或使用鼠标打开管理员菜单。
  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

解决方案
为bulk-offline-update-screens-service用户提供读取权限并 screens-devices-master 组代表全部 /content/dam 或您希望使用的特定资源（如果您希望使用更严格的限制）。

如何解决Screens复制代理错误？ replication-agent

解决方案
确保未在代理配置中选中使用反向复制选项。 Screens复制代理不能用作反向复制代理，此功能的作用是将设备命令从创作转发到发布。

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