在AEM Cloud Manager中部署期間的OSGi套件解析失敗
在Adobe Experience Manager (AEM) Cloud Manager中,部署期間的OSGi套件解析失敗會讓套件組合停用或未解決,並導致服務和功能無法使用。 部署後,當必要的OSGi套件或套件組合遺失、非作用中或不相容時,就會發生問題。 若要修正此問題,請識別未解決的相依性,並將所需的套件組合、套件和程式碼與部署的AEM環境對齊。
說明 description
環境
- Adobe Experience Manager (AEM) Cloud Manager
症狀
-
在Cloud Manager中的OSGi套件組合解析階段期間,部署失敗。
-
多個OSGi組合(例如Granite UI、DAM、Campaign和Forms)保持非作用中或未解決。
-
錯誤記錄檔會顯示封裝的未解析需求,例如:
org.apache.sling.scripting.jsp.utilcom.adobe.aem.dermis.api.bridge -
遺失類別的錯誤,例如
ClassNotFoundException。 -
排定的工作可能失敗,復寫測試Ping可能傳回
Connection refused。 -
AEM執行個體在部署後可能會停止回應。
原因
部署因OSGi套件相依性未解析而失敗,通常是因為不相容或缺少套件組合、升級不完整或AEM基底、附加元件和自訂程式碼之間的套件對齊方式不當所導致。
解決方法 resolution
請依照下列步驟解決問題:
-
暫停進一步的部署嘗試,直到執行階段和套件狀態通過驗證為止。
-
請檢閱AEM error.log以瞭解未解析的OSGi套件需求,並識別哪些套件組合非作用中或未解析。
-
比較失敗的部署與上次的已知良好部署:
- 使用AEM Web主控台(系統主控台
>套裝)檢查已安裝的套件和套裝版本。 - 確認必要的組合(例如提供
org.apache.sling.scripting.jsp.util的組合)存在且處於Active狀態。 - 確認所有核心AEM、DAM、Campaign和Forms套件組合皆為作用中。
- 使用AEM Web主控台(系統主控台
-
確認AEM基本版本、Forms附加元件、Service Pack和任何適用的Hotfix相容且已正確安裝。
-
如果最近的升級或部署變更了執行階段狀態,請使用標準部署程式(例如,使用Cloud Manager或封裝管理員)還原或重新部署最後一個已知良好的成品。
-
修正後,執行受控部署:
- 分別依序部署核心套件組合和內容套件,以將風險降至最低。
- 避免在單一步驟中將所有自訂套件組合和內容套件部署在一起。
-
部署後,請確認:
- 提供
org.apache.sling.scripting.jsp.util的組合存在且作用中。 com.adobe.granite.ui.commons和其他受影響的組合作用中。- OSGi Web主控台中不會保留任何無法解析的套件匯入。
- AEM和受影響的功能(例如Forms)會通過煙霧測試並回應。
- 提供
-
如果修復後未解決的套件組合持續存在,請計畫完整執行個體重新啟動以重新整理OSGi配線。