Documentazione

Risoluzione dei problemi relativi a AEM MSM

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Questo articolo descrive come risolvere eventuali problemi di AEM MSM. Vengono inoltre trattate le seguenti questioni:

  • Ricerca di informazioni avanzate sullo stato di blueprint e Live Copy
  • Verifica delle informazioni specifiche di MSM nell’archivio
  • Informazioni da fornire quando si genera un ticket di supporto MSM

Descrizione description

Ambiente

Experience Manager

Problema/Sintomi

Le verifiche di base iniziano con:

Risoluzione resolution

Ricerca di informazioni avanzate sullo stato di blueprint e Live Copy

Multi-Site Manager (MSM) registra diversi servlet che possono essere richiesti con i selettori sugli URL delle risorse.

Vengono utilizzati dall’interfaccia utente, ma possono anche essere richiesti direttamente per visualizzare stati MSM avanzati e direttamente aggiuntivi per le tue pagine:

  1. http://host:port/content/path/to/bluprint/page.blueprint.json?&maxSize=500&advancedStatus=true&returnRelationships=true&msm%3Atrigger=ROLLOUT
    Utilizza in una pagina Blueprint per recuperare l’elenco di tutte le Live Copy ad essa collegate, con stato LC avanzato.

  2. http://host:port/content/path/to/livecopy/page.msm.json
    Utilizza nelle pagine Livecopy per ottenere informazioni avanzate sulla loro connessione con la pagina Blueprint.

    Se la pagina non è una Live Copy, non viene restituito nulla.

Questi servlet generano messaggi del registro DEBUG attraverso il logger com.day.cq.wcm.msm che è opportuno controllare.

Verifica delle informazioni specifiche di MSM nell’archivio

I servlet di cui sopra restituivano informazioni calcolate in base ai nodi e ai mixin specifici di MSM.
Le informazioni vengono memorizzate nel modo seguente.

  • Tipo mixin cq:LiveSync

    È impostato sui nodi jcr:content e definisce pagine Live Copy principali.

    Le pagine avranno un nodo figlio cq:LiveSyncConfig di tipo cq:LiveCopy che conterrà informazioni di base e obbligatorie sulla Livecopy tramite le seguenti proprietà:

    • cq:master - punta alla pagina blueprint della Livecopy
    • cq:rolloutConfigs: indica le configurazioni di rollout attive applicate alla Livecopy
    • cq:isDeep - è true se le pagine figlie di questa pagina Live Copy principale sono incluse nella Livecopy.

  • Tipo mixin cq:LiveRelationship
    Qualsiasi pagina Live Copy ha questo tipo mixin sul suo nodo jcr:content.

    In caso contrario, la pagina a un certo punto è stata staccata o creata manualmente tramite l’interfaccia di authoring al di fuori di un’azione Live Copy (creazione o rollout).

  • Tipo mixin cq:LiveSyncCancelled
    Aggiunto sui nodi jcr:content di pagine Livecopy sospese.

    Se la sospensione è efficace anche per le pagine figlie: viene aggiunta una proprietà cq:isCancelledForChildren=true sullo stesso nodo.

Le informazioni presenti dovrebbero ovviamente essere riportate nell'interfaccia utente, tuttavia in situazioni anomale in cui è possibile mettere in discussione il comportamento dell'interfaccia utente o di MSM, gli utenti avanzati possono verificare direttamente tali nodi per comprendere lo stato delle loro pagine MSM.

Conoscere queste proprietà può essere utile anche per eseguire query sull’archivio e individuare set di pagine che si trovano in determinati stati.

Esempio: seleziona * da cq:LiveSync restituirà tutte le pagine principali di Livecopy.

Informazioni da fornire quando si genera un ticket di supporto MSM.

In futuro potrebbe essere necessaria l’assistenza del Supporto AEM.

Quando si genera un ticket di supporto nel portale di supporto, qualificare il problema nel modo migliore possibile seguendo le linee guida nel seguente articolo KB

Per le questioni relative a MSM è opportuno aggiungere idealmente queste precisazioni aggiuntive:

  • Prima di allegare i registri: abilitare il livello DEBUG per il logger com.day.cq.wcm.msm in /system/console/slinglog e ripetere l'azione MSM problematica.
  • Allega l'output della configurazione http://<host>:<port>/libs/wcm/msm/content/commands/rolloutconfigs.json
  • Comunicare le configurazioni di rollout allegate alle Live Copy
  • Se il problema sembra provenire dall'interfaccia utente (viene visualizzato l'errore della console del browser o l'errore dell'interfaccia utente): genera un file HAR per acquisire il flusso completo dal punto di vista dell'utente quando si esegue l'azione MSM problematica: vedi questo collegamento per dettagli sulla generazione di file HAR

Riprodurre il problema è il modo più semplice per consentire al supporto di analizzare rapidamente e determinare se il comportamento è normale o meno e agire di conseguenza.

A questo scopo, prova a:

  1. Riprodurre il problema in un'impostazione simile basata su We-Retail Pages
  2. Se non è possibile, prova a creare un pacchetto di contenuti che includa esempi di contenuto, in modo che un tecnico dell’assistenza possa installarlo in un’istanza AEM vuota con lo stesso livello di patch dell’istanza precedente e riprodurre il problema.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f