Installieren des Dispatchers

Hinweis

Dispatcher-Versionen sind unabhängig von AEM. Möglicherweise wurden Sie von der Dokumentation zu einer früheren AEM-Version zu dieser Seite weitergeleitet.

Verwenden Sie Adobe PackageShare, um die neueste Installationsdatei des Dispatchers für Ihr Betriebssystem und Ihren Webserver abzurufen. 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-<Webserver>-<Betriebssystem>-<Dispatcher-Versionsnummer>.<Dateiformat>

Beispielsweise enthält die Datei „dispatcher-apache2.2-linux-i686-4.0.6.tgz“ die Dispatcher-Version 4.0.6 für einen Apache 2.2-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-apache2.4-<andere Parameter>
 Apache 2.2  dispatcher-apache2.2-<andere Parameter>
 Microsoft Internet
 Information Server 7.5, 8, 8.5
 dispatcher-iis-<andere Parameter>
 Sun Java Web Server/iPlanet
 dispatcher-ns-<andere parameter>

Hinweis

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.

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 

Hinweis

Bitte informieren Sie sich in der README-Datei über kurzfristig eingeführte Änderungen/plattformspezifische Hinweise, bevor Sie mit der Installation beginnen.

In den folgenden Abschnitten sind Einzelheiten zu den webserverspezifischen Installationsverfahren aufgeführt.

Microsoft Internet Information Server

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

Erforderliche IIS-Komponenten

Für die Nutzung der IIS-Versionen 7.5, 8.0 und 8.5 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-<Betriebssystem>-<Dispatcher-Releasenummer>.zip

Die ZIP-Datei enthält die folgenden Dateien:

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

Code-Beispiele dienen lediglich zu Illustrationszwecken.

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

0: nur Fehlermeldungen.
1: Fehlermeldungen und Warnungen.
2: Fehlermeldungen, Warnungen und Informationsmeldungen.
3: Fehlermeldungen, Warnungen, Informationsmeldungen und 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.

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 jegliche Header mit dem Namen „Authorization“ mit Ausnahme von „Basic“ durch die Entsprechung „Basic <IIS:LOGON_USER>“.

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 zählen u. a. AUTH_USER, LOGON_USER und HTTPS_KEYSIZE. In der IIS-Dokumentation finden Sie eine umfassende Liste der Variablen mit detaillierten Informationen.

Eine Beispielkonfiguration:

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

Code-Beispiele dienen lediglich zu Illustrationszwecken.

Konfigurieren von Microsoft IIS

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

Anonymen Zugriff konfigurieren – IIS 7.5, 8.0 und 8.5

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 7.50, 8.0 und 8.5

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 dann auf „OK“.

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

Konfigurieren des Zugriffs auf den Cache – IIS 7.5, 8.0 und 8.5

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 Stammordner 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 7.5, 8.0 und 8.5

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-Typ: Anwendung/json

Entfernen des ausgeblendeten Segments „bin“ – IIS 7.5, 8.0 und 8.5

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 7.5, 8.0 und 8.5

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
            

    Code-Beispiele dienen lediglich zu Illustrationszwecken.

Nächste Schritte

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

Apache-Webserver

Achtung

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

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.

Achtung

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.

Lesen Sie auch die Sicherheitstipps und Sicherheitsberichte von Apache HTTP Server.

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>-<rel-nr>.so Unix:
die DSO-Datei (Dynamic Link Library) des Dispatchers.
mod_dispatcher.so Unix:
ein Beispiellink.
http.conf.disp<x> Eine Beispielkonfigurationsdatei für den Apache-Server.
dispatcher.any Eine Beispielkonfigurationsdatei für den Dispatcher.
README Datei mit Installationsanweisungen und aktuellen Informationen.
Hinweis: Lesen Sie die Informationen in dieser Datei, bevor Sie mit der Installation beginnen.
CHANGES Datei, in der Probleme aufgeführt sind, die in der aktuellen und in vorherigen Versionen behoben wurden.

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

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

    • Windows: Platzieren Sie disp_apache<x.y>.dll <APACHE_ROOT>/modules.
    • Unix: Suchen Sie je nach Installation entweder nach dem Verzeichnis <APACHE_ROOT>/libexec oder <APACHE_ROOT>/modules.
      Kopieren Sie dispatcher-apache<Optionen>.so in dieses Verzeichnis.
      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 [Pfad zur Datei „dispatcher.so“] durch den Pfad zum Dispatcher-Modul, das Sie auf dem Apache-Webserver installiert haben, und [path to the docroot] durch den Pfad zum Dokumentenstamm (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](/.*)?"
        

Code-Beispiele dienen lediglich zu Illustrationszwecken.

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. Wechseln Sie zum Ordner <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. Der DocumentRoot (<APACHE_ROOT>/htdocs) muss zum folgenden Benutzerdaemon gehö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
...

Hinweis

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:

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 Definiert den zu verwendenden Serverheader:
nicht definiert oder 0 – der HTTP-Serverheader 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 wurden, die 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. 

Informationen zu „about mod_rewrite“ finden Sie in der Apache-Webserver-Dokumentation, beispielsweise Apache 2.2. Bei Verwendung von „mod_rewrite“ empfiehlt sich die Verwendung der Kennzeichnung 'passthrough|PT' (Weiterleiten an den nächsten Handler), um die Rewrite-Engine zum Festlegen des URI-Felds der internen Struktur „request_rec“ auf den Wert des Dateinamenfelds zu zwingen.
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. Wenn der Wert 0 lautet, wird der Keep-Alive-Timeout deaktiviert. Bei Aktivierung des Keep-Alive-Timeouts wird ein Wert von 60 empfohlen. Der Standardwert ist 0.

Hinweis

Pfadeinträge sind relativ zum Stammverzeichnis des Apache-Webservers.

Hinweis

Die Standardeinstellungen für den Serverheader lauten:
    ServerTokens               Full

    DispatcherNoServerHeader   0

Dies zeigt die AEM-Version (zu statistischen Zwecken). Wenn Sie verhindern möchten, dass solche Informationen im Header verfügbar sind, können Sie Folgendes festlegen:
    ServerTokens               Prod

Weitere Informationen finden Sie in der Apache-Dokumentation zur ServerTokens-Anweisung (beispielsweise für Apache 2.2).

SetHandler

Nach diesen Einträgen müssen Sie die Anweisung SetHandler zum Kontext Ihrer Konfiguration hinzufügen (<Directory>, <Location>), damit der Dispatcher die eingehenden Anforderungen 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>
...

Hinweis

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.

Hinweis

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

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
            

    Code-Beispiele dienen lediglich zu Illustrationszwecken.

  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
            

    Code-Beispiele dienen lediglich zu Illustrationszwecken.

Nächste Schritte

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

Sun Java System Web Server/iPlanet

Hinweis

Hier werden Anweisungen für Windows- und Unix-Umgebungen beschrieben.

Gehen Sie bei der Auswahl der auszuführenden Version umsichtig vor.

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.
README Datei mit Installationsanweisungen und aktuellen Informationen.
Hinweis: Lesen Sie die Informationen in dieser Datei, bevor Sie mit der Installation beginnen.
CHANGES Datei, in der Probleme aufgeführt sind, die in der aktuellen und in vorherigen Versionen behoben wurden.

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

  1. Platzieren Sie die Dispatcher-Datei im Verzeichnis plugin des Webservers:
    • Windows:
      Platzieren Sie disp-ns.dll im Verzeichnis <WEBSERVER_ROOT>/plugins.
    • Unix:
      Platzieren Sie dispatcher.so im Verzeichnis <WEBSERVER_ROOT>/plugins.

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. Wechseln Sie zum Ordner <WEBSERVER_ROOT>/config.
  2. Öffnen Sie obj.conf zur Bearbeitung.
  3. Kopieren Sie die Zeile, die folgendermaßen beginnt:
        Service fn="dispService"
    aus dem Abschnitt 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 beiden Zeilen, die folgendermaßen beginnen:
      Init funcs="dispService, dispInit"
     und
      Init fn="dispInit"
    aus obj.conf.disp in den Initialisierungsabschnitt von magnus.conf.
  7. Speichern Sie die Änderungen.

Hinweis

Die folgenden Konfigurationen sollten sich alle in einer Zeile befinden und $(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. Wenn der Wert 0 lautet, wird der Keep-Alive-Timeout deaktiviert. Bei Aktivierung des Keep-Alive-Timeouts wird ein Wert von 60 empfohlen. Der Standardwert ist 0.

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:

​