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

Description

Environnement
Experience Manager

Problème/Symptômes
Vérifications de base

Résolution

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 à l’aide de la fonction com.day.cq.wcm.msm Enregistreurs 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 mixin type

Défini sur les noeuds jcr:content et défini pages Live Copy racine .
Ces pages auront une cq:LiveSyncConfig noeud enfant 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 Plan directeur de la Live Copy.
cq:rolloutConfigs : indique les principales configurations de déploiement appliquées à la Live Copy.
cq:isDeep : est définie sur true si les pages enfants de cette page Live Copy racine sont incluses dans la Live Copy.

- cq:LiveRelationship type de mixin

Toute page Live Copy possède un tel type de mixin sur son noeud jcr:content .
Si ce n’est pas le cas, 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).

- cq:LiveSyncCancelled type de mixin

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, vous pouvez rencontrer des questions sur 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.

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

Exemple : sélectionnez * à partir de cq:LiveSyncrenvoie 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 la section suivante : Article de base de connaissances.

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

  • Avant de joindre des logs : Activation du 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://< hôte> :< 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’exécution de l’action problématique MSM : voir ceci link 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.

Sur cette page