DokumentationAEMDispatcher-Anleitung

Installieren des Dispatchers installing-dispatcher

Last update: Fri Jul 12 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 Adobe 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
Installieren Sie die neueste Dispatcher-Version, die für Ihre Plattform verfügbar ist. Aktualisieren Sie Ihre Dispatcher-Instanz darüber hinaus jährlich auf die neueste Version, um von Produktverbesserungen zu profitieren.
NOTE
Kundinnen und Kunden, die von Version 4.3.3 auf die Version 4.3.4 aktualisieren, werden wahrscheinlich ein anderes Verhalten in Bezug darauf bemerken, wie Caching-Header für nicht zwischenspeicherbare Inhalte festgelegt werden. Weitere Informationen zu dieser Änderung finden Sie auf der Seite Versionshinweise.

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
Informieren Sie sich über die 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 hier:

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 für das Microsoft® Internet Information System benötigte Archiv 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.
ÄNDERUNGEN
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

Um die Dispatcher-Installation zu konfigurieren, bearbeiten Sie die Datei disp_iis.ini. 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 Datei dispatcher.log. Wenn dieser Speicherort 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 auf Protokollebene für die Protokolldatei angegeben werden:
0 – nur Fehlermeldungen.
1 – Fehlermeldungen und Warnungen.
2 – Fehlermeldungen, Warnungen und Informationsmeldungen.
3 – Fehlermeldungen, Warnungen, Informations- und Debugging-Meldungen.
Hinweis: Legen Sie die Protokollebene während der Installation und der Tests auf 3 fest und setzen Sie sie anschließend beim Ausführen in einer Produktionsumgebung wieder auf 0.
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 Entsprechung Basic <IIS:LOGON\_USER>.
servervariables
Definiert, wie Server-Variablen verarbeitet werden.
0 – IIS-Server-Variablen 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 Client-Antwort 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, 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. 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 dann 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 aus, 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 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 mit den Ordnereigenschaften 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 aus 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. Konfigurieren Sie den Dispatcher zur Verwendung der Protokolldatei und gewähren Sie IIS Schreibzugriff auf die Datei.

  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.

  4. Klicken Sie 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.

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

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

  7. 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

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

  9. 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 Vollzugriff und klicken Sie auf „OK“. Klicken Sie auf „OK“, um das Dialogfeld mit den Ordnereigenschaften zu schließen.

  10. Verwenden Sie einen Texteditor, um die Datei disp_iis.ini zu öffnen.

  11. Um den Speicherort der Protokolldatei zu konfigurieren, fügen Sie eine Textzeile ähnlich dem folgenden Beispiel hinzu und speichern Sie dann die Datei:

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

Nächste Schritte next-steps

Bevor Sie den Dispatcher verwenden können, müssen Sie mit Folgendem vertraut sein:

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, dynamic modules support zu aktivieren. Die Aktivierung dieser Option kann mit einer der Optionen von –enable-shared durchgeführt werden. 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 Installationsarchivdateien enthalten 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 Beispiel-Link.
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.
ÄNDERUNGEN
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 Red Hat® Linux® Kernel 2.6 ausführen und SELinux aktiviert ist, werden 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. Wenn ja, führen Sie die folgenden Aufgaben aus:

  • 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 Beispielkonfigurationsdatei 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, die Inhaberin oder den Inhaber des Verzeichnisses „htdocs“ zu ändern:

    • Der Apache-Server startet (aus Sicherheitsgründen) 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 Version 4.3.3 auf die Version 4.3.4 aktualisieren, werden wahrscheinlich ein anderes Verhalten in Bezug darauf bemerken, 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 Haupt-Server-Konfiguration 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: Legen Sie die Protokollebene während der Installation und der Tests auf 3 fest und setzen Sie sie anschließend beim Ausführen in einer Produktionsumgebung wieder auf 0.
DispatcherNoServerHeader

Dieser Parameter ist veraltet und unwirksam.

Definiert den zu verwendenden Server-Header:

  • nicht definiert oder 0 – der HTTP-Server-Header enthält die AEM-Version.
  • 1 – der Apache-Server-Header wird verwendet.
DispatcherDeclineRoot
Definiert, ob Anfragen an den Stamm „/“ abgelehnt werden sollen:
0 – Anfragen an / akzeptieren
1 – Der Dispatcher verarbeitet keine Anfragen an /. Verwenden Sie stattdessen „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 vorausgehen (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 Cache-Dateistruktur verwendet. Informationen zu „mod_rewrite“ finden Sie in der Dokumentation auf der Apache-Website, z. B. Apache 2.4. Verwenden Sie bei Nutzung von „mod_rewrite“ das Flag „passthrough“ (Durchleitung an nächsten Handler), um die Rewrite-Engine zu zwingen, das URI-Feld der internen request_rec-Struktur auf den Wert des Dateinamen-Felds zu setzen.
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 sendet keine Fehlerantwort an den Client (wenn der Status-Code größer oder gleich 400 ist). Stattdessen übergibt er den Status-Code an Apache, wodurch eine ErrorDocument-Anweisung einen solchen Status-Code verarbeiten kann.
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
Benutzen und konfigurieren Sie den Parameter ModMimeUsePathInfo nur, 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, ist ein Upgrade auf eine aktuelle Dispatcher-Version angezeigt.

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. Das standardmäßige Setup bedeutet, dass mod_mime den Inhaltstyp bestimmt. Daher wird nur der Teil der URL berücksichtigt, der einer Datei oder einem Verzeichnis zugeordnet ist.

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.

Im folgenden Beispiel wird ModMimeUsePathInfo aktiviert:

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® and 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. Gehen Sie zur Nutzung von OpenSSL 1.0.1 wie folgt vor, 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 Installationsarchivdateien enthalten 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 Beispiel-Link.
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.
ÄNDERUNGEN
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 beispielhafte Konfigurationsdatei 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. Außerdem müssen $(SERVER_ROOT) und $(PRODUCT_SUBDIR) durch ihre jeweiligen 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"
...

Dabei 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 Debugging
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, bearbeiten 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