文件Experience Cloud KCS

適用於版本、作業系統、JBoss和平台相容性的AEM Forms JEE升級指引

最後更新： 2026年7月7日

在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 LTS
  • JBoss EAP 7.4.x和JBoss EAP 8
  • Red Hat Enterprise Linux和Windows Server

問題/症狀：

  • 不確定哪些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.gz或adobe-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