Documentation

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

Last update: Tue Jul 16 2024 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 l’état de votre plan directeur et de vos Live Copies
  • Vérification des informations spécifiques à MSM dans le référentiel
  • Informations à fournir lors de la levée d’un ticket de support MSM

Description description

Environnement

Experience Manager

Problème/Symptômes

Vérifications de base à commencer par :

Résolution resolution

Recherche d’informations avancées sur l’état de votre plan directeur et de vos 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 états MSM calculés supplémentaires 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 y sont liées, avec un état 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 à leur page de plan directeur.

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

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

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

Les servlets ci-dessus renvoyaient des informations calculées en fonction des noeuds et des mixins spécifiques à MSM.
Les informations sont stockées de la manière suivante.

  • cq:LiveSync Type de mixin

    Il est défini sur les noeuds jcr:content et définit les pages racine Live Copy.

    Ces pages auront un noeud enfant cq:LiveSyncConfig de type cq:LiveCopy qui contiendra des informations de base et obligatoires sur la Live Copy via les propriétés suivantes :

    • cq:master - pointe vers la page Blueprint de la Live Copy
    • cq:rolloutConfigs : indique les configurations de déploiement actives appliquées à la Live Copy
    • cq:isDeep - est défini sur true si les pages enfants de cette page Live Copy racine sont incluses dans la Live Copy.

  • Type de mixin cq:LiveRelationship
    Toute page Live Copy possède un tel type de mixin sur son noeud jcr:content .

    Dans le cas contraire, la page a été à un moment détachée ou créée manuellement via 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 noeuds jcr:content des pages Live Copy qui ont été suspendus.

    Si la suspension est effective pour les pages enfants également : une propriété cq:isCancelledForChildren=true est ajoutée sur le même noeud.

Les informations qu’il contient doivent bien sûr être reflétées dans l’interface utilisateur. Cependant, dans des situations anormales où vous pouvez mettre en doute le comportement de l’interface utilisateur ou de MSM, les superutilisateurs peuvent vérifier directement ces noeuds pour comprendre l’état de leurs pages MSM.

Connaître 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 : select * from cq:LiveSync renverra toutes les pages racine Live Copy.

Informations à fournir lors de la levée d’un ticket d’assistance MSM.

Vous aurez peut-être besoin d’une assistance AEM.

Lors de la levée d’un ticket d’assistance sur le portail d’assistance, qualifiez le problème autant que possible en suivant les instructions de l’ article de la base de connaissances suivant

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

  • Avant de joindre des journaux : activez le niveau DEBUG pour l’enregistreur com.day.cq.wcm.msm dans /system/console/slinglog et répétez l’action problématique MSM.
  • Joindre la sortie de la configuration http://<host>:<port>/libs/wcm/msm/content/commands/rolloutconfigs.json
  • Communication des configurations de déploiement associées aux Live Copies
  • Si le problème semble provenir de l’interface utilisateur (une erreur de 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’action MSM problématique : consultez ce lien pour plus d’informations sur la génération de fichiers 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, et d’agir en conséquence.

À cet effet, essayez d’effectuer les opérations suivantes :

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