Infoga innehåll i Cloud Service ingesting-content
Inmatningsprocess i Cloud Acceleration Manager ingestion-process
Följ stegen nedan för att importera din migreringsuppsättning med Cloud Acceleration Manager:
-
Gå till Cloud Acceleration Manager. Klicka på projektkortet och klicka på kortet för innehållsöverföring. Navigera till Inmatningsjobb och klicka på Nytt inlägg
-
Granska checklistan för konsumtion och se till att alla steg är slutförda. Dessa steg är nödvändiga för att tillförseln ska lyckas. Gå bara till steget Nästa om checklistan är slutförd.
-
Ange nödvändig information för att skapa ett intag.
- Migreringsuppsättning: Välj den migreringsuppsättning som innehåller extraherade data som Source.
- Migreringsuppsättningar kommer att upphöra efter en längre inaktivitetsperiod, så det förväntas att intaget sker relativt snart efter att extraktionen har utförts. Granska migreringsuppsättningen upphör om du vill ha mer information.
note tip TIP Om extraheringen körs visas en dialogruta. När extraheringen har slutförts startas intaget automatiskt. Om extraheringen misslyckas eller stoppas kommer intagningsjobbet att avbrytas. -
Mål: Välj målmiljö. I den här miljön importeras migreringsuppsättningens innehåll.
- Inställningarna stöder inte mål av typen Rapid Development Environment (RDE) eller Preview, och de visas inte som ett möjligt målval, även om användaren har tillgång till det.
- En migreringsuppsättning kan importeras till flera destinationer samtidigt, men målet kan vara att bara ha ett som kör eller väntar på inmatning åt gången.
-
Nivå: Välj nivån. (Författare/Publish).
- Om källan var
Author
rekommenderar vi att du importerar den tillAuthor
-nivån på målet. Om källan varPublish
bör målet också varaPublish
.
- Om källan var
note note NOTE Om målnivån är Author
stängs författarinstansen av under den tid som inmatningen pågår och blir otillgänglig för användare (till exempel författare eller alla som utför underhåll). Orsaken är att skydda systemet och förhindra alla ändringar som antingen kan gå förlorade eller orsaka en konflikt i ett intag. Se till att ditt team är medvetna om detta. Observera också att miljön visas i viloläge under författarintaget.-
Rensa: Välj värdet
Wipe
- Alternativet Rensa anger målets startpunkt för importen. Om Rensa är aktiverat återställs målet inklusive allt innehåll till den version av AEM som är angiven i Cloud Manager. Om det inte är aktiverat behåller målet sitt aktuella innehåll som startpunkt.
- Det här alternativet påverkar INTE hur innehållsintaget kommer att utföras. Inmatningen använder alltid en strategi för innehållsersättning och inte en strategi för innehållssammanfogning, så i både Rensa och Ej rensad kommer inmatningen av en migreringsuppsättning att skriva över innehåll i samma sökväg på målet. Om migreringsuppsättningen till exempel innehåller
/content/page1
och målet redan innehåller/content/page1/product1
, tar det bort helapage1
-sökvägen och dess underordnade sidor, inklusiveproduct1
, och ersätter den med innehållet i migreringsuppsättningen. Detta innebär att noggrann planering måste utföras när du utför ett icke-rensat-inlägg till ett mål som innehåller innehåll som ska behållas. - Icke-rensningsfrågor är särskilt utformade för att användas i det övre intaget. Dessa förslag är avsedda att innehålla en stegvis mängd nytt innehåll som har ändrats sedan det senaste intaget i en befintlig migreringsuppsättning. Genomgående av icke-rensningsfrågor utanför detta användningsfall kan leda till mycket lång intag.
note important IMPORTANT Om inställningen Rensa är aktiverad för den aktuella inmatningen återställs hela den befintliga databasen, inklusive användarbehörigheterna för målinstansen av Cloud Servicen. Den här återställningen gäller även för en admin-användare som har lagts till i gruppen administratörer och den användaren måste läggas till i gruppen Administratörer igen för att kunna starta ett inlägg. -
Förkopia: Välj värdet
Pre-copy
- Du kan köra det valfria förkopieringssteget för att avsevärt snabba upp intaget. Mer information finns i Ingesting with AzCopy.
- Om konsumtion med förkopia används (för S3 eller Azure Data Store) bör du endast köra
Author
-intagning. Om du gör det går det snabbare att få tillgång tillPublish
när det körs senare.
note important IMPORTANT Du kan bara initiera en inmatning till målmiljön om du tillhör den lokala gruppen AEM administratörer i målserverns författartjänst. Om du inte kan påbörja ett inlägg kan du läsa Det går inte att påbörja inmatningen för mer information. - Migreringsuppsättning: Välj den migreringsuppsättning som innehåller extraherade data som Source.
-
När du har valt alternativ för intag visas en uppskattning av dess varaktighet. Detta är en uppskattning av bästa möjliga insats baserad på historiska data om liknande inmatningar.
- Den här uppskattningen beräknas och visas endast om värdena för Kontrollera storlek för extraheringen har samlats in och är tillgängliga.
- Detta värde är en uppskattning och bör inte betraktas som exakt, även om det beräknas på ett intelligent sätt. Olika faktorer kan ändra den faktiska varaktigheten.
- Det här värdet är även tillgängligt i dialogrutan för varaktighet som du kommer åt via åtgärden Visa varaktighet för det aktuella inmatningen när inmatningen körs.
-
Klicka på Infoga.
-
Du kan sedan övervaka intaget från listvyn för förbrukningsjobb och använda matningsens åtgärdsmeny för att visa varaktighet och logg allt eftersom intaget fortskrider.
-
Klicka på knappen (i) på raden om du vill ha mer information om intagsjobbet. Du kan se varaktigheten för varje steg i Inmatningen när den körs eller slutförs genom att klicka på … och sedan på Visa varaktighet. Informationen från extraheringen visar också på vad som förtärs.
Övre inmatning top-up-ingestion-process
Verktyget Innehållsöverföring har en funktion som tillåter extrahering av differentiellt innehåll genom att utföra en top-up av migreringsuppsättningen. Detta gör att migreringsuppsättningen kan ändras så att endast innehåll som har ändrats sedan den föregående extraheringen tas med, utan att allt innehåll behöver extraheras igen.
Om du vill importera differentiellt innehåll efter att en del inmatningsfrågor är slutförda måste du köra en extrahering uppifrån och sedan använda inmatningsmetoden med alternativet Rensa inaktiverat. Läs förklaringen Rensa ovan för att undvika att innehåll som redan finns på målet går förlorat.
Börja med att skapa ett matningsjobb och se till att Rensa är inaktiverat under matningen, vilket visas nedan:
Felsökning troubleshooting
CAM kan inte hämta migreringstoken cam-unable-to-retrieve-the-migration-token
Den automatiska hämtningen av migreringstoken kan misslyckas av olika orsaker, bland annat att konfigurera ett IP-tillåtelselista via Cloud Manager i målservermiljön. I sådana fall visas följande dialogruta när du försöker starta ett intag:
Hämta migreringstoken manuellt genom att klicka på länken Hämta token i dialogrutan. En annan flik öppnas som visar token. Du kan sedan kopiera token och klistra in den i fältet Indata för migreringstoken. Nu borde du kunna påbörja intaget.
Det går inte att starta matning unable-to-start-ingestion
Du kan bara initiera en inmatning till målmiljön om du tillhör den lokala gruppen AEM administratörer i målserverns författartjänst. Om du inte tillhör gruppen AEM administratörer visas ett fel som visas nedan när du försöker starta ett intag. Du kan antingen be din administratör att lägga till dig i de lokala AEM administratörerna eller be om själva token, som du sedan kan klistra in i fältet Migreringstokenindata.
Det gick inte att nå migreringstjänsten unable-to-reach-migration-service
Efter att ett matningsförslag har begärts kan ett meddelande som följande visas för användaren: "Migreringstjänsten i målmiljön är inte tillgänglig. Om så är fallet, försök igen senare eller kontakta supporten för Adobe."
Det här meddelandet anger att Cloud Acceleration Manager inte kunde nå målmiljöns migreringstjänst för att starta inmatningen. Denna situation kan uppstå av olika skäl.
- AEM as a Cloud Service underhåller miljötillståndet och måste ibland starta om migreringstjänsten av olika vanliga orsaker. Om tjänsten startas om kan den inte nås, men är tillgänglig så småningom.
- Det är möjligt att en annan process körs på instansen. Om till exempel AEM versionsuppdateringar tillämpar en uppdatering kan systemet vara upptaget och migreringstjänsten är inte tillgänglig regelbundet. När den processen är klar kan ett nytt försök att starta intaget göras.
- Om ett IP-Tillåtelselista har tillämpats via Cloud Manager blockeras Cloud Acceleration Manager från att nå migreringstjänsten. Det går inte att lägga till en IP-adress för frågor eftersom adressen är dynamisk. För närvarande är den enda lösningen att inaktivera IP-tillåtelselista under importen och indexeringen.
- Det kan finnas andra skäl till att en utredning behöver göras. Om det fortfarande inte går att få tillgång till produkten eller indexeringen kontaktar du Adobe kundtjänst.
AEM och förslag aem-version-updates-and-ingestions
AEM Versionsuppdateringar används automatiskt i miljöer för att hålla dem uppdaterade med den senaste AEM as a Cloud Service-versionen. Om uppdateringen utlöses när ett intag utförs, kan det orsaka oförutsägbara resultat, bland annat skador på miljön.
Om"AEM versionsuppdateringar" introduceras i målprogrammet försöker den att inaktivera kön innan den startar. När inmatningen är klar återställs versionsuppdaterarens tillstånd till det som var innan inmatningen startade.
Om"AEM versionsuppdateringar" är aktiv (d.v.s. uppdateringar körs eller köas för att köras), kommer importen inte att börja och följande meddelande visas i användargränssnittet. När uppdateringarna är klara kan intaget startas. Cloud Manager kan användas för att se aktuell status för programmets rörledningar.
Inmatningsfel i toppklass på grund av Unikhetsbegränsningsöverträdelse top-up-ingestion-failure-due-to-uniqueness-constraint-violation
En vanlig orsak till ett Top-up Inghit-fel är en konflikt i nod-ID:n. Du kan identifiera felet genom att hämta matningsloggen med hjälp av Cloud Acceleration Manager-gränssnittet och leta efter en post som följande:
java.lang.RuntimeException: org.apache.jackrabbit.oak.api.CommitFailedException: OakConstraint0030: Unikhetsvillkoret bröt egenskapen [jcr:uid] med värdet a1a1a1-b2b2-c3c3-d4d4-e5e e5e5e5e5e5: /some/path/jcr:content, /some/other/path/jcr:content
Varje nod i AEM måste ha ett unikt uuid. Detta fel anger att en nod som importeras har samma UID som en som finns på en annan sökväg i målinstansen. Detta kan bero på två orsaker:
- En nod flyttas till källan mellan en extrahering och en efterföljande extrahering uppifrån
- KOM IHÅG: För top-up-extraheringar finns noden fortfarande i migreringsuppsättningen, även om den inte längre finns i källan.
- En nod på destinationen flyttas mellan ett intag och ett efterföljande uppåtgående intag.
Den här konflikten måste lösas manuellt. Någon som är bekant med innehållet måste bestämma vilken av de två noderna som ska tas bort, med hänsyn tagen till annat innehåll som refererar till det. Lösningen kan kräva att extraheringen av den övre delen görs igen utan den felande noden.
Inmatningsfel högst upp på grund av att det inte går att ta bort referensnod top-up-ingestion-failure-due-to-unable-to-delete-referenced-node
En annan vanlig orsak till ett överst inmatningsfel är en versionskonflikt för en viss nod i målinstansen. Du kan identifiera felet genom att hämta matningsloggen med hjälp av Cloud Acceleration Manager-gränssnittet och leta efter en post som följande:
java.lang.RuntimeException: org.apache.jackrabbit.oak.api.CommitFailedException: OakIntegrity001: Det går inte att ta bort refererad nod: 8a2289f4-b904-4bd0-8410-15e41e 0976a8
Detta kan inträffa om en nod på målet ändras mellan ett intag och ett efterföljande icke-rensat-intag så att en ny version har skapats. Om migreringsuppsättningen har extraherats med inkluderingsversioner aktiverat kan en konflikt uppstå eftersom målet nu har en senare version som versionshistorik och annat innehåll refererar till. Det går inte att ta bort den felaktiga versionsnoden eftersom den refereras.
Lösningen kan kräva att extraheringen av den övre delen görs igen utan den felande noden. Eller skapa en liten migreringsuppsättning av den felande noden, men med inkluderingsversioner inaktiverade.
Bästa tillvägagångssätt visar att om ett icke-rensat-inlägg måste köras med en migreringsuppsättning som innehåller versioner är det viktigt att innehållet på målet ändras så lite som möjligt, tills migreringsresan är klar. I annat fall kan dessa konflikter uppstå.
Inmatningsfel på grund av stora nodegenskapsvärden ingestion-failure-due-to-large-node-property-values
Nodegenskapsvärden som lagras i MongoDB får inte överskrida 16 MB. Om ett nodvärde överskrider den storlek som stöds misslyckas importen och loggen innehåller antingen:
- ett
BSONObjectTooLarge
-fel och ange vilken nod som överskrider maxvärdet, eller - ett
BsonMaximumSizeExceededException
-fel, som anger att det finns en nod som sannolikt innehåller unicode-tecken som överskrider den maximala storleken **
Detta är en MongoDB-begränsning.
Mer information finns i Node property value in MongoDB
-anteckningen i Krav för verktyget Innehållsöverföring. Där finns också en länk till ett Oak-verktyg som kan hjälpa dig att hitta alla stora noder. När alla noder med stora storlekar har åtgärdats kör du extraheringen och intaget igen.
Du kan undvika den här begränsningen genom att köra Best Practices Analyzer på AEM källinstans och granska resultatet som visas, särskilt "Repository Structure som inte stöds" (URS) -mönstret.
Inmatningsfel på grund av oväntade återkommande fel ingestion-failure-due-to-unexpected-intermittent-errors
Ibland kan oväntade problem ge upphov till misslyckade frågor där det enda sättet att göra detta är att försöka få igen. Undersök matningsloggen för att ta reda på orsaken till felet och se om den är i linje med något av de fel som anges nedan, där ett nytt försök bör göras.
MongoDB-problem mongo-db-issues
Atlas prescale timeout error
- Inmatningsfasen försöker förskala målmolndatabasen till en lämplig storlek som passar storleken på det migreringsuppsättningsinnehåll som importeras. Oftast slutförs inte den här åtgärden inom den förväntade tidsramen.Exhausted mongo restore retries
- Ett försök att återställa en lokal dump av innehållet i den inkapslade migreringsuppsättningen till molndatabasen har gjorts. Detta tyder på ett övergripande hälso-/nätverksproblem med MongoDB, som ofta läker av sig själv efter några minuter.
Inmatningen har avbrutits ingestion-rescinded
Ett intag som skapades med en pågående extrahering när dess källmigreringsuppsättning väntar tålt tills extraheringen lyckas och börjar då normalt. Om extraheringen misslyckas eller stoppas börjar inte intaget och indexeringsjobbet utan avbryts. I det här fallet kontrollerar du extraheringen för att fastställa varför den misslyckades, åtgärdar problemet och börjar extrahera igen. När den fasta extraheringen körs kan ett nytt intag schemaläggas.
Borttagen resurs finns inte efter upprepat förtäring
I allmänhet rekommenderas inte att du ändrar molnmiljödata mellan de olika förslagen.
När en resurs tas bort från Cloud Servicens mål med Assets Touch-gränssnittet tas noddata bort, men resursens blob med bilden tas inte bort omedelbart. Den är markerad för borttagning så att den inte längre visas i användargränssnittet. Den finns dock kvar i datalagret tills skräpinsamlingen sker och blobben tas bort.
Om en tidigare migrerad resurs tas bort och nästa inmatning körs innan skräpinsamlaren har slutfört borttagningen av resursen, återställs inte den borttagna resursen om samma migreringsuppsättning används. När intaget kontrolleras i molnmiljön för resursen finns det inga noddata. Inmatningen kopierar därför noddata till molnmiljön. När den kontrollerar blobbutiken ser den dock att blobben finns och hoppar över kopieringen av blobben. Det är därför som metadata förekommer när du tittar på resursen från Touch-gränssnittet, men bilden är inte det. Kom ihåg att migreringsuppsättningar och innehåll inte har utformats för att hantera det här fallet. De vill lägga till nytt innehåll i molnmiljön och inte återställa tidigare migrerat innehåll.
What's Next whats-next
När importen är klar AEM indexeringen startas automatiskt. Mer information finns i Indexera efter att du har migrerat innehåll.
När du har slutfört Inkludering av innehåll i Cloud Servicen kan du visa loggar för varje steg (extrahering och förtäring) och leta efter fel. Mer information finns i Visa loggar för en migreringsuppsättning.