在AEM Cloud Manager中进行部署期间,OSGi捆绑包解析失败
在Adobe Experience Manager (AEM) Cloud Manager中,部署期间的OSGi捆绑包解析失败可能会导致捆绑包处于非活动或未解析,并导致服务和功能不可用。 当部署后所需的OSGi包或捆绑包缺失、不活动或不兼容时,会发生此问题。 要修复此问题,请识别未解析的依赖关系,并将所需的捆绑包、包和代码与部署的AEM环境保持一致。
描述 description
环境
- Adobe Experience Manager (AEM) Cloud Manager
症状
-
在Cloud Manager中的OSGi捆绑包解析阶段部署失败。
-
多个OSGi包(例如Granite UI、DAM、Campaign和Forms)保持不活动或未解决。
-
错误日志显示包的未解决要求,例如:
org.apache.sling.scripting.jsp.utilcom.adobe.aem.dermis.api.bridge -
错误,例如缺少类的
ClassNotFoundException。 -
计划的作业可能失败,复制测试ping可能返回
Connection refused。 -
AEM实例在部署后可能会变得无响应。
原因
部署失败是由于OSGi包依赖项未解析所致,这些依赖项通常是由不兼容或缺少包、升级不完整或AEM基代码、加载项和自定义代码之间的包对齐不当导致的。
解决方法 resolution
请按照以下步骤解决问题:
-
暂停进一步的部署尝试,直到运行时和包状态得到验证为止。
-
查看AEM error.log以了解未解决的OSGi包要求,并确定哪些捆绑包处于非活动状态或未解决。
-
将失败的部署与上一次已知良好的部署进行比较:
- 使用AEM Web控制台(系统控制台
>包)检查已安装的包和包版本。 - 验证所需的包(例如提供
org.apache.sling.scripting.jsp.util的包)是否存在并处于Active状态。 - 确保所有核心AEM、DAM、Campaign和Forms捆绑包都处于活动状态。
- 使用AEM Web控制台(系统控制台
-
确认AEM基本版本、Forms附加组件、Service Pack和任何适用的修补程序兼容并正确安装。
-
如果最近的升级或部署更改了运行时状态,请使用标准部署过程(例如,使用Cloud Manager或包管理器)恢复或重新部署最后一个已知良好的工件。
-
修正后,执行受控部署:
- 按顺序单独部署核心捆绑包和内容包,以将风险降至最低。
- 避免在单个步骤中一起部署所有自定义捆绑包和内容包。
-
部署后,请验证:
- 提供
org.apache.sling.scripting.jsp.util的包存在且处于活动状态。 com.adobe.granite.ui.commons和其他受影响的包处于活动状态。- OSGi Web控制台中不会保留未解析的包导入。
- AEM和受影响的功能(例如Forms)通过烟雾测试并响应。
- 提供
-
如果修复后未解决的捆绑包仍然存在,请计划完整实例重启以刷新OSGi布线。