Vanliga frågor och svar om AEM Dispatcher

Introduktion

Vad är Dispatcher?

Dispatcher är ett Adobe Experience Manager verktyg för cachelagring och/eller belastningsutjämning som gör att du kan skapa en snabb och dynamisk webbmiljö. För cachelagring fungerar Dispatcher som en del av en HTTP-server, till exempel Apache. Syftet är att lagra (eller"cachelagra") så mycket av det statiska webbplatsinnehållet som möjligt och att så sällan som möjligt få åtkomst till webbplatsens layoutmotor. I en lastbalanserande roll distribuerar Dispatcher användarförfrågningar (inläsning) över olika AEM instanser (återgivningar).

För cachelagring använder modulen Dispatcher webbserverns förmåga att hantera statiskt innehåll. Dispatcher placerar de cachelagrade dokumenten i dokumentroten på webbservern.

Hur utför Dispatcher cachelagring?

Dispatcher använder webbserverns förmåga att hantera statiskt innehåll. Dispatcher lagrar cachelagrade dokument i webbserverns dokumentrot. Dispatcher har två primära metoder för att uppdatera cacheinnehållet när ändringar görs på webbplatsen.

Vilka är fördelarna med lastbalansering?

Belastningsutjämning distribuerar användarförfrågningar (inläsning) över flera AEM instanser. I följande lista beskrivs fördelarna med belastningsutjämning:

Installera och konfigurera

Var hämtar jag Dispatcher-modulen från?

Du kan hämta den senaste Dispatcher-modulen från Dispatcher Release Notes sida.

Hur installerar jag modulen Dispatcher?

Se Installerar Dispatcher page

Hur konfigurerar jag modulen Dispatcher?

Se Konfigurera Dispatcher sida.

Hur konfigurerar jag Dispatcher för författarinstansen?

Se Använda Dispatcher med en författarinstans för de detaljerade stegen.

Hur konfigurerar jag Dispatcher med flera domäner?

Du kan konfigurera CQ Dispatcher med flera domäner, förutsatt att domänerna uppfyller följande villkor:

Läs Använda Dispatcher med flera domäner för mer information.

Hur konfigurerar jag Dispatcher så att alla begäranden från en användare dirigeras till samma Publish-instans?

Du kan använda klisterlappande anslutningar som ser till att alla dokument för en användare bearbetas i samma instans av AEM. Den här funktionen är viktig om du använder personaliserade sidor och sessionsdata. Data lagras på instansen. Därför måste efterföljande begäranden från samma användare returnera till den instansen, annars går data förlorade.

Eftersom häftiga anslutningar begränsar Dispatcher möjlighet att optimera begäranden bör du bara använda den här metoden när det behövs. Du kan ange den mapp som innehåller de"klisterlappande" dokumenten, så att alla dokument i mappen behandlas på samma plats för en användare.

Kan jag använda kladdiga anslutningar och cachelagring tillsammans?

För de flesta sidor där klisterlappande anslutningar används bör du inaktivera cachelagring. I annat fall visas samma instans av sidan för alla användare, oavsett sessionsinnehållet.

I vissa program kan du använda både fast anslutning och cachelagring. Om du till exempel visar ett formulär som skriver data till en session, kan du använda kladdiga anslutningar och cachelagring tillsammans.

Kan en Dispatcher och en AEM Publish-instans finnas på samma fysiska dator?

Ja, om maskinen är tillräckligt kraftfull. Du bör dock konfigurera Dispatcher och AEM Publish-instansen på olika datorer.

Vanligtvis finns Publish-instansen inuti brandväggen och Dispatcher finns i DMZ. Om du väljer att ha både Publish-instansen och Dispatcher på samma fysiska dator måste du se till att brandväggsinställningarna förhindrar direktåtkomst till Publish-instansen från externa nätverk.

Kan jag bara cachelagra filer med specifika tillägg?

Ja. Om du till exempel bara vill cachelagra GIF-filer anger du *.gif i cache-avsnittet i dispatcher.any-konfigurationsfilen.

Hur tar jag bort filer från cachen?

Du kan ta bort filer från cachen genom att använda en HTTP-begäran. När HTTP-begäran tas emot tar Dispatcher bort filerna från cachen. Dispatcher cachelagrar filerna igen endast när de tar emot en klientbegäran för sidan. Att ta bort cachelagrade filer på det här sättet är lämpligt för webbplatser som sannolikt inte tar emot samtidiga begäranden för samma sida.

HTTP-begäran har följande syntax:

POST /dispatcher/invalidate.cache HTTP/1.1
CQ-Action: Activate
CQ-Handle: path-pattern
Content-Length: 0

Dispatcher tar bort de cachelagrade filer och mappar som har namn som matchar värdet i CQ-Handle-huvudet. En CQ-Handle med /content/geomtrixx-outdoors/en matchar följande objekt:

Alla filer (oavsett filtillägg) med namnet en i katalogen geometrixx-outdoor.
Alla kataloger med namn _jcr_content nedanför katalogen en (som, om den finns, innehåller cachelagrade återgivningar av sidans undernoder).
Katalogen en tas bara bort om CQ-Action är Delete eller Deactivate.

Mer information om detta avsnitt finns på Invalidera Dispatcher-cachen manuellt.

Hur implementerar jag behörighetskänslig cachelagring?

Se Cachelagra säkert innehåll sida.

Hur skyddar jag kommunikationen mellan Dispatcher- och CQ-instanserna?

Se Dispatcher Security Checklist och AEM sidor.

Skickaproblem jcr:content ändrat till jcr%3acontent

Fråga: Företaget har nyligen stött på ett problem på Dispatcher-nivå. En av AJAX samtal som fick data från CQ-databasen hade jcr:content i den. Det blev kodat till jcr%3acontent vilket resulterar i fel resultatmängd.

Svar: Använd ResourceResolver.map() metod för att hämta en Friendly-URL som ska användas/utfärdas, hämta begäranden från och även för att lösa cachelagringsproblemet med Dispatcher. Metoden map() kodar : kolon till understreck och metoden resolve() avkodar dem till SLING JCR-läsbart format. Använd metoden map() för att generera den URL som används i Ajax-anropet.

Läs mer: https://sling.apache.org/documentation/the-sling-engine/mappings-for-resource-resolution.html#namespace-mangling

Rensa Dispatcher

Hur konfigurerar jag push-agenter för Dispatcher i en Publish-instans?

Se Replikering sida.

Hur felsöker jag problem med att tömma Dispatcher?

Se de här felsökningsartiklarna.

Om åtgärderna Ta bort gör att Dispatcher rensas använd lösningen i det här blogginlägget från Sensei Martin.

Hur tömmer jag DAM-resurser från Dispatcher-cachen?

Du kan använda funktionen "kedjereplikering". När den här funktionen är aktiverad skickar Dispatcher flush-agenten en tömningsbegäran när en replikering tas emot från författaren.

Så här aktiverar du den:

Diverse

Hur avgör Dispatcher om ett dokument är aktuellt?
För att avgöra om ett dokument är uppdaterat utför Dispatcher följande åtgärder:

Den kontrollerar om dokumentet kan ogiltigförklaras automatiskt. Annars betraktas dokumentet som uppdaterat.
Om dokumentet har konfigurerats för automatisk ogiltigförklaring kontrollerar Dispatcher om det är äldre eller nyare än den senaste tillgängliga ändringen. Om den är äldre begär Dispatcher den aktuella versionen från AEM och ersätter versionen i cachen.

Hur returnerar Dispatcher dokument?

Du kan definiera om Dispatcher ska cachelagra ett dokument med Dispatcher-konfiguration fil, dispatcher.any. Dispatcher kontrollerar begäran mot listan med cachelagrade dokument. Om dokumentet inte finns med i den här listan begär Dispatcher dokumentet från AEM.

The /rules anger vilka dokument som cachelagras enligt dokumentets sökväg. Oavsett /rules egenskapen, Dispatcher cachelagrar aldrig ett dokument under följande omständigheter:

Dispatcher lagrar cachelagrade filer på webbservern som om de var en del av en statisk webbplats. Om en användare begär ett cachelagrat dokument kontrollerar Dispatcher om dokumentet finns i webbserverns filsystem. I så fall returnerar Dispatcher dokumenten. Annars begär Dispatcher dokumentet från AEM.

Kan jag implementera flera utskickare i en konfiguration?

Ja. I så fall måste du se till att båda utskickarna har direktåtkomst till den AEM webbplatsen. En Dispatcher kan inte hantera begäranden från en annan Dispatcher.