由于不兼容的捆绑包以及恢复后的内容问题,暂存创作实例

本文介绍如何恢复在恢复后由于捆绑包不兼容并且缺少服务用户而无法启动或提供内容的Adobe Experience Manager暂存创作实例。

描述 description

环境

Adobe Experience Manager (AEM)

问题/症状

  • 暂存创作实例在较长的一段时间(8小时以上)内不可访问。
  • 浏览创作实例会导致错误或空白页面。
  • 位于/libs/granite/core/content/login.html的登录页面不可访问。
  • 错误日志显示不兼容的捆绑包和缺少服务用户的问题。
  • 存在与org.apache.aries.spifly.dynamic.bundlelinkcheckerTransformer相关的错误。
  • 从多个备份中恢复并重新启动AEM并不能解决此问题。

可能会在日志中观察到以下错误:

加载包org.apache.aries.spifly.dynamic.bundle时出错:与Java 21不兼容。

的linkcheckerTransformer配置出错
/apps/<应用程序> /config/rewriter/versioned-clientlibs.

服务用户缺少错误。

原因

还原Java21不支持具有不兼容的捆绑包(org.apache.aries.spifly.dynamic.bundle)的创作实例、配置错误的linkchecker transformer以及缺少服务用户会导致启动和内容访问失败。

解决方法 resolution

要解决此问题,请执行以下步骤:

  1. 确定创作实例的最新有效备份,然后使用此备份还原创作实例。
  2. 恢复后,检查错误日志中是否存在不兼容的包,如org.apache.aries.spifly.dynamic.bundle
  3. 从OSGi控制台或文件系统删除不兼容的捆绑包,然后重新启动AEM实例。
  4. 如果出现与linkcheckerTransformer相关的错误,请在/apps/<application>/config/rewriter/versioned-clientlibs处更新配置。
  5. 根据需要删除或更正linkchecker配置,然后重新启动AEM以应用更改。
  6. 查看错误日志以了解缺少的服务用户错误。 确保所有必需的服务用户都存在且配置正确。
  7. 如果缺少特定内容路径(例如,/content/<content-root>/us/en),请从发布服务器实例为所需路径创建包。
  8. 在创作实例上安装包。
  9. 验证内容现在是否可用。 确认登录页面和创作UI可访问。
  10. 验证所有必需的内容和配置是否都存在。
recommendation-more-help
experience-cloud-kcs-help-kbarticles