Risoluzione dei problemi e domande frequenti relativi a MSM

Risoluzione dei problemi - Primi passi

Se stai riscontrando un comportamento errato o un errore in MSM, prima di iniziare e risolvere in modo dettagliato i problemi assicurati:

Ricerca di informazioni avanzate sullo stato della blueprint e della Live Copy

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:

  1. 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
  2. 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

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 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 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 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 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.

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 trovare set di pagine che si trovano in determinati stati. Esempio:

  • select * from cq:LiveSync restituisce tutte le pagine principali di Live Copy.

Domande frequenti

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?

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 questo articolo per ulteriori informazioni relative a questo argomento.

Come posso rimuovere le autorizzazioni di rollout per un gruppo di autori?

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.
  • Rimuovere i privilegi di scrittura dalla struttura Live Copy per gli autori che non possono eseguire il rollout.

Perché vedo le pagine Live Copy con il suffisso “_msm_moved“?

Se viene eseguito il rollout di una pagina blueprint, la pagina Live Copy verrà aggiornata oppure, se non esiste ancora, ne verrà creata una nuova (ad esempio, quando viene eseguito il rollout per la prima volta, oppure 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 di conseguenza prima che venga creata la pagina Live Copy.

Per impostazione predefinita, al momento della creazione di una pagina Live Copy, il rollout prevede una pagina Live Copy collegata, sulla quale verrà effettuato il rollout degli aggiornamenti dei blueprint, oppure nessuna 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, utilizza la funzione Sospendi della Live Copy anziché la funzione Stacca. Maggiori dettagli sull’azione Stacca sono disponibili in questo articolo.

In questa pagina