Häufig gestellte Fragen zu Problemen bei AEM Dispatcher

Last update: Fri Mar 08 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:
Dispatcher

Erstellt für:

Admin

Konfigurieren des Dispatchers

Einführung

Was genau ist der Dispatcher?

Der Dispatcher ist das Caching- bzw. Lastenausgleichs-Tool von Adobe Experience Manager, das für eine schnelle und dynamische Web-Authoring-Umgebung sorgt. Zum Zwischenspeichern fungiert der Dispatcher als Teil eines HTTP-Servers, z. B. Apache. Er soll so viele statische Website-Inhalte wie möglich speichern (bzw. zwischenspeichern) und so selten wie möglich auf die Layout-Engine der Website zuzugreifen. Beim Lastenausgleich verteilt der Dispatcher Benutzeranfragen (Lasten) auf verschiedene AEM-Instanzen (Renderer).

Zum Caching nutzt das Dispatcher-Modul die Fähigkeit des Webservers, statische Inhalte bereitzustellen. Der Dispatcher legt die zwischengespeicherten Dokumente im Basisverzeichnis des Webservers ab.

Wie führt der Dispatcher das Caching durch?

Das Dispatcher-Modul nutzt die Fähigkeit des Webservers, statische Inhalte bereitzustellen. Der Dispatcher legt die zwischengespeicherten Dokumente im Basisverzeichnis des Webservers ab. Der Dispatcher setzt auf zwei Hauptverfahren zum Aktualisieren des zwischengespeicherten Inhalts, wenn Änderungen an der Website vorgenommen werden:

Inhaltsaktualisierungen entfernen die geänderten Seiten sowie die Dateien, die sich direkt auf sie beziehen.
Automatische Invalidierung macht automatisch jene Teile des Caches ungültig, die nach einer Aktualisierung möglicherweise veraltet sind. Dies bedeutet beispielsweise, dass entsprechende Seiten als veraltet markiert werden, ohne dass diese gelöscht werden.

Welche Vorteile hat der Lastenausgleich?

Beim Lastenausgleich werden Benutzeranfragen (Lasten) auf mehrere AEM-Instanzen verteilt. In der folgenden Liste werden die Vorteile des Lastenausgleichs beschrieben:

Verbesserte Verarbeitungsleistung: In der Praxis bedeutet diese Methode, dass der Dispatcher Dokumentanfragen zwischen mehreren AEM-Instanzen aufteilt. Da jede Instanz weniger Dokumente zu verarbeiten hat, sind die Reaktionszeiten kürzer. Der Dispatcher führt interne Statistiken für jede Dokumentenkategorie, sodass die Anforderungen geschätzt und die Abfragen effizient aufgeteilt werden können.
Verbesserte Fail-Safe-Abdeckung: Wenn der Dispatcher von einer Instanz keine Antwort empfängt, werden Anfragen automatisch an eine der anderen Instanzen weitergeleitet. Wenn eine Instanz nicht verfügbar ist, ist die einzige Auswirkung daher eine Verlangsamung der Site, proportional zur verloren gegangenen Rechenleistung.

NOTE

Weitere Informationen finden Sie auf der Seite Dispatcher-Übersicht.

Installieren und Konfigurieren

Wo kann ich das Dispatcher-Modul herunterladen?

Sie können das neueste Dispatcher-Modul über die Seite Versionshinweise zu Dispatcher herunterladen.

Wie konfiguriere ich den Dispatcher mit mehreren Domänen?

Sie können den CQ Dispatcher mit mehreren Domänen konfigurieren, sofern die Domänen die folgenden Bedingungen erfüllen:

Der Webinhalt für beide Domänen wird in einem einzelnen AEM-Repository gespeichert.
Die Dateien im Dispatcher-Cache können getrennt für jede Domäne ungültig gemacht werden

Weitere Informationen erhalten Sie unter Verwenden des Dispatchers mit mehreren Domänen.

Wie konfiguriere ich den Dispatcher so, dass alle Anforderungen eines Benutzers an dieselbe Veröffentlichungsinstanz weitergeleitet werden?

Sie können die Funktion für Sticky-Verbindungen verwenden, um sicherzustellen, dass alle Dokumente für einen Benutzer in derselben Instanz von AEM verarbeitet werden. Diese Funktion ist wichtig, wenn Sie personalisierte Seiten und Sitzungsdaten verwenden. Die Daten werden in der Instanz gespeichert. Nachfolgende Anfragen desselben Benutzers müssen daher zu dieser Instanz zurückgegeben werden oder die Daten gehen verloren.

Da durch Sticky-Verbindungen die Fähigkeit des Dispatchers eingeschränkt wird, die Anfragen zu optimieren, sollten Sie diesen Ansatz nur wenn nötig verwenden. Sie können den Ordner mit Sticky-Dokumenten angeben und so sicherstellen, dass alle Dokumente in diesem Ordner für jeden Benutzer auf derselben Instanz verarbeitet werden.

Kann ich Sticky-Verbindungen und Caching gleichzeitig verwenden?

Bei den meisten Seiten, die Sticky-Verbindungen verwenden, sollten Sie die Zwischenspeicherung deaktivieren. Andernfalls wird allen Benutzern unabhängig vom Sitzungsinhalt dieselbe Instanz der Seite angezeigt.

Für einige Anwendungen können sowohl Sticky-Verbindungen als auch Caching verwendet werden. Wenn Sie beispielsweise ein Formular anzeigen, das Daten in eine Sitzung schreibt, können Sie Sticky-Verbindungen und Caching gleichzeitig verwenden.

Können sich Dispatcher und eine AEM-Veröffentlichungsinstanz auf demselben physischen Computer befinden?

Ja, wenn der Computer ausreichend leistungsfähig ist. Es wird jedoch empfohlen, den Dispatcher und die AEM-Veröffentlichungsinstanz auf verschiedenen Computern einzurichten.

Normalerweise befindet sich die Veröffentlichungsinstanz in der Firewall und der Dispatcher in der DMZ. Wenn Sie sich dafür entscheiden, dass sich die Veröffentlichungsinstanz und der Dispatcher auf demselben physischen Computer befinden, ist sicherzustellen, dass die Firewall-Einstellungen den direkten Zugriff von externen Netzwerken auf die Veröffentlichungsinstanz verhindern.

Kann ich nur Dateien mit bestimmten Erweiterungen zwischenspeichern?

Ja. Wenn Sie beispielsweise nur GIF-Dateien zwischenspeichern möchten, geben Sie *.gif im Cache-Abschnitt der Konfigurationsdatei „dispatcher.any“ an.

Wie lösche ich Dateien aus dem Cache?

Sie können Dateien mittels HTTP-Anfrage aus dem Cache löschen. Nach Empfang der HTTP-Anfrage löscht der Dispatcher die Dateien aus dem Cache. Der Dispatcher speichert die Dateien nur dann erneut im Cache, wenn eine Clientanfrage für die Seite eingeht. Auf diese Weise zwischengespeicherte Dateien zu löschen, empfiehlt sich für Websites mit geringer Wahrscheinlichkeit, gleichzeitige Anfragen für ein und dieselbe Seite zu empfangen.

Die HTTP-Anfrage hat folgende Syntax:

POST /dispatcher/invalidate.cache HTTP/1.1
CQ-Action: Activate
CQ-Handle: path-pattern
Content-Length: 0

Der Dispatcher leert (löscht) die zwischengespeicherten Dateien und Ordner mit Namen, die dem Wert des Headers des CQ-Handles entsprechen. Beispielsweise entspricht der CQ-Handle mit dem Wert /content/geomtrixx-outdoors/en:

Allen Dateien (mit beliebiger Dateierweiterung) mit dem Namen „en“ im Verzeichnis „geometrixx-outdoors“.
Allen Verzeichnissen mit dem Namen _jcr_content unter dem Verzeichnis „en“ (das, sofern vorhanden, zwischengespeicherte Renderings von Unterknoten der Seite enthält).
Das Verzeichnis en wird nur gelöscht, wenn die CQ-Action auf Delete oder Deactivate eingestellt ist.

Weitere Einzelheiten zu diesem Thema finden Sie unter Manuelle Invalidierung des Dispatcher-Caches.

Wie implementiere ich berechtigungssensitive Zwischenspeicherung?

Lesen Sie hierzu Zwischenspeichern sicherer Inhalte.

Wie sichere ich die Kommunikation zwischen den Dispatcher- und CQ-Instanzen?

Lesen Sie hierzu die Seiten Checkliste für die Dispatcher-Sicherheit sowie Checkliste für die AEM-Sicherheit.

Dispatcher-Problem `jcr:content` geändert in `jcr%3acontent`

Frage: Das Unternehmen sah sich vor Kurzem mit einem Problem auf Dispatcher-Ebene konfrontiert. In einem der AJAX-Aufrufe, bei dem einige Daten aus dem CQ-Repository abgerufen wurden, war jcr:content enthalten. Das wurde zu jcr%3acontent verschlüsselt, was zu einem falschen Ergebnissatz führte.

Antwort: Verwenden Sie die Methode ResourceResolver.map(), um eine benutzerfreundliche URL zu erhalten, von der Anfragen entsprechend abgerufen bzw. ausgegeben werden und die das Caching-Problem mit dem Dispatcher lösen kann. Die Methode map() codiert den Doppelpunkt (:) in Unterstriche und die Methode resolve() decodiert diese zurück in das SLING JCR-lesbare Format. Verwenden Sie die Methode map(), um die URL zu generieren, die im Ajax-Aufruf verwendet wird.

Weitere Informationen: https://sling.apache.org/documentation/the-sling-engine/mappings-for-resource-resolution.html#namespace-mangling

Dispatcher bereinigen

Wie konfiguriere ich Dispatcher-Flush-Agenten auf einer Veröffentlichungsinstanz?

Lesen Sie hierzu die Seite Replikation.

Wie kann ich Probleme bei der Dispatcher-Leerung beheben?

Lesen Sie hierzu diese Artikel zur Fehlerbehebung.

Wenn der Dispatcher durch Löschvorgänge geleert wird, können Sie das Problem so umgehen, wie in diesem Community-Blog-Beitrag von Sensei Martin beschrieben.

Wie lösche ich DAM-Assets aus dem Dispatcher-Cache?

Sie können die Funktion zur Kettenreplikation verwenden. Ist diese Funktion aktiviert, sendet der Dispatcher Flush-Agent eine Leerungsanfrage bei Empfang einer Replikation von Author.

So aktivieren Sie ihn:

Folgen Sie diesen Schritten zur Erstellung von Flushing-Agenten beim Veröffentlichen.
Wechseln Sie zu den Konfigurationen des Agenten und markieren Sie auf der Registerkarte Auslöser das Feld Bei Empfang.

Sonstiges

Wie erkennt der Dispatcher, ob ein Dokument aktuell ist?
Um zu bestimmen, ob ein Dokument aktuell ist, führt der Dispatcher diese Aktionen durch:

Es wird geprüft, ob für das Dokument die automatische Invalidierung ausgeführt wird. Ist dies nicht der Fall, wird das Dokument als aktuell betrachtet.
Wenn das Dokument für die automatische Invalidierung konfiguriert wurde, überprüft der Dispatcher, ob es älter oder neuer als die letzte verfügbare Änderung ist. Wenn es älter ist, ruft der Dispatcher die aktuelle Version von der AEM-Instanz ab und ersetzt die Version im Cache.

Wie werden die Dispatcher-Rückgabedokumente zurückgegeben?

Sie können über die Dispatcher-Konfigurationsdatei dispatcher.any festlegen, ob der Dispatcher ein Dokument zwischenspeichert. Der Dispatcher überprüft die Anforderung anhand der Liste der Dokumente, die zwischengespeichert werden können. Wenn das Dokument nicht in dieser Liste enthalten ist, fordert der Dispatcher das Dokument von der AEM-Instanz an.

Die /rules-Eigenschaft steuert anhand des Dokumentenpfads, welche Dokumente zwischengespeichert werden sollen. Unabhängig von der /rules-Eigenschaft werden in folgenden Fällen Dokumente nie zwischengespeichert:

Der Anfrage-URI enthält ein Fragezeichen (?).
Dieses gibt eine dynamische Seite an (z. B. ein Suchergebnis), die nicht zwischengespeichert werden muss.
Die Dateierweiterung fehlt.
Der Webserver benötigt die Erweiterung, um den Dokumenttyp (den MIME-Typ) zu ermitteln.
Der Authentifizierungs-Header wurde festgelegt (konfigurierbar).
Die AEM-Instanz antwortet mit folgenden Headern:
- no-cache
- no-store
- must-revalidate

Der Dispatcher speichert die zwischengespeicherten Dateien auf dem Webserver, als wären sie Teil einer statischen Website. Wenn ein Benutzer ein zwischengespeichertes Dokument anfordert, überprüft der Dispatcher, ob das Dokument im Dateisystem des Webservers vorhanden ist: Ist dies der Fall, gibt der Dispatcher die Dokumente zurück. Wenn nicht, fordert der Dispatcher das Dokument von der AEM-Instanz an.