在JEE和OSGi上的Service Pack之間升級AEM Forms 6.5

AEM Forms客戶在AEM 6.5 Service Pack之間移動時,會面臨正確升級路徑的不確定性,因為Forms元件會與主要AEM Service Pack分開出貨,而JEE和OSGi部署會使用不同的安裝流程。 Adobe會為每個Service Pack散發多個套件(JEE累積安裝程式、OSGi附加元件、Hotfix和相容性套件),因此很容易識別適用於指定環境的套件。 這是設定問題,不是軟體瑕疵。 識別您的執行階段型別、確認您目前的版本,並以正確的順序安裝正確的套件,會產生乾淨的升級。

說明 description

問題:為JEE和OSGi選取正確的AEM Forms 6.5 Service Pack升級路徑

說明

從一個AEM 6.5 Service Pack移至另一個套件(例如,從SP18移至SP24、從SP20移至SP23、或具有SP24的Hotfix的SP23)會引發關於套用哪些套件以及安裝順序的問題。 常見問題包括是否支援直接升級、是否必須先移除現有的Hotfix、安裝哪些Forms附加元件、需要哪些JEE修補程式安裝程式,以及如何處理WebSphere、JBoss、Windows或Linux等平台需求。

環境:

  • AEM Forms 6.5 (內部部署)
  • OSGi執行階段
  • JEE執行階段(WebSphere、WebLogic、JBoss)
  • Windows和Linux平台

問題/症狀:

  • 不確定要安裝哪個AEM Forms Service Pack或附加元件,包括同一個Service Pack的多個附加元件組建
  • 混淆是否支援直接升級路徑(例如SP18 → SP24或SP20 → SP23)
  • 有關在套用較新的Service Pack之前是否必須移除現有Hotfix的問題
  • 相較於OSGi附加套件,何時需要JEE修補程式的指引不明確

根本原因:

AEM Forms升級需要依賴平台的步驟,因為Forms元件是獨立於主要AEM Service Pack提供,且JEE和OSGi部署使用不同的修補程式和安裝流程。 由於Adobe會針對每個Service Pack散發多個套件(JEE累積安裝程式、OSGi附加元件、Hotfix和相容性套件),因此很容易誤解哪些套件適用於特定環境。 問題是組態不確定,而不是軟體缺陷。

如何確認

  1. 識別您的執行階段型別。 登入AEM並檢查/lc是否存在。 如果/lc/login載入,則為JEE;如果只有/aem/start.html載入,則為OSGi。 JEE環境使用EAR/WAR檔案和Configuration Manager。
  2. 確認您目前的Service Pack版本。 導覽至/system/console/productinfo並檢查「已安裝產品」區段(例如: Adobe Experience Manager (6.5.23.0))。
  3. 檢查平台相容性。 升級之前,請先將作業系統、Java、應用程式伺服器和資料庫版本與支援的平台矩陣進行比較。

解決方法 resolution

  1. 根據您的起始Service Pack選取正確的升級路徑:

    • 從SP18或SP20,支援直接升級至SP24或SP23。
    • 從SP11,先升級基礎平台元件,然後移至SP24。
    • 如果您使用SP23且有Hotfix,請正常進行且不要移除Hotfix — Service Pack具有累積功能。
  2. OSGi — 安裝主要AEM 6.5 Service Pack:aem-service-pkg-6.5.xx.x.zip上傳至CRX Package Manager,然後按一下安裝。 請造訪/system/console/productinfo以確認SP版本更新,並確認所有套件組合皆為ACTIVEFRAGMENT。 如果安裝失敗,請檢查error.log是否有相依性錯誤。

  3. OSGi — 安裝正確的Forms附加元件套件:識別並安裝與您的Service Pack和平台相符的附加元件組建。 檢查/system/console/bundles以確認AEM Forms套件組合是否處於ACTIVE狀態。 如果安裝失敗,請重新啟動AEM並重試。

  4. OSGi — 只有相關時才安裝其他Hotfix:套用必要的修正,例如Granite安全性Hotfix。 在/system/console/productinfo確認更新的元件,並在[軟體發佈詳細資料]頁面上確認Hotfix必要條件。

  5. JEE — 安裝相關的JEE修補程式安裝程式:執行目標Service Pack的JEE修補程式安裝程式。 確認Configuration Manager辨識更新的版本。 如果失敗,請收集Configuration Manager記錄。

  6. JEE — 重新啟動應用程式伺服器:使用原生應用程式伺服器指令碼,執行WebSphere、WebLogic或JBoss的全新重新啟動。 確認應用程式伺服器記錄檔未顯示部署失敗。 如果EAR無法部署,請檢查是否有遺失的JNDI專案、資料來源或存放庫路徑。

  7. 驗證完整升級(JEE和OSGi):登入AEM並確認最適化Forms、工作流程和其他Forms功能載入。 檢閱套件組合和產品資訊頁面,並檢查error.log是否有遺漏的套件或相依性錯誤。

驗證

  1. 瀏覽至/system/console/productinfo並確認SP版本正確顯示(例如: Adobe Experience Manager (6.5.24.0))。
  2. 確認所有OSGi套件組合都是透過/system/console/bundlesACTIVEFRAGMENT
  3. 若為JEE,請在重新啟動後檢閱應用程式伺服器記錄,以確認所有已部署的EAR,而不會發生錯誤。
  4. 執行基本Forms工作流程或轉譯調適型表單以確認執行階段穩定性。

相關閱讀

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