Résolution des problèmes liés à AEM MSM
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 :
- Consultez la page FAQ MSM pour voir que vos problèmes ou questions n’y sont pas déjà résolus.
- Consultez la page de documentation sur les bonnes pratiques MSM
- Assurez-vous que le problème est reproductible avec le dernier Service Pack installé
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 :
-
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é. -
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 typecq: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 Copycq:rolloutConfigs
: indique les configurations de déploiement actives appliquées à la Live Copycq: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 :
- Reproduisez votre problème sur une configuration similaire basée sur les pages We-Retail
- 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.