文档Experience Cloud KCS

在JEE和OSGi上的Service Pack之间升级AEM Forms 6.5

最近更新： 2026年6月23日

在AEM Forms 6.5 Service Pack之间移动时，AEM客户面临关于正确升级路径的不确定性，因为Forms组件与主AEM Service Pack分开发货，而JEE和OSGi部署则使用不同的安装流程。 Adobe为每个Service Pack分发多个包（JEE累积安装程序、OSGi附加组件、修补程序和兼容包），因此很容易识别适用于给定环境的包。 这是一个配置问题，而不是软件缺陷。 确定运行时类型、确认当前版本并按正确顺序安装正确的软件包将产生干净升级。

描述 description

问题：为JEE和OSGi选择正确的AEM Forms 6.5 Service Pack升级路径

说明

从一个AEM 6.5 Service Pack移动到另一个包（例如，从SP18到SP24、从SP20到SP23、或带有适用于SP24的修补程序的SP23）会引发以下问题：哪些包适用，安装顺序如何。 常见问题包括是否支持直接升级、是否必须先删除现有修补程序、要安装哪个Forms插件、需要哪个JEE修补程序安装程序以及如何处理WebSphere、JBoss、Windows或Linux等平台要求。

环境：

  • AEM Forms 6.5（内部部署）
  • OSGi运行时
  • JEE运行时(WebSphere、WebLogic、JBoss)
  • Windows和Linux平台

问题/症状：

  • 不确定要安装哪个AEM Forms Service Pack或附加组件，包括用于同一Service Pack的多个附加组件版本
  • 混淆是否支持直接升级路径（例如SP18 → SP24或SP20 → SP23）
  • 有关在应用较新的Service Pack之前是否必须删除现有修补程序的问题
  • 与OSGi附加组件包相比，在何时需要JEE修补程序方面的指导不明确

根本原因：

AEM Forms升级需要执行与平台相关的步骤，因为Forms组件与主AEM Service Pack分开提供，并且JEE和OSGi部署使用不同的修补程序和安装流程。 由于Adobe为每个Service Pack分发多个包（JEE累积安装程序、OSGi附加组件、修补程序和兼容包），因此很容易误解哪些包适用于给定环境。 问题是配置不确定性，而不是软件缺陷。

如何确认

  1. 识别您的运行时类型。 登录到AEM并检查/lc是否存在。 如果/lc/login加载，则它是JEE；如果仅/aem/start.html加载，则它是OSGi。 JEE环境使用EAR/WAR文件和Configuration Manager。
  2. 确认您当前的Service Pack版本。 导航到/system/console/productinfo并检查“已安装的产品”部分（例如： Adobe Experience Manager (6.5.23.0)）。
  3. 检查平台兼容性。 在升级之前，将您的操作系统、Java、应用程序服务器和数据库版本与支持的平台矩阵进行比较。

解决方法 resolution

  1. 根据您的起始Service Pack选择正确的升级路径：

    • 从SP18或SP20，支持直接升级到SP24或SP23。
    • 从SP11中，首先升级底层平台组件，然后移至SP24。
    • 如果您使用的是带有修补程序的SP23，请正常继续执行并且不删除修补程序 — Service Pack是累积的。

  2. OSGi — 将主AEM 6.5 Service Pack：上传aem-service-pkg-6.5.xx.x.zip到CRX包管理器，然后单击安装。 访问/system/console/productinfo以确认SP版本更新，并确保所有包都是ACTIVE或FRAGMENT。 如果安装失败，请检查error.log是否存在依赖项错误。

  3. OSGi — 安装正确的Forms附加组件包：识别并安装与您的Service Pack和平台匹配的附加组件版本。 检查/system/console/bundles以确认AEM Forms包处于ACTIVE状态。 如果安装失败，请重新启动AEM并重试。

  4. OSGi — 仅在相关时安装其他修补程序：应用所需的修补程序，如Granite安全修补程序。 在/system/console/productinfo处确认更新的组件，并在Software Distribution详细信息页面上验证修补程序先决条件。

  5. JEE — 安装关联的JEE修补程序安装程序：运行目标Service Pack的JEE修补程序安装程序。 确认Configuration Manager识别更新的版本。 如果失败，则收集Configuration Manager日志。

  6. JEE — 重新启动应用程序服务器：使用本机应用程序服务器脚本对WebSphere、WebLogic或JBoss执行干净重新启动。 确认应用程序服务器日志未显示部署失败。 如果EAR无法部署，请检查是否缺少JNDI条目、数据源或存储库路径。

  7. 验证完整升级（JEE和OSGi）：登录到AEM并确认自适应Forms、工作流和其他Forms功能加载。 查看捆绑包和产品信息页面，并检查error.log是否存在缺少的包或依赖项错误。

验证

  1. 导航到/system/console/productinfo并确认SP版本正确显示（例如： Adobe Experience Manager (6.5.24.0)）。
  2. 通过/system/console/bundles验证所有OSGi包是ACTIVE或FRAGMENT。
  3. 对于JEE，请在重新启动后查看应用程序服务器日志，以确认所有部署的EAR均无错误。
  4. 运行基本的Forms工作流或渲染自适应表单以确认运行时稳定性。

相关阅读

recommendation-more-help
experience-cloud-kcs-help-kbarticles