Dokumentation

Fehlerbehebung bei AEM MSM-Problemen

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

In diesem Artikel werden Möglichkeiten zur Fehlerbehebung bei AEM MSM-Problemen beschrieben. Darüber hinaus wird Folgendes erörtert:

  • Erweiterte Informationen zum Status Ihres Blueprints und Ihrer Live Copies
  • Überprüfen der MSM-spezifischen Informationen im Repository
  • Informationen, die beim Erstellen eines MSM-Support-Tickets bereitgestellt werden müssen

Beschreibung description

Umgebung

Experience Manager

Problem/Symptome

Grundlegende Überprüfungen für den Anfang:

Auflösung resolution

Erweiterte Informationen zum Status Ihres Blueprints und Ihrer Live Copies

Multi-Site Manager (MSM) registriert mehrere Servlets, die mit Selektoren in den Ressourcen-URLs angefordert werden können.

Sie werden von der Benutzeroberfläche verwendet, können aber auch direkt angefordert werden, um zusätzliche erweiterte und berechnete MSM-Status für Ihre Seiten direkt anzuzeigen:

  1. http://host:port/content/path/to/bluprint/page.blueprint.json?&maxSize=500&advancedStatus=true&returnRelationships=true&msm%3Atrigger=ROLLOUT
    Verwenden Sie auf einer Blueprint-Seite, um die Liste aller mit ihr verknüpften Live Copies mit dem Status Erweitert LC abzurufen.

  2. http://host:port/content/path/to/livecopy/page.msm.json
    Auf Live Copy-Seiten können Sie erweiterte Informationen über die Verbindung mit der jeweiligen Blueprint-Seite abrufen.

    Wenn es sich bei der Seite nicht um eine Live Copy handelt, wird nichts zurückgegeben.

Diese Servlets generieren DEBUG-Protokollmeldungen über den com.day.cq.wcm.msm-Logger, die ebenfalls überprüft werden sollten.

Überprüfen der MSM-spezifischen Informationen im Repository

Die oben genannten Servlets haben berechnete Informationen auf der Grundlage MSM-spezifischer Knoten und Mixins zurückgegeben.
Die Informationen werden wie folgt gespeichert.

  • cq:LiveSync Mixin-Typ

    Dieser wird auf jcr:content-Knoten festgelegt und definiert Stamm-Live Copy-Seiten.

    Diese Seiten haben einen cq:LiveSyncConfig untergeordneten Knoten des Typs cq:LiveCopy, der grundlegende und obligatorische Informationen über die Live Copy in den folgenden Eigenschaften enthält:

    • cq:master - verweist auf die Blueprint-Seite der Live Copy
    • cq:rolloutConfigs - zeigt aktive Rollout-Konfigurationen an, die auf die Live Copy angewendet werden
    • cq:isDeep - ist „true“, wenn die untergeordneten Seiten dieses Live Copy-Stamms in der Live Copy enthalten sind.

  • Mixin-Typ cq:LiveRelationship
    Jede Live Copy-Seite verfügt über einen solchen Mixin-Typ auf ihrem jcr:content-Knoten.

    Andernfalls wurde die Seite zu einem bestimmten Zeitpunkt getrennt oder außerhalb einer Live Copy-Aktion manuell über die Authoring-Oberfläche (Erstellen oder Rollout) erstellt.

  • Mixin-Typ cq:LiveSyncCancelled
    Auf JCR:content-Knoten von Live Copy-Seiten hinzugefügt, die ausgesetzt wurden.

    Wenn die Aussetzung auch für untergeordnete Seiten gilt: Eine cq:isCancelledForChildren=true Eigenschaft wird auf demselben Knoten hinzugefügt.

Die dort vorhandenen Informationen sollten natürlich in der Benutzeroberfläche angezeigt werden (anormale Situationen, in denen Sie das UI- oder MSM-Verhalten infrage stellen können, können Superuser diese Knoten direkt überprüfen, um den Status ihrer MSM-Seiten zu verstehen.

Die Kenntnis dieser Eigenschaften kann auch nützlich sein, um Abfragen an Ihr Repository zu senden und Sets von Seiten zu finden, die einen bestimmten Status aufweisen.

Beispiel: select * from cq:LiveSync gibt alle Live Copy-Stammseiten zurück.

Informationen, die beim Erstellen eines MSM-Support-Tickets bereitgestellt werden müssen.

Möglicherweise benötigen Sie Unterstützung durch den AEM Support.

Qualifizieren Sie das Problem beim Erstellen eines Support-Tickets im Support-Portal gemäß den Richtlinien im Abschnitt "​ eines Support-Tickets in Experience League.

Bei MSM-Problemen sollten diese zusätzlichen Präzisionen idealerweise hinzugefügt werden:

  • Vor dem Anhängen von Protokollen: Aktivieren Sie die DEBUG-Ebene für den Logger-com.day.cq.wcm.msm in /system/console/slinglog und wiederholen Sie die problematische MSM-Aktion.
  • Fügen Sie die Ausgabe der http://<host>:<port>/libs/wcm/msm/content/commands/rolloutconfigs.json hinzu
  • Kommunikation der an die Live Copies angehängten Rollout-Konfigurationen
  • Wenn das Problem von der Benutzeroberfläche zu stammen scheint (Browser-Konsolenfehler oder UI-Fehler-Popup erscheint): Erzeugen Sie eine HAR-Datei, um den vollständigen Fluss aus der Benutzerperspektive bei der Durchführung der problematischen MSM-Aktion zu erfassen: siehe diesen Link für Details zur HAR-Dateigenerierung

Das Reproduzieren des Problems ist die einfachste Möglichkeit für Support, um schnell zu analysieren und zu bestimmen, ob das Verhalten normal ist oder nicht, und entsprechend zu handeln.

Versuchen Sie zu diesem Zweck:

  1. Reproduzieren Sie Ihr Problem in einem ähnlichen Setup auf der Grundlage von We-Retail-Seiten
  2. Wenn nicht möglich, versuchen Sie, ein Inhaltspaket zu erstellen, das Beispielinhalte enthält, damit ein Support-Mitarbeiter es auf einer leeren AEM-Instanz mit derselben Patch-Ebene wie Sie installiert und das Problem reproduziert.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f