Replikeringsagenter är centrala för Adobe Experience Manager (AEM) eftersom den mekanism som används för att:
Begäranden är köade till lämplig agent för bearbetning.
Användardata (användare, användargrupper och användarprofiler) replikeras inte mellan författare- och publiceringsinstanser.
För flera publiceringsinstanser distribueras användardata när Användarsynkronisering är aktiverat.
Replikering till en publiceringsinstans eller dispatcher sker i flera steg:
författaren begär att visst innehåll ska publiceras (aktiveras), detta kan initieras av en manuell begäran eller av automatiska utlösare som har förkonfigurerats.
begäran skickas till lämplig standardredigeringsagent, en miljö kan ha flera standardagenter som alltid väljs för sådana åtgärder.
replikeringsagenten"paketerar" innehållet och placerar det i replikeringskön.
på fliken Webbplatser är den färgade statusindikatorn inställd för de enskilda sidorna.
innehållet tas bort från kön och transporteras till publiceringsmiljön med det konfigurerade protokollet, vanligtvis är detta HTTP.
en server i publiceringsmiljön tar emot begäran och publicerar det mottagna innehållet, standardservleten är https://localhost:4503/bin/receive
.
flera skribent- och publiceringsmiljöer kan konfigureras.
Vissa funktioner tillåter användare att ange data i en publiceringsinstans.
I vissa fall behövs en typ av replikering som kallas omvänd replikering för att returnera dessa data till den redigeringsmiljö varifrån de distribueras till andra publiceringsmiljöer. Av säkerhetsskäl måste all trafik från publicering till redigeringsmiljön vara strikt kontrollerad.
Omvänd replikering använder en agent i publiceringsmiljön som refererar till redigeringsmiljön. Den här agenten placerar data i en utkorg. Utkorgen matchas med replikeringslyssnare i redigeringsmiljön. Avlyssnarna avsöker utkorgarna för att samla in alla data som anges och sedan distribuera dem efter behov. Detta garanterar att redigeringsmiljön styr all trafik.
I andra fall, t.ex. för communityfunktioner (t.ex. forum, bloggar, kommentarer och granskningar), är mängden användargenererat innehåll (UGC) som anges i publiceringsmiljön svår att effektivt synkronisera mellan AEM instanser med hjälp av replikering.
AEM Communities använder aldrig replikering för UGC. Distributionen för Communities kräver i stället en gemensam lagringsplats för UGC (se Community Content Storage).
Webbplatsen för webbutiker som ingår i en standardinstallation av AEM kan användas för att illustrera replikering.
Om du vill följa det här exemplet och använda standardreplikeringsagenterna måste du installera AEM med:
4502
4503
Aktiverad som standard:
Inaktiverat som standard (från och med AEM 6.1):
Om du vill kontrollera status för agenten eller kön använder du konsolen Verktyg.
Se Övervaka dina replikeringsagenter.
<pi>
Den här replikeringen utförs från redigeringsmiljön av:
Standardagent (publicera)
Den här agenten replikerar innehåll till standardpubliceringsinstansen.
Information om detta (konfiguration och loggar) finns på verktygskonsolen i författarmiljön. eller:
https://localhost:4502/etc/replication/agents.author/publish.html
.
Följande agenter finns i en AEM standardinstallation:
Standardagent
används för replikering från författare till publicering.
Dispatcher Flush
Detta används för att hantera Dispatcher-cachen. Mer information finns i Invaliderar Dispatcher Cache från redigeringsmiljön och Invaliderar Dispatcher Cache från en Publishing Instance.
Omvänd
replikering används för replikering från publicering till författare. Omvänd replikering används inte för communityfunktioner som forum, bloggar och kommentarer. Den är inaktiverad eftersom utkorgen inte är aktiverad. Användning av omvänd replikering kräver anpassad konfiguration.
Statisk agent
Detta är en"agent som lagrar en statisk representation av en nod i filsystemet."
Med standardinställningarna lagras till exempel innehållssidor och dammresurser under /tmp
, antingen som HTML eller i lämpligt resursformat. Se flikarna Settings
och Rules
för konfigurationen.
Detta begärdes så att innehållet kan ses när sidan begärs direkt från programservern. Detta är en specialiserad agent och (troligen) krävs inte för de flesta instanser.
När du konfigurerar en replikeringsagent från verktygskonsolen är fyra flikar tillgängliga i dialogrutan:
Namn
Ett unikt namn för replikeringsagenten.
Beskrivning
En beskrivning av syftet med den här replikeringsagenten.
Aktiverad
Anger om replikeringsagenten är aktiverad.
När agenten är aktiverad visas kön som:
Serialiseringstyp
Typ av serialisering:
Återförsöksfördröjning
Fördröjningen (i millisekunder) mellan två försök om ett problem skulle uppstå.
Standard: 60000
Användar-ID för agent
Beroende på miljön kommer agenten att använda det här användarkontot för att:
Lämna det här fältet tomt om du vill använda systemanvändarkontot (det konto som definierats i sling som administratörsanvändare). som standard är detta admin
).
För en agent i författarmiljön måste det här kontot ha läsåtkomst till alla sökvägar som du vill ha replikerade.
För en agent i publiceringsmiljön måste det här kontot ha den behörighet att skapa/skriva som krävs för att replikera innehållet.
Detta kan användas som en mekanism för att välja specifikt innehåll för replikering.
Loggnivå
Anger den detaljnivå som ska användas för loggmeddelanden.
Error
: endast fel loggasInfo
: fel, varningar och andra informationsmeddelanden loggasDebug
: en hög detaljnivå kommer att användas i meddelandena, främst i felsökningssyfteStandard: Info
Använd för omvänd replikering
Anger om agenten ska användas för omvänd replikering. returnerar användarindata från publicerings- till författarmiljön.
Aliasuppdatering
Om du väljer det här alternativet aktiveras ogiltiga aliassökvägar eller ogiltiga sökvägar för Dispatcher. Se även Konfigurera en Dispatcher Flush Agent.
URI
Detta anger den mottagande servern på målplatsen. Du kan särskilt ange värdnamnet (eller aliaset) och kontextsökvägen till målinstansen här.
Till exempel:
https://localhost:4503/bin/receive
https://localhost:8000/dispatcher/invalidate.cache
Det protokoll som anges här (HTTP eller HTTPS) avgör transportmetoden.
För Dispatcher Flush-agenter används URI-egenskapen endast om du använder sökvägsbaserade virtualhost-poster för att skilja mellan grupper, använder du det här fältet för att göra gruppen ogiltig. Servergrupp #1 har till exempel en virtuell värd på www.mysite.com/path1/*
och servergrupp #2 har en virtuell värd på www.mysite.com/path2/*
. Du kan använda URL:en /path1/invalidate.cache
för att ange den första servergruppen som mål och /path2/invalidate.cache
för den andra servergruppen.
Användare
Användarnamn för kontot som ska användas för att komma åt målet.
Lösenord
Lösenord för kontot som ska användas för att komma åt målet.
NTLM-domän
Domän för NTML-autentisering.
NTLM-värd
Värd för NTML-autentisering.
Aktivera relaxerad SSL
Aktivera om du vill att självcertifierade SSL-certifikat ska godkännas.
Tillåt utgångna certifikat
Aktivera om du vill att utgångna SSL-certifikat ska godkännas.
Följande inställningar behövs bara om en proxy behövs:
Proxyvärd
Värdnamn för proxyn som används för transport.
Proxyport
Proxyns port.
Proxyanvändare
Användarnamn för kontot som ska användas.
Proxylösenord
Lösenord för kontot som ska användas.
Proxy NTLM-domän
NTLM-proxydomänen.
Proxy NTLM-värd
NTLM-proxydomänen.
Gränssnitt
Här kan du definiera socketgränssnittet som du vill binda till.
Detta anger den lokala adress som ska användas när anslutningar skapas. Om detta inte anges används standardadressen. Detta är användbart när du vill ange vilket gränssnitt som ska användas på system med flera hem eller kluster.
HTTP-metod
HTTP-metoden som ska användas.
För en Dispatcher Flush-agent är detta nästan alltid GET och bör inte ändras (POSTEN skulle vara ett annat möjligt värde).
HTTP-huvuden
Dessa används för Dispatcher Flush-agenter och anger element som måste tömmas.
För en Dispatcher Flush-agent behöver de tre standardposterna inte ändras:
CQ-Action:{action}
CQ-Handle:{path}
CQ-Path:{path}
Dessa används, beroende på vad som är lämpligt, för att ange vilken åtgärd som ska användas när handtaget eller banan töms. Underparametrarna är dynamiska:
{action}
anger en replikeringsåtgärd
{path}
anger en bana
De ersätts av den sökväg/åtgärd som är relevant för begäran och behöver därför inte"hårdkodas":
Om du har installerat AEM i en annan kontext än den rekommenderade måste du registrera kontexten i HTTP-rubrikerna. Till exempel:
CQ-Handle:/<*yourContext*>{path}
Stäng anslutning
Aktivera för att stänga anslutningen efter varje begäran.
Tidsgräns för anslutning
Timeout (i millisekunder) som ska användas vid försök att upprätta en anslutning.
Tidsgräns för socket
Timeout (i millisekunder) som ska användas vid väntan på trafik efter att en anslutning har upprättats.
Protokollversion
Protokollets version. till exempel 1.0
för HTTP/1.0.
De här inställningarna används för att definiera utlösare för automatiserad replikering:
Ignorera standard
Om du markerar detta utesluts agenten från standardreplikering. Detta innebär att det inte kommer att användas om en innehållsförfattare utfärdar en replikeringsåtgärd.
Vid ändring
Här aktiveras en replikering från den här agenten automatiskt när en sida ändras. Detta används främst för Dispatcher Flush-agenter, men även för omvänd replikering.
Vid distribution
Om det här alternativet är markerat kopieras automatiskt allt innehåll som är markerat för distribution när det ändras.
On-/Offtime uppnådd
Detta startar automatisk replikering (för att aktivera eller inaktivera en sida efter behov) när de tider eller offtider som har definierats för en sida inträffar. Detta används främst för Dispatcher Flush-agenter.
Vid mottagning
Om det här alternativet är markerat kommer agenten att kedja replikeringen när den tar emot replikeringshändelser.
Ingen statusuppdatering
När det här alternativet är markerat framtvingar agenten ingen uppdatering av replikeringsstatusen.
Ingen versionshantering
När det här alternativet är markerat framtvingar agenten inte versionshantering av aktiverade sidor.
Mer information om hur du ansluter replikeringsagenter till publiceringsinstansen med MSSL finns i Replikera med Mutual SSL.
På fliken Verktyg i författarmiljön kan du konfigurera replikeringsagenter som finns antingen i författarmiljön (Agenter på författare) eller i publiceringsmiljön (Agenter på publicering). Följande procedurer illustrerar konfigurationen av en agent för författarmiljön, men kan användas för båda.
När en dispatcher hanterar HTTP-begäranden för författare- eller publiceringsinstanser måste HTTP-begäran från replikeringsagenten innehålla PATH-huvudet. Utöver följande procedur måste du lägga till PATH-huvudet i avsändarlistan med klientrubriker. (Se /clientheaders (Klientrubriker).
Gå till fliken Verktyg i AEM.
Klicka på Replikering (vänster ruta för att öppna mappen).
Dubbelklicka på Agenter på författare (antingen den vänstra eller den högra rutan).
Klicka på lämpligt agentnamn (som är en länk) för att visa detaljerad information om agenten.
Klicka på Redigera för att öppna konfigurationsdialogrutan:
De angivna värdena ska vara tillräckliga för en standardinstallation. Om du gör ändringar klickar du på OK för att spara dem (mer information om de enskilda parametrarna finns i Replikeringsagenter - Konfigurationsparametrar).
En standardinstallation av AEM anger admin
som användare för transportreferenser inom standardreplikeringsagenterna.
Detta bör ändras till ett platsspecifikt replikeringsanvändarkonto med behörighet att replikera de nödvändiga sökvägarna.
Omvänd replikering används för att hämta användarinnehåll som genererats på en publiceringsinstans tillbaka till en författarinstans. Detta används ofta för funktioner som undersökningar och registreringsformulär.
Av säkerhetsskäl tillåter de flesta nätverkstopologier inte anslutningar från den "Demilitarized Zone" (ett undernätverk som exponerar de externa tjänsterna för ett ej betrott nätverk som Internet).
Eftersom publiceringsmiljön vanligtvis finns i DMZ måste anslutningen initieras från författarinstansen för att innehållet ska kunna skickas tillbaka till redigeringsmiljön. Detta görs med:
För AEM Communities används inte replikering för användargenererat innehåll på en publiceringsinstans. Se Community Content Storage.
För att göra detta behöver du:
En agent för omvänd replikering i redigeringsmiljönDetta fungerar som den aktiva komponenten för att samla in information från utkorgen i publiceringsmiljön:
Om du vill använda omvänd replikering kontrollerar du att agenten är aktiverad.
En agent för omvänd replikering i publiceringsmiljön (en utkorg) Detta är det passiva elementet eftersom det fungerar som en"utkorg". Användarindata placeras här, där de samlas in av agenten i författarmiljön.
Endast innehåll replikeras - användardata är inte det (användare, användargrupper och användarprofiler).
Om du vill synkronisera användardata mellan flera publiceringsinstanser aktiverar du Användarsynkronisering.
Vid installationen är en standardagent redan konfigurerad för replikering av innehåll till en publiceringsinstans som körs på port 4503 på den lokala värden.
Så här konfigurerar du replikering av innehåll för ytterligare en publiceringsinstans som du måste skapa och konfigurera en ny replikeringsagent:
Öppna fliken Verktyg i AEM.
Välj Replikering och Agenter på författare i den vänstra panelen.
Välj Nytt….
Ange titeln och Namn och välj sedan Replikeringsagent.
Klicka på Skapa för att skapa den nya agenten.
Dubbelklicka på det nya agentobjektet för att öppna konfigurationspanelen.
Klicka på Redigera - Dialogrutan Agentinställningar öppnas - Serialiseringstypen är redan definierad som standard, detta måste finnas kvar så.
På fliken Inställningar:
Aktivera Aktiverad.
Ange en beskrivning.
Ange Återförsöksfördröjning till 60000
.
Låt serialiseringstypen vara Default
.
På fliken Transport:
Ange den URI som krävs för den nya publiceringsinstansen. till exempel
https://localhost:4504/bin/receive
.
Ange det platsspecifika användarkonto som används för replikering.
Du kan konfigurera andra parametrar efter behov.
Klicka på OK för att spara inställningarna.
Du kan sedan testa åtgärden genom att uppdatera och sedan publicera en sida i författarmiljön.
Uppdateringarna visas på alla publiceringsinstanser som har konfigurerats enligt ovan.
Om du får problem kan du kontrollera loggarna på författarinstansen. Beroende på vilken detaljnivå som krävs kan du även ställa in loggnivån till Debug
med dialogrutan Agentinställningar enligt ovan.
Detta kan kombineras med Agentanvändar-ID för att välja ett annat innehåll som ska replikeras till de enskilda publiceringsmiljöerna. För varje publiceringsmiljö:
Standardagenter ingår i installationen. Men en viss konfiguration behövs fortfarande, och det samma gäller om du definierar en ny agent:
Öppna fliken Verktyg i AEM.
Klicka på Distribution.
Välj Replikering och sedan Agenter vid publicering.
Dubbelklicka på Dispatcher Flush-objektet för att öppna översikten.
Klicka på Redigera - dialogrutan Agentinställningar öppnas:
På fliken Inställningar:
Aktivera Aktiverad.
Ange en beskrivning.
Lämna serialiseringstypen som Dispatcher Flush
, eller ange den som sådan om du skapar en ny agent.
(valfritt) Välj Aliasuppdatering om du vill aktivera aliasbegäran eller ogiltighetsbegäran för ogiltighetssökvägen till Dispatcher.
På fliken Transport:
Ange den URI som krävs för den nya publiceringsinstansen. till exempel
https://localhost:80/dispatcher/invalidate.cache
.
Ange det platsspecifika användarkonto som används för replikering.
Du kan konfigurera andra parametrar efter behov.
För Dispatcher Flush-agenter används URI-egenskapen endast om du använder sökvägsbaserade virtualhost-poster för att skilja mellan grupper, använder du det här fältet för att göra gruppen ogiltig. Servergrupp #1 har till exempel en virtuell värd på www.mysite.com/path1/*
och servergrupp #2 har en virtuell värd på www.mysite.com/path2/*
. Du kan använda URL:en /path1/invalidate.cache
för att ange den första servergruppen som mål och /path2/invalidate.cache
för den andra servergruppen.
Om du har installerat AEM i en annan kontext än den rekommenderade standardkontexten måste du konfigurera HTTP-rubrikerna på fliken Extended.
Klicka på OK för att spara ändringarna.
Gå tillbaka till fliken Verktyg, härifrån kan du aktivera agenten Dispatcher Flush (Agenter on publish).
Replikeringsagenten Dispatcher Flush är inte aktiv för författaren. Du kan komma åt samma sida i publiceringsmiljön med motsvarande URI; till exempel https://localhost:4503/etc/replication/agents.publish/flush.html
.
Åtkomst till de sidor som används för att konfigurera replikeringsagenterna kan styras med användar- och/eller gruppsidbehörigheter på noden etc/replication
.
Om du anger sådana behörigheter påverkas inte användare som replikerar innehåll (t.ex. från webbplatskonsolen eller sidosparsalternativet). Replikeringsramverket använder inte den aktuella användarens användarsession för att komma åt replikeringsagenter när sidor replikeras.
Det går bara att skapa replikeringsagenter på databasplatsen /etc/replication
. Detta krävs för att de tillhörande åtkomstkontrollistorna ska hanteras på rätt sätt. Om du skapar en replikeringsagent på en annan plats i trädet kan det leda till obehörig åtkomst.
Olika parametrar för replikeringsagenterna kan konfigureras med CRXDE Lite.
Om du går till /etc/replication
ser du följande tre noder:
agents.author
agents.publish
treeactivation
De två agents
innehåller konfigurationsinformation om lämplig miljö och är bara aktiva när den miljön körs. agents.publish
kommer till exempel endast att användas i publiceringsmiljön. På följande skärmbild visas publiceringsagenten i författarmiljön, som i AEM WCM:
Så här övervakar du en replikeringsagent:
Gå till fliken Verktyg i AEM.
Klicka på Replikering.
Dubbelklicka på länken till agenterna för lämplig miljö (antingen vänster eller höger ruta). till exempel Agenter på författare.
I det resulterande fönstret visas en översikt över alla dina replikeringsagenter för redigeringsmiljön, inklusive mål och status.
Klicka på lämpligt agentnamn (som är en länk) för att visa detaljerad information om agenten:
Här kan du:
Se om agenten är aktiverad.
Se målet för alla replikeringar.
Kontrollera om replikeringskön är aktiv (aktiverad).
Se om det finns några objekt i kön.
Uppdatera schemat för att uppdatera visningen av köposter. så att du lättare kan se objekt komma in i och lämna kön.
Visa Logg för att komma åt loggen för eventuella åtgärder som utförs av replikeringsagenten.
Testa anslutning till målinstansen.
Tvinga återförsök av köobjekt om det behövs.
Använd inte länken Testa anslutning för den omvända replikeringsutkorgen på en publiceringsinstans.
Om ett replikeringstest utförs för en Utkorgskö kommer alla objekt som är äldre än testreplikeringen att bearbetas på nytt med varje omvänd replikering.
Om sådana objekt redan finns i en kö kan de hittas med följande XPath JCR-fråga och bör tas bort.
/jcr:root/var/replication/outbox//*[@cq:repActionType='TEST']
Gruppreplikeringen replikerar inte enskilda sidor eller resurser, men väntar på att det första tröskelvärdet för de två sidorna, baserat på tid eller storlek, ska aktiveras.
Därefter paketeras alla replikeringsobjekt i ett paket som sedan replikeras som en enda fil till utgivaren.
Utgivaren packar upp alla artiklar, sparar dem och rapporterar tillbaka till författaren.
http://serveraddress:serverport/siteadmin
http://serveraddress:serverport/etc/replication/agents.author/publish.html
Enable Batch Mode
- aktiverar eller inaktiverar batchreplikeringslägeMax Wait Time
- Maximal väntetid i sekunder tills en gruppbegäran startas. Standardvärdet är 2 sekunder.Trigger Size
- Startar batchreplikering när den här storleksgränsen överskridsMer information om felsökning finns på sidan Felsökning av replikering.