DokumentationAEM 6.5Användarhandbok

Felsökning av replikering troubleshooting-replication

Last update: Sat Jul 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Administratör

Den här sidan innehåller information om hur du felsöker replikeringsproblem.

Problem problem

Replikering (icke-omvänd replikering) misslyckas av någon anledning.

Upplösning resolution

Det finns olika orsaker till att replikeringen misslyckas. I den här artikeln förklaras den metod som kan användas vid analys av dessa problem.

Utlöses replikeringar överhuvudtaget när du klickar på knappen Aktivera? Om INTE, gör du följande:

  1. Gå till /crx/explorer och logga in som administratör.
  2. Öppna "Innehållsutforskaren"
  3. Se om det finns en nod/bin/replikate eller /bin/replicate.json. Om noden finns tar du bort den och sparar den.

köas replikeringarna i replikeringsagentköerna?

Kontrollera detta genom att gå till /etc/replication/agents.author.html och sedan klicka på replikeringsagenterna för att kontrollera.

Om en agentkö eller ett fåtal agentköer har fastnat:

  1. Visar kön status Blockerad? Om så är fallet, körs inte publiceringsinstansen eller svarar den inte? Kontrollera publiceringsinstansen för att se vad som är fel med den. Kontrollera loggarna och se om det finns ett OutOfMemory-fel eller något annat problem. Om det bara är långsamt tar du tråd och analyserar dem.

  2. Visar köstatusen Kön är aktiv - # väntande? Replikeringsjobbet kan i princip fastna i en socketläsning som väntar på att publiceringsinstansen eller Dispatcher ska svara. Det kan innebära att publiceringsinstansen eller Dispatcher är under hög belastning eller sitter fast i ett lås. Ta tråddumpar från författaren och publicera i det här fallet.

    • Öppna trådsdumpar från författaren i en tråddumpsanalyserare, kontrollera om det visar att replikeringsagentens snedningsjobb har fastnat i en socketRead.
    • Öppna trådsdumpar från publicering i en tråddumpsanalyserare och analysera vad som kan göra att publiceringsinstansen inte svarar. Du bör se en tråd med POSTEN /bin/receive i dess namn som är den tråd som tar emot replikeringen från författaren.

Om alla agentköer har fastnat

  1. Det är möjligt att en viss del av innehållet inte kan serialiseras under /var/replication/data på grund av att databasen är skadad eller något annat problem. Kontrollera om det finns ett relaterat fel i logs/error.log. Så här rensar du bort det felaktiga replikeringsobjektet:

    1. Gå till https://<host>:<port>/crx/de och logga in som admin-användare.
    2. Klicka på"Verktyg" i den övre menyn.
    3. Klicka på knappen för förstoringsglas.
    4. Välj "XPath" som Typ.
    5. I rutan Fråga anger du den här frågans/jcr:root/var/eventing/job//element(*,slingevent:Job) ordning av @slingevent:created
    6. Klicka på Sök.
    7. I resultatet är de viktigaste objekten de senaste snedsättningsjobben. Klicka på var och en och hitta de kvarvarande replikeringar som matchar det som visas högst upp i kön.

  2. Det kan vara något fel med att snedställa jobbköer i utvecklingsramverket. Prova att starta om paketet org.apache.sling.event i /system/console.

  3. Det kan bero på att jobbbearbetningen är avstängd. Det kan du kolla under Felix Console på fliken Sling Eventing. Kontrollera om den visas - Apache Sling Eventing (JOBBBEARBETNING ÄR INAKTIVERAD!)

    • Om ja, kontrollera Apache Sling Job Event Handler på fliken Konfiguration i Felix Console. Det kan bero på att kryssrutan Jobbbearbetning är aktiverad inte är markerad. Om detta är markerat och fortfarande visar att jobbbearbetning är inaktiverad, kontrollerar du om det finns någon övertäckning under /apps/system/config som inaktiverar jobbbearbetningen. Försök att skapa en osgi:config-nod för jobmanager.enabled med ett booleskt värde till true och kontrollera om aktiveringen har startat och det inte finns några fler jobb i kö.

  4. Det kan också vara så att DefaultJobManager-konfigurationen försätts i ett inkonsekvent tillstånd. Detta kan inträffa när någon manuellt ändrar konfigurationen av "Apache Sling Job Event Handler" via OSGiconsole (t.ex. inaktivera och återaktivera egenskapen "Jobbbearbetning aktiverad" och spara konfigurationen).

    • I det här läget försätts DefaultJobManager-konfigurationen som lagras på crx-quickstart/launchpad/config/org/apache/sling/event/impl/jobs/DefaultJobManager.config i ett inkonsekvent läge. Och även om egenskapen "Apache Sling Job Event Handler" visar att "Job Processing Enabled" är i markerat läge, visas meddelandet "Job Processing Enabled" (Jobbbearbetning är inaktiverat) när man går till fliken Sling Eventing Eventing, och replikeringen fungerar inte.
    • Du löser det här problemet genom att navigera till konfigurationssidan för OSGi-konsolen och ta bort konfigurationen Apache Sling Job Event Handler. Starta sedan om klusternoden för att få tillbaka konfigurationen till ett konsekvent tillstånd. Detta bör åtgärda problemet och replikeringen börjar fungera igen.

Skapa en replikering.log

Ibland kan det vara praktiskt att ange att all replikeringsloggning ska läggas till i en separat loggfil på DEBUG-nivå. Så här gör du:

  1. Gå till https://host:port/system/console/configMgr och logga in som administratör.

  2. Hitta Apache Sling Logging Logger-fabriken och skapa en instans genom att klicka på knappen + till höger om fabrikskonfigurationen. Detta skapar en ny loggningslogg.

  3. Ställ in konfigurationen så här:

    • Loggnivå: FELSÖKNING
    • Loggfilens sökväg: logs/replication.log
    • Kategorier: com.day.cq.replikation

  4. Om du misstänker att problemet är relaterat till snedstreck/jobb på något sätt, kan du även lägga till det här Java™-paketet under kategorier:org.apache.sling.event

Pausar kön för replikeringsagent pausing-replication-agent-queue

Ibland kan det vara lämpligt att pausa replikeringskön för att minska belastningen på författarsystemet, utan att inaktivera den. Detta är för närvarande endast möjligt om en port konfigureras tillfälligt. Från och med 5.4 kan du se pausknappen i replikeringsagentkön. Den har vissa begränsningar

  1. Tillståndet är inte beständigt, vilket innebär att om du startar om en server eller ett replikeringspaket återställs det till körningsläge.
  2. Pausen är inaktiv under en kortare period (OOB 1 timme efter inga aktiviteter med replikering från andra trådar) och inte under en längre tid. Eftersom det finns en funktion i sling som undviker inaktiva trådar. Kontrollera i princip om en jobbkötråd har varit oanvänd en längre tid, och i så fall startas rensningscyklerna. På grund av rensningscykeln stoppas kopplingen och därför försvinner den pausade inställningen. Eftersom jobb är beständiga initieras en ny tråd för att bearbeta kön som inte har information om den pausade konfigurationen. På grund av den här kön blir det körläge.

Sidbehörigheter replikeras inte vid användaraktivering page-permissions-are-not-replicated-on-user-activation

Sidbehörigheter replikeras inte eftersom de lagras under noderna som åtkomst beviljas till, inte med användaren.

I allmänhet bör sidbehörigheter inte replikeras från författaren till publiceringen och är inte standard. Detta beror på att åtkomsträttigheterna bör vara olika i dessa två miljöer. Därför rekommenderar Adobe att du konfigurerar åtkomstkontrollistor vid publicering, separat från författaren.

Replikeringskön har blockerats vid replikering av namnområdesinformation från författaren till Publish replication-queue-blocked-when-replicating-namespace-information-from-author-to-publish

Ibland blockeras replikeringskön vid försök att replikera namnområdesinformation från författarinstansen till publiceringsinstansen. Detta inträffar eftersom replikeringsanvändaren inte har privilegiet jcr:namespaceManagement. Undvik problemet genom att se till att:

  • Replikeringsanvändaren (som konfigurerats under fliken Transport>Användare) finns också på Publish-instansen.
  • Användaren har läs- och skrivbehörighet på sökvägen där innehållet är installerat.
  • Användaren har privilegiet jcr:namespaceManagement på databasnivå. Du kan bevilja privilegiet enligt följande:
  1. Logga in på CRX/DE ( https://localhost:4502/crx/de/index.jsp) som administratör.
  2. Klicka på fliken Åtkomstkontroll.
  3. Välj Databas.
  4. Klicka på Lägg till post (plusikonen).
  5. Ange användarens namn.
  6. Välj jcr:namespaceManagement i listan över privilegier.
  7. Klicka på OK.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2