Dispatcher-Konfigurationen für AEM Screens dispatcher-configurations-for-aem-screens

Last update: Wed Apr 10 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:
Administering Screens

Erstellt für:

Intermediate
Developer
User

Der Dispatcher ist das Caching- und/oder Lastenausgleichstool von Adobe Experience Manager.

Auf der folgenden Seite finden Sie die Richtlinien zum Konfigurieren des Dispatchers für ein AEM Screens-Projekt.

NOTE

Wenn ein Dispatcher verfügbar ist, können Verbindungen zum Registrierungs-Servlet durch Filtern in den Dispatcher-Regeln verhindert werden.

Wenn kein Dispatcher vorhanden ist, deaktivieren Sie das Registrierungs-Servlet in der Liste der OSGi-Komponenten.

Bevor Sie den Dispatcher für ein AEM Screens-Projekt konfigurieren, müssen Sie über Vorkenntnisse in Dispatcher verfügen.
Siehe Dispatcher konfigurieren für weitere Details.

Konfigurieren von Dispatcher für die Manifest-Version v2 configuring-dispatcher

IMPORTANT

Die folgenden Dispatcher-Konfigurationen gelten nur für die Manifest-Version v2. Siehe Dispatcher-Konfigurationen für Manifestversion v3 für die Manifestversion v3.

AEM Screens-Player oder -Geräte verwenden authentifizierte Sitzungen, um auf die Ressourcen in den Veröffentlichungsinstanzen zuzugreifen. Wenn Sie also über mehrere Veröffentlichungsinstanzen verfügen, sollten die Anforderungen immer an dieselbe Veröffentlichungsinstanz gesendet werden, damit die authentifizierte Sitzung für alle Anforderungen gültig ist, die von den AEM Screens-Playern/Geräten stammen.

Gehen Sie wie folgt vor, um den Dispatcher für ein AEM Screens-Projekt zu konfigurieren.

Aktivieren von fixierbaren Sitzungen enable-sticky-session

Wenn Sie mehrere Veröffentlichungsinstanzen mit einem Frontend des einzelnen Dispatchers verwenden möchten, aktualisieren Sie die dispatcher.any -Datei, um die Treue zu aktivieren.

/stickyConnections {
  /paths
  {
    "/"
  }
 }

Wenn eine Veröffentlichungsinstanz von einem Dispatcher als Frontend fungiert, hilft das Aktivieren der Treue beim Dispatcher nicht, da der Lastenausgleich jede Anfrage an den Dispatcher senden kann. Wählen Sie in diesem Fall Aktivieren in Stickiness -Feld, um es auf Ihrer Lastenausgleichsebene zu aktivieren, wie in der folgenden Abbildung dargestellt:

Bild

Wenn Sie beispielsweise AWS ALB verwenden, lesen Sie Zielgruppen für Ihren Anwendungs-Lastenausgleich für die Aktivierung der Stickigkeit auf ALB-Ebene. Aktivieren Sie die Stickiness für einen Tag.

Schritt 1: Konfigurieren von Client-Kopfzeilen step-configuring-client-headers

Fügen Sie dem Abschnitt /clientheaders Folgendes hinzu:

X-Requested-With

X-SET-HEARTBEAT

X-REQUEST-COMMAND

Schritt 2: Konfigurieren von Screens-Filtern step-configure-screens-filters

Fügen Sie /filter Folgendes hinzu, um Screens-Filter zu konfigurieren.

## AEM Screens Filters
## # Login, Ping and Device Configurations
/0200 { /type "allow" /method "POST" /url "/libs/granite/core/content/login.validate/j_security_check" }
/0201 { /type "allow" /method "GET" /url "/libs/granite/csrf/token.json" }
/0202 { /type "allow" /method "GET" /url "/content/screens/svc.json" }
/0203 { /type "allow" /method "GET" /url "/content/screens/svc.ping.json" }
/0204 { /type "allow" /method "GET" /url "/content/screens/svc.config.json" }
## # Device Dashboard Configurations
/0210 { /type "allow" /method '(GET|POST)' /url "/home/users/screens/*/devices/*/profile_screens.preferences.json" }
/0211 { /type "allow" /method "POST" /url "/home/users/screens/*/devices/*/profile_screens.logs.json" }
/0212 { /type "allow" /method "POST" /url "/home/users/screens/*/devices/*/profile_screens.statusinfo.json" }
/0213 { /type "allow" /method "POST" /url "/home/users/screens/*/devices/*/profile_screens.screenshot.json" }
## # Content Configurations
/0220 { /type "allow" /method '(GET|HEAD)' /url "/content/screens/*" }
/0221 { /type "allow" /method '(GET|HEAD)' /url "/content/screens/*/jcr:content/*/offline-config_*.zip" }
/0222 { /type "allow" /method '(GET|HEAD)' /url '/var/contentsync/content/screens/.+/jcr:content/.+/offline-config_.*\.[0-9]+\.zip' }

Schritt 3: Deaktivieren von Dispatcher-Cache step-disabling-dispatcher-cache

Dispatcher-Zwischenspeicherung deaktivieren für /content/screens path.

Screens-Player verwenden authentifizierte Sitzungen, sodass der Dispatcher keine der Anforderungen der Screens-Player für channels/assets.

Um den Cache für die Assets zu aktivieren, damit die Assets aus dem Dispatcher-Cache bereitgestellt werden, müssen Sie:

/allowAuthorization 1 im Abschnitt /cache hinzufügen,
die folgenden Regeln zum Abschnitt /rules von /cache hinzufügen.

/0000
    {
        /glob "*"
        /type "allow"
    }

/0001
    {
        # Disable Dispatcher Cache for Screens channels
        /glob "/content/screens/*.html"
        /type "deny"
    }

/0002
    {
    # Disable Dispatcher Cache for Screens offline manifests
    /glob "/content/screens/*.json"
    /type "deny"
    }

/0003
    { # Disable Dispatcher Cache for Screens devices json
    /glob "/home/users/screens/*.json"
    /type "deny"
    }

Konfigurieren von Dispatcher für die Manifest-Version v3 configuring-dispatcherv3

Stellen Sie sicher, dass diese Filter und Cache-Regeln in Dispatchern vor den Veröffentlichungsinstanzen für die Funktion von Screens zugelassen werden.

Voraussetzungen für Manifest-Version v3 prerequisites3

Befolgen Sie diese beiden Voraussetzungen, bevor Sie den Dispatcher (Manifestversion v3) für AEM Screens konfigurieren:

Stellen Sie sicher, dass Sie v3 manifests verwenden. Navigieren Sie zu https://<server:port>/system/console/configMgr/com.adobe.cq.screens.offlinecontent.impl.ContentSyncCacheFeatureFlag und stellen Sie sicher, dass Enable ContentSync Cache deaktiviert ist.
Stellen Sie sicher, dass der Dispatcher-Flush-Agent unter konfiguriert ist. /etc/replication/agents.publish/dispatcher1useast1Agent in der Veröffentlichungsinstanz.

Filter filter-v3

## AEM Screens Filters
## # Login, Ping and Device Configurations
/0200 { /type "allow" /method "POST" /url "/libs/granite/core/content/login.validate/j_security_check" }
/0201 { /type "allow" /method "GET" /url "/libs/granite/csrf/token.json" }
/0202 { /type "allow" /method "GET" /url "/content/screens/svc.json" }
/0203 { /type "allow" /method "GET" /url "/content/screens/svc.ping.json" }
/0204 { /type "allow" /method "GET" /url "/content/screens/svc.config.json" }

## # Device Dashboard Configurations
/0210 { /type "allow" /method '(GET|POST)' /url "/home/users/screens/*/devices/*/profile_screens.preferences.json" }
/0211 { /type "allow" /method "POST" /url "/home/users/screens/*/devices/*/profile_screens.logs.json" }
/0212 { /type "allow" /method "POST" /url "/home/users/screens/*/devices/*/profile_screens.statusinfo.json" }
/0213 { /type "allow" /method "POST" /url "/home/users/screens/*/devices/*/profile_screens.screenshot.json" }

## # Content Configurations
/0220 { /type "allow" /method '(GET|HEAD)' /url "/content/screens/*" }
#/0221 { /type "allow" /method '(GET|HEAD)' /url "/content/experience-fragments/*" } ## uncomment this, if you're using experience-fragments
/0222 { /type "allow" /extension '(css|eot|gif|ico|jpeg|jpg|js|gif|pdf|png|svg|swf|ttf|woff|woff2|html|mp4|mov|m4v)' /path "/content/dam/*" } ## add any other formats required for your project here

## # Enable clientlibs proxy servlet
/0230 { /type "allow" /method "GET" /url "/etc.clientlibs/*" }

Cache-Regeln cache-rules-v3

Fügen Sie /allowAuthorized "1" zum Abschnitt /cache in publish_farm.any hinzu.
Alle AEM Screens-Player verwenden eine authentifizierte Sitzung, um eine Verbindung zu AEM (Autor/Veröffentlichung) herzustellen. Der vordefinierte Dispatcher speichert diese URLs nicht zwischen, daher sollten Sie diese aktivieren.
Hinzufügen statfileslevel "10" nach /cache Abschnitt in publish_farm.any
Dies unterstützt das Caching von bis zu zehn Ebenen aus dem Cache-Basisverzeichnis und das entsprechende Invalidieren bei der Veröffentlichung von Inhalten, anstatt alles zu invalidieren. Sie können diese Ebene ändern, je nachdem, wie tief Ihre Inhaltsstruktur ist.

Hinzufügen von Folgendem zu /invalidate section in publish_farm.any

code language-none
`/0003 { /glob "*.json" /type "allow" }`

Fügen Sie die folgenden Regeln zum Abschnitt /rules in /cache in publish_farm.any oder einer Datei hinzu, die in publish_farm.any enthalten ist:

code language-none

code language-none
## Don't cache CSRF login tokens /0001 { /glob "/libs/granite/csrf/token.json" /type "deny" } ## Allow Dispatcher Cache for Screens channels /0002 { /glob "/content/screens/.html" /type "allow" } ## Allow Dispatcher Cache for Screens offline manifests /0003 { /glob "/content/screens/.manifest.json" /type "allow" } ## Allow Dispatcher Cache for Assets /0004 { /glob "/content/dam/" /type "allow" } ## Disable Dispatcher Cache for Screens devices json /0005 { /glob "/home/users/screens/.json" /type "deny" } ## Disable Dispatcher Cache for Screens svc json /0006 { /glob "/content/screens/svc.json" /type "deny" }

## Don't cache CSRF login tokens
/0001
    {
    /glob "/libs/granite/csrf/token.json"
    /type "deny"
    }
## Allow Dispatcher Cache for Screens channels
/0002
    {
        /glob "/content/screens/*.html"
        /type "allow"
    }
## Allow Dispatcher Cache for Screens offline manifests
/0003
    {
    /glob "/content/screens/*.manifest.json"
    /type "allow"
    }
## Allow Dispatcher Cache for Assets
/0004
    {

    /glob "/content/dam/*"
    /type "allow"
    }
## Disable Dispatcher Cache for Screens devices json
/0005
    {
    /glob "/home/users/screens/*.json"
    /type "deny"
    }
## Disable Dispatcher Cache for Screens svc json
/0006
    {
    /glob "/content/screens/svc.json"
    /type "deny"
    }

Hinzufügen der Invalidierungsregel für segment.js invalidsegmentjs

Wenn Sie zielgerichtete Kampagnen mit AEM Screens verwenden, wird die segments.js file vom Dispatcher bereitgestellt werden, müssen invalidiert werden, wenn Sie neue Segmente hinzufügen und auf AEM veröffentlichen. Ohne diese Invalidierungsregel funktionieren neue zielgerichtete Kampagnen nicht auf dem AEM Screens-Player (es wird stattdessen der Standardinhalt angezeigt).

Fügen Sie eine Invalidierungsregel zu /etc/httpd/conf.dispatcher.d/available_farms/999_ams_publish_farm.any hinzu. Folgende Regel soll hinzugefügt werden:

    /invalidate {
                        .
                        .
                        /0004 {
                               /glob "conf/<project-name>/settings/wcm/.js"
                               /type "allow"
                        }
                }

Diese Regel stellt sicher, dass die segments.js-Datei invalidiert wird und die neueste Datei abgerufen wird, wenn sie geändert wird.

recommendation-more-help

adce462a-f916-4dbe-9ab5-0b62cfb0f053