Risoluzione dei problemi relativi a AEM MSM

Ultimo aggiornamento: 2023-11-30

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

Ambiente

Experience Manager

Problema/Sintomi

Le verifiche di base iniziano con:

Risoluzione

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 com.day.cq.wcm.msm logger che vale la pena 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.

    Tali pagine avranno un cq:LiveSyncConfig nodo figlio di tipo cq:LiveCopy che conterrà informazioni di base e obbligatorie sulla Live Copy attraverso 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 per bambini: cq:isCancelledForChildren=true viene aggiunta sullo stesso nodo.

Le informazioni presenti dovrebbero ovviamente essere riflesse nell’interfaccia utente, tuttavia, in situazioni anomale che potrebbero verificarsi quando puoi 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 trovare 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 generi un ticket di supporto nel portale di supporto, qualifica il problema nel modo migliore seguendo le linee guida riportate di seguito articolo KB

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

  • Prima di allegare i registri: abilita il livello DEBUG per il logger com.day.cq.wcm.msm in /system/console/slinglog, e ripeti la problematica Azione MSM.
  • 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 la finestra a comparsa dell’errore dell’interfaccia utente): genera un file HAR per acquisire il flusso completo dalla prospettiva dell’utente quando si esegue l’azione MSM problematica: vedi questo link per informazioni dettagliate sulla generazione di file HAR

La riproduzione del problema è il modo più semplice per consentire al supporto di analizzare e determinare rapidamente 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.

In questa pagina