有关版本、操作系统、JBoss和平台兼容性的AEM Forms JEE升级指南

在JEE上升级AEM Forms(迁移到较新的Service Pack、在RHEL版本之间迁移或在6.5.x和6.5 LTS之间选择)的客户需要在继续操作之前对支持的平台进行权威确认。 JEE上的AEM Forms强制要求操作系统、JBoss、Java和数据库层严格兼容,并且受支持的组合位于Adobe的平台矩阵中,但需要映射到您的特定环境。 跳过验证可能会安装不支持的二进制文件或提交无法成功的升级路径。 根据矩阵确认您的操作系统、JBoss和Java组合,获取正确的安装程序,然后依次应用Service Pack或LTS升级,即可解决不确定性。

描述 description

环境:

  • JEE上的Adobe Experience Manager Forms
  • Adobe Experience Manager 6.5(内部部署)
  • Adobe Experience Manager 6.5磅
  • JBoss EAP 7.4.x和JBoss EAP 8
  • Red Hat Enterprise Linux和Windows服务器

问题/症状:

  • 不确定哪些AEM Forms版本支持特定操作系统平台,例如RHEL 8、RHEL 9和Windows Server 2022。
  • 对于特定的AEM Forms发行版(例如带有SP22的JBoss 7.4.22或带有LTS的Java 17和21 ),兼容JBoss EAP或Java版本存在不确定性。
  • 该请求用于权威确认支持的平台、安装程序可用性、先决条件和升级顺序,而不是中断/修复故障排除。

根本原因:

JEE上的AEM Forms在操作系统、JBoss、Java和数据库层之间实施严格的兼容性,因此组合在升级或应用Service Pack之前需要验证。 Adobe在其平台矩阵中记录了支持的组合,但需要对这些组合进行适当的解释,并将其映射到您的环境。 如果不确认支持的组合,则可能会安装不支持的二进制文件或规划无法成功的升级路径。

解决方法 resolution

请按照以下步骤解决问题:

  1. 识别您当前的AEM Forms JEE版本和平台组件。 收集操作系统版本、JBoss EAP版本、Java版本和数据库类型。 通过运行java -version、检查JBoss EAP控制台版本并在RHEL上运行cat /etc/redhat-release等操作系统释放命令来确认它们。
  2. 确定您的目标是Service Pack升级还是LTS迁移。 6.5 LTS需要Java 17或21和JBoss EAP 8,而6.5.x Service Pack升级仍停留在Java 8或11和JBoss 7.4.x上。 这将告诉您是针对6.5.24 (SP24)还是6.5 LTS。
  3. 使用官方的“支持的平台列表”验证平台支持。 确认您的操作系统(RHEL 8、RHEL 9或Windows Server 2022)和JBoss版本出现在目标版本的矩阵中。 如果您的平台未列出,请在升级之前选择明确支持的操作系统和JBoss版本。
  4. 对于操作系统迁移(RHEL 7到RHEL 8或RHEL 8到RHEL 9),请确认可行性。 RHEL 8需要SP11或更高版本,而RHEL 9支持SP23和SP24。 将您的目标操作系统与矩阵中支持的版本相匹配。 如果您的版本不支持目标操作系统,请使用新服务器计划异地迁移。
  5. 从Adobe Software Distribution下载正确的完整安装程序和Service Pack,包括SP23完整安装程序、SP24修补程序以及Forms附加组件。 文件名匹配模式,如aemforms_server_6_5_0_jboss_all_unix.tar.gzadobe-aem-forms-jee-servicepack-6.5.24.0-win-jboss.zip。 如果Software Distribution中未显示文件,请确认您的Adobe ID在Admin Console中拥有正确的权限。
  6. 准备升级。 备份CRX目录、GDS、TEMP和数据库,并在继续操作之前确认存在带时间戳的备份。
  7. 安装新的AEM Forms JEE完整安装程序。 启动JBoss并确认/lc已加载。 如果部署失败,请检查JBoss日志以了解部署错误并验证操作系统库。
  8. 应用最新的Service Pack (SP24)和Forms附加组件。 在Linux或Windows上安装适用于JBoss的SP24修补程序,然后安装SP24 OSGi组件(servlet片段、Service Pack和Forms附加组件)。 检查/lc/system/console/bundles以确认捆绑包停止生成滚动错误。 如果不能,请重新安装servlet片段或检查error.log是否缺少依赖项。
  9. 对于JBoss升级,请验证所需的环境变量。 升级JBoss EAP 7.4.x时设置DISABLE_JDK_SERIAL_FILTER = true,然后确认JBoss启动时没有出现序列化错误。 如果序列化错误仍然存在,请确认已在JBoss启动脚本中正确导出变量。
  10. 验证已升级的环境。 启动JBoss、访问/adminui并测试关键模块,如PDF Generator、Workbench连接和Reader扩展。 检查error.log是否有新的栈栈跟踪或滚动消息。

相关阅读

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