在升级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

要解决此问题,请执行以下步骤:

  1. 确保notsoserial.jar文件存在于WebSphere上部署的AEM应用程序使用的目录中,如应用程序服务器实例的installedApps目录中。

  2. 在与notsoserial.jar相同的目录中创建名为is-deserialized.txt的空文件。

  3. 在WebSphere Admin Console中,转到Servers >[ your server] > Java and Process Management > Process Definition > Java Virtual Machine > Generic JVM arguments。

  4. 添加或更新以下JVM参数:

    code language-none
    -javaagent:<path-to-notsoserial.jar> -Dnotsoserial.dryrun=<path-to-is-deserialized.txt>
    
  5. 将<path-to-notsoserial.jar>和<path-to-is-deserialized.txt>替换为其完整路径。

  6. 删除任何以前相关的JVM参数,除非您的环境明确要求它们:

    code language-none
    -Dorg.kantega.notsoserial.allow=...
              -Djdk.serialFilter=...
    
  7. 保存更改并重新启动WebSphere应用程序服务器。

  8. 重新启动后,验证在启动和Configuration Manager执行期间SystemOut.log或其他相关日志中不再出现反序列化错误。

注释

  • -Dnotsoserial.dryrun属性在启动时强制初始化,这是在JNDI引导期间正常操作所必需的。
  • 保留这些JVM参数以备将来进行修补或升级。 如果在维护后重新出现反序列化错误,请确认这些设置仍然存在。
  • notsoserial.jar的位置因部署结构而异。 确保为您的环境引用正确的路径。
  • 除上述步骤外,不提供其他故障排除步骤。
recommendation-more-help
experience-cloud-kcs-help-kbarticles