DocumentatieAEMDispatcher-handleiding

Dispatcher installeren installing-dispatcher

Last update: Wed Feb 28 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Admin

Gebruik de Opmerkingen bij de release Dispatcher om het nieuwste Dispatcher-installatiebestand voor uw besturingssysteem en webserver op te halen. De versienummers van de Dispatcher zijn onafhankelijk van de Adobe Experience Manager-releasenummers en zijn compatibel met de Adobe Experience Manager 6.x-, 5.x- en Adobe CQ 5.x-releases.

NOTE
Voor Adobe Experience Manager 6.5 is Dispatcher versie 4.3.2 of hoger vereist. Dat gezegd hebbende, zijn de versies van de Verzender onafhankelijk van AEM, bijvoorbeeld, is Dispatcher versie 4.3.2 ook compatibel met Adobe Experience Manager 6.4.

De volgende naamgevingsconventie voor bestanden wordt gebruikt:

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

Bijvoorbeeld de dispatcher-apache2.4-linux-x86_64-ssl-4.3.1.tar.gz Het bestand bevat Dispatcher versie 4.3.1 voor een Apache 2.4-webserver die wordt uitgevoerd op Linux i686 en die is verpakt met de teer gebruiken.

De volgende tabel bevat de id van de webserver die wordt gebruikt in bestandsnamen voor elke webserver:

Webserver
Installatiekit
Apache 2.4
verzender-apache 2,4-<other parameters="">
Microsoft Internet Information Server 7.5, 8, 8.5, 10
verzender-iis-<other parameters="">
Sun Java Web Server iPlanet
verzender-ns-<other parameters="">
CAUTION
Installeer de nieuwste versie van Dispatcher die beschikbaar is voor uw platform. Op jaarbasis, zou u uw instantie moeten bevorderen Dispatcher om de recentste versie te gebruiken om uit productverbeteringen voordeel te halen.
NOTE
Klanten die specifiek een upgrade uitvoeren van versie 4.3.3 naar versie 4.3.4, merken op dat het in cache plaatsen van koppen anders werkt dan bij niet-cachebare inhoud. Voor meer informatie over deze wijziging raadpleegt u de Opmerkingen bij de release pagina.

Elk archief bevat de volgende bestanden:

  • de Dispatcher-modules
  • een voorbeeldconfiguratiebestand
  • het README-bestand met installatie-instructies en informatie van het laatste moment
  • het dossier van WIJZIGINGEN dat van kwesties een lijst maakt die in huidige en vroegere versies worden opgelost
NOTE
Controleer het README-bestand op eventuele laatste wijzigingen/platformspecifieke opmerkingen voordat u de installatie start.

Microsoft Internet Information Server microsoft-internet-information-server

Zie de volgende bronnen voor informatie over het installeren van deze webserver:

Vereiste IIS-componenten required-iis-components

IIS versies 8.5 en 10 vereisen dat de volgende componenten IIS worden geïnstalleerd:

  • ISAPI-extensies

Ook, moet u de rol van de Server van het Web (IIS) toevoegen. Gebruik Serverbeheer om de rol en componenten toe te voegen.

Microsoft IIS - De Dispatcher-module installeren microsoft-iis-installing-the-dispatcher-module

Het vereiste archief voor Microsoft Internet Information System is:

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

Het ZIP-bestand bevat de volgende bestanden:

Bestand
Beschrijving
disp_iis.dll
Het bibliotheekbestand voor dynamische koppelingen voor Dispatcher.
disp_iis.ini
Het dossier van de configuratie voor IIS. Dit voorbeeld kan met uw vereisten worden bijgewerkt. Opmerking: Het ini-bestand moet dezelfde naam-hoofdmap hebben als de dll.
dispatcher.any
Een voorbeeldconfiguratiebestand voor de Dispatcher.
author_dispatcher.any
Een voorbeeldconfiguratiebestand voor Dispatcher dat werkt met de auteurinstantie.
README
Leesmij-bestand met installatie-instructies en informatie van het laatste moment. Opmerking: Controleer dit bestand voordat u de installatie start.
WIJZIGINGEN
Wijzigt het bestand met de problemen die zijn opgelost in de huidige en eerdere versies.

Gebruik de volgende procedure om de Dispatcher-bestanden naar de juiste locatie te kopiëren.

  1. Windows Verkenner gebruiken om de <IIS_INSTALLDIR>/Scripts map, bijvoorbeeld C:\inetpub\Scripts.

  2. Pak de volgende bestanden uit het pakket Dispatcher uit in deze map Scripts:

    • disp_iis.dll

    • disp_iis.ini

    • Een van de volgende bestanden is afhankelijk van het feit of Dispatcher werkt met een AEM instantie van de auteur of een publicatie-instantie:

      • Instantie van auteur: author_dispatcher.any
      • Instantie publiceren: dispatcher.any

Microsoft IIS - Het INI-bestand Dispatcher configureren microsoft-iis-configure-the-dispatcher-ini-file

Bewerk de disp_iis.ini bestand om de installatie van Dispatcher te configureren. Het basisformaat van de .ini bestand is als volgt:

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

In de volgende tabel wordt elke eigenschap beschreven.

Parameter
Beschrijving
configpath
De locatie van dispatcher.any in het lokale bestandssysteem (absoluut pad).
logbestand
De locatie van de dispatcher.log bestand. Als dit niet wordt geplaatst dan gaan de logboekberichten naar het logboek van de venstersgebeurtenis.
logniveau
Definieert het logniveau dat wordt gebruikt voor het uitvoeren van berichten naar het gebeurtenislogboek. De volgende waarden kunnen worden opgegeven:Logniveau voor het logbestand:
0 - alleen foutberichten.
1 - fouten en waarschuwingen.
2 - fouten, waarschuwingen en informatieve berichten
3 - fouten, waarschuwingen, informatie en foutopsporingsberichten.
Opmerking: Het wordt aanbevolen het logniveau tijdens de installatie en het testen in te stellen op 3 en vervolgens op 0 wanneer de gebruiker in een productieomgeving wordt uitgevoerd.
vervangvergunning
Geeft aan hoe machtigingsheaders in de HTTP-aanvraag worden verwerkt. De volgende waarden zijn geldig:
0 - De machtigingsheaders worden niet gewijzigd.
1 - Vervangt elke koptekst met de naam "Autorisatie", behalve "Standaard", door de bijbehorende Basic <IIS:LOGON\_USER> equivalent.
servervariabelen
Definieert hoe servervariabelen worden verwerkt.
0 - IIS de servervariabelen worden verzonden naar noch de Dispatcher noch AEM.
1 - alle IIS-servervariabelen (zoals LOGON\_USER, QUERY\_STRING, ...) worden samen met de aanvraagheaders naar de Dispatcher verzonden (en ook naar de AEM instantie als deze niet in cache is geplaatst).
Servervariabelen omvatten AUTH\_USER, LOGON\_USER, HTTPS\_KEYSIZE en vele anderen. Zie de documentatie IIS voor de volledige lijst van variabelen, met details.
enable_chunked_transfer
Bepaalt of om (1) of onbruikbaar te maken (0) geknotte overdracht voor de cliëntreactie. De standaardwaarde is 0.

Een voorbeeldconfiguratie:

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

Microsoft IIS configureren configuring-microsoft-iis

Vorm IIS om de Dispatcher ISAPI module te integreren. In IIS gebruikt u toewijzing van jokertekens voor toepassingen.

Het vormen Anonieme Toegang - IIS 8.5 en 10 configuring-anonymous-access-iis-and

De standaard Flush replicatieagent op de instantie van de Auteur wordt gevormd zodat het geen veiligheidsgeloofsbrieven met flush verzoeken verzendt. Daarom moet de website die u een Dispatcher geheime voorgeheugen gebruikt anonieme toegang toestaan.

Als uw website een authentificatiemethode gebruikt, moet de Flush replicatieagent dienovereenkomstig worden gevormd.

  1. Open IIS Manager en selecteer de website die u als Dispatcher geheim voorgeheugen gebruikt.
  2. Gebruikend de wijze van de Mening van Eigenschappen, in de sectie IIS dubbelklikt Authentificatie.
  3. Als Anonieme verificatie niet is ingeschakeld, selecteert u Anonieme verificatie en klikt u in het gedeelte Handelingen op Inschakelen.

Integratie van de Dispatcher ISAPI Module - IIS 8.5 en 10 integrating-the-dispatcher-isapi-module-iis-and

Gebruik de volgende procedure om de Dispatcher ISAPI Module aan IIS toe te voegen.

  1. Open IIS Manager.

  2. Selecteer de website die u als Dispatcher Cache gebruikt.

  3. Gebruikend de wijze van de Mening van Eigenschappen, in de sectie IIS dubbelklikt Handler Mappings.

  4. Klik in het deelvenster Handelingen van de pagina Handler Mappings op Toevoegen van Jokerscript, voeg de volgende eigenschapswaarden toe en klik op OK:

    • Pad aanvragen: *
    • Uitvoerbaar: het absolute pad van het bestand disp_is.dll, bijvoorbeeld C:\inetpub\Scripts\disp_iis.dll.
    • Naam: een beschrijvende naam voor de handlertoewijzing, bijvoorbeeld Dispatcher.

  5. Klik op Ja in het dialoogvenster dat wordt weergegeven om de bibliotheek disp_is.dll toe te voegen aan de lijst ISAPI- en CGI-beperkingen.

    Voor IIS 7.0 en 7.5 is de configuratie volledig. Ga met de resterende stappen verder als u IIS 8.0 vormt.

  6. (IIS 8.0) Selecteer in de lijst met handlertoewijzingen de afbeelding die u zojuist hebt gemaakt en klik in het gedeelte Handelingen op Bewerken.

  7. (IIS 8.0) Klik in het dialoogvenster Scriptkaart bewerken op de knop Beperkingen aanvragen.

  8. (IIS 8.0) Om ervoor te zorgen dat de manager voor dossiers en omslagen wordt gebruikt die nog niet in het voorgeheugen ondergebracht zijn, schrap de Beheerde slechts als Verzoek aan wordt toegewezen, en klik dan O.K.

  9. (IIS 8.0) Klik in het dialoogvenster Scripttoewijzing bewerken op OK.

Het vormen Toegang tot het geheime voorgeheugen - IIS 8.5 en 10 configuring-access-to-the-cache-iis-and

Geef de standaardgebruiker van de App Pool schrijftoegang tot de map die wordt gebruikt als Dispatcher-cache.

  1. Klik met de rechtermuisknop op de hoofdmap van de website die u gebruikt als de Dispatcher-cache en klik op Eigenschappen, zoals C:\inetpub\wwwroot.

  2. Klik op het tabblad Beveiliging op Bewerken en klik vervolgens in het dialoogvenster Machtigingen op Toevoegen. Er wordt een dialoogvenster geopend waarin u gebruikersaccounts kunt selecteren. Klik op de knop Locaties, selecteer de naam van de computer en klik op OK.

    Zorg dat dit dialoogvenster geopend blijft terwijl u de volgende stap uitvoert.

  3. in Manager IIS, selecteer de plaats IIS die u voor het geheime voorgeheugen van de Verzender gebruikt, en op de rechterkant van het venster klik Geavanceerde Montages.

  4. Selecteer de waarde van het bezit van de Pool van de Toepassing en kopieer het aan het klembord.

  5. Ga terug naar het geopende dialoogvenster. Typ in het vak Geef de objectnamen op die u wilt selecteren IIS AppPool\ en plakt u vervolgens de inhoud van het klembord. De waarde moet er als volgt uitzien:

    IIS AppPool\DefaultAppPool

  6. Klik op de knop Namen controleren. Klik op OK als Windows het gebruikersaccount oplost.

  7. Selecteer in het dialoogvenster Machtigingen voor de verzendermap de account die u zojuist hebt toegevoegd, alle machtigingen voor de account inschakelen behalve Volledige controle en klik op OK. Klik op OK om het dialoogvenster Eigenschappen van map te sluiten.

Registreren van het JSON Mime-type - IIS 8.5 en 10 registering-the-json-mime-type-iis-and

Gebruik de volgende procedure om het JSON MIME-type te registreren, wanneer u Dispatcher JSON-aanroepen wilt toestaan.

  1. In Manager IIS, selecteer uw website en gebruikend de Mening van Eigenschappen, klik types Mime. tweemaal.

  2. Als de JSON-extensie niet in de lijst voorkomt, klikt u in het deelvenster Handelingen op Toevoegen, voert u de volgende eigenschapswaarden in en klikt u op OK:

    • Bestandsnaamextensie: .json
    • MIME-type: application/json

Het verborgen segment van de bin verwijderen - IIS 8.5 en 10 removing-the-bin-hidden-segment-iis-and

Gebruik de volgende procedure om de bin verborgen segment. Websites die niet nieuw zijn, kunnen dit verborgen segment bevatten.

  1. In Manager IIS, selecteer uw website en gebruikend de Mening van Eigenschappen, klik het Filtreren van het Verzoek tweemaal.
  2. Selecteer de bin klikt u op Verwijderen en klikt u in het bevestigingsdialoogvenster op Ja.

Het registreren IIS Berichten aan een Dossier - IIS 8.5 en 10 logging-iis-messages-to-a-file-iis-and

Gebruik de volgende procedure om het logboekberichten van de Ontvanger aan een logboekdossier in plaats van aan het logboek van de Gebeurtenis van Vensters te schrijven. U moet Dispatcher vormen om het logboekdossier te gebruiken, en IIS van schrijven-toegang tot het dossier te voorzien.

  1. Windows Verkenner gebruiken om een map te maken met de naam dispatcher onder de logbestanden van de IIS-installatie. Het pad van deze map voor een standaardinstallatie is C:\inetpub\logs\dispatcher.

  2. Klik met de rechtermuisknop op de map dispatcher en klik op Eigenschappen.

  3. Klik op het tabblad Beveiliging op Bewerken en klik vervolgens in het dialoogvenster Machtigingen op Toevoegen. Er wordt een dialoogvenster geopend waarin u gebruikersaccounts kunt selecteren. Klik op de knop Locaties, selecteer de naam van de computer en klik op OK.

    Zorg dat dit dialoogvenster geopend blijft terwijl u de volgende stap uitvoert.

  4. in Manager IIS, selecteer de plaats IIS die u voor het geheime voorgeheugen van de Verzender gebruikt, en op de rechterkant van het venster klik Geavanceerde Montages.

  5. Selecteer de waarde van het bezit van de Pool van de Toepassing en kopieer het aan het klembord.

  6. Ga terug naar het geopende dialoogvenster. Typ in het vak Geef de objectnamen op die u wilt selecteren IIS AppPool\ en plakt u vervolgens de inhoud van het klembord. De waarde moet er als volgt uitzien:

    IIS AppPool\DefaultAppPool

  7. Klik op de knop Namen controleren. Klik op OK als Windows het gebruikersaccount oplost.

  8. Selecteer in het dialoogvenster Machtigingen voor de verzendermap de account die u zojuist hebt toegevoegd, alle machtigingen voor de account inschakelen behalve voor volledige controle, en klik op OK. Klik op OK om het dialoogvenster Eigenschappen van map te sluiten.

  9. Een teksteditor gebruiken om het dialoogvenster disp_iis.ini bestand.

  10. Voeg een tekstregel toe die lijkt op het volgende voorbeeld om de locatie van het logbestand te configureren en sla het bestand vervolgens op:

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

Volgende stappen next-steps

Voordat u de Dispatcher kunt gaan gebruiken, moet u weten:

Apache Web Server apache-web-server

CAUTION
Instructies voor installatie onder beide Windows en Unix zijn hier behandeld. Wees voorzichtig wanneer u de stappen uitvoert.

Apache Web Server installeren installing-apache-web-server

Lees de installatiehandleiding voor informatie over het installeren van een Apache Web Server - ofwel online of in de distributie.

CAUTION
Als u een binair Apache-bestand maakt door de bronbestanden te compileren, moet u ervoor zorgen dat ondersteuning voor dynamische modules. Dit kan worden gedaan door om het even welk van —enable-shared opties. Neem minimaal de mod_so -module.
Meer informatie vindt u in de installatiehandleiding van Apache Web Server.

Zie ook de Apache HTTP Server Beveiligingstips en Beveiligingsrapporten.

Apache Web Server - Add the Dispatcher Module apache-web-server-add-the-dispatcher-module

De Dispatcher wordt geleverd als:

  • Windows: een Dynamic Link Library (DLL)
  • Unix: een dynamisch gezamenlijk object (DSO)

De archiefbestanden voor de installatie bevatten de volgende bestanden, afhankelijk van of u Windows of Unix hebt geselecteerd:

Bestand
Beschrijving
disp_apache<x.y>.dll
Windows: Het bibliotheekbestand voor de dynamische koppeling van Dispatcher.
verzender-apache<x.y>-<rel-nr>.so
Unix: Het bibliotheekbestand van het gezamenlijke object Dispatcher.
mod_dispatcher.so
Unix: Een voorbeeldkoppeling.
http.conf.disp<x>
Een voorbeeldconfiguratiebestand voor de Apache-server.
dispatcher.any
Een voorbeeldconfiguratiebestand voor de Dispatcher.
README
Leesmij-bestand met installatie-instructies en informatie van het laatste moment. Opmerking: Controleer dit bestand voordat u de installatie start.
WIJZIGINGEN
Wijzigt het bestand met de problemen die zijn opgelost in de huidige en eerdere versies.

Ga als volgt te werk om Dispatcher toe te voegen aan uw Apache Web Server:

  1. Plaats het Dispatcher-bestand in de juiste Apache-modulemap:

    • Windows: Place disp_apache<x.y>.dll <APACHE_ROOT>/modules
    • Unix: Zoek een van de <APACHE_ROOT>/libexec of <APACHE_ROOT>/modulesvolgens uw installatie.
      Kopiëren dispatcher-apache<options>.so in deze map.
      U kunt ook een symbolische koppeling maken met de naam mod_dispatcher.so aan de verzender:
      ln -s dispatcher-apache<x>-<os>-<rel-nr>.so mod_dispatcher.so

  2. Kopieer het bestand dispatcher.any naar de <APACHE_ROOT>/conf directory.

    Opmerking: U kunt dit dossier in een verschillende plaats plaatsen, zolang het bezit DispatcherLog van de module van de Verzender dienovereenkomstig wordt gevormd. (Zie Verzendspecifieke configuratiegegevens verderop.)

Apache Web Server - SELinux-eigenschappen configureren apache-web-server-configure-selinux-properties

Als u Dispatcher uitvoert op RedHat Linux Kernel 2.6 terwijl SELinux ingeschakeld is, worden mogelijk foutberichten als deze weergegeven in het logbestand van de verzender.

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

Dit is waarschijnlijk het gevolg van een ingeschakelde SELinux-beveiliging. Vervolgens moet u de volgende taken uitvoeren:

  • Vorm de context SELinux van het de moduledossier van de verzender.
  • Schakel HTTP-scripts en -modules in om netwerkverbindingen te maken.
  • Vorm de context SELinux van de docroot, waar de caching dossiers worden opgeslagen.

Voer de volgende opdrachten in een terminalvenster in en vervang deze [path to the dispatcher.so file] met het pad naar de module Dispatcher die u op Apache Web Server hebt geïnstalleerd, en path to the docroot met het pad waar de hoofdmap zich bevindt (bijvoorbeeld /opt/cq/cache):

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

Apache Web Server - Apache Web Server voor Dispatcher configureren apache-web-server-configure-apache-web-server-for-dispatcher

De Apache Web Server moet worden geconfigureerd, met httpd.conf. In de installatiekit Dispatcher vindt u een voorbeeld-configuratiebestand met de naam httpd.conf.disp<x>.

Deze stappen zijn verplicht:

  1. Navigeren naar <APACHE_ROOT>/conf.

  2. Openen httpd.confvoor bewerken.

  3. De volgende configuratieingangen moeten, in de vermelde orde worden toegevoegd:

    • LoadModule om de module bij opstarten te laden.
    • Dispatcher-specifieke configuratieingangen, inclusief DispatcherConfig, DispatcherLog en DispatcherLogLevel.
    • SetHandler om de Dispatcher te activeren. LoadModule.
    • ModMimeUsePathInfo om gedrag van te vormen mod_mime.

  4. (Optioneel) U wordt aangeraden de eigenaar van de map htdocs te wijzigen:

    • De apache-server begint als root, hoewel de onderliggende processen beginnen als daemon (voor beveiligingsdoeleinden). De DocumentRoot (<APACHE_ROOT>/htdocs) moet bij de gebruikersdaemon horen:

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

LoadModule

De volgende lijst maakt een lijst van voorbeelden die kunnen worden gebruikt; de nauwkeurige ingangen zijn volgens uw specifieke Server van het Web Apache:

Windows
... LoadModule dispatcher_module modules\disp_apache.dll ...
Unix (symbolische koppeling wordt gebruikt)
... LoadModule dispatcher_module libexec/mod_dispatcher.so ...
NOTE
De eerste parameter van elke instructie moet precies zo worden geschreven als in de bovenstaande voorbeelden.
Zie de dossiers van de voorbeeldconfiguratie en de documentatie van de Server van het Web Apache voor volledige details over dit bevel worden verstrekt die.

Specifieke configuratiegegevens van Dispatcher

De Dispatcher-specifieke configuratieingangen worden geplaatst na de ingang LoadModule. De volgende lijst maakt een lijst van een voorbeeldconfiguratie die voor zowel Unix als Vensters van toepassing is:

Windows en Unix

...
<IfModule disp_apache2.c>
DispatcherConfig conf/dispatcher.any
DispatcherLog logs/dispatcher.log DispatcherLogLevel 3
DispatcherNoServerHeader 0 DispatcherDeclineRoot 0
DispatcherUseProcessedURL 0
DispatcherPassError 0
DispatcherKeepAliveTimeout 60
</IfModule>
...
NOTE
Klanten die specifiek een upgrade uitvoeren van versie 4.3.3 naar versie 4.3.4, merken op dat het in cache plaatsen van koppen anders werkt dan bij niet-cachebare inhoud. Voor meer informatie over deze wijziging raadpleegt u de Opmerkingen bij de release pagina.

De individuele configuratieparameters:

Parameter
Beschrijving
DispatcherConfig
Locatie en naam van het Dispatcher-configuratiebestand.
Wanneer dit bezit in de belangrijkste serverconfiguratie wordt gevestigd, erven alle virtuele gastheren de bezitswaarde. Virtuele hosts kunnen echter een eigenschap DispatcherConfig opnemen om de hoofdserverconfiguratie te overschrijven.
DispatcherLog
Locatie en naam van het logbestand.
DispatcherLogLevel
Logniveau voor het logbestand:
0 - Fouten
1 - Waarschuwingen
2 - Infos
3 - Foutopsporing
Opmerking: Het wordt aanbevolen het logniveau tijdens de installatie en het testen in te stellen op 3 en vervolgens op 0 wanneer de gebruiker in een productieomgeving wordt uitgevoerd.
DispatcherNoServerHeader

Deze parameter is vervangen en heeft geen effect meer.

Hiermee definieert u de serverkoptekst die moet worden gebruikt:

  • undefined of 0 - de de serverkopbal van HTTP bevat de AEM versie.
  • 1 - de header van de Apache-server wordt gebruikt.
DispatcherDeclineRoot
Bepaalt of verzoeken aan de wortel "/" te weigeren:
0 - aanvragen accepteren voor /
1 - aanvragen aan / worden niet afgehandeld door de verzender; gebruik mod_alias voor de juiste toewijzing.
DispatcherUseProcessURL
Hiermee wordt gedefinieerd of vooraf verwerkte URL's moeten worden gebruikt voor alle verdere verwerking door Dispatcher:
0 - gebruik de oorspronkelijke URL die aan de webserver is doorgegeven.
1 - de verzender de URL gebruikt die al is verwerkt door de handlers die aan de verzender voorafgaan (d.w.z. mod_rewrite) in plaats van de oorspronkelijke URL die aan de webserver is doorgegeven. Het origineel of de verwerkte URL wordt bijvoorbeeld gekoppeld aan de Dispatcher-filters. De URL wordt ook gebruikt als basis voor de structuur van het cachebestand. Raadpleeg de documentatie bij de Apache-website voor informatie over mod_rewrite, bijvoorbeeld Apache 2.4. Als mod_rewrite wordt gebruikt, is het raadzaam de markering 'passthrough' te gebruiken
DispatcherPassError
Definieert hoe foutcodes voor ErrorDocument-afhandeling worden ondersteund:
0 - Dispatcher spoolt alle foutreacties naar de client.
1 - Dispatcher genereert geen foutreactie op de client (waar de statuscode groter of gelijk is aan 400), maar geeft de statuscode door aan Apache, die bijvoorbeeld een ErrorDocument-instructie toestaat om een dergelijke statuscode te verwerken.
Codebereik - Geef een bereik foutcodes op waarvoor het antwoord wordt doorgegeven aan Apache. Andere foutcodes worden doorgegeven aan de client. De volgende configuratie geeft bijvoorbeeld reacties voor fout 412 door aan de client en alle andere fouten worden doorgegeven aan Apache: DispatcherPassError 400-411,413-417
DispatcherKeepAliveTimeout
Geeft de time-out bij 'houden in leven' in seconden aan. Vanaf Dispatcher versie 4.2.0 is de standaardwaarde voor het in leven houden 60. Met de waarde 0 wordt het in leven houden uitgeschakeld.
DispatcherNoCanonURL
Als u deze parameter instelt op Aan, wordt de onbewerkte URL doorgegeven aan de achterkant in plaats van de gecanonicaliseerde URL en worden de instellingen van DispatcherUseProcessURL genegeerd. De standaardwaarde is Uit.
Opmerking: De filterregels in de configuratie Dispatcher worden altijd geëvalueerd op basis van de ontsmette URL en niet op basis van de onbewerkte URL.
NOTE
Paditems zijn relatief ten opzichte van de hoofdmap van de Apache Web Server.
NOTE
De standaardinstellingen voor de serverkoptekst zijn:
ServerTokens Full
DispatcherNoServerHeader 0
De AEM versie (voor statistische doeleinden). Als u het beschikbaar zijn van dergelijke informatie in de kopbal wilt onbruikbaar maken kunt u plaatsen:
ServerTokens Prod
Zie de Apache-documentatie over ServerTokens-richtlijn (bijvoorbeeld voor Apache 2.4) voor meer informatie .

SetHandler

Na deze vermeldingen moet u een SetHandler verklaring aan de context van uw configuratie ( <Directory>, <Location>) voor de Dispatcher om de binnenkomende aanvragen af te handelen. In het volgende voorbeeld wordt de Dispatcher geconfigureerd voor het afhandelen van aanvragen voor de volledige website:

Windows en Unix

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

Options FollowSymLinks
AllowOverride None
</Directory>
...

In het volgende voorbeeld wordt de Dispatcher geconfigureerd om aanvragen voor een virtueel domein af te handelen:

Windows

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

Unix

...
<VirtualHost 123.45.67.89>
ServerName www.mycompany.com
DocumentRoot /usr/apachecache/docs
<Directory /usr/apachecache/docs>
<IfModule disp_apache2.c>
SetHandler dispatcher-handler
</IfModule>
AllowOverride None
</Directory>
</VirtualHost>
...
NOTE
De parameter van SetHandler instructie moet worden geschreven exact zoals in de bovenstaande voorbeelden, aangezien dit de naam van de manager is die in de module wordt bepaald.
Zie de dossiers van de voorbeeldconfiguratie en de documentatie van de Server van het Web Apache voor volledige details over dit bevel worden verstrekt die.

ModMimeUsePathInfo

Na de SetHandler moet u ook de instructie ModMimeUsePathInfo definitie.

NOTE
De ModMimeUsePathInfo Deze parameter moet alleen worden gebruikt en geconfigureerd als u Dispatcher versie 4.0.9 of hoger gebruikt.
(Let op: Dispatcher versie 4.0.9 is uitgebracht in 2011. Als u een oudere versie gebruikt, kunt u een upgrade uitvoeren naar een recente versie van Dispatcher.)

De ModMimeUsePathInfo parameter moet worden ingesteld On voor alle Apache-configuraties:

ModMimeUsePathInfo On

De module mod_mime (zie bijvoorbeeld Mod_mime voor Apache-module) wordt gebruikt om metagegevens van de inhoud toe te wijzen aan de inhoud die is geselecteerd voor een HTTP-reactie. De standaardopstelling betekent dat wanneer mod_mime het inhoudstype bepaalt, slechts het deel van URL dat aan een dossier of een folder in kaart brengt zal worden overwogen.

Wanneer Onde ModMimeUsePathInfo parameter specificeert dat mod_mime bepaalt het inhoudstype op basis van de complete URL; dit betekent dat voor virtuele bronnen metagegevens worden toegepast op basis van hun extensie.

In het volgende voorbeeld wordt geactiveerd: ModMimeUsePathInfo:

Windows en Unix

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

Options FollowSymLinks
AllowOverride None
</Directory>
...

Ondersteuning inschakelen voor HTTPS (Unix en Linux) enable-support-for-https-unix-and-linux

Dispatcher gebruikt OpenSSL om veilige communicatie via HTTP te implementeren. Vanaf de Dispatcher-versie 4.2.0., OpenSSL 1.0.0 en OpenSSL 1.0.1 worden ondersteund. Dispatcher gebruikt standaard OpenSSL 1.0.0. Als u OpenSSL 1.0.1 wilt gebruiken, gebruikt u de volgende procedure om symbolische koppelingen te maken, zodat Dispatcher de geïnstalleerde OpenSSL-bibliotheken gebruikt.

  1. Open een terminal en wijzig de huidige map in de map waarin de OpenSSL-bibliotheken zijn geïnstalleerd, bijvoorbeeld:

    code language-shell 
    cd /usr/lib64

  2. Voer de volgende opdrachten in om de symbolische koppelingen te maken:

    code language-shell 
    ln -s libssl.so libssl.so.1.0.1
ln -s libcrypto.so libcrypto.so.1.0.1
NOTE
Als u een aangepaste versie van Apache gebruikt, moet u ervoor zorgen dat Apache en Dispatcher zijn gecompileerd met dezelfde versie van OpenSSL.

Volgende stappen next-steps-1

Voordat u de Dispatcher kunt gaan gebruiken, moet u nu:

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

NOTE
Hier worden instructies voor zowel Windows- als Unix-omgevingen besproken.
Wees voorzichtig wanneer u selecteert welke u wilt uitvoeren.

Sun Java System Web Server / iPlanet - Uw webserver installeren sun-java-system-web-server-iplanet-installing-your-web-server

Raadpleeg de documentatie bij de betreffende webservers voor volledige informatie over het installeren van deze webservers:

  • Sun Java System Web Server
  • iPlanet-webserver

Sun Java System Web Server / iPlanet - Voeg de Dispatcher Module toe sun-java-system-web-server-iplanet-add-the-dispatcher-module

De Dispatcher wordt geleverd als:

  • Windows: een Dynamic Link Library (DLL)
  • Unix: een dynamisch gezamenlijk object (DSO)

De archiefbestanden voor de installatie bevatten de volgende bestanden, afhankelijk van of u Windows of Unix hebt geselecteerd:

Bestand
Beschrijving
disp_ns.dll
Windows: Het bibliotheekbestand voor de dynamische koppeling van Dispatcher.
dispatcher.so
Unix: Het bibliotheekbestand van het gezamenlijke object Dispatcher.
dispatcher.so
Unix: Een voorbeeldkoppeling.
obj.conf.disp
Een voorbeeldconfiguratiebestand voor de iPlanet/Sun Java System-webserver.
dispatcher.any
Een voorbeeldconfiguratiebestand voor de Dispatcher.
README
Leesmij-bestand met installatie-instructies en informatie van het laatste moment. Opmerking: controleer dit bestand voordat u de installatie start.
WIJZIGINGEN
Wijzigt het bestand met de problemen die zijn opgelost in de huidige en eerdere versies.

Ga als volgt te werk om de Dispatcher aan uw webserver toe te voegen:

  1. Plaats het Dispatcher-bestand in de plugin map:

Sun Java System Web Server / iPlanet - Configureren voor Dispatcher sun-java-system-web-server-iplanet-configure-for-the-dispatcher

De webserver moet worden geconfigureerd met obj.conf. In de installatiekit Dispatcher vindt u een voorbeeld-configuratiebestand met de naam obj.conf.disp.

  1. Navigeren naar <WEBSERVER_ROOT>/config.

  2. Openen obj.confvoor bewerken.

  3. Kopieer de regel die begint:
    Service fn="dispService"
    van obj.conf.disp naar de initialisatiesectie van obj.conf.

  4. Sla de wijzigingen op.

  5. Openen magnus.conf voor bewerken.

  6. Kopieer de twee regels die beginnen:
    Init funcs="dispService, dispInit"
    en
    Init fn="dispInit"
    van obj.conf.disp naar de initialisatiesectie van magnus.conf.

  7. Sla de wijzigingen op.

NOTE
De volgende configuraties moeten allemaal op één regel staan en $(SERVER_ROOT) en $(PRODUCT_SUBDIR) moeten worden vervangen door de respectieve waarden.

Init

De volgende tabel bevat voorbeelden die kunnen worden gebruikt. De exacte vermeldingen zijn gebaseerd op uw specifieke webserver:

Windows en 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"
...

waarbij:

Parameter
Beschrijving
config
Locatie en naam van het configuratiebestand dispatcher.any.
logbestand
Locatie en naam van het logbestand.
logniveau
Logniveau voor het schrijven van berichten naar het logbestand:
0 Fouten
1 Waarschuwingen
2 Infos
3 Foutopsporing
Opmerking: Het wordt aanbevolen het logniveau tijdens de installatie en het testen in te stellen op 3 en op 0 bij het uitvoeren in een productieomgeving.
keepalivetimeout
Geeft de time-out bij 'houden in leven' in seconden aan. Vanaf Dispatcher versie 4.2.0 is de standaardwaarde voor het in leven houden 60. Met de waarde 0 wordt het in leven houden uitgeschakeld.

Afhankelijk van uw vereisten kunt u de Dispatcher definiëren als service voor uw objecten. Als u de Dispatcher voor uw gehele website wilt configureren, wijzigt u het standaardobject:

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="\*/\*"
...

Volgende stappen next-steps-2

Voordat u de Dispatcher kunt gaan gebruiken, moet u nu:

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