Risoluzione dei problemi e domande frequenti relativi a MSM troubleshooting-msm
Risoluzione dei problemi - Primi passi first-steps
Se stai riscontrando un comportamento errato o un errore in MSM, prima di iniziare e risolvere in modo dettagliato i problemi assicurati:
- Controlla le Domande frequenti su MSM poiché alcuni problemi o domande potrebbero già essere stati affrontati lì.
- Controlla l'articolo sulle best practice di MSM in quanto vengono offerti diversi suggerimenti insieme a chiarimenti di alcuni malintesi.
Ricerca di informazioni avanzate sullo stato della blueprint e della Live Copy advanced-info
MSM registra diversi servlet che possono essere richiesti con i selettori sugli URL delle risorse. Questi vengono utilizzati dall’interfaccia utente, ma possono anche essere richiesti direttamente per visualizzare stati MSM avanzati e direttamente aggiuntivi per le tue pagine:
-
http://<host>:<port>/content/path/to/bluprint/page.blueprint.json?&maxSize=500&advancedStatus=true&returnRelationships=true&msm%3Atrigger=ROLLOUT
-
Utilizza questo su una pagina blueprint per recuperare l’elenco di tutte le Live Copy ad essa collegate, con informazioni sullo stato di Live Copy aggiuntive.
-
ad esempio:
http://localhost:4502/content/wknd/language-masters/en.blueprint.json?&maxSize=500&advancedStatus=true&returnRelationships=true&msm%3Atrigger=ROLLOUT
-
-
http://<host>:<port>/content/path/to/livecopy/page.msm.json
-
Utilizza questo nelle pagine Live Copy per recuperare informazioni avanzate sulla loro connessione con le loro pagine blueprint. Se la pagina non è una Live Copy, non viene restituito nulla.
-
ad esempio:
http://localhost:4502/content/wknd/ca/en.msm.json
-
Questi servlet generano messaggi del registro DEBUG attraverso il logger com.day.cq.wcm.msm
che può anche essere utile.
Verifica delle informazioni specifiche di MSM nell’archivio checking-repo
I servlet precedenti restituivano informazioni calcolate in base ai nodi e ai mixin specifici di MSM. Le informazioni vengono memorizzate nell’archivio nel modo seguente.
-
Tipo mixin
cq:LiveSync
-
È impostato sui nodi
jcr:content
e definisce le pagine Live Copy principali. -
Le pagine hanno un nodo figlio
cq:LiveSyncConfig
di tipocq:LiveCopy
che contiene 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 Live Copy.cq:isDeep
è true se le pagine figlie di questa pagina Live Copy principale sono incluse nella Live Copy.
-
-
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 scollegata o creata manualmente tramite l’interfaccia di authoring al di fuori di un’azione Live Copy (creazione o rollout).
- Qualsiasi pagina Live Copy ha questo tipo mixin sul suo nodo
-
Tipo mixin
cq:LiveSyncCancelled
- Aggiunto ai nodi
jcr:content
di pagine Live Copy sospese. - Se la sospensione è efficace anche per le pagine figlie, una proprietà
cq:isCancelledForChildren
è impostata su true sullo stesso nodo.
- Aggiunto ai nodi
Le informazioni presenti in queste proprietà devono essere riportare nell’interfaccia utente, tuttavia durante la risoluzione dei problemi può essere utile osservare il comportamento di MSM direttamente nell’archivio mentre si verificano le azioni 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:
select * from cq:LiveSync
restituisce tutte le pagine principali di Live Copy.
Domande frequenti faq
Ecco alcune domande frequenti relative a MSM e Live Copy.
Perché alcune proprietà (ad esempio titolo, annotazioni) non vengono aggiornate durante un rollout di MSM? missing-properties
Le azioni di sincronizzazione MSM sono altamente configurabili. Quali proprietà o componenti vengono modificati durante il rollout dipendono direttamente dalle proprietà di tali configurazioni.
Consulta Best practice MSM per ulteriori informazioni su questo argomento.
Come posso rimuovere le autorizzazioni di rollout per un gruppo di autori? remove-rollout-permissions
Non esiste alcun privilegio di rollout che può essere impostato o rimosso per le entità principali di AEM (utenti o gruppi).
In alternativa, puoi effettuare le seguenti operazioni:
- Personalizzare l’interfaccia utente del prodotto per nascondere le azioni di Rollout per una determinata entità principale.
- Rimuovi i privilegi di scrittura dalla struttura Live Copy per gli autori che non sono autorizzati a eseguire il rollout.
Perché vedo le pagine Live Copy con il suffisso “_msm_moved“? moved-pages
Se viene eseguito il rollout di una pagina blueprint, la pagina Live Copy viene aggiornata oppure, se non esiste ancora, viene creata una nuova pagina Live Copy. Ad esempio, quando viene eseguito il rollout per la prima volta o la pagina Live Copy è stata eliminata manualmente.
In quest'ultimo caso, tuttavia, se esiste una pagina senza una proprietà cq:LiveRelationship
con lo stesso nome, la pagina verrà rinominata prima che venga creata la pagina Live Copy.
Per impostazione predefinita, il rollout prevede una pagina Live Copy collegata, alla quale vengono distribuiti gli aggiornamenti dei blueprint. Oppure, quando viene creata una pagina Live Copy, non prevede assolutamente alcuna pagina.
Se viene trovata una pagina “indipendente“, MSM sceglie di rinominare questa pagina e di creare una pagina Live Copy separata collegata.
Una tale pagina indipendente in una sottostruttura Live Copy è in genere il risultato di un'operazione Scollega oppure la pagina Live Copy precedente è stata eliminata manualmente da un autore e quindi ricreata con lo stesso nome.
Per evitare questo problema, utilizza la funzione Live Copy Sospendi invece di Scollega. Ulteriori dettagli sull'azione Stacca sono disponibili in questo articolo.