DokumentationAEMDispatcher-Anleitung

Installieren des Dispatchers installing-dispatcher

Last update: Thu Mar 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Admin

Rufen Sie über die Seite Versionshinweise zu Dispatcher die neueste Dispatcher-Installationsdatei für Ihr Betriebssystem und Ihren Webserver ab. Die Dispatcher-Versionsnummern sind von den Adobe Experience Manager-Versionsnummern unabhängig und mit den Versionen Adobe Experience Manager 6.x, Adobe Experience Manager 5.x und Adobe CQ 5.x kompatibel.

NOTE
Für Experience Manager 6.5 ist die Dispatcher-Version 4.3.2 oder höher erforderlich. Allerdings sind Dispatcher-Versionen unabhängig von AEM. Beispielsweise ist die Dispatcher-Version 4.3.2 auch mit Adobe Experience Manager 6.4 kompatibel.

Es wird die folgende Dateinamenskonvention verwendet:

dispatcher-<web-server>-<operating-system>-<dispatcher-version-number>.<file-format>

Beispielsweise enthält die Datei dispatcher-apache2.4-linux-x86_64-ssl-4.3.1.tar.gz die Dispatcher-Version 4.3.1 für einen Apache 2.4-Webserver, der unter Linux i686 ausgeführt wird. Diese Datei ist im  tar-Format gepackt.

In der folgenden Tabelle ist die Webserverkennung aufgeführt, die in den Dateinamen für die einzelnen Webserver verwendet wird:

Webserver
Installations-Kit
Apache 2.4
dispatcher-apache 2.4-<andere Parameter>
Microsoft Internet Information Server 7.5, 8, 8.5, 10
dispatcher-iis-<andere Parameter>
Sun Java Web Server/iPlanet
dispatcher-ns-<andere Parameter>
CAUTION
Sie sollten die neueste Dispatcher-Version installieren, die für Ihre Plattform verfügbar ist. Darüber hinaus sollten Sie Ihre Dispatcher-Instanz jährlich auf die neueste Version aktualisieren, um von Produktverbesserungen zu profitieren.
NOTE
Kundinnen und Kunden, die von 4.3.3 auf die Version 4.3.4 aktualisieren, werden ein anderes Verhalten in Bezug darauf feststellen, wie Caching-Header für nicht zwischenspeicherbare Inhalte festgelegt werden. Weitere Informationen zu dieser Änderung finden Sie in den Versionshinweisen.

Jedes Archiv enthält die folgenden Dateien:

  • die Dispatcher-Module
  • eine Beispielkonfigurationsdatei
  • die README-Datei mit Installationsanweisungen und aktuellen Informationen
  • die CHANGES-Datei, in der Probleme aufgeführt sind, die in der aktuellen und in vorherigen Versionen behoben wurden
NOTE
Bitte informieren Sie sich in der README-Datei über kurzfristig eingeführte Änderungen/plattformspezifische Hinweise, bevor Sie mit der Installation beginnen.

Microsoft Internet Information Server microsoft-internet-information-server

Weitere Informationen zur Installation dieses Webservers finden Sie:

Erforderliche IIS-Komponenten required-iis-components

Für die Nutzung der IIS-Versionen 8.5 und 10 müssen die folgenden IIS-Komponenten installiert sein:

  • ISAPI-Erweiterungen

Darüber hinaus müssen Sie die Webserver-Rolle (IIS) hinzufügen. Verwenden Sie den Server-Manager, um die Rolle und Komponenten hinzuzufügen.

Microsoft IIS – Installieren des Dispatcher-Moduls microsoft-iis-installing-the-dispatcher-module

Das erforderliche Archiv für Microsoft Internet Information System ist:

  • dispatcher-iis-<operating-system>-<dispatcher-release-number>.zip

Die ZIP-Datei enthält die folgenden Dateien:

File
Beschreibung
disp_iis.dll
Die DLL-Datei (Dynamic Link Library) des Dispatchers.
disp_iis.ini
Konfigurationsdatei für IIS. Dieses Beispiel kann mit Ihren Anforderungen aktualisiert werden. Hinweis: Die INI-Datei muss denselben Namensstamm wie die DLL haben.
dispatcher.any
Eine Beispielkonfigurationsdatei für den Dispatcher.
author_dispatcher.any
Eine Beispielkonfigurationsdatei für den Dispatcher bei Verwendung der Autoreninstanz.
README
Datei mit Installationsanweisungen und aktuellen Informationen. Hinweis: Lesen Sie die Informationen in dieser Datei, bevor Sie mit der Installation beginnen.
CHANGES
Datei, in der Probleme aufgeführt sind, die in der aktuellen und in vorherigen Versionen behoben wurden.

Führen Sie die folgenden Schritte aus, um die Dispatcher-Dateien an den richtigen Speicherort zu kopieren.

  1. Verwenden Sie Windows Explorer, um das Verzeichnis <IIS_INSTALLDIR>/Scripts zu erstellen, beispielsweise C:\inetpub\Scripts.

  2. Extrahieren Sie die folgenden Dateien aus dem Dispatcher-Paket in dieses Skriptverzeichnis:

    • disp_iis.dll

    • disp_iis.ini

    • Eine der folgenden Dateien, je nachdem ob der Dispatcher mit einer AEM-Autoreninstanz oder -Veröffentlichungsinstanz eingesetzt wird:

      • Autoreninstanz: author_dispatcher.any
      • Veröffentlichungsinstanz: dispatcher.any

Microsoft IIS – Konfigurieren der INI-Datei des Dispatchers microsoft-iis-configure-the-dispatcher-ini-file

Bearbeiten Sie die Datei disp_iis.ini, um die Dispatcher-Installation zu konfigurieren. Das Standardformat der .ini-Datei lautet wie folgt:

[main]
configpath=<path to dispatcher.any>
loglevel=1|2|3
servervariables=0|1
replaceauthorization=0|1

In der folgenden Tabelle werden die einzelnen Eigenschaften beschrieben.

Parameter
Beschreibung
configpath
Der Speicherort von dispatcher.any im lokalen Dateisystem (absoluter Pfad).
logfile
Der Speicherort der dispatcher.log-Datei. Wenn dieser nicht festgelegt ist, werden Protokollmeldungen im Windows-Ereignisprotokoll gespeichert.
loglevel
Definiert die Protokollebene, die verwendet wird, um Meldungen im Ereignisprotokoll auszugeben. Die folgenden Werte können als Protokollebene für die Protokolldatei angegeben werden:
0 – nur Fehlermeldungen.
1 – Fehlermeldungen und Warnungen.
2 – Fehler, Warnungen und Informationsmeldungen
3 – Fehler, Warnungen, Informations- und Problembehebungsnachrichten.
Hinweis: Es wird empfohlen, die Protokollebene während der Installation und der Tests auf 3 festzulegen und anschließend beim Ausführen in einer Produktionsumgebung wieder auf 0 zu setzen.
replaceauthorization
Legt fest, wie Autorisierungs-Header in der HTTP-Anfrage verarbeitet werden. Die folgenden Werte sind gültig:
0 – Autorisierungs-Header werden nicht geändert.
1 – ersetzt alle Header mit dem Namen „Authorization“ mit Ausnahme von „Basic“ durch die Basic <IIS:LOGON\_USER>-Entsprechung.
servervariables
Definiert, wie Server-Variablen verarbeitet werden.
0 – IIS-Servervariablen werden weder an den Dispatcher noch an AEM gesendet.
1 – Alle IIS-Servervariablen (wie LOGON\_USER, QUERY\_STRING, ...) werden zusammen mit den Anforderungsheadern an den Dispatcher gesendet (und an die AEM-Instanz, wenn keine Zwischenspeicherung erfolgt).
Zu den Servervariablen gehören AUTH\_USER, LOGON\_USER, HTTPS\_KEYSIZE und viele andere. In der IIS-Dokumentation finden Sie eine umfassende Liste der Variablen mit detaillierten Informationen.
enable_chunked_transfer
Definiert, ob die Blockübertragung für die Clientantwort aktiviert (1) oder deaktiviert (0) werden soll. Der Standardwert ist 0.

Eine Beispielkonfiguration:

[main]
configpath=C:\Inetpub\Scripts\dispatcher.any
loglevel=1
servervariables=1
replaceauthorization=0

Konfigurieren von Microsoft IIS configuring-microsoft-iis

Konfigurieren Sie IIS, um das ISAPI-Modul des Dispatchers zu integrieren. In IIS werden Platzhalter-Anwendungszuordnungen verwendet.

Konfigurieren des anonymen Zugriffs  – IIS 8.5 und 10 configuring-anonymous-access-iis-and

Der standardmäßige Flush-Replikationsagent auf der Autoreninstanz ist so konfiguriert, dass er keine Sicherheitsanmeldeinformationen mit Anfragen zum Leeren sendet. Daher muss die Website, die Sie als Dispatcher-Cache verwenden, den anonymen Zugriff zulassen.

Wenn Ihre Website eine Authentifizierungsmethode anwendet, muss der Flush-Replikationsagent entsprechend konfiguriert werden.

  1. Öffnen Sie den IIS-Manager und wählen Sie die Website, die Sie als Dispatcher-Cache verwenden.
  2. Doppelklicken Sie im Ansichtsmodus „Features“ im Abschnitt „IIS“ auf „Authentifizierung“.
  3. Wenn die anonyme Authentifizierung nicht aktiviert ist, wählen Sie „Anonyme Authentifizierung“ und klicken Sie im Bereich „Aktionen“ auf „Aktivieren“.

Integrieren des ISAPI-Moduls des Dispatchers – IIS 8.5 und 10 integrating-the-dispatcher-isapi-module-iis-and

Führen Sie die folgenden Schritte aus, um das ISAPI-Modul des Dispatchers zu IIS hinzuzufügen.

  1. Öffnen Sie den IIS-Manager.

  2. Wählen Sie die Website aus, die Sie als Dispatcher-Cache verwenden.

  3. Doppelklicken Sie im Ansichtsmodus „Features“ im Abschnitt „IIS“ auf „Handler-Zuordnungen“.

  4. Klicken Sie auf der Seite „Handler-Zuordnungen“ im Bereich „Aktionen“ auf „Skriptzuordnung mit Platzhalter hinzufügen“, fügen Sie die folgenden Eigenschaftswerte hinzu und klicken Sie dann auf „OK“:

    • Anfragepfad: *
    • Ausführbare Datei: der absolute Pfad der Datei „disp_iis.dll“, beispielsweise C:\inetpub\Scripts\disp_iis.dll.
    • Name: ein beschreibender Name für die Handlerzuordnung, beispielsweise Dispatcher.

  5. Klicken Sie im daraufhin angezeigten Dialogfeld, auf „Ja“, um der Liste „ISAPI- und CGI-Einschränkungen“ die Bibliothek „disp_iis.dll“ hinzuzufügen.

    Für IIS 7.0 und 7.5 ist die Konfiguration damit abgeschlossen. Fahren Sie mit den verbleibenden Schritten fort, wenn Sie IIS 8.0 konfigurieren.

  6. (IIS 8.0) Wählen Sie in der Liste der Handler-Zuordnungen die Zuordnung aus, die Sie zuvor erstellt haben, und klicken Sie im Bereich „Aktionen“ auf „Bearbeiten“.

  7. (IIS 8.0) Klicken Sie im Dialogfeld „Skriptzuordnung bearbeiten“ auf die Schaltfläche „Einschränkungen“.

  8. (IIS 8.0) Um sicherzustellen, dass der Handler für Dateien und Ordner verwendet wird, die noch nicht im Cache zwischengespeichert sind, deaktivieren Sie das Kontrollkästchen „Handler nur bei folgender Zuordnung aufrufen“ und klicken Sie auf „OK“.

  9. (IIS 8.0) Klicken Sie im Dialogfeld „Skriptzuordnung bearbeiten“ auf „OK“.

Konfigurieren des Zugriffs auf den Cache – IIS 8.5 und 10 configuring-access-to-the-cache-iis-and

Geben Sie den standardmäßigen Anwendungspoolbenutzer mit Schreibzugriff auf den Ordner an, der als Dispatcher-Cache verwendet werden soll.

  1. Klicken Sie mit der rechten Maustaste auf den Basisordner der Website, die Sie als Dispatcher-Cache verwenden, und klicken Sie auf „Eigenschaften“, beispielsweise C:\inetpub\wwwroot

  2. Klicken Sie auf der Registerkarte „Sicherheit“ auf „Bearbeiten“ und im Dialogfeld „Berechtigungen“ auf „Hinzufügen“. Daraufhin wird ein Dialogfeld zum Auswählen von Benutzerkonten geöffnet. Klicken Sie auf die Schaltfläche „Speicherorte“, wählen Sie den Namen Ihres Computers aus und klicken Sie dann auf „OKׅ“.

    Lassen Sie dieses Dialogfeld geöffnet, während Sie den nächsten Schritt durchführen.

  3. Wählen Sie im IIS-Manager die IIS-Website, die Sie als Dispatcher-Cache verwenden, und klicken Sie rechts im Fenster auf „Erweiterte Einstellungen“.

  4. Wählen Sie den Wert der Eigenschaft „Anwendungspool“ und kopieren Sie ihn in die Zwischenablage.

  5. Kehren Sie zum geöffneten Dialogfeld zurück. Geben Sie im Feld „Geben Sie die zu verwendenden Objektnamen ein“ IIS AppPool\ ein und fügen Sie dann den Inhalt aus der Zwischenablage ein. Der Wert sollte wie folgt lauten:

    IIS AppPool\DefaultAppPool

  6. Klicken Sie auf die Schaltfläche „Namen überprüfen“. Wenn Windows das Benutzerkonto auflöst, klicken Sie auf „OK“.

  7. Wählen Sie im Dialogfeld „Berechtigungen“ für den Ordner „Dispatcher“ das Konto, das Sie gerade hinzugefügt haben, aktivieren Sie alle Berechtigungen für das Konto außer Vollzugriff und klicken Sie auf „OK“. Klicken Sie auf „OK“, um das Dialogfeld „Eigenschaften“ zu schließen.

Registrieren des JSON-MIME-Typs – IIS 8.5 und 10 registering-the-json-mime-type-iis-and

Führen Sie die folgenden Schritte aus, um den JSON-MIME-Typ zu registrieren, wenn Sie möchten, dass der Dispatcher JSON-Aufrufe zulässt.

  1. Wählen Sie im IIS-Manager Ihre Website und doppelklicken Sie unter Verwendung der Ansicht „Features“ auf „MIME-Typen“.

  2. Wenn die JSON-Erweiterung nicht in der Liste aufgeführt wird, klicken Sie im Bereich „Aktionen“ auf „Hinzufügen“, geben Sie die folgenden Eigenschaftswerte ein und klicken Sie dann auf „OK“:

    • Dateinamenerweiterung: .json
    • MIME Type: application/json

Entfernen des ausgeblendeten Segments „bin“ – IIS 8.5 und 10 removing-the-bin-hidden-segment-iis-and

Führen Sie die folgenden Schritte aus, um das ausgeblendete Segment bin zu entfernen. Websites, die nicht neu sind, können dieses ausgeblendete Segment enthalten.

  1. Wählen Sie im IIS-Manager Ihre Website und doppelklicken Sie unter Verwendung der Ansicht „Features“ auf „Anfragefilterung“.
  2. Wählen Sie das Segment bin, klicken Sie auf „Entfernen“ und klicken Sie im Bestätigungsdialogfeld auf „Ja“.

Protokollieren von IIS-Meldungen in einer Datei – IIS 8.5 und 10 logging-iis-messages-to-a-file-iis-and

Führen Sie die folgenden Schritte aus, damit Dispatcher-Protokollmeldungen in eine Protokolldatei und nicht in das Windows-Ereignisprotokoll geschrieben werden. Sie müssen den Dispatcher zur Verwendung der Protokolldatei konfigurieren und IIS Schreibzugriff auf die Datei gewähren.

  1. Verwenden Sie Windows Explorer, um unter dem Protokollordner der IIS-Installation einen Ordner mit dem Namen dispatcher zu erstellen. Der Pfad dieses Ordners für eine Standardinstallation lautet C:\inetpub\logs\dispatcher.

  2. Klicken Sie mit der rechten Maustaste auf den Dispatcher-Ordner und klicken Sie dann auf „Eigenschaften“.

  3. Klicken Sie auf der Registerkarte „Sicherheit“ auf „Bearbeiten“ und im Dialogfeld „Berechtigungen“ auf „Hinzufügen“. Daraufhin wird ein Dialogfeld zum Auswählen von Benutzerkonten geöffnet. Klicken Sie auf die Schaltfläche „Speicherorte“, wählen Sie den Namen Ihres Computers aus und klicken Sie dann auf „OKׅ“.

    Lassen Sie dieses Dialogfeld geöffnet, während Sie den nächsten Schritt durchführen.

  4. Wählen Sie im IIS-Manager die IIS-Website, die Sie als Dispatcher-Cache verwenden, und klicken Sie rechts im Fenster auf „Erweiterte Einstellungen“.

  5. Wählen Sie den Wert der Eigenschaft „Anwendungspool“ und kopieren Sie ihn in die Zwischenablage.

  6. Kehren Sie zum geöffneten Dialogfeld zurück. Geben Sie im Feld „Geben Sie die zu verwendenden Objektnamen ein“ IIS AppPool\ ein und fügen Sie dann den Inhalt aus der Zwischenablage ein. Der Wert sollte wie folgt lauten:

    IIS AppPool\DefaultAppPool

  7. Klicken Sie auf die Schaltfläche „Namen überprüfen“. Wenn Windows das Benutzerkonto auflöst, klicken Sie auf „OK“.

  8. Wählen Sie im Dialogfeld „Berechtigungen“ für den Dispatcher-Ordner das Konto aus, das Sie gerade hinzugefügt haben, aktivieren Sie alle Berechtigungen für das Konto außer dem Vollzugriff und klicken Sie auf „OK“. Klicken Sie auf „OK“, um das Dialogfeld „Eigenschaften“ zu schließen.

  9. Verwenden Sie einen Text-Editor, um die Datei disp_iis.ini zu öffnen.

  10. Fügen Sie eine Textzeile ähnlich wie im folgenden Beispiel hinzu, um den Speicherort der Protokolldatei zu konfigurieren, und speichern Sie die Datei anschließend

    code language-xml 
    logfile=C:\inetpub\logs\dispatcher\dispatcher.log

Nächste Schritte next-steps

Bevor Sie mit der Verwendung des Dispatchers beginnen können, ist Folgendes zu beachten:

Apache-Webserver apache-web-server

CAUTION
Hier finden Sie Anweisungen für die Installation unter Windows und Unix. Gehen Sie bei der Durchführung der Schritte vorsichtig vor.

Installieren eines Apache-Webservers installing-apache-web-server

Weitere Informationen zum Installieren eines Apache-Webservers finden Sie im entsprechenden Installationshandbuch, das entweder online verfügbar ist oder im Rahmen der Verteilung bereitgestellt wurde.

CAUTION
Wenn Sie eine Apache-Binärdatei durch Kompilieren der Quelldateien erstellen, denken Sie daran, die Unterstützung für dynamische Module zu aktivieren. Dies kann mithilfe einer der –enable-shared-Optionen erfolgen. Nehmen Sie mindestens das mod_so-Modul auf.
Weitere Informationen finden Sie im Installationshandbuch für Apache-Webserver.

Lesen Sie auch die Sicherheitstipps und Sicherheitsberichte für Apache HTTP-Server.

Apache-Webserver – Hinzufügen des Dispatcher-Moduls apache-web-server-add-the-dispatcher-module

Der Dispatcher wird folgendermaßen bereitgestellt:

  • Windows: als Dynamic Link Library (DLL)
  • Unix: als Dynamic Shared Object (DSO)

Die Installationsarchivdatei enthält die folgenden Dateien, je nachdem, ob Sie Windows oder Unix ausgewählt haben:

File
Beschreibung
disp_apache<x.y>.dll
Windows: die DLL-Datei des Dispatchers.
dispatcher-apache<x.y>-<Versionsnr>.so
Unix: die DSO-Datei des Dispatchers.
mod_dispatcher.so
Unix: ein Beispiellink.
http.conf.disp<x>
Eine Beispielkonfigurationsdatei für den Apache-Server.
dispatcher.any
Eine Beispielkonfigurationsdatei für den Dispatcher.
README
Datei mit Installationsanweisungen und aktuellen Informationen. Hinweis: Lesen Sie die Informationen in dieser Datei, bevor Sie mit der Installation beginnen.
CHANGES
Datei, in der Probleme aufgeführt sind, die in der aktuellen und in vorherigen Versionen behoben wurden.

Führen Sie die folgenden Schritte aus, um den Dispatcher zum Apache-Webserver hinzuzufügen:

  1. Platzieren Sie die Dispatcher-Datei im entsprechenden Verzeichnis des Apache-Moduls:

    • Windows: disp_apache<x.y>.dll in <APACHE_ROOT>/modules platzieren.
    • Unix: Suchen Sie je nach Installation entweder nach dem Verzeichnis <APACHE_ROOT>/libexec oder <APACHE_ROOT>/modules.
      Kopieren Sie dispatcher-apache<options>.so in diesen Ordner.
      Um die Verwaltung langfristig zu vereinfachen, können Sie auch eine symbolische Verknüpfung mit dem Namen mod_dispatcher.so zum Dispatcher erstellen:
      ln -s dispatcher-apache<x>-<os>-<rel-nr>.so mod_dispatcher.so

  2. Kopieren Sie die Datei „dispatcher.any“ in das Verzeichnis <APACHE_ROOT>/conf.

    Hinweis: Sie können diese Datei an einem anderen Speicherort platzieren, sofern die Eigenschaft „DispatcherLog“ des Dispatcher-Moduls entsprechend konfiguriert ist. (Siehe „Dispatcher-spezifische Konfigurationseinträge“ unten.)

Apache-Webserver – Konfigurieren der SELinux-Eigenschaften apache-web-server-configure-selinux-properties

Wenn Sie den Dispatcher auf RedHat Linux Kernel 2.6 ausführen und SELinux aktiviert ist, werden Ihnen in der Dispatcher-Protokolldatei möglicherweise Fehlermeldungen wie diese angezeigt.

Mon Jun 30 00:03:59 2013] [E] [16561(139642697451488)] Unable to connect to backend rend01 (10.122.213.248:4502): Permission denied

Grund hierfür sind wahrscheinlich die aktivierten SELinux-Sicherheitseinstellungen. Dann müssen Sie die folgenden Aufgaben ausführen:

  • Konfigurieren des SELinux-Kontextes der Dispatcher-Moduldatei
  • Aktivieren von HTTPD-Skripten und -Modulen zum Herstellen von Netzwerkverbindungen
  • Konfigurieren des SELinux-Kontextes des Dokumentenstamms, in dem die zwischengespeicherten Dateien gespeichert sind

Geben Sie in einem Terminal-Fenster die folgenden Befehle ein und ersetzen Sie dabei [path to the dispatcher.so file] durch den Pfad zum Dispatcher-Modul, das Sie auf dem Apache-Webserver installiert haben, und path to the docroot durch den Pfad zum Basisverzeichnis (z. B. /opt/cq/cache):

semanage fcontext -a -t httpd_modules_t [path to the dispatcher.so file]
setsebool -P httpd_can_network_connect on
chcon -R --type httpd_sys_rw_content_t [path to the docroot]
semanage fcontext -a -t httpd_sys_rw_content_t "[path to the docroot](/.*)?"

Apache-Webserver – Konfigurieren eines Apache-Webservers für den Dispatcher apache-web-server-configure-apache-web-server-for-dispatcher

Der Apache-Webserver muss mithilfe von httpd.conf konfiguriert werden. Im Dispatcher Installation Kit finden Sie eine Beispielskonfigurationsdatei mit dem Namen httpd.conf.disp<x>.

Die folgenden Schritte sind erforderlich:

  1. Navigieren Sie zu <APACHE_ROOT>/conf.

  2. Öffnen Sie httpd.conf zur Bearbeitung.

  3. Die folgenden Konfigurationseinträge müssen in der angegebenen Reihenfolge hinzugefügt werden:

    • LoadModule zum Laden des Moduls beim Start
    • Dispatcher-spezifische Konfigurationseinträge, einschließlich DispatcherConfig, DispatcherLog und DispatcherLogLevel.
    • SetHandler zum Aktivieren des LoadModule des Dispatchers.
    • ModMimeUsePathInfo zum Konfigurieren des Verhaltens von mod_mime.

  4. (Optional) Es wird empfohlen, den Inhaber des Verzeichnisses „htdocs“ zu ändern:

    • Aus Sicherheitsgründen startet der Apache-Server als Root, auch wenn die untergeordneten Prozesse als Daemon starten. DocumentRoot (<APACHE_ROOT>/htdocs) muss dem Benutzer Daemon angehören:

      code language-xml 
      cd <APACHE_ROOT>
chown -R daemon:daemon htdocs

LoadModule

In der folgenden Tabelle sind Beispiele aufgeführt, die verwendet werden können. Die genauen Einträge hängen vom jeweiligen Apache-Webserver ab:

Windows
... LoadModule dispatcher_module modules\disp_apache.dll ...
Unix  (ausgehend von einer symbolischen Verknüpfung)
... LoadModule dispatcher_module libexec/mod_dispatcher.so ...
NOTE
Der erste Parameter jeder Anweisung muss genau wie in den oben aufgeführten Beispielen geschrieben sein.
Umfassende Informationen zu diesem Befehl finden Sie in den Beispielkonfigurationsdateien und in der Apache-Webserver-Dokumentation.

Dispatcher-spezifische Konfigurationseinträge

Die Dispatcher-spezifischen Konfigurationseinträge werden nach dem Eintrag „LoadModule“ platziert. Die folgende Tabelle enthält eine Beispielkonfiguration, die sowohl für Unix als auch für Windows anwendbar ist:

Windows und Unix

...
<IfModule disp_apache2.c>
DispatcherConfig conf/dispatcher.any
DispatcherLog logs/dispatcher.log DispatcherLogLevel 3
DispatcherNoServerHeader 0 DispatcherDeclineRoot 0
DispatcherUseProcessedURL 0
DispatcherPassError 0
DispatcherKeepAliveTimeout 60
</IfModule>
...
NOTE
Kundinnen und Kunden, die von 4.3.3 auf die Version 4.3.4 aktualisieren, werden ein anderes Verhalten in Bezug darauf feststellen, wie Caching-Header für nicht zwischenspeicherbare Inhalte festgelegt werden. Weitere Informationen zu dieser Änderung finden Sie auf der Seite Versionshinweise.

Die einzelnen Konfigurationsparameter lauten:

Parameter
Beschreibung
DispatcherConfig
Speicherort und Name der Dispatcher-Konfigurationsdatei.
Wenn sich diese Eigenschaft in der Hauptserverkonfiguration befindet, übernehmen alle virtuellen Hosts den Eigenschaftenwert. Allerdings können virtuelle Hosts die Eigenschaft DispatcherConfig einschließen, um die Hauptserverkonfiguration zu überschreiben.
DispatcherLog
Speicherort und Name der Protokolldatei.
DispatcherLogLevel
Protokollebene für die Protokolldatei:
0 – Fehlermeldungen
1 – Warnungen
2 – Informationen
3 – Debug-Meldungen
Hinweis: Es wird empfohlen, die Protokollebene während der Installation und der Tests auf 3 festzulegen und anschließend beim Ausführen in einer Produktionsumgebung wieder auf 0 zu setzen.
DispatcherNoServerHeader

Dieser Parameter wird veraltet und hat keine Auswirkung mehr.

Definiert den zu verwendenden Server-Header:

  • nicht definiert oder 0 – der HTTP-Server-Header enthält die AEM-Version.
  • 1 – der Apache-Serverheader wird verwendet.
DispatcherDeclineRoot
Definiert, ob Anfragen an den Stamm „/“ abgelehnt werden sollen:
0  – Anfragen an / werden angenommen
1  – Anfragen an / werden nicht vom Dispatcher verarbeitet. Verwenden Sie „mod_alias“ für die korrekte Zuordnung.
DispatcherUseProcessedURL
Legt fest, ob vorverarbeitete URLs für die weitere Verarbeitung durch den Dispatcher verwendet werden sollen:
0 – die an den Webserver übergebene ursprüngliche URL wird verwendet.
1  – Der Dispatcher verwendet die URL, die bereits von den Handlern verarbeitet wurde, die dem Dispatcher vorangehen (d. h. mod_rewrite), anstelle der ursprünglichen URL, die an den Webserver übergeben wurde. Beispielsweise wird entweder die ursprüngliche oder verarbeitete URL mit den Dispatcher-Filtern abgeglichen. Die URL wird auch als Grundlage für die Cachedateistruktur verwendet. Weitere Informationen zu „mod_rewrite“ finden Sie in der Dokumentation auf der Apache-Website, z. B. Apache 2.4. Bei Verwendung von „mod_rewrite“ wird empfohlen, die Markierung „passthrough“ zu verwenden
DispatcherPassError
Definiert, wie Fehler-Codes für die ErrorDocument-Verarbeitung unterstützt werden:
0 – Der Dispatcher spoolt alle Fehlerantworten an den Client.
1 – Der Dispatcher spoolt keine Fehlerantwort an den Client (wobei der Status-Code größer oder gleich 400 ist), übergibt aber den Status-Code an Apache, was es beispielsweise einer ErrorDocument-Direktive ermöglicht, einen solchen Status-Code zu verarbeiten.
Code-Bereich  – Geben Sie eine Reihe von Fehler-Codes an, für die die Antwort an Apache übergeben wird. Andere Fehlercodes werden an den Client übergeben. Beispielsweise übergibt die folgende Konfiguration Antworten für Fehler 412 an den Client und alle anderen Fehler werden an Apache übergeben: DispatcherPassError 400-411,413-417
DispatcherKeepAliveTimeout
Gibt den Keep-Alive-Timeout in Sekunden an. Ab Dispatcher-Version 4.2.0 beträgt der Standardwert für die Keep-Alive-Funktion 60. Wenn der Wert 0 lautet, wird der Keep-Alive-Timeout deaktiviert.
DispatcherNoCanonURL
Wenn Sie diesen Parameter auf „Ein“ setzen, wird die unformatierte URL anstelle der kanonisierten URL an das Backend übergeben und die Einstellungen von DispatcherUseProcessedURL überschrieben. Der Standardwert ist „Off“.
Hinweis: Die Filterregeln in der Dispatcher-Konfiguration werden immer anhand der bereinigten URL und nicht anhand der unformatierten URL ausgewertet.
NOTE
Pfadeinträge sind relativ zum Stammverzeichnis des Apache-Webservers.
NOTE
Die Standardeinstellungen für den Server-Header lauten:
ServerTokens Full
DispatcherNoServerHeader 0
Dies zeigt die AEM-Version (für statistische Zwecke). Wenn Sie diese Informationen im Header deaktivieren möchten, können Sie Folgendes festlegen:
ServerTokens Prod
Weitere Informationen erhalten Sie in der Apache-Dokumentation zur ServerTokens-Direktive (zum Beispiel für Apache 2.4).

SetHandler

Nach diesen Einträgen müssen Sie die Anweisung SetHandler zum Kontext Ihrer Konfiguration (<Directory>, <Location>) hinzufügen, damit der Dispatcher die eingehenden Anfragen verarbeiten kann. Im folgenden Beispiel wird der Dispatcher zur Bearbeitung von Anforderungen für die gesamte Website konfiguriert:

Windows und Unix

...
<Directory />
<IfModule disp_apache2.c>
SetHandler dispatcher-handler
</IfModule>

Options FollowSymLinks
AllowOverride None
</Directory>
...

Im folgenden Beispiel wird der Dispatcher zur Bearbeitung von Anforderungen für eine virtuelle Domäne konfiguriert:

Windows

...
<VirtualHost 123.45.67.89>
ServerName www.mycompany.com
DocumentRoot _\[cache-path\]_\\docs
<Directory _\[cache-path\]_\\docs>
<IfModule disp_apache2.c>
SetHandler dispatcher-handler
</IfModule>
AllowOverride None
</Directory>
</VirtualHost>
...

Unix

...
<VirtualHost 123.45.67.89>
ServerName www.mycompany.com
DocumentRoot /usr/apachecache/docs
<Directory /usr/apachecache/docs>
<IfModule disp_apache2.c>
SetHandler dispatcher-handler
</IfModule>
AllowOverride None
</Directory>
</VirtualHost>
...
NOTE
Der Parameter der Anweisung SetHandler muss genau wie in den oben aufgeführten Beispielen geschrieben sein, da dies der Name des im Modul definierten Handlers ist.
Umfassende Informationen zu diesem Befehl finden Sie in den Beispielkonfigurationsdateien und in der Apache-Webserver-Dokumentation.

ModMimeUsePathInfo

Nach der Anweisung SetHandler sollten Sie auch die Definition ModMimeUsePathInfo hinzufügen.

NOTE
Der Parameter ModMimeUsePathInfo sollte nur verwendet und konfiguriert werden, wenn Sie die Dispatcher-Version 4.0.9 oder höher verwenden.
(Die Dispatcher-Version 4.0.9 wurde im Jahr 2011 veröffentlicht. Wenn Sie eine ältere Version verwenden, sollten Sie ein Upgrade auf eine aktuelle Dispatcher-Version durchführen.)

Der Parameter ModMimeUsePathInfo sollte für alle Apache-Konfigurationen auf On festgelegt sein:

ModMimeUsePathInfo On

Mit dem mod_mime-Modul (siehe beispielsweise Apache Module mod_mime) werden Inhaltsmetadaten dem Inhalt zugewiesen, der für eine HTTP-Antwort ausgewählt wurde. Standardsetup bedeutet, dass nur der Teil der URL berücksichtigt wird, der einer Datei oder einem Verzeichnis zugeordnet ist, wenn „mod_mime“ den Inhaltstyp bestimmt.

Wenn die Angabe On lautet, gibt der Parameter ModMimeUsePathInfo an, dass mod_mime den Inhaltstypen anhand der vollständigen URL bestimmen wird. Das bedeutet, dass auf virtuelle Ressourcen anhand ihrer Erweiterung Metainformationen angewendet werden.

Das folgende Beispiel aktiviert ModMimeUsePathInfo:

Windows und Unix

...
<Directory />
<IfModule disp_apache2.c>
SetHandler dispatcher-handler
ModMimeUsePathInfo On
</IfModule>

Options FollowSymLinks
AllowOverride None
</Directory>
...

Aktivieren der Unterstützung für HTTPS (Unix und Linux) enable-support-for-https-unix-and-linux

Der Dispatcher verwendet OpenSSL, um eine sichere Kommunikation über HTTP zu implementieren. Ab Dispatcher-Version 4.2.0 werden OpenSSL 1.0.0 und OpenSSL 1.0.1 unterstützt. Der Dispatcher verwendet standardmäßig OpenSSL 1.0.0. Wenden Sie zur Nutzung von OpenSSL 1.0.1 das folgende Verfahren an, um symbolische Verknüpfungen zu erstellen, sodass der Dispatcher die installierten OpenSSL-Bibliotheken verwendet.

  1. Öffnen Sie ein Terminal-Fenster und ändern Sie das aktuelle Verzeichnis in das Verzeichnis, in dem die OpenSSL-Bibliotheken installiert sind, beispielsweise:

    code language-shell 
    cd /usr/lib64

  2. Um die symbolischen Verknüpfungen zu erstellen, geben Sie die folgenden Befehle ein:

    code language-shell 
    ln -s libssl.so libssl.so.1.0.1
ln -s libcrypto.so libcrypto.so.1.0.1
NOTE
Wenn Sie eine angepasste Version von Apache verwenden, stellen Sie sicher, dass Apache und der Dispatcher mit derselben OpenSSL-Version kompiliert wurden.

Nächste Schritte next-steps-1

Bevor Sie mit der Verwendung des Dispatchers beginnen können, müssen Sie Folgendes durchführen:

Sun Java System Web Server/iPlanet sun-java-system-web-server-iplanet

NOTE
Hier werden Anweisungen für Windows- und Unix-Umgebungen beschrieben.
Gehen Sie bei der Auswahl der auszuführenden Version vorsichtig vor.

Sun Java System Web Server/iPlanet – Installieren des Webservers sun-java-system-web-server-iplanet-installing-your-web-server

Umfassende Informationen zur Installation dieser Webserver finden Sie in der jeweiligen Dokumentation:

  • Sun Java System Web Server
  • iPlanet Web Server

Sun Java System Web Server/iPlanet – Hinzufügen des Dispatcher-Moduls sun-java-system-web-server-iplanet-add-the-dispatcher-module

Der Dispatcher wird folgendermaßen bereitgestellt:

  • Windows: als Dynamic Link Library (DLL)
  • Unix: als Dynamic Shared Object (DSO)

Die Installationsarchivdatei enthält die folgenden Dateien, je nachdem, ob Sie Windows oder Unix ausgewählt haben:

File
Beschreibung
disp_ns.dll
Windows: die DLL-Datei des Dispatchers.
dispatcher.so
Unix: die DSO-Datei des Dispatchers.
dispatcher.so
Unix: ein Beispiellink.
obj.conf.disp
Eine Beispielkonfigurationsdatei für den iPlanet-/Sun Java-System-Webserver.
dispatcher.any
Eine Beispielkonfigurationsdatei für den Dispatcher.
README
Datei mit Installationsanweisungen und aktuellen Informationen. Hinweis: Lesen Sie die Informationen in dieser Datei, bevor Sie mit der Installation beginnen.
CHANGES
Datei, in der Probleme aufgeführt sind, die in der aktuellen und in vorherigen Versionen behoben wurden.

Führen Sie die folgenden Schritte aus, um den Dispatcher zu Ihrem Webserver hinzuzufügen:

  1. Platzieren Sie die Dispatcher-Datei im Verzeichnis plugin des Webservers:

Sun Java System Web Server/iPlanet – Konfigurieren für den Dispatcher sun-java-system-web-server-iplanet-configure-for-the-dispatcher

Der Webserver muss mithilfe von obj.conf konfiguriert werden. Im Dispatcher Installation Kit finden Sie eine Beispielskonfigurationsdatei mit dem Namen obj.conf.disp.

  1. Navigieren Sie zu <WEBSERVER_ROOT>/config.

  2. Öffnen Sie obj.conf zur Bearbeitung.

  3. Kopieren Sie die wie folgt beginnende Zeile
    Service fn="dispService"
    aus obj.conf.disp in den Initialisierungsabschnitt von obj.conf.

  4. Speichern Sie die Änderungen.

  5. Öffnen Sie magnus.conf zur Bearbeitung.

  6. Kopieren Sie die wie folgt beginnenden Zeilen
    Init funcs="dispService, dispInit"
    und
    Init fn="dispInit"
    aus obj.conf.disp in den Initialisierungsabschnitt von magnus.conf.

  7. Speichern Sie die Änderungen.

NOTE
Die folgenden Konfigurationen sollten sich alle in einer Zeile befinden. $(SERVER_ROOT) und $(PRODUCT_SUBDIR) müssen durch die entsprechenden Werte ersetzt werden.

Init

In der folgenden Tabelle sind Beispiele aufgeführt, die verwendet werden können. Die genauen Einträge hängen vom jeweiligen Webserver ab:

Windows und Unix

...
Init funcs="dispService,dispInit" fn="load-modules" shlib="$(SERVER\_ROOT)/plugins/dispatcher.so"
Init fn="dispInit" config="$(PRODUCT\_SUBDIR)/dispatcher.any" loglevel="1" logfile="$(PRODUCT\_SUBDIR)/logs/dispatcher.log"
keepalivetimeout="60"
...

Hierbei gilt:

Parameter
Beschreibung
config
Speicherort und Name der Konfigurationsdatei dispatcher.any.
logfile
Speicherort und Name der Protokolldatei.
loglevel
Protokollebene für die Protokolldatei:
0 Fehlermeldungen
1 Warnungen
2 Informationen
3 Debug-Meldungen
Hinweis: Es wird empfohlen, die Protokollebene während der Installation und der Tests auf 3 festzulegen und anschließend beim Ausführen in einer Produktionsumgebung wieder auf 0 zu setzen.
keepalivetimeout
Gibt den Keep-Alive-Timeout in Sekunden an. Ab Dispatcher-Version 4.2.0 beträgt der Standardwert für die Keep-Alive-Funktion 60. Wenn der Wert 0 lautet, wird der Keep-Alive-Timeout deaktiviert.

Abhängig von Ihren jeweiligen Anforderungen können Sie den Dispatcher als einen Service für Ihre Objekte definieren. Um den Dispatcher für Ihre gesamte Website zu konfigurieren, ändern Sie das Standardobjekt:

Windows

...
NameTrans fn="document-root" root="$(PRODUCT\_SUBDIR)\\dispcache"
...
Service fn="dispService" method="(GET|HEAD|POST)" type="\*\\\*"
...

Unix

...
NameTrans fn="document-root" root="$(PRODUCT\_SUBDIR)/dispcache"
...
Service fn="dispService" method="(GET|HEAD|POST)" type="\*/\*"
...

Nächste Schritte next-steps-2

Bevor Sie mit der Verwendung des Dispatchers beginnen können, müssen Sie Folgendes durchführen:

recommendation-more-help
ce382601-480f-4a99-8be7-73178d4b6ef5