在升级AEM Forms后修复反序列化错误
在Adobe Experience Manager WebSphere应用程序服务器9.0.5.28上将IBM (AEM) Forms升级到版本6.5.25后,在服务器启动和Configuration Manager执行期间出现反序列化错误。 解决此问题的方法是:使用必需的JVM参数配置非串行Java代理,该参数在启动时初始化其,因为客户没有CRX。
描述 description
环境
- 产品: Adobe Experience Manager (AEM) Forms JEE
- 版本: 6.5.25,从6.5.23升级
- 应用程序服务器: IBM WebSphere应用程序服务器9.0.5.28
- 操作系统: Windows Server 2022数据中心
问题/症状
- 升级到AEM Forms 6.5.25并在IBM WebSphere上启动应用程序后,日志中出现大量 不允许对类 进行反序列化。
- 在服务器启动和Configuration Manager执行期间均会出现错误。
解决方法 resolution
要解决此问题,请执行以下步骤:
-
确保
notsoserial.jar文件存在于WebSphere上部署的AEM应用程序使用的目录中,如应用程序服务器实例的installedApps目录中。 -
在与
notsoserial.jar相同的目录中创建名为is-deserialized.txt的空文件。 -
在WebSphere Admin Console中,转到
Servers >[ your server] > Java and Process Management > Process Definition > Java Virtual Machine > Generic JVM arguments。 -
添加或更新以下JVM参数:
code language-none -javaagent:<path-to-notsoserial.jar> -Dnotsoserial.dryrun=<path-to-is-deserialized.txt> -
将
<path-to-notsoserial.jar>和<path-to-is-deserialized.txt>替换为其完整路径。 -
删除任何以前相关的JVM参数,除非您的环境明确要求它们:
code language-none -Dorg.kantega.notsoserial.allow=... -Djdk.serialFilter=... -
保存更改并重新启动WebSphere应用程序服务器。
-
重新启动后,验证在启动和Configuration Manager执行期间
SystemOut.log或其他相关日志中不再出现反序列化错误。
注释
-Dnotsoserial.dryrun属性在启动时强制初始化,这是在JNDI引导期间正常操作所必需的。- 保留这些JVM参数以备将来进行修补或升级。 如果在维护后重新出现反序列化错误,请确认这些设置仍然存在。
notsoserial.jar的位置因部署结构而异。 确保为您的环境引用正确的路径。- 除上述步骤外,不提供其他故障排除步骤。
recommendation-more-help
experience-cloud-kcs-help-kbarticles