升級AEM Forms後修正還原序列化錯誤

在IBM WebSphere Application Server 9.0.5.28上將Adobe Experience Manager (AEM) Forms升級為6.5.25版後,在伺服器啟動和Configuration Manager執行期間會出現還原序列化錯誤。 解決這個問題的方法是,使用必要的JVM引數設定notsoserial 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