DokumentationAEM 6.4Användarhandbok om distribution

Avlastar jobb offloading-jobs

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Developer
CAUTION
AEM 6.4 har nått slutet på den utökade supporten och denna dokumentation är inte längre uppdaterad. Mer information finns i teknisk supportperiod. Hitta de versioner som stöds här.

Introduktion introduction

Avlastning av distribuerar bearbetningsuppgifter som är Experience Manager instanser i en topologi. Med avlastning kan du använda särskilda Experience Manager-instanser för att utföra vissa typer av bearbetning. Specialiserad bearbetning gör att du kan maximera användningen av tillgängliga serverresurser.

Avlastningen baseras på Apache Sling Discovery och Sling JobManager-funktioner. Om du vill använda avlastning lägger du till Experience Manager-kluster i en topologi och identifierar de jobbämnen som klusterprocessen gör. Kluster består av en eller flera instanser av Experience Manager, så att en enda instans betraktas som ett kluster.

Mer information om hur du lägger till instanser i en topologi finns i Administrera topologier.

Jobbdistribution job-distribution

Med Sling JobManager och JobConsumer kan du skapa jobb som bearbetas i en topologi:

  • JobManager: En tjänst som skapar jobb för specifika ämnen.
  • JobConsumer: En tjänst som kör jobb i ett eller flera ämnen. Flera JobConsumer-tjänster kan registreras för samma ämne.

När JobManager skapar ett jobb väljer avlastningsramverket ett Experience Manager-kluster i topologin för att köra jobbet:

  • Klustret måste innehålla en eller flera instanser som kör en JobConsumer som är registrerad för jobbämnet.
  • Ämnet måste aktiveras för minst en instans i klustret.

Se Konfigurera ämnesförbrukning om du vill ha information om hur du finjusterar jobbdistributionen.

chlimage_1-109

När avlastningsramverket väljer ett kluster för att köra ett jobb, och klienten består av flera instanser, avgör Sling Distribution vilken instans i klustret som kör jobbet.

Jobbnyttolaster job-payloads

Avlastningsramverket stöder jobbnyttolaster som associerar jobb med resurser i databasen. Jobbnyttolaster är användbara när jobb skapas för att bearbeta resurser och jobbet avlastas till en annan dator.

När ett jobb skapas garanteras nyttolasten bara finnas på instansen som skapar jobbet. När du avlastar jobbet ser replikeringsagenterna till att nyttolasten skapas på instansen som till slut förbrukar jobbet. När jobbkörningen är klar kopieras nyttolasten tillbaka till instansen som skapade jobbet.

Administrera topologier administering-topologies

Topologier är löst kopplade Experience Manager-kluster som deltar i avlastning. Ett kluster består av en eller flera Experience Manager-serverinstanser (en enda instans betraktas som ett kluster).

Varje instans i Experience Manager kör följande avlastningsrelaterade tjänster:

  • Discovery Service: Skickar begäranden till en Topology Connector om att gå med i topologin.
  • Topology Connector: Tar emot kopplingsbegäranden och godkänner eller avvisar varje begäran.

Identifieringstjänsten för alla medlemmar i topologin pekar på Topology Connector på en av medlemmarna. I efterföljande avsnitt kallas den här medlemmen rotmedlem.

chlimage_1-110

Varje kluster i topologin innehåller en instans som identifieras som ledare. Klusterledaren interagerar med topologin för de andra medlemmarna i klustret. När ledaren lämnar klustret väljs automatiskt en ny ledare för klustret.

Visa topologin viewing-the-topology

Använd Topology Browser för att utforska läget för topologin där Experience Manager-instansen deltar. Topology Browser visar kluster och instanser av topologin.

För varje kluster visas en lista med klustermedlemmar som anger i vilken ordning varje medlem har anslutit till klustret och vilken medlem som är ledare. Egenskapen Current anger instansen som du för närvarande administrerar.

För varje instans i klustret kan du se flera topologirelaterade egenskaper:

  • En tillåtelselista med ämnen för förekomstens jobbkonsument.
  • De slutpunkter som exponeras för anslutning till topologin.
  • De jobbämnen som instansen är registrerad för avlastning för.
  • Jobbämnena som instansen bearbetar.

  1. Klicka på fliken Verktyg med Touch-gränssnittet. (http://localhost:4502/tools.html)

  2. Klicka på Avlastningsläsaren i området Beskärningsåtgärder.

  3. Klicka på Topology Browser i navigeringspanelen.

    De kluster som ingår i topologin visas.

    chlimage_1-111

  4. Klicka på ett kluster för att visa en lista över instanserna i klustret och deras ID, Aktuell status och Ledarstatus.

  5. Klicka på ett instans-ID om du vill se mer detaljerade egenskaper.

Du kan också använda webbkonsolen för att visa topologiinformation. Konsolen ger mer information om topologiklustren:

  • Vilken instans är den lokala instansen.
  • Topology Connector-tjänsterna som den här instansen använder för att ansluta till topologin (utgående) och tjänsterna som ansluter till den här instansen (inkommande).
  • Ändringshistorik för topologi- och instansegenskaperna.

Gör så här för att öppna sidan Topology Management i webbkonsolen:

  1. Öppna webbkonsolen i webbläsaren. (http://localhost:4502/system/console)

  2. Klicka på Meny > Topologihantering.

    chlimage_1-112

Konfigurera topologimedlemskap configuring-topology-membership

Resursbaserad sökningstjänst för Apache Sling körs på varje instans för att styra hur instanser från Experience Manager interagerar med en topologi.

Identifieringstjänsten skickar periodiska POSTER (hjärtslag) till Topology Connector-tjänster för att upprätta och underhålla kopplingar till topologin. Topology Connector-tjänsten underhåller en tillåtelselista med IP-adresser eller värdnamn som kan ansluta till topologin:

  • Om du vill koppla en instans till en topologi anger du URL:en för Topology Connector-tjänsten för rotmedlemmen.
  • Om du vill göra det möjligt för en instans att ansluta till en topologi lägger du till instansen tillåtelselista i rotmedlemmens Topology Connector-tjänst.

Använd webbkonsolen eller en sling:OsgiConfig-nod för att konfigurera följande egenskaper för tjänsten org.apache.sling.discovery.impt.Config:

Egenskapsnamn
OSGi-namn
Beskrivning
Standardvärde
Timeout för pulsslag (sekunder)
hjärtslagTimeout
Hur lång tid i sekunder det tar att vänta på ett pulsslagssvar innan målinstansen anses vara otillgänglig.
20
Intervall för pulsslag (sekunder)
hjärtslagIntervall
Tiden i sekunder mellan hjärtslag.
15
Minimal händelsefördröjning (sekunder)
minEventDelay

När en ändring görs i topologin, den tid det tar att fördröja ändringen av tillståndet från TOPOLOGY_CHANGING till TOPOLOGY_CHANGED. Varje ändring som inträffar när läget är TOPOLOGY_CHANGING ökar fördröjningen med den här tiden.

Den här fördröjningen förhindrar att avlyssnare översvämmas av händelser.

Om du inte vill använda någon fördröjning anger du 0 eller ett negativt tal.

3
Topology Connector-URL:er
topologyConnectorUrls
URL:erna för Topology Connector-tjänsterna som skickar meddelanden om hjärtslag.
http://localhost:4502/libs/sling/topology/connector
Topology Connector tillåtelselista
topologyConnectorWhitelist
Listan över IP-adresser eller värdnamn som tillåts av den lokala Topology Connector-tjänsten i topologin.

localhost

127.0.0.1

Databasbeskrivningsnamn
leaderValectionRepositoryDescriptor
<no value>

Använd följande procedur för att ansluta en CQ-instans till rotmedlemmen i en topologi. Proceduren pekar instansen mot Topology Connector-URL:en för rotopologimedlemmen. Utför den här proceduren på alla medlemmar i topologin.

  1. Öppna webbkonsolen i webbläsaren. (http://localhost:4502/system/console)
  2. Klicka på Meny > Topologihantering.
  3. Klicka på Konfigurera sökningstjänst.
  4. Lägg till ett objekt i egenskapen Topology Connector URL:er och ange URL:en för rotopologimedlemmens Topology Connector-tjänst. URL:en har formatet https://rootservername:4502/libs/sling/topology/connector.

Utför följande procedur på rotmedlemmen i topologin. Proceduren lägger till namnen på de andra topologimedlemmarna i tillåtelselista för sökningstjänsten.

  1. Öppna webbkonsolen i webbläsaren. (http://localhost:4502/system/console)
  2. Klicka på Meny > Topologihantering.
  3. Klicka på Konfigurera sökningstjänst.
  4. För varje medlem i topologin lägger du till ett objekt i tillåtelselista-egenskapen Topology Connector och anger värdnamnet eller IP-adressen för topologimedlemmen.

Konfigurera ämnesförbrukning configuring-topic-consumption

Använd Avlastningsläsaren för att konfigurera ämnesförbrukning för Experience Manager-instanserna i topologin. För varje förekomst kan du ange ämnen som den upptar. Om du till exempel vill konfigurera din topologi så att endast en instans förbrukar ämnen av en viss typ, inaktiverar du ämnet för alla instanser utom en.

Jobb distribueras som summeringsinstanser där det associerade ämnet är aktiverat med hjälp av resurslogik.

  1. Klicka på fliken Verktyg med Touch-gränssnittet. (http://localhost:4502/tools.html)

  2. Klicka på Avlastningsläsaren i området Beskärningsåtgärder.

  3. Klicka på Avlasta webbläsare i navigeringspanelen.

    Avlastande ämnen och serverinstanser som kan förbruka ämnena visas.

    chlimage_1-113

  4. Om du vill inaktivera användningen av ett ämne för en instans klickar du under ämnesnamnet på Inaktivera bredvid instansen.

  5. Om du vill konfigurera all ämnesförbrukning för en instans klickar du på förekomdentifieraren under ett ämne.

    chlimage_1-114

  6. Klicka på någon av följande knappar bredvid ett ämne för att konfigurera konsumtionsbeteendet för instansen och klicka sedan på Spara:

    • Aktiverad: Den här instansen förbrukar jobb i det här avsnittet.
    • Inaktiverad: Den här instansen förbrukar inte jobb i det här avsnittet.
    • Exklusivt: Den här instansen förbrukar endast jobb i det här avsnittet.

    Obs! När du väljer Exklusiv för ett ämne ställs alla andra ämnen automatiskt in på Inaktiverad.

Installerade jobbkonsumenter installed-job-consumers

Flera JobConsumer-implementeringar installeras med Experience Manager. Ämnen som dessa JobConsumers är registrerade för visas i Avläsningsläsaren. Ytterligare ämnen som visas är de som anpassade JobConsumers har registrerat. I följande tabell beskrivs JobConsumers som är standard.

Jobbämne
Tjänst-PID
Beskrivning
/
org.apache.sling.event.impl.jobs.deprecated.EventAdminBridge
Installerat med Apache Sling. Bearbetar jobb som genereras av OSGi-händelseadministratören för bakåtkompatibilitet.
com/day/cq/replication/job/*
com.day.cq.replication.impl.AgentManagerImpl
En replikeringsagent som replikerar jobbnyttolaster.
com/adobe/granite/workflow/offloading
com.adobe.granite.workflow.core.offloading.WorkflowOffloadingJobConsumer
Bearbetar jobb som genereras av arbetsflödet DAM Update Asset Offloader.

Inaktivera och aktivera ämnen för en instans disabling-and-enabling-topics-for-an-instance

Tjänsten Apache Sling Job Consumer Manager innehåller egenskaperna tillåtelselista och blockeringslista. Konfigurera dessa egenskaper för att aktivera eller inaktivera bearbetning av specifika ämnen i en Experience Manager-instans.

Obs! Om instansen tillhör en topologi kan du även använda Avlastningsläsaren på vilken dator som helst i topologin för att aktivera eller inaktivera ämnen.

Den logik som skapar listan med aktiverade ämnen tillåter först alla ämnen som finns i tillåtelselista och tar sedan bort ämnen som finns i blockeringslista. Som standard aktiveras alla ämnen (värdet tillåtelselista är *) och inga ämnen är inaktiverade (blockeringslista har inget värde).

Använd webbkonsol eller en sling:OsgiConfig -nod för att konfigurera följande egenskaper. För sling:OsgiConfig noder, PID för tjänsten Job Consumer Manager är org.apache.sling.event.impl.job.JobConsumerManager.

Egenskapsnamn i webbkonsolen
OSGi ID
Beskrivning
Ämnesvitlista
job.consumermanager.whitelist
En lista med ämnen som den lokala JobManager-tjänsten bearbetar. Standardvärdet för * skickar alla ämnen till den registrerade TopicConsumer-tjänsten.
Ämnessvartlista
job.consumermanager.blacklist
En lista med ämnen som den lokala JobManager-tjänsten inte bearbetar.

Skapar replikeringsagenter för avlastning creating-replication-agents-for-offloading

Avlastningsramverket använder replikering för att transportera resurser mellan författare och arbetare. Ramverket för avlastning skapar automatiskt replikeringsagenter när instanser ansluts till topologin. Agenterna skapas med standardvärden. Du måste ändra lösenordet som agenterna använder för autentisering manuellt.

CAUTION
Ett känt problem med de automatiskt genererade replikeringsagenterna kräver att du skapar nya replikeringsagenter manuellt. Följ proceduren i Problem med att använda automatiskt genererade replikeringsagenter innan du skapar agenterna för avlastning.

Skapa de replikeringsagenter som transporterar jobbnyttolaster mellan instanser för avlastning. Följande bild visar de agenter som krävs för att avlasta författaren till en arbetarinstans. Författaren har ett Sling-ID på 1 och arbetarinstansen har ett Sling-ID på 2:

chlimage_1-115

Installationen kräver följande tre agenter:

  1. En utgående agent på författarinstansen som replikeras till arbetarinstansen.
  2. En omvänd agent på författarinstansen som hämtas från utkorgen på arbetarinstansen.
  3. En utkorgsagent på arbetarinstansen.

Replikeringsschemat liknar det som används mellan författare och publiceringsinstanser. I avlastningssituationen är dock alla instanser aktuella.

NOTE
Avlastningsramverket använder topologin för att hämta IP-adresserna för avlastningsinstanserna. Replikeringsagenterna skapas sedan automatiskt i ramverket baserat på dessa IP-adresser. Om IP-adresserna för avlastningsinstanserna ändras senare kommer ändringen automatiskt att utföras i topologin när instansen startas om. Däremot uppdaterar inte ramverket för avlastning automatiskt replikeringsagenterna så att de motsvarar de nya IP-adresserna. Du kan undvika den här situationen genom att använda fasta IP-adresser för alla instanser i topologin.

Namnge replikeringsagenter för avlastning naming-the-replication-agents-for-offloading

Använd ett specifikt format för Namn egenskapen för replikeringsagenterna så att avlastningsramverket automatiskt använder rätt agent för specifika arbetarinstanser.

Namnge den utgående agenten på författarinstansen:

offloading_<slingid>, där <slingid> är Sling-ID för arbetarinstansen.

Exempel: offloading_f5c8494a-4220-49b8-b079-360a72f71559

Namnge den omvända agenten på författarinstansen:

offloading_reverse_<slingid>, där <slingid> är Sling-ID för arbetarinstansen.

Exempel: offloading_reverse_f5c8494a-4220-49b8-b079-360a72f71559

Namnge utkorgen på arbetarinstansen:

offloading_outbox

Skapar den utgående agenten creating-the-outgoing-agent

  1. Skapa en Replikeringsagent på författaren. (Se dokument för replikeringsagenter). Ange Titel. The Namn måste följa namnkonventionen.

  2. Skapa agenten med följande egenskaper:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
    Egenskap Värde
    Inställningar > Serialiseringstyp Standard
    Transport >Transport-URI https://<ip of target instance>:<port>/bin/receive?sling:authRequestLogin=1
    Transport > Transportanvändare Replikeringsanvändare i målinstansen
    Transport >Transportlösenord Lösenord för replikeringsanvändare för målinstans
    Extended > HTTP Method POST
    Utlösare > Ignorera standard True

Skapar den omvända agenten creating-the-reverse-agent

  1. Skapa en Agenten för omvänd replikering på författaren. (Se dokument för replikeringsagenter.) Ange Titel. The Namn måste följa namnkonventionen.

  2. Skapa agenten med följande egenskaper:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
    Egenskap Värde
    Inställningar > Serialiseringstyp Standard
    Transport >Transport-URI https://<ip of target instance>:<port>/bin/receive?sling:authRequestLogin=1
    Transport > Transportanvändare Replikeringsanvändare i målinstansen
    Transport >Transportlösenord Lösenord för replikeringsanvändare för målinstans
    Extended > HTTP Method GET

Skapa en utkorgsagent creating-the-outbox-agent

  1. Skapa en Replikeringsagent på arbetarinstansen. (Se dokument för replikeringsagenter.) Ange Titel. The Namn måste vara offloading_outbox.

  2. Skapa agenten med följande egenskaper.

    table 0-row-2 1-row-2 2-row-2 3-row-2
    Egenskap Värde
    Inställningar > Serialiseringstyp Standard
    Transport >Transport-URI repo://var/replication/outbox
    Utlösare > Ignorera standard True

Sling ID hittas finding-the-sling-id

Hämta Sling ID för en Experience Manager-instans med någon av följande metoder:

  • Öppna webbkonsolen och i Sling-inställningarna hittar du värdet för egenskapen Sling ID (http://localhost:4502/system/console/status-slingsettings). Den här metoden är användbar om instansen ännu inte ingår i topologin.
  • Använd Topology-webbläsaren om instansen redan är en del av topologin.

Avlasta bearbetning av DAM-resurser offloading-the-processing-of-dam-assets

Konfigurera instanserna av en topologi så att specifika instanser utför bakgrundsbearbetningen av resurser som läggs till eller uppdateras i DAM.

Som standard kör Experience Manager arbetsflödet DAM Update Asset när en DAM-resurs ändras eller en resurs läggs till i DAM. Ändra standardbeteendet så att Experience Manager i stället kör arbetsflödet DAM Update Asset Offloader. Det här arbetsflödet genererar ett JobManager-jobb som har ett ämne i com/adobe/granite/workflow/offloading. Konfigurera sedan topologin så att jobbet skickas till en dedikerad arbetare.

CAUTION
Inget arbetsflöde ska vara tillfälligt när det används med arbetsflödesavlastning. Arbetsflödet för DAM-uppdatering av tillgångar får till exempel inte vara övergående när det används för avlastning av resurser. Information om hur du anger/tar bort den tillfälliga flaggan i ett arbetsflöde finns i Övergående arbetsflöden.

Följande procedur utgår från följande egenskaper för avlastningstopologin:

  • En eller flera Experience Manager-instanser är redigeringsinstanser som användare interagerar med för att lägga till eller uppdatera DAM-resurser.
  • Användare som inte interagerar direkt med en eller flera Experience Manager-instanser som bearbetar DAM-resurserna. De här instanserna är dedikerade till bakgrundsbearbetning av DAM-resurser.

  1. Konfigurera sökningstjänsten för varje Experience Manager-instans så att den pekar på rotkonnektorn för topografi. (Se Konfigurera topologimedlemskap.)

  2. Konfigurera Topography Connector för roten så att anslutande instanser finns på tillåtelselista.

  3. Öppna Avlastningsläsaren och inaktivera com/adobe/granite/workflow/offloading Information om de instanser med vilka användarna interagerar för att överföra eller ändra DAM-resurser.

    chlimage_1-116

  4. För varje instans som användare interagerar med för att överföra eller ändra DAM-resurser, ska du konfigurera arbetsflödesstarter så att arbetsflödet för DAM Update Asset Offloading används:

    1. Öppna arbetsflödeskonsolen.
    2. Klicka på fliken Launcher.
    3. Leta reda på de två startkonfigurationer som kör arbetsflödet DAM Update Asset. En startkonfigurationshändelsetyp är Node Created och den andra är Node Modified.
    4. Ändra båda händelsetyperna så att de kör arbetsflödet DAM Update Asset Offloading. (Mer information om startkonfigurationer finns i Starta arbetsflöden när noder ändras.)

  5. Inaktivera arbetsflödet som startar DAM Update Asset-arbetsflödet för de instanser som utför bakgrundsbearbetning av DAM-resurser.

Ytterligare läsning further-reading

Förutom informationen på den här sidan kan du läsa följande:

recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56