DocumentaciónDetección de patrones de AEM

UMI umi

Last update: Fri Jun 09 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Developer

Problema de falta de configuración de la actualización

Fondo background

UMI identifica las modificaciones a ciertas configuraciones de OSGi que causarán problemas al actualizar, incluida una actualización fallida o una funcionalidad reducida.

Se comprueban las siguientes configuraciones para su modificación:

  • 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 : Identifique si la propiedad org.apache.sling.commons.log.file de los registradores personalizados señala a algo distinto del archivo logs/error.log.

Posibles implicaciones y riesgos implications-and-risks

  • Cambiar o quitar configuraciones puede causar los siguientes problemas:

    • La actualización puede quedarse atascada (por ejemplo, org.apache.jackrabbit.oak.security.user.RandomAuthorizableNodeName faltaba, pero estaba presente en org.apache.jackrabbit.oak.security.internal.SecurityProviderRegistration.requiredServicePids).
    • Los problemas de autorización pueden producirse después de la actualización (org.apache.sling.engine.impl.auth.SlingAuthenticator).
    • Es posible que ciertas funciones no operen correctamente. Por ejemplo, cambiar org.apache.sling.scripting.java.impl.JavaScriptEngineFactory puede provocar que algunos archivos JSP no se compilen, lo que en última instancia resultará en la pérdida de funcionalidad.
    • Los valores de la configuración del externalizador com.day.cq.commons.impl.ExternalizerImpl están definidos por variables de entorno de Cloud Manager en AEM as a Cloud Service.
    • AEM as a Cloud Services no admite archivos de registro personalizados. No se podrá acceder a los registros escritos en registros con nombres personalizados desde AEM as a Cloud Service.

Posibles soluciones solutions

  • No cambie ni elimine las cuatro configuraciones mencionadas anteriormente.
    • En caso de la siguiente infracción:
      “Faltan propiedades requeridas para la configuración OSGi 'xyz-configuration': '[property-1, property-2…]'.”
      Confirme si estas eliminaciones son legítimas o no, ya que estas configuraciones de OSGI son OOTB y es posible que nunca se hayan modificado o guardado desde el Administrador de configuración OSGi.
  • Si las configuraciones se han modificado, se deben restaurar a los valores esperados. Estos valores se indican en los mensajes de UMI.
  • Para com.day.cq.commons.impl.ExternalizerImpl, consulte la documentación para definir la configuración del externalizador mediante variables de entorno de Cloud Manager en AEM as a Cloud Service.
  • Para org.apache.sling.commons.log.LogManager.factory.config, cambie la configuración OSGI para enviar el registrador personalizado al archivo logs/error.log. Consulte documentación para volver a señalar al archivo logs/error.log.
  • Póngase en contacto con nuestro Equipo de Soporte de AEM para obtener aclaraciones o solucionar problemas.
recommendation-more-help
c50d24a5-718e-4110-a484-b335e8a63206