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.sling.commons.log.LogManager.factory.config：確認自訂記錄器的 org.apache.sling.commons.log.file 屬性是否指向 logs/error.log 檔案以外的內容。

可能影響和風險

  • 變更或移除設定可能會造成下列錯誤：
    • 升級可能會變得停滯 (例如遺失的 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 環境變數所設定。
    • AEM as a Cloud Service 不支援自訂記錄檔。無法從 AEM as a Cloud Service 存取寫入自訂命名記錄的記錄。

可能的解決方案

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

本頁內容