Migrering av icke-UID till UUID-innehåll id226TI0U20XA
Följ de här stegen för att migrera ditt innehåll från version 4.3.1 som inte är UUID till version 4.3.2.
-
Innan du startar migreringsprocessen bör du kontrollera att du har:
- Alla aktiva granskningar stängdes.
- Alla översättningsuppgifter stängdes.
-
Innan du migrerar innehåll till UUID-servern kontrollerar du att du har en icke-UID-server med en kompatibel AEM Guides-version installerad på den.
-
Om du använder en version före 4.3.1 ska du uppgradera till version 4.3.1. Följ de uppgraderingsinstruktioner som är specifika för den licensierade versionen av din produkt.
-
För närvarande stöds inte versioner efter 4.3.1 för migrering.
Paketinstallation
Hämta de paket som behövs från Adobe Software Distribution Portal, baserat på din version:
- Före migrering: com.adobe.guides.pre-uid-migration-1.2.27.zip
- Hämta UUID version 4.3.2: com.adobe.fmdita-6.5-uuid-4.3.2.1977.zip
- Migrering: com.adobe.guides.uid-upgrade-1.2.110.zip
Kontroller före migrering
Gör följande kontroller av icke-UID version 4.3.1:
-
Installera paketet com.adobe.guides.pre-uid-migration-1.2.27.zip över version 4.3.1.
note note NOTE - Du måste ha administratörsbehörighet för att kunna utföra migreringen.
- Du bör åtgärda filerna med fel innan du fortsätter med migreringen.
-
Om det finns fler än 100 000 DITA-filer i systemet uppdaterar du frågebegränsningskonfigurationerna så att skriptet fungerar:
- Navigera till
/system/console/configMgr and increase both the configs to more than number of assets - queryLimitInMemory
ochqueryLimitReads under org.apache.jackrabbit.oak.query.QueryEngineSettingsService
- Navigera till
-
Starta
http://<server-name>/libs/fmdita/clientlibs/xmleditor_uuid_upgrade/page.html
. -
Välj Kompatibilitetsutvärdering i den vänstra panelen och bläddra i mappsökvägen
/content/dam
för alla resurser. -
Kontrollera kompatibiliteten för att lista följande information:
- Totalt antal filer
- Beräknad tid för migrering
- Antal filer med fel
- Filer med GUID-filnamn
-
Om felet uppstår analyserar du loggarna och åtgärdar felen. Du kan köra kompatibilitetsmatrisen igen när du har åtgärdat felen.
-
Välj Konfigurera valideringar på den vänstra panelen. Välj sedan karta och Välj förinställning för kartan för att konfigurera dem. Den aktuella utdatavalideringslistan visar de utdatafiler som finns före migreringen och kan valideras mot de utdatafiler som genereras efter migreringen senare.
Genom att markera flera och stora DITA-kartor kan du validera att allt innehåll har migrerats utan problem. Genom att markera förinställningar med baslinjer i dem kan du även vara säker på att baslinjer och versioner migreras korrekt.
-
(Valfritt) Rensa innehållet i version för att ta bort onödiga versioner och snabba upp migreringsprocessen. Om du vill rensa versionen väljer du alternativet Rensa version på migreringsskärmen och går till användargränssnittet med URL:en
http://<server- name>/libs/fmdita/clientlibs/xmleditor_uuid_upgrade/page.html
.note note NOTE Verktyget tar inte bort versioner som används i baslinjer eller granskningar och har inga etiketter.
Mer information finns i Rensa äldre versioner.
Krav för migrering
-
Kör endast UUID-migrering på en Author-instans.
-
Säkerställ följande infrastrukturberedskap:
- Författarinstansen har uppgraderats i CPU och minne för att ge snabbare bearbetning och ytterligare minne som behövs för satsaktivitet. Om till exempel den aktuella allokerade processorn och minnet är 8 vCPU och 24 GB heap ska du använda dubbla storleken för den här aktiviteten.
- Det totala diskutrymmet och det tillfälliga diskutrymmet
(crx-quickstart directory)
bör ha en buffert på 10 gånger det som redan har förbrukats. När du är klar med migreringen kan du återvinna större delen av diskutrymmet genom att köra en komprimering. - Kör Offlinemålkomprimering innan du startar den här aktiviteten.
- Se till att ingen indexering eller inget systemunderhåll planeras under migreringens fönster.
-
Installera UUID-versionen av den version som stöds över den version som inte är UUID. Om du t.ex. använder 4.3.1 icke-UUID-bygge måste du installera UUID version 4.3.2 com.adobe.fmdita-6.5-uuid-4.3.2.1977.zip) och köra migreringen.
-
Installera uppgraderingspaketet för UID-migrering com.adobe.guides.uid-upgrade-1.2.110.zip.
-
Inaktivera startprogram för följande arbetsflöden med URL
http://<server-name>/libs/cq/workflow/content/console.html
.- Arbetsflöde för DAM-uppdatering
- Arbetsflöde för DAM-metadataåterställning
note note NOTE Alla arbetsflödesstarter som körs på alla sökvägar i content/dam
bör helst inaktiveras. -
Uppdatera följande konfigurationer enligt de föreslagna ändringarna:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 Konfiguration Egenskap Värde com.adobe.fmdita.config.ConfigManager
Aktivera startprogram för arbetsflöde efter bearbetning Inaktivera com.adobe.fmdita.config.ConfigManager
uuid. regex ^GUID-(?<id>.*)
com.adobe.fmdita.postprocess.version.PostProcessVersionObservation
Aktivera efterbearbetning av version Inaktivera Dag CQ-taggningstjänst Aktivera validering (validation.enabled) Inaktivera -
Lägg till en separat loggare för:
com.adobe.fmdita.uuid
com.adobe.guides.uuid
.
-
(Om det inte har gjorts tidigare) Om det finns fler än 100 000 DITA-filer i systemet uppdaterar du
queryLimitReads
underorg.apache.jackrabbit.oak.query.QueryEngineSettingsService
till ett större värde (vilket värde som helst som är större än antalet resurser, till exempel 200 000).table 0-row-3 1-row-3 PID Egenskapsnyckel Egenskapsvärde org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Värde: 200000
standardvärde: 100000
Migrering
-
Starta
http://<server-name>/libs/fmdita/clientlibs/xmleditor_uuid_upgrade/page.html
.note note NOTE Om du väljer Aktivera säkerhetskopiering av DITA-resurser lagras de temporära säkerhetskopiorna under /content/uuid-upgrade
och DITA-säkerhetskopiorna tas bort när migreringen av en fil är klar. -
Välj Systemuppgradering i den vänstra panelen för att köra migreringen. Vi rekommenderar att du migrerar alla data samtidigt eftersom systemet optimalt hanterar gruppering internt. Endast filer som inte är DITA-resurser och som inte används i några DITA-resurser kan hoppas över för migrering.
-
(Valfritt) Markera de mappar som du vill hoppa över migreringen för. Använd det här alternativet om du vill migrera de här mapparna senare eller hoppa över att migrera dem. Se till att dessa mappar inte har några DITA-resurser och att de inte refereras av (och i framtiden kommer inte att refereras till) några DITA-resurser. Exempel:
content/dam/projects
. -
Välj Aktivera säkerhetskopiering av datatillgångar om du vill skapa en säkerhetskopia av resursen före migrering. Den här säkerhetskopian används för att återställa om det uppstår ett fel när en fil migreras. Säkerhetskopian tas bort om migreringen lyckas. Detta saktar dock ned migreringsprocessen.
-
Starta migreringen.
note note NOTE Ladda ned de fullständiga loggarna och observera om det finns några fel. Om något fel eller undantag hittas Fortsätt inte, men åtgärda felet först. Vanliga fel visas i slutet av artikeln. -
När migreringen är klar är rapporten tillgänglig för hämtning och hela loggar kan också hämtas.
-
Välj Hämta rapport när migreringen körs för att kontrollera om alla filer i mappen har uppgraderats korrekt och om alla funktioner bara fungerar för den mappen.
note note NOTE Innehållsmigreringen kan köras på en mappnivå, hela /content/dam
eller samma mapp (kör migreringen igen).Det är också viktigt att se till att innehållsmigreringen görs för alla medieresurser, till exempel bilder och grafik som du har använt i DITA-innehållet.
-
När alla filer har migrerats väljer du Originalplan/Granska uppgradering i den vänstra panelen för att migrera baslinjerna och granska på mappnivå.
Analysera rapporter från varje steg
Steg: Systemuppgradering
Steg: Uppgradera baslinjer
baselineObj not found on
Efter migrering
-
När migreringen är klar väljer du Verifiera systemuppgradering på den vänstra panelen och validerar utdatafilerna före och efter migreringen för att säkerställa att migreringen lyckas.
-
När servern har migrerats kan du aktivera följande arbetsflöden och konfigurationer (inklusive alla andra arbetsflöden som inaktiverades från början under migreringen) för att fortsätta arbeta på servern:
- Arbetsflöde för DAM-uppdatering
- Arbetsflöde för DAM-metadata
note note NOTE Helst ska alla arbetsflödesstarter som kördes på alla sökvägar i content/dam
före migreringen aktiveras. -
Aktivera följande konfigurationer:
table 0-row-3 1-row-3 2-row-3 3-row-3 Konfiguration Egenskap Värde com.adobe.fmdita.config.ConfigManager
Aktivera startprogram för arbetsflöde efter bearbetning Aktivera com.adobe.fmdita.postprocess.version.PostProcessVersionObservation
Aktivera efterbearbetning av version Aktivera Dag CQ-taggningstjänst Aktivera validering (validation.enabled) Aktivera -
Assets-egenskaper för granskning efter migrering:
table 0-row-4 1-row-4 Konfiguration Egenskap Värde före migrering på icke-UID Eftermigreringsvärde på UID com.adobe.fmdita.config.ConfigManager
Använd rubrik AEM webbplatsens sidnamn Falskt (standardvärde) True note note NOTE Om egenskapen Använd rubrik för AEM webbplatssidnamn i com.adobe.fmdita.config.ConfigManager
anges till Falskt före migreringen, måste den här egenskapen uppdateras efter migreringen. -
När valideringen är klar kan större delen av diskutrymmet återvinnas genom att en komprimering körs (se
https://experienceleague.adobe.com/docs/experience-manager-65/deploying/deploying/revision-cleanup.html?lang=en
).