Dispatcher installeren

Gebruik de Opmerkingen bij de release Dispatcher om het meest recente Dispatcher-installatiebestand voor uw besturingssysteem en webserver te verkrijgen. 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.

OPMERKING

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>

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 verzender-iis-<other parameters="">
Sun Java Web Server iPlanet verzender-ns-<other parameters="">
LET OP

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.

OPMERKING

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
OPMERKING

Controleer het README-bestand op eventuele laatste wijzigingen/platformspecifieke opmerkingen voordat u de installatie start.

Microsoft Internet Information Server

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

Vereiste IIS-componenten

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

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

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 op 0 wanneer u in een productieomgeving werkt.
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

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

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 Disptcher-cache 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

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) In het Edit de dialoogvakje van de Kaart van het Manuscript, klik de knoop van de Beperkingen van het Verzoek.

  8. (IIS 8.0) Om ervoor te zorgen dat de manager voor dossiers en omslagen wordt gebruikt die nog niet in het voorgeheugen onder worden gebracht, schrap de Beheerde slechts aanhalen als het 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

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

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 de Types van 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

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

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:

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

Volgende stappen

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

Apache Web Server

LET OP

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

Apache Web Server installeren

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

LET OP

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

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 dynamische koppelingen voor 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 voorbeeld van een configuratiebestand 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: Plaatsen 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

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_content_t [path to the docroot]
semanage fcontext -a -t httpd_sys_content_t "[path to the docroot](/.*)?"

Apache Web Server - Apache Web Server voor Dispatcher configureren

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. Ga 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, met inbegrip van 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:

      cd <APACHE_ROOT>
      chown -R daemon:daemon htdocs
      

LoadModule

De volgende tabel bevat voorbeelden die kunnen worden gebruikt. de exacte gegevens zijn in overeenstemming met uw specifieke Apache Web Server:

Windows ... LoadModule dispatcher_module modules\disp_apache.dll ...
Unix (symbolische koppeling wordt gebruikt) ... LoadModule dispatcher_module libexec/mod_dispatcher.so ...
OPMERKING

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

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 op 0 wanneer u in een productieomgeving werkt.
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 - verzoeken aan / worden niet door de verzender afgehandeld; gebruik mod_alias voor de correcte afbeelding.
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.
OPMERKING

Paditems zijn relatief ten opzichte van de hoofdmap van de Apache Web Server.

OPMERKING

De standaardinstellingen voor de serverkoptekst zijn:

ServerTokens Full

DispatcherNoServerHeader 0

Dit is 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>
...
OPMERKING

De parameter van de 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.

OPMERKING

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 zullen 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)

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:

    cd /usr/lib64
    
  2. Voer de volgende opdrachten in om symbolische koppelingen te maken:

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

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

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

Sun Java System Web Server / iPlanet

OPMERKING

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

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

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 dynamische koppelingen voor 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

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

  1. Ga 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"
    and
    Init fn="dispInit"
    van obj.conf.disp naar de initialisatiesectie van magnus.conf.

  7. Sla de wijzigingen op.

OPMERKING

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

Init

De volgende tabel bevat voorbeelden die kunnen worden gebruikt. de exacte gegevens zijn volgens 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

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

Op deze pagina