Installieren des Dispatchers

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-Releasenummern unabhängig und mit Adobe Experience Manager 6.x, 5.x und den Adobe CQ 5.x-Releases kompatibel.

Es wird die folgende Dateibenennungskonvention 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	dispatcher-iis-<andere Parameter>
Sun Java Web Server/iPlanet	dispatcher-ns-<andere Parameter>

Jedes Archiv enthält die folgenden Dateien:

• die Dispatcher-Module
• eine Beispielkonfigurationsdatei
• die README-Datei, die die Installationsanweisungen und aktuelle Informationen enthält
• die CHANGES-Datei, in der Probleme aufgeführt sind, die in der aktuellen und in vorherigen Versionen behoben wurden

Microsoft Internet Information Server

Weitere Informationen zur Installation dieses Webservers bieten Ihnen die folgenden Ressourcen:

• Dokumentation von Microsoft zu Internet Information Server
• Die offizielle Microsoft-Website zu IIS

Erforderliche IIS-Komponenten

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 Webserverrolle (IIS) hinzufügen. Verwenden Sie Server-Manager, um die Rolle und Komponenten hinzuzufügen.

Microsoft IIS – Installieren des Dispatcher-Moduls

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

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 angegeben werden:Protokollebene für die Protokolldatei: 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 Tests auf 3 festzulegen und anschließend zur Ausführung in der Produktionsumgebung wieder auf 0 zu setzen.
replaceauthorization	Legt fest, wie Autorisierungsheader in der HTTP-Anforderung bearbeitet werden. Die folgenden Werte sind gültig: 0 – Autorisierungsheader 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 Servervariablen 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

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

Anonymen Zugriff konfigurieren – IIS 8.5 und 10

Der standardmäßige Flush-Replikationsagent auf der Autoreninstanz ist so konfiguriert, dass er keine Sicherheitsanmeldeinformationen mit Anforderung 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

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 „Handlerzuordnungen“.

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

   • Anforderungspfad: *
   • 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, um IIS 8.0 zu konfigurieren.

6. (IIS 8.0) Wählen Sie in der Liste der Handlerzuordnungen 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

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 klicken Sie dann im Dialogfeld „Berechtigungen“ auf „Hinzufügen“. Daraufhin öffnet sich ein Dialogfeld zum Auswählen von Benutzerkonten. Klicken Sie auf die Schaltfläche „Speicherorte“, wählen Sie den Namen Ihres Computers und klicken Sie dann auf „OKׅ“.

   Lassen Sie dieses Dialogfeld geöffnet, während Sie den nächsten Schritt abschließen.

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

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 Eigenschaftenwerte ein und klicken Sie dann auf „OK“:

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

Entfernen des ausgeblendeten Segments „bin“ – IIS 8.5 und 10

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 „Anforderungsfilterung“.
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

Führen Sie die folgenden Schritte aus, um Dispatcher-Protokollmeldungen in eine Protokolldatei anstatt in das Windows-Ereignisprotokoll zu schreiben. 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 Ordner „Dispatcher“ und klicken Sie auf „Eigenschaften“.

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

   Lassen Sie dieses Dialogfeld geöffnet, während Sie den nächsten Schritt abschließen.

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

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

    logfile=C:\inetpub\logs\dispatcher\dispatcher.log
    

Nächste Schritte

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

• Konfiguration des Dispatchers
• Konfiguration von AEM zur Verwendung mit dem Dispatcher

Apache-Webserver

Installieren eines Apache-Webservers

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

Siehe auch Apache HTTP Server Security Tips und Security Reports.

Apache-Webserver – Hinzufügen des Dispatcher-Moduls

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 gewählt haben:

Datei	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.
LESEN	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 weiter unten auf dieser Seite.)

Apache-Webserver – Konfigurieren der SELinux-Eigenschaften

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-Skripts und -Modulen zum Herstellen von Netzwerkverbindungen
• Konfigurieren des SELinux-Kontextes des Dokumentenstamms, in dem die zwischengespeicherten Dateien gespeichert sind

Geben Sie in einem Terminalfenster die folgenden Befehle ein und ersetzen Sie [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_content_t [path to the docroot]
semanage fcontext -a -t httpd_sys_content_t "[path to the docroot](/.*)?"

Apache-Webserver – Konfigurieren eines Apache-Webservers für den 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 Dispatchers. LoadModule.
   • ModMimeUsePathInfo zum Konfigurieren des Verhaltens von mod_mime.

4. (Optional) Es wird empfohlen, den Besitzer 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:

     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 von Ihrem spezifischen 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 ...

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

...
<fModule disp_apache2.c>
DispatcherConfig conf/dispatcher.any
DispatcherLog logs/dispatcher.log DispatcherLogLevel 3
DispatcherNoServerHeader 0 DispatcherDeclineRoot 0
DispatcherUseProcessedURL 0
DispatcherPassError 0
DispatcherKeepAliveTimeout 60
</IfModule>
...

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 – Debugmeldungen Hinweis: Es wird empfohlen, die Protokollebene während der Installation und Tests auf 3 festzulegen und anschließend zur Ausführung in der Produktionsumgebung wieder auf 0 zurückzusetzen.
DispatcherNoServerHeader	Dieser Parameter wird veraltet und hat keine Auswirkung mehr. Definiert den zu verwendenden Serverheader: nicht definiert oder 0 – der HTTP-Server-Header enthält die AEM-Version. 1 – der Apache-Serverheader wird verwendet.
DispatcherDeclineRoot	Definiert, ob Anforderungen an den Stamm „/“ abgelehnt werden sollen: 0 – Anforderungen an / werden angenommen 1 – Anforderungen 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 Fehlercodes 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 Statuscode größer oder gleich 400 ist), übergibt aber den Statuscode an Apache, was es beispielsweise einer ErrorDocument-Direktive ermöglicht, einen solchen Statuscode zu verarbeiten. Codebereich – Geben Sie eine Reihe von Fehlercodes 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 „Aus“. Hinweis: Die Filterregeln in der Dispatcher-Konfiguration werden immer anhand der bereinigten URL und nicht anhand der unformatierten URL ausgewertet.

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

ModMimeUsePathInfo

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

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

ModMimeUsePathInfo On

Das mod_mime-Modul (siehe beispielsweise Apache Module mod_mime) wird zum Zuweisen von Inhaltsmetadaten zu dem Inhalt verwendet, der für eine HTTP-Antwort gewä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)

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 Terminalfenster und ändern Sie das aktuelle Verzeichnis in das Verzeichnis, in dem die OpenSSL-Bibliotheken installiert sind, beispielsweise:

   cd /usr/lib64
   

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

   ln -s libssl.so libssl.so.1.0.1
   ln -s libcrypto.so libcrypto.so.1.0.1
   

Nächste Schritte

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

• Konfiguration des Dispatchers
• Konfiguration von AEM zur Verwendung mit dem Dispatcher

Sun Java System Web Server/iPlanet

Sun Java System Web Server/iPlanet – Installieren des Webservers

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

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 gewählt haben:

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

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.

Init

In der folgenden Tabelle sind Beispiele aufgeführt, die verwendet werden können. Die genauen Einträge hängen von Ihrem spezifischen 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 Debugmeldungen Hinweis: Es wird empfohlen, die Protokollebene während der Installation und Tests auf 3 festzulegen und anschließend zur Ausführung in der Produktionsumgebung wieder auf 0 zurückzusetzen.
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 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

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

• Konfiguration des Dispatchers
• Konfiguration von AEM zur Verwendung mit dem Dispatcher