在AEM环境中安装包失败
当包中包含不可变路径、无效的ZIP结构、安装挂接或受影响的AEM版本时,SDK包安装失败。 诊断安装错误并按照相应的解决步骤成功安装软件包。
描述 description
环境
- Adobe Experience Manager as a Cloud Service
- AEM Managed Services
- Adobe Developer App Builder
问题/症状
- 上载期间出现错误,指示存档文件不是有效的内容包,因为缺少jcr_root。
- 安装过程中出现包验证错误。
- 安装被阻止,因为软件包包含不可变的存储库路径。
- 所有包中嵌入的包不会自动安装。
- 包名称无效导致包下载失败。
- 与缺少安装挂接类相关的安装失败。
原因
当包结构无效、包包含不可变的存储库路径、包名称包含不支持的字符、在不支持的位置使用安装挂接,或者部署依赖于受回归影响的SDK版本时,会发生安装失败。
解决方法 resolution
要解决此问题,请执行以下步骤:
- 通过查看包管理器消息或日志来识别安装错误。
- 如果包无法识别为内容包,请验证ZIP文件顶层是否存在
META-INF和jcr_root。 如有必要,请重新创建包。 - 如果包包含不可变的存储库路径,请通过相应的部署管道部署代码,而不是直接通过包管理器进行安装。
- 如果嵌入的包未自动安装,请验证SDK版本,并升级到包含回归修复程序的SDK版本。
- 在部署到不支持安装挂接的环境时,请删除安装挂接。 对于支持的环境,请确保安装了所有必需的依赖项。
- 更新包名称以删除不支持的字符并重新构建包,然后再重新部署。
- 通过确认不再出现安装错误并在适用时正确安装嵌入包来验证安装。
相关阅读
recommendation-more-help
experience-cloud-kcs-help-kbarticles