Beheben von Dispatcher-Konfigurationsfehlern in AEM
Die Dispatcher-Konfiguration schlägt während der Bereitstellung oder Migration aufgrund einer falschen Dateistruktur, nicht unterstützten Paketerstellung oder falsch ausgerichteter Pipeline- und Cache-Konfigurationseinstellungen fehl. Diese Probleme können eine erfolgreiche Bereitstellung verhindern oder zu unerwartetem Verhalten in allen AEM-Umgebungen führen. Um das Problem zu beheben, korrigieren Sie die Konfigurationsstruktur, überprüfen Sie das Pipeline-Verhalten und überprüfen Sie die Einrichtung.
Beschreibung description
Umgebungen
- Adobe Experience Manager as a Cloud Service (AEMaaCS)
- AEM Managed Services (AMS)
- Bereitstellungs- und Migrationsszenarios für die Dispatcher-Konfiguration
Problem/Symptome
- Die Bereitstellung schlägt fehl, wenn die Dispatcher-Konfiguration als ZIP-Archiv anstatt als Rohordner hochgeladen wird
- Migration zeigt Fehler EPERM: Vorgang nicht erlaubt, Symlink auf Windows-Systemen
- Die Dispatcher-Pipeline aktualisiert Konfigurationen nicht erwartungsgemäß
- Cache wird nach der Bereitstellung trotz Konfigurationsaktualisierungen nicht gelöscht
Ursache
Bereitstellungsfehler treten auf, weil Cloud Manager die Raw-Dispatcher-Ordnerstruktur und keine komprimierten Archive benötigt. In AMS müssen umgebungsspezifische Variablen extern definiert werden, anstatt hartcodiert zu werden. Während der Migration stützt sich Dispatcher Converter auf symbolische Links, die durch Betriebssystembeschränkungen blockiert werden können.
Lösung resolution
Führen Sie diese Schritte aus, um das Problem zu beheben
- Stellen Sie sicher, dass das Repository unkomprimierte Dispatcher-Ordner wie
conf.dundconf.dispatcher.dam richtigen Speicherort enthält, und entfernen Sie alle manuell erstellten ZIP-Dateien. - Erstellen Sie eine dedizierte Web-Stufen-Pipeline in Cloud Manager und wählen Sie den richtigen Repository-Pfad aus, damit die Dispatcher-Konfiguration unabhängig bereitgestellt wird, ohne dass vollständige Bereitstellungen ausgelöst werden.
- Überprüfen Sie das Bereitstellungsverhalten und stellen Sie sicher, dass die ausgewählte Pipeline die Dispatcher-Quellstruktur enthält und erfolgreich mit aktualisierten Protokollen ausgeführt wird. Beachten Sie dabei, dass nur Dispatcher-Pipelines inkrementell aktualisiert werden.
- Wenden Sie unterstützte Cache-Löschmethoden an, indem Sie einen Flush-Endpunkt für AEM as a Cloud Service aktivieren oder benutzerdefinierte Skripte in AMS verwenden, und bestätigen Sie Cache-Aktualisierungen, indem Sie die Dispatcher-Cache-Zeitstempel überprüfen.
- Definieren Sie Umgebungsspezifische Variablen in Managed Services mithilfe von Variablendateien, schließen Sie sie in Virtual-Host-Konfigurationen ein und stellen Sie sicher, dass die Konfiguration bei Anfragen korrekt aufgelöst wird.
- Rufen Sie bei Bedarf Dispatcher-Konfigurationspakete aus der Umgebung ab und überprüfen Sie, ob die extrahierten Dateien mit der erwarteten Verzeichnisstruktur übereinstimmen.
- Führen Sie die Dispatcher-Konversion mit entsprechenden Systemberechtigungen aus oder verwenden Sie eine unterstützte Umgebung, um Symlink-Fehler zu vermeiden und sicherzustellen, dass die konvertierte Struktur erfolgreich generiert.
- Validieren Sie die Bereitstellung über Umgebungen hinweg, indem Sie die Pipeline-Ausführungsprotokolle überprüfen, Dispatcher-Protokolle überprüfen und bestätigen, dass Konfigurationsaktualisierungen korrekt angewendet werden.
- Wenden Sie sich an Ihr Adobe-Konto-Team , um die Anmeldedaten für die CDN-Bereinigungs-API anzufordern, wenn Sie eine programmgesteuerte Cache-Leerung benötigen.