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.

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:

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

Microsoft Internet Information Server

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

• Microsoft eigen documentatie op de Internet Information Server
• "De officiële Microsoft IIS-site"

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:

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.

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:

• Configureren Dispatcher
• AEM om met Dispatcher te werken.

Apache Web Server

Apache Web Server installeren

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

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:

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:

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:

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

ModMimeUsePathInfo

Na de SetHandler moet u ook de instructie ModMimeUsePathInfo definitie.

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
   

Volgende stappen

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

• Configureren Dispatcher
• AEM om met Dispatcher te werken.

Sun Java System Web Server / iPlanet

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:

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.

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:

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:

• Configureren Dispatcher
• AEM om met Dispatcher te werken.

Bronnen voor Business.Adobe.com

Ecommerce Integrations Automated Onboarding Cms Cloud Personalized Experiences Customer Communications Asset Collections