Replikering replication
Replikeringsagenter är centrala för Adobe Experience Manager (AEM) eftersom den mekanism som används för att:
- Publicera (aktivera) innehåll från en författare till en publiceringsmiljö.
- Rensa innehåll explicit från Dispatcher-cachen.
- Returnera användarindata (till exempel formulärindata) från publiceringsmiljön till författarmiljön (under kontroll av författarmiljön).
Begäranden köad till lämpligt ombud för behandling.
Replikerar från författare till publicering replicating-from-author-to-publish
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 färgad statusindikator är inställt 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
http://localhost:4503/bin/receive
. -
flera skribent- och publiceringsmiljöer kan konfigureras.
Replikerar från publicera till författare replicating-from-publish-to-author
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 butik för UGC (se Community-innehåll).
Replikering - utanför lådan replication-out-of-the-box
Geometrixx webbplats 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 de standardreplikeringsagenter som du behöver Installera AEM med:
- författarmiljön på porten
4502
- publiceringsmiljön på porten
4503
- Agenter på författare: Standardagent (publicera)
- Agenter på författare: Agenten för omvänd replikering (publish_reverse)
- Agenter vid publicering: Omvänd replikering (utkorg)
Se Övervaka replikeringsagenter.
Replikering (författare att publicera) replication-author-to-publish
-
Navigera till supportsidan i författarmiljön.
http://localhost:4502/content/geometrixx/en/support.html
-
Redigera sidan för att lägga till ny text.
-
Aktivera sida för att publicera ändringarna.
-
Öppna supportsidan i publiceringsmiljön:
http://localhost:4503/content/geometrixx/en/support.html
-
Du kan nu se ändringarna som du har angett för författaren.
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:
http://localhost:4502/etc/replication/agents.author/publish.html
.
Replikeringsagenter - utanför lådan replication-agents-out-of-the-box
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. Se Dispatcher Cache har inte verifierats från redigeringsmiljön och Invaliderar Dispatcher Cache från en publiceringsinstans för mer information.
-
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 lämpligt resursformat. SeSettings
ochRules
-flikar 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.
Replikeringsagenter - konfigurationsparametrar replication-agents-configuration-parameters
När du konfigurerar en replikeringsagent från verktygskonsolen är fyra flikar tillgängliga i dialogrutan:
Inställningar settings
-
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 Kön visas som:
- Aktiv när objekt bearbetas.
- Ledig när kön är tom.
- Blockerad när objekten finns i kön, men inte kan bearbetas, till exempel när mottagande kö är inaktiverad.
-
Serialiseringstyp
Typ av serialisering:
- Standard: Ange om agenten ska väljas automatiskt.
- Dispatcher Flush: Välj det här alternativet om agenten ska användas för att tömma dispatchercachen.
-
Å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:
- samla in och paketera innehåll från författarmiljön
- skapa och skriva innehåll i publiceringsmiljön
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
).note caution CAUTION För en agent i författarmiljön är det här kontot måste har läsåtkomst till alla sökvägar som du vill ha replikerade. note caution CAUTION För en agent i publiceringsmiljön är det här kontot måste har den behörighet att skapa/skriva som krävs för att replikera innehållet. note note NOTE 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ökningssyfte
Standard:
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 agent för utskickstömning.
Transport transport
-
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:
- En standardagent kan replikeras till
http://localhost:4503/bin/receive
- En agent för utskickstömning kan replikeras till
http://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 för
www.mysite.com/path1/*
och grupp 2 har en virtuell värd förwww.mysite.com/path2/*
. Du kan använda en URL med/path1/invalidate.cache
för att rikta in sig på den första gården och/path2/invalidate.cache
för den andra gruppen. - En standardagent kan replikeras till
-
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.
Proxy proxy
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.
Utökad extended
-
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":
note note NOTE 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.
-
Timeout 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.
Utlösare triggers
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.
Konfigurera replikeringsagenter configuring-your-replication-agents
Mer information om hur du ansluter replikeringsagenter till publiceringsinstansen med MSSL finns i Replikering med ömsesidig SSL.
Konfigurera dina replikeringsagenter från författarmiljön configuring-your-replication-agents-from-the-author-environment
På fliken Verktyg i redigeringsmiljön kan du konfigurera replikeringsagenter som finns i antingen författarmiljön (Agenter på författare) eller publiceringsmiljön (Agenter vid publicering). Följande procedurer illustrerar konfigurationen av en agent för författarmiljön, men kan användas för båda.
-
Öppna verktyg AEM.
-
Klicka Replikering (vänster ruta för att öppna mappen).
-
Dubbelklicka Agenter på författare (antingen vänster eller höger ruta).
-
Klicka på lämpligt agentnamn (som är en länk) för att visa detaljerad information om agenten.
-
Klicka 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 (se Replikeringsagenter - konfigurationsparametrar för mer information om de enskilda parametrarna).
admin
som användare för transportreferenser inom standardreplikeringsagenterna.Konfigurerar omvänd replikering configuring-reverse-replication
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 "Demilitarized Zone" (ett undernätverk som exponerar de externa tjänsterna för ett icke tillförlitligt 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:
- en utkorg i den publiceringsmiljö där innehållet placeras.
- en agent (publicera) i författarmiljön som regelbundet frågar efter nytt innehåll i utkorgen.
För att göra detta behöver du:
En omvänd replikeringsagent i författarmiljön Detta fungerar som en aktiv komponent 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 omvänd replikeringsagent 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.
Konfigurera replikering för flera publiceringsinstanser configuring-replication-for-multiple-publish-instances
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 verktyg AEM.
-
Välj Replikering sedan Agenter på författare i den vänstra panelen.
-
Välj Nytt….
-
Ange Titel och Namn väljer Replikeringsagent.
-
Klicka Skapa för att skapa den nya agenten.
-
Dubbelklicka på det nya agentobjektet för att öppna konfigurationspanelen.
-
Klicka Redigera - Agentinställningar öppnas Serialiseringstyp är redan definierad som Standard. Detta måste förbli så.
-
I Inställningar tab:
- Aktivera Aktiverad.
- Ange Beskrivning.
- Ange Återförsöksfördröjning till
60000
. - Lämna Serialiseringstyp as
Default
.
-
I Transport tab:
-
Ange den URI som krävs för den nya publiceringsinstansen. till exempel
http://localhost:4504/bin/receive
. -
Ange det platsspecifika användarkonto som används för replikering.
-
Du kan konfigurera andra parametrar efter behov.
-
-
-
Klicka 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 ange Loggnivå till Debug
med Agentinställningar som ovan.
- Konfigurera en replikeringsagent för replikering till den publiceringsmiljön.
- Konfigurera ett användarkonto; med de åtkomsträttigheter som krävs för att läsa det innehåll som ska replikeras till den specifika publiceringsmiljön.
- Tilldela användarkontot som Användar-ID för agent för replikeringsagenten.
Konfigurera en agent för utskickstömning configuring-a-dispatcher-flush-agent
Standardagenter ingår i installationen. Men en viss konfiguration behövs fortfarande, och det samma gäller om du definierar en ny agent:
-
Öppna verktyg AEM.
-
Klicka Distribution.
-
Välj Replikering och sedan Agenter vid publicering.
-
Dubbelklicka på Dispatcher Flush för att öppna översikten.
-
Klicka Redigera - Agentinställningar öppnas:
-
I Inställningar tab:
- Aktivera Aktiverad.
- Ange Beskrivning.
- Lämna Serialiseringstyp as
Dispatcher Flush
eller ange det som en 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.
-
I Transport tab:
-
Ange den URI som krävs för den nya publiceringsinstansen. till exempel
http://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 för
www.mysite.com/path1/*
och grupp 2 har en virtuell värd förwww.mysite.com/path2/*
. Du kan använda en URL med/path1/invalidate.cache
för att rikta in sig på den första gården och/path2/invalidate.cache
för den andra gruppen.note note NOTE Om du har installerat AEM i en annan kontext än den rekommenderade måste du konfigurera HTTP-huvuden i Utökad -fliken. -
-
Klicka OK för att spara ändringarna.
-
Återgå till verktyg här kan du Aktivera den Dispatcher Flush agent (Agenter vid publicering).
The Dispatcher Flush replikeringsagenten är inte aktiv på författaren. Du kan komma åt samma sida i publiceringsmiljön med motsvarande URI; till exempel http://localhost:4503/etc/replication/agents.publish/flush.html
.
Kontrollera åtkomst till replikeringsagenter controlling-access-to-replication-agents
Åtkomst till de sidor som används för att konfigurera replikeringsagenterna kan styras med användar- och/eller gruppsidbehörigheter på etc/replication
nod.
Konfigurera dina replikeringsagenter från CRXDE Lite configuring-your-replication-agents-from-crxde-lite
[OBS!]
Det går bara att skapa replikeringsagenter i
/etc/replication
lagringsplats. 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 navigerar till /etc/replication
Följande tre noder visas:
agents.author
agents.publish
treeactivation
De två agents
innehåller konfigurationsinformation om lämplig miljö och är bara aktiv när den miljön körs. Till exempel: agents.publish
kommer endast att användas i publiceringsmiljön. På följande skärmbild visas publiceringsagenten i författarmiljön, som i AEM WCM:
Övervaka replikeringsagenter monitoring-your-replication-agents
Så här övervakar du en replikeringsagent:
-
Öppna verktyg AEM.
-
Klicka 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 eller Rensa 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 få åtkomst till loggen över eventuella åtgärder från replikeringsagenten.
- Testanslutning till målinstansen.
- Tvinga återförsök på alla köobjekt om det behövs.
note caution CAUTION 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']
Batchreplikering batch-replication
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.
Konfigurerar batchreplikering configuring-batch-replication
- Gå till
http://serveraddress:serverport/siteadmin
- Tryck på Tools ikonen längst upp på skärmen
- Från vänster navigeringsspår, gå till Replication - Agents on Author och dubbelklicka Default Agent.
- Du kan även nå standardagenten för publiceringsreplikering genom att gå direkt till
http://serveraddress:serverport/etc/replication/agents.author/publish.html
- Du kan även nå standardagenten för publiceringsreplikering genom att gå direkt till
- Tryck på Edit ovanför replikeringskön.
- I följande fönster går du till Batch tab:
- Konfigurera agenten.
Parametrar parameters
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 nås, i MB. Standardvärdet är 5 MB.
Ytterligare resurser additional-resources
Mer information om felsökning finns i Felsökning av replikering sida.
För mer information har Adobe en serie kunskapsbasartiklar om replikering:
https://helpx.adobe.com/se/experience-manager/kb/ReplicationSiblingReordering.html
https://helpx.adobe.com/se/experience-manager/kb/ReplicationFailureAfterNewIP.html
https://helpx.adobe.com/se/experience-manager/kb/LimitAccessToReplicationAgents.html
https://helpx.adobe.com/experience-manager/kb/PagePermissionsNotReplicatedWithUser.html
https://helpx.adobe.com/se/experience-manager/kb/HowToUseReverseReplication.html
https://helpx.adobe.com/se/experience-manager/kb/CQ5ReplicateToSpecificAgents.html
https://helpx.adobe.com/se/experience-manager/kb/ReplicationListener.html
https://helpx.adobe.com/experience-manager/kb/replication-stuck.html
https://helpx.adobe.com/se/experience-manager/kb/replication-privileges-missing-after-upgrade-to-cq-5-5.html
https://helpx.adobe.com/se/experience-manager/kb/CQ53UnableToCreateJobQueueDueToMaxQueues.html
https://helpx.adobe.com/se/experience-manager/kb/ACLReplication.html
https://helpx.adobe.com/se/experience-manager/kb/content-grow-due-reverse-replication.html
https://helpx.adobe.com/se/experience-manager/kb/ReplicationAgentUsingAnonUser.html