Documentation

Résolution des problèmes liés à AEM MSM

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Cet article décrit comment résoudre les problèmes liés à AEM MSM. Il aborde en outre les points suivants :

  • Recherche d’informations avancées sur votre plan directeur et le statut des Live Copies
  • Vérification des informations spécifiques au module MSM dans le référentiel
  • Informations à fournir lors de l’ouverture d’un ticket d’assistance MSM

Description description

Environnement

Experience Manager

Problème/Symptômes

Vérifications de base pour commencer par :

Résolution resolution

Recherche d’informations avancées sur votre plan directeur et le statut des Live Copies

Multi-Site Manager (MSM) enregistre plusieurs servlets qui peuvent être demandés avec des sélecteurs sur les URL des ressources.

Ils sont utilisés par l’interface utilisateur mais peuvent également être demandés directement pour afficher directement des statuts MSM supplémentaires calculés de manière avancée pour vos pages :

  1. http://host:port/content/path/to/bluprint/page.blueprint.json?&maxSize=500&advancedStatus=true&returnRelationships=true&msm%3Atrigger=ROLLOUT
    Utilisez sur une page de plan directeur pour récupérer la liste de toutes les Live Copies qui lui sont liées, avec le statut LC avancé.

  2. http://host:port/content/path/to/livecopy/page.msm.json
    Utilisez sur les pages Live Copy pour obtenir des informations avancées sur leur connexion à la page de plan directeur.

    Si la page n’est pas une Live Copy, rien n’est renvoyé.

Ces servlets génèrent des messages du journal DEBUG via l’enregistreur de com.day.cq.wcm.msm qui méritent également d’être vérifiés.

Vérification des informations spécifiques au module MSM dans le référentiel

Les servlets ci-dessus ont renvoyé des informations calculées en fonction des nœuds et mixins spécifiques à MSM.
Les informations sont stockées de la manière suivante.

  • Type de mixin cq:LiveSync

    Elle est définie sur les nœuds jcr:content et définit les pages racine Live Copy.

    Ces pages comporteront un nœud enfant cq:LiveSyncConfig de type cq:LiveCopy qui contiendra des informations de base et obligatoires sur la Live Copy dans les propriétés suivantes :

    • cq:master : pointe vers la page Plan directeur de la Live Copy
    • cq:rolloutConfigs : indique les configurations de déploiement actives appliquées à la Live Copy.
    • cq:isDeep : a la valeur true si les pages enfants de cette page racine de Live Copy sont incluses dans la Live Copy.

  • Type de mixin cq:LiveRelationship
    Toute page Live Copy dispose de ce type de mixin sur son nœud jcr:content.

    Dans le cas contraire, la page a à un moment donné été détachée ou créée manuellement par le biais de l’interface de création en dehors d’une action Live Copy (création ou déploiement).

  • Type de mixin cq:LiveSyncCancelled
    Ajout sur les nœuds jcr:content des pages Live Copy suspendues.

    Si la suspension s’applique également aux pages enfants : une propriété cq:isCancelledForChildren=true est ajoutée sur le même nœud.

Les informations présentes doivent bien sûr se refléter dans l’interface utilisateur. Cependant, dans des situations anormales que vous pouvez rencontrer et qui permettent de remettre en question l’interface utilisateur ou le comportement MSM, les superutilisateurs peuvent vérifier directement ces nœuds pour comprendre le statut de leurs pages MSM.

La connaissance de ces propriétés peut également s’avérer utile pour interroger votre référentiel et découvrir des ensembles de pages qui se trouvent dans des états particuliers.

Exemple : sélectionner * dans cq:LiveSync renverra toutes les pages racine Live Copy.

Informations à fournir lors de l’ouverture d’un ticket d’assistance MSM.

Vous aurez peut-être besoin d’aide de l’assistance AEM.

Lors de l’ouverture d’un ticket d’assistance sur le portail d’assistance, qualifiez au mieux le problème en suivant les instructions de la section Comment envoyer un ticket d’assistance sur Experience League.

Pour les problèmes MSM, ces précisions supplémentaires doivent idéalement être ajoutées :

  • Avant de joindre des journaux : activez le niveau DEBUG pour l’enregistreur com.day.cq.wcm.msm dans /system/console/slinglog, puis répétez l’action MSM problématique.
  • Joindre la sortie de config http://<host>:<port>/libs/wcm/msm/content/commands/rolloutconfigs.json
  • Communiquer les configurations de déploiement jointes aux Live Copies
  • Si le problème semble provenir de l’interface utilisateur (une erreur de la console du navigateur ou une fenêtre contextuelle d’erreur de l’interface utilisateur s’affiche) : générez un fichier HAR pour capturer le flux complet du point de vue de l’utilisateur lors de l’exécution de l’action MSM problématique : consultez ce lien pour plus d’informations sur la génération du fichier HAR

La reproduction du problème est le moyen le plus simple pour l’assistance d’analyser rapidement et de déterminer si le comportement est normal ou non, puis d’agir en conséquence.

À cet effet, essayez de :

  1. Reproduisez votre problème sur une configuration similaire basée sur les pages We-Retail
  2. Si cela n’est pas possible, essayez de créer un package de contenu qui comprend un exemple de votre contenu afin qu’un ingénieur de l’assistance puisse l’installer sur une instance AEM vierge avec le même niveau de correctif que le vôtre et reproduire le problème.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f