文档

AEM MSM问题疑难解答

Last update: Thu Sep 11 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

本文介绍了对任何AEM MSM问题进行故障诊断的方法。 此外，还讨论了以下内容：

  • 查找有关您的Blueprint和活动副本状态的高级信息
  • 检查存储库中的MSM特定信息
  • 在提出MSM支持票证时要提供的信息

描述 description

环境

Experience Manager

问题/症状

要开始的基本验证：

解决方法 resolution

查找有关您的Blueprint和活动副本状态的高级信息

多站点管理器(MSM)在资源URL上注册多个可使用选择器请求的servlet。

它们由UI使用，也可以直接请求以直接查看页面的其他高级计算MSM状态：

  1. http://host:port/content/path/to/bluprint/page.blueprint.json？&maxSize=500&advancedStatus=true&returnRelationships=true&msm%3Atrigger=ROLLOUT
    在Blueprint页面上使用可检索链接到它的所有活动副本的列表，状态为高级LC。

  2. http://host:port/content/path/to/livecopy/page.msm.json
    在Livecopy页面上使用可获取有关其与Blueprint页面的连接的高级信息。

    如果页面不是Livecopy，则不会返回任何内容。

这些servlet通过com.day.cq.wcm.msm记录器生成值得检查的DEBUG日志消息。

检查存储库中的MSM特定信息

上述servlet返回了基于MSM特定节点和Mixin的计算信息。
信息通过以下方式存储。

  • cq:LiveSync mixin类型

    它在jcr:content节点上设置并定义 根Livecopy页面。

    这些页面将具有类型为cq:LiveSyncConfig的cq:LiveCopy子节点，这些子节点将通过以下属性包含有关Livecopy的基本和必需信息：

    • cq:master — 指向Livecopy的Blueprint页面
    • cq:rolloutConfigs — 指示应用于Livecopy的活动转出配置
    • cq:isDeep — 如果此根Livecopy页面的子页面包含在Livecopy中，则为true。

  • cq:LiveRelationship mixin类型
    任何livecopy页面的jcr:content节点上均具有此类mixin类型。

    如果没有，则页面在某个时间点已被分离，或在Livecopy操作（创建或转出）之外通过创作界面手动创建。

  • cq:LiveSyncCancelled mixin类型
    添加在已暂停的Livecopy页面的jcr:content节点上。

    如果暂停对子页面也有效：将cq:isCancelledForChildren=true属性添加到同一节点上。

此处显示的信息当然应反映在UI中​ 但是，在您可能遇到可能会对UI或MSM行为产生质疑的异常情况下，超级用户可以直接验证这些节点以了解其MSM页面的状态。

了解这些属性对于查询存储库并找出处于特定状态的页面集也很有用。

示例： select *from cq:LiveSync ​将返回所有Livecopy根页面。

在提出MSM支持票证时要提供的信息。

您最终可能需要AEM支持帮助。

在支持门户中提交支持票证时，请按照如何在Experience League上提交支持票证中的准则尽可能确定问题。

对于MSM问题，最好添加这些附加精确度：

  • 在附加日志之前：在com.day.cq.wcm.msm中为记录器/system/console/slinglog启用DEBUG级别，并重复有问题的MSM操作。
  • 附加配置http://<host>:<port>/libs/wcm/msm/content/commands/rolloutconfigs.json的输出
  • 传达附加到活动副本的转出配置
  • 如果问题似乎来自UI（出现浏览器控制台错误或用户界面错误弹出窗口）：在执行有问题的MSM操作时，生成HAR文件以从用户的角度捕获整个流：有关HAR文件生成的详细信息，请参阅此链接

重现问题是支持人员快速分析和确定行为是否正常并相应地采取行动的最简单方法。

为此，请尝试：

  1. 在基于We-Retail页面的类似设置中重现您的问题
  2. 如果不可能，请尝试构建一个包含您的示例内容的内容包，以便支持工程师将该内容包安装在与您的修补程序级别相同的空白AEM实例上，并重现问题。
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f