UMI

升級設定錯誤問題

背景

UMI 會識別某些 OSGi 設定的修改，這些修改在升級時可能會造成問題，包括升級失敗或降低功能。

會檢查下列設定是否修改：

• org.apache.jackrabbit.oak.security.user.RandomAuthorizableNodeName
• org.apache.jackrabbit.oak.security.internal.SecurityProviderRegistration.requiredServicePids
• org.apache.sling.engine.impl.auth.SlingAuthenticator
• org.apache.sling.scripting.java.impl.JavaScriptEngineFactory
• com.day.cq.commons.impl.ExternalizerImpl

可能影響和風險

• 變更或移除設定可能會造成下列錯誤：
  • 升級可能會變得停滯 (例如遺失的 org.apache.jackrabbit.oak.security.user.RandomAuthorizableNodeName 出現在 org.apache.jackrabbit.oak.security.internal.SecurityProviderRegistration.requiredServicePids 中)。
  • 升級後授權問題可能隨之而來 (org.apache.sling.engine.impl.auth.SlingAuthenticator)。
  • 某些功能可能無法如預期運作。例如變更 org.apache.sling.scripting.java.impl.JavaScriptEngineFactory 可能會導致 JSP 檔案未編譯，最終結果是失去功能。
  • 外部器設定 com.day.cq.commons.impl.ExternalizerImpl 的值是由 AEM as a Cloud Service 中的 Cloud Manager 環境變數所設定。

可能的解決方案

• 請勿變更或移除上述四個設定。
  • 如果發生以下違規情況：
    「遺失 OSGi 設定『xyz-configuration』的必要屬性：『[property-1,property-2…]』」。
    請確認這些刪除是否合法，因為這些 OSGI 設定是 OOTB，而且可能從未透過 OSGi 設定管理員進行修改/儲存。
• 如果已經變更設定，應將其還原為預期值。這些值顯示在 UMI 訊息中。
• 對於 com.day.cq.commons.impl.ExternalizerImpl，請參閱文件以了解如何使用 AEM as a Cloud Service 中的 Cloud Manager 環境變數來進行外部器設定。
• 請聯繫我們的 AEM 支援團隊以澄清或解決問題。