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.
Beachten Sie, dass für Adobe Experience Manager 6.5 die Dispatcher-Version 4.3.2 oder höher erforderlich ist. Allerdings sind Dispatcher-Versionen unabhängig von AEM, z. B. ist die Dispatcher-Version 4.3.2 auch mit Adobe Experience Manager 6.4 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> |
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.
Kunden, die ein spezifisches Upgrade von Version 4.3.3 auf Version 4.3.4 durchführen, werden feststellen, dass beim Festlegen von Zwischenspeicherkopfzeilen für nicht erreichbare Inhalte ein anderes Verhalten auftritt. Weitere Informationen zu dieser Änderung finden Sie unter Versionshinweise Seite.
Jedes Archiv enthält die folgenden Dateien:
Bitte informieren Sie sich in der README-Datei über kurzfristig eingeführte Änderungen/plattformspezifische Hinweise, bevor Sie mit der Installation beginnen.
Weitere Informationen zur Installation dieses Webservers bieten Ihnen die folgenden Ressourcen:
Für die Nutzung der IIS-Versionen 8.5 und 10 müssen die folgenden IIS-Komponenten installiert sein:
Darüber hinaus müssen Sie die Webserverrolle (IIS) hinzufügen. Verwenden Sie Server-Manager, um die Rolle und Komponenten hinzuzufügen.
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.
Verwenden Sie Windows Explorer, um das Verzeichnis <IIS_INSTALLDIR>/Scripts
zu erstellen, beispielsweise C:\inetpub\Scripts
.
Extrahieren Sie die folgenden Dateien aus dem Dispatcher-Paket in dieses Skriptverzeichnis:
disp_iis.dll
disp_iis.ini
author_dispatcher.any
dispatcher.any
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 - Autorisierungskopfzeilen 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 Sie IIS, um das ISAPI-Modul des Dispatchers zu integrieren. In IIS werden Anwendungsplatzhalter verwendet.
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.
Führen Sie die folgenden Schritte aus, um das ISAPI-Modul des Dispatchers zu IIS hinzuzufügen.
Öffnen Sie den IIS-Manager.
Wählen Sie die Website aus, die Sie als Dispatcher-Cache verwenden.
Doppelklicken Sie im Ansichtsmodus „Features“ im Abschnitt „IIS“ auf „Handlerzuordnungen“.
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“:
C:\inetpub\Scripts\disp_iis.dll
.Dispatcher
.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.
(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“.
(IIS 8.0) Klicken Sie im Dialogfeld „Skriptzuordnung bearbeiten“ auf die Schaltfläche „Einschränkungen“.
(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“.
(IIS 8.0) Klicken Sie im Dialogfeld „Skriptzuordnung bearbeiten“ auf „OK“.
Geben Sie den standardmäßigen Anwendungspoolbenutzer mit Schreibzugriff auf den Ordner an, der als Dispatcher-Cache verwendet werden soll.
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
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.
Wählen Sie im IIS-Manager die IIS-Website, die Sie als Dispatcher-Cache verwenden, und klicken Sie rechts im Fenster auf „Erweiterte Einstellungen“.
Wählen Sie den Wert der Eigenschaft „Anwendungspool“ und kopieren Sie ihn in die Zwischenablage.
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
Klicken Sie auf die Schaltfläche „Namen überprüfen“. Wenn Windows das Benutzerkonto auflöst, klicken Sie auf „OK“.
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.
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.
Wählen Sie im IIS-Manager Ihre Website und doppelklicken Sie unter Verwendung der Ansicht „Features“ auf „MIME-Typen“.
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“:
.json
application/json
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.
bin
, klicken Sie auf „Entfernen“ und klicken Sie im Bestätigungsdialogfeld auf „Ja“.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.
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
.
Klicken Sie mit der rechten Maustaste auf den Ordner „Dispatcher“ und klicken Sie auf „Eigenschaften“.
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.
Wählen Sie im IIS-Manager die IIS-Website, die Sie als Dispatcher-Cache verwenden, und klicken Sie rechts im Fenster auf „Erweiterte Einstellungen“.
Wählen Sie den Wert der Eigenschaft „Anwendungspool“ und kopieren Sie ihn in die Zwischenablage.
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
Klicken Sie auf die Schaltfläche „Namen überprüfen“. Wenn Windows das Benutzerkonto auflöst, klicken Sie auf „OK“.
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.
Verwenden Sie einen Text-Editor, um die Datei disp_iis.ini
zu öffnen.
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
Bevor Sie mit der Verwendung des Dispatchers beginnen können, ist Folgendes zu beachten:
Hier finden Sie Anweisungen für die Installation unter Windows und Unix. Gehen Sie bei der Durchführung der Schritte umsichtig vor.
Weitere Informationen zum Installieren eines Apache-Webservers finden Sie im entsprechenden Installationshandbuch, das entweder online verfügbar oder der Verteilung beigefügt ist.
Wenn Sie eine Apache-Binärdatei durch Kompilieren der Quelldateien erstellen, stellen Sie sicher, dass Sie die Unterstützung für dynamische Module 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.
Weitere Informationen finden Sie unter Apache HTTP Server . Sicherheitstipps und Sicherheitsberichte.
Der Dispatcher wird folgendermaßen bereitgestellt:
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. |
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:
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
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.)
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:
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](/.*)?"
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:
Navigieren Sie zu <APACHE_ROOT>/conf
.
Öffnen Sie httpd.conf
zur Bearbeitung.
Die folgenden Konfigurationseinträge müssen in der angegebenen Reihenfolge hinzugefügt werden:
(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 ... |
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>
...
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:
|
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. |
Pfadeinträge sind relativ zum Stammverzeichnis des Apache-Webservers.
Die Standardeinstellungen für den Server-Header lauten:
ServerTokens Full
DispatcherNoServerHeader 0
Dies zeigt die AEM-Version (statistische Zwecke). Wenn Sie diese Informationen im Header deaktivieren möchten, können Sie Folgendes festlegen:
ServerTokens Prod
Siehe Apache-Dokumentation zur ServerTokens-Direktive (z. B. für Apache 2.4) für weitere Informationen.
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>
...
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.
Der Parameter ModMimeUsePathInfo
sollte nur verwendet und konfiguriert werden, wenn Sie die Dispatcher-Version 4.0.9 oder höher verwenden.
(Beachten Sie, dass die Dispatcher-Version 4.0.9 im Jahr 2011 veröffentlicht wurde. 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
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>
...
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.
Öffnen Sie ein Terminalfenster und ändern Sie das aktuelle Verzeichnis in das Verzeichnis, in dem die OpenSSL-Bibliotheken installiert sind, beispielsweise:
cd /usr/lib64
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
Wenn Sie eine angepasste Version von Apache verwenden, stellen Sie sicher, dass Apache und der Dispatcher mit derselben Version von OpenSSL / kompiliert wurden.
Bevor Sie mit der Verwendung des Dispatchers beginnen können, müssen Sie Folgendes durchführen:
Hier werden Anweisungen für Windows- und Unix-Umgebungen beschrieben.
Gehen Sie bei der Auswahl der auszuführenden Version umsichtig vor.
Umfassende Informationen zur Installation dieser Webserver finden Sie in der jeweiligen Dokumentation:
Der Dispatcher wird folgendermaßen bereitgestellt:
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. |
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 Webserver hinzuzufügen:
plugin
des Webservers:Der Webserver muss mithilfe von obj.conf
konfiguriert werden. Im Dispatcher Installation Kit finden Sie eine Beispielskonfigurationsdatei mit dem Namen obj.conf.disp
.
Navigieren Sie zu <WEBSERVER_ROOT>/config
.
Öffnen Sie obj.conf
zur Bearbeitung.
Kopieren Sie die wie folgt beginnende Zeile
Service fn="dispService"
aus obj.conf.disp
in den Initialisierungsabschnitt von obj.conf
.
Speichern Sie die Änderungen.
Öffnen Sie magnus.conf
zur Bearbeitung.
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
.
Speichern Sie die Änderungen.
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 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="\*/\*"
...
Bevor Sie mit der Verwendung des Dispatchers beginnen können, müssen Sie Folgendes durchführen: