Risoluzione dei problemi relativi a AEM MSM

Descrizione

Ambiente
Experience Manager

Problema/Sintomi
Verifiche di base

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.

- cq:LiveSync mixin tipo

è 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 Live Copy
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.

- cq:LiveRelationship tipo mixin

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)

- cq:LiveSyncCanceled tipo mixin

Aggiunto sui nodi jcr:content di pagine Livecopy sospese.

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

Le informazioni presenti dovrebbero ovviamente essere riflesse nell’interfaccia utente, tuttavia, in situazioni anomale che potrebbero verificarsi quando puoi mettere in discussione l’interfaccia utente o il comportamento 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:LiveSyncrestituirà 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 l’azione MSM problematica.

  • Allega l’output della configurazione http://< host> :< porta> /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