Replikering

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 är köade till lämplig agent för bearbetning.

OBSERVERA

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.

Replikerar från författare till publicering

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.

chlimage_1-21

Replikerar från publicera till författare

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

Replikering - utanför lådan

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:

  • författarmiljön på port 4502
  • publiceringsmiljön på port 4503
OBSERVERA

Aktiverad som standard:

  • Agenter på författare: Standardagent (publicera)

Inaktiverat som standard (från och med AEM 6.1):

  • Agenter på författare: Agenten för omvänd replikering (publish_reverse)
  • Agenter vid publicering: Omvänd replikering (utkorg)

Om du vill kontrollera status för agenten eller kön använder du konsolen Verktyg.
Se Övervaka dina replikeringsagenter.

Replikering (författare att publicera)

  1. Navigera till supportsidan i författarmiljön.
    https://localhost:4502/content/we-retail/us/en/experience.html <pi>
  2. Redigera sidan för att lägga till ny text.
  3. Aktivera sidan om du vill publicera ändringarna.
  4. Öppna supportsidan i publiceringsmiljön:
    https://localhost:4503/content/we-retail/us/en/experience.html
  5. 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:

    https://localhost:4502/etc/replication/agents.author/publish.html.

Replikeringsagenter - utanför lådan

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.

Replikeringsagenter - konfigurationsparametrar

När du konfigurerar en replikeringsagent från verktygskonsolen är fyra flikar tillgängliga i dialogrutan:

Inställningar

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

    • Aktiveras när artiklar bearbetas.
    • Inaktivera när kön är tom.
    • Blockeras 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).

    FÖRSIKTIGHET

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

    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.

    OBSERVERA

    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 loggas
    • Info: fel, varningar och andra informationsmeddelanden loggas
    • Debug: 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 Dispatcher Flush Agent.

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 replikera till https://localhost:4503/bin/receive
    • En agent för utskickstömning kan replikera till 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.

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

  • 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":

    OBSERVERA

    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.

Utlösare

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

Mer information om hur du ansluter replikeringsagenter till publiceringsinstansen med MSSL finns i Replikera med Mutual SSL.

Konfigurera dina replikeringsagenter från författarmiljön

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.

OBSERVERA

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

  1. Gå till fliken Verktyg i AEM.

  2. Klicka på Replikering (vänster ruta för att öppna mappen).

  3. Dubbelklicka på Agenter på författare (antingen den vänstra eller den högra rutan).

  4. Klicka på lämpligt agentnamn (som är en länk) för att visa detaljerad information om agenten.

  5. Klicka på Redigera för att öppna konfigurationsdialogrutan:

    chlimage_1-22

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

OBSERVERA

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.

Konfigurerar omvänd replikering

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:

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

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.

chlimage_1-23

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.

chlimage_1-1

Konfigurera replikering för flera publiceringsinstanser

OBSERVERA

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:

  1. Öppna fliken Verktyg i AEM.

  2. Välj Replikering och Agenter på författare i den vänstra panelen.

  3. Välj Nytt….

  4. Ange titeln och Namn och välj sedan Replikeringsagent.

  5. Klicka på Skapa för att skapa den nya agenten.

  6. Dubbelklicka på det nya agentobjektet för att öppna konfigurationspanelen.

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

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

OBSERVERA

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

  1. Konfigurera en replikeringsagent för replikering till den publiceringsmiljön.
  2. 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.
  3. Tilldela användarkontot som agentanvändar-ID för replikeringsagenten.

Konfigurera en agent för utskickstömning

Standardagenter ingår i installationen. Men en viss konfiguration behövs fortfarande, och det samma gäller om du definierar en ny agent:

  1. Öppna fliken Verktyg i AEM.

  2. Klicka på Distribution.

  3. Välj Replikering och sedan Agenter vid publicering.

  4. Dubbelklicka på Dispatcher Flush-objektet för att öppna översikten.

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

    OBSERVERA

    Om du har installerat AEM i en annan kontext än den rekommenderade standardkontexten måste du konfigurera HTTP-rubrikerna på fliken Extended.

  6. Klicka på OK för att spara ändringarna.

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

Kontrollera åtkomst till replikeringsagenter

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

OBSERVERA

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.

Konfigurera dina replikeringsagenter från CRXDE Lite

OBSERVERA

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:

chlimage_1-24

Övervaka replikeringsagenter

Så här övervakar du en replikeringsagent:

  1. Gå till fliken Verktyg i AEM.

  2. Klicka på Replikering.

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

  4. Klicka på lämpligt agentnamn (som är en länk) för att visa detaljerad information om agenten:

    chlimage_1-2

    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.

    FÖRSIKTIGHET

    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

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

  1. Gå till http://serveraddress:serverport/siteadmin
  2. Tryck på ikonen Tools längst upp på skärmen
  3. Gå till Replication - Agents on Author och dubbelklicka på Default Agent från den vänstra navigeringslisten.
    • Du kan även nå standardagenten för publiceringsreplikering genom att gå direkt till http://serveraddress:serverport/etc/replication/agents.author/publish.html
  4. Tryck på knappen Edit ovanför replikeringskön.
  5. Gå till fliken Batch i följande fönster:
    batchreplikering
  6. Konfigurera agenten.

Parametrar

  • Enable Batch Mode - aktiverar eller inaktiverar batchreplikeringsläge
  • Max 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 överskrids

Ytterligare resurser

Mer information om felsökning finns på sidan Felsökning av replikering.

På denna sida