DocumentazioneRilevamento pattern di AEM

UMI umi

Last update: Fri Jul 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Sviluppatore

Problema di configurazione errata dell’aggiornamento

Informazioni di base background

UMI identifica le modifiche ad alcune configurazioni OSGi che causeranno problemi durante l’aggiornamento, come un aggiornamento non riuscito o funzionalità ridotte.

Le seguenti configurazioni vengono verificate per rilevare eventuali modifiche:

  • 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: identifica se la proprietà org.apache.sling.commons.log.file dei logger personalizzati rimanda a qualcosa di diverso dal file logs/error.log.

Possibili implicazioni e rischi implications-and-risks

  • La modifica o la rimozione delle configurazioni può causare i seguenti problemi:

    • L’aggiornamento potrebbe bloccarsi (ad esempio org.apache.jackrabbit.oak.security.user.RandomAuthorizableNodeName mancante ma presente in org.apache.jackrabbit.oak.security.internal.SecurityProviderRegistration.requiredServicePids).
    • Dopo l’aggiornamento possono verificarsi problemi di autorizzazione (org.apache.sling.engine.impl.auth.SlingAuthenticator).
    • Alcune funzionalità potrebbero non funzionare come previsto. Ad esempio, la modifica di org.apache.sling.scripting.java.impl.JavaScriptEngineFactory può causare la mancata compilazione di alcuni file JSP, che alla fine determina una perdita di funzionalità.
    • I valori com.day.cq.commons.impl.ExternalizerImpl della configurazione di Externalizer sono impostati con le variabili di ambiente di Cloud Manager in AEM as a Cloud Service.
    • AEM as a Cloud Service non supporta i file di registro personalizzati. I registri scritti con file log e nomi personalizzati non saranno accessibili da AEM as a Cloud Service.

Soluzioni possibili solutions

  • Non modificare o rimuovere le quattro configurazioni sopra menzionate.
    • Se si verifica la seguente violazione:
      “Mancano le proprietà richieste per la configurazione OSGi xyz-configuration: ‘[proprietà-1, proprietà-2…]’.”
      Conferma se queste eliminazioni sono legittime o meno, in quanto queste configurazioni OSGI sono integrate e potrebbero non essere mai state modificate o salvate dal gestore di configurazione OSGi.
  • Se le configurazioni sono state modificate, è necessario riportarle ai valori previsti. Questi valori sono indicati nei messaggi UMI.
  • Per com.day.cq.commons.impl.ExternalizerImpl, consulta la documentazione relativa all’impostazione della configurazione di Externalizer utilizzando le variabili di ambiente di Cloud Manager in AEM as a Cloud Service.
  • Per org.apache.sling.commons.log.LogManager.factory.config, modifica la configurazione OSGi per inviare il logger personalizzato al file logs/error.log. Consulta la documentazione per rimandare nuovamente al file logs/error.log.
  • Contatta il team di supporto AEM per ottenere chiarimenti o per eventuali dubbi.
recommendation-more-help
c50d24a5-718e-4110-a484-b335e8a63206