DocumentatieAEM GuidesDocumentatie voor AEM Guides

Migratie van niet-UUID naar UUID-inhoud id226TI0U20XA

Last update: Thu Sep 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Ervaren
  • Beheerder

Voer de volgende stappen uit om uw inhoud te migreren van niet-UUID versie 4.3.1 naar UUID versie 4.3.2.

IMPORTANT

  • Voordat u het migratieproces start, moet u controleren of:

    1. Alle actieve revisies zijn gesloten.
    2. Alle vertaaltaken zijn afgesloten.

  • Voordat u inhoud migreert naar de UUID-server, moet u controleren of er een niet-UUID-server is geïnstalleerd waarop een compatibele AEM Guides-versie is geïnstalleerd.

  • Als u een versie gebruikt die ouder is dan 4.3.1, voert u een upgrade uit naar versie 4.3.1. Volg de verbeteringsinstructiesspecifiek voor de vergunning gegeven versie van uw product.

  • Momenteel worden versies na 4.3.1 niet ondersteund voor migratie.

Pakketinstallatie

Download de vereiste pakketten van het Portaal van de Distributie van de Software van de Adobe, die op uw versie wordt gebaseerd:

  1. pre-migratie: com.adobe.guides.pre-uuid-migratie-1.2.27.zip
  2. versie van UUID van de Download UUID 4.3.2: com.adobe.fmdita-6.5-uuid-4.3.2.1977.zip
  3. Migratie: com.adobe.guides.uuid-verbetering-1.2.110.zip

Premigratiecontroles

Voer de volgende controles uit op niet-UUID versie 4.3.1:

  1. Installeer het pre-migratiepakket com.adobe.guides.pre-uuid-migratie-1.2.27.zipover versie 4.3.1.

    note note
    NOTE
    • U hebt beheerdersmachtigingen nodig om de migratie uit te voeren.
    • Het wordt aanbevolen de bestanden met fouten te corrigeren voordat u verdergaat met de migratie.

  2. Als er meer dan 100.000 DITA- dossiers in het systeem zijn, werk de configuratie van de vraaggrens voor het manuscript bij om te werken:

    • Navigeren naar /system/console/configMgr and increase both the configs to more than number of assets - queryLimitInMemory en queryLimitReads under org.apache.jackrabbit.oak.query.QueryEngineSettingsService

  3. Start http://<server-name>/libs/fmdita/clientlibs/xmleditor_uuid_upgrade/page.html .

  4. Selecteer Beoordeling van de Verenigbaarheid van het linkerpaneel en doorblader de /content/dam omslagweg voor alle activa.

  5. Controleer de compatibiliteit om de volgende informatie weer te geven:

    • Totaal aantal bestanden
    • Geschatte tijd voor migratie
    • Aantal bestanden met fouten
    • Bestanden met GUID-bestandsnaam

    lusje van de verenigbaarheidsbeoordeling in migratie

  6. Als de fout verschijnt, analyseert u de logboeken en corrigeert u deze fouten. U kunt de compatibiliteitsmatrix opnieuw uitvoeren nadat u de fouten hebt gecorrigeerd.

  7. Selecteer vormen Bevestigingen van het linkerpaneel. Dan, Uitgezochte kaart en Uitgezochte vooraf ingesteld van de kaart om hen te vormen. De huidige lijst van de outputbevestiging toont de outputdossiers aanwezig vóór migratie en kan tegen de outputdossiers worden bevestigd die na migratie later worden geproduceerd.

    Door meerdere en grote DITA-kaarten te selecteren, kunt u controleren of alle inhoud zonder problemen is gemigreerd. Als u voorinstellingen met basislijnen selecteert, zorgt u er ook voor dat basislijnen en versies correct worden gemigreerd.

    vormt het lusje van Bevestigingen in migratie

  8. (Optioneel) Voer versiebeheer uit op de inhoud om overbodige versies te verwijderen en het migratieproces te versnellen. Om versie het zuiveren uit te voeren, selecteer de optie Woorden van de Versie van het migratiescherm en ga naar het gebruikersinterface gebruikend URL http://<server- name>/libs/fmdita/clientlibs/xmleditor_uuid_upgrade/page.html.

    note note
    NOTE
    Dit hulpprogramma verwijdert geen versies die in basislijnen of revisies worden gebruikt of heeft labels.

Voor meer details, zuiveren de mening oudere versies.

Migratievoorwaarden

  1. UUID-migratie alleen uitvoeren op een instantie Auteur.

  2. Ervoor zorgen dat de infrastructuur gereed is:

    • Auteur-instantie wordt qua CPU en geheugen vergroot om snellere verwerking en extra geheugen te ondersteunen die nodig zijn voor bulkactiviteiten. Als de momenteel toegewezen CPU en geheugen bijvoorbeeld 8 vCPU en 24 GB heap zijn, moet u deze activiteit tweemaal zo groot maken.
    • De totale schijfruimte en de tijdelijke schijfruimte (crx-quickstart directory) zouden een buffer van tien keer moeten hebben wat reeds wordt verbruikt. Nadat u de migratie hebt voltooid, kunt u het grootste deel van de schijfruimte vrijmaken door een compacte toepassing uit te voeren.
    • Stelt Offline Tar samenpersen alvorens deze activiteit te beginnen.
    • Zorg ervoor dat er tijdens het venster van deze migratie geen indexering of systeemonderhoud wordt gepland.

  3. Installeer de UUID-versie van de ondersteunde versie op de niet-UUID-versie. Bijvoorbeeld, als u 4.3.1 niet-UUID bouwt gebruikt, moet u versie UUID 4.3.2 com.adobe.fmdita-6.5-uuid-4.3.2.1977.zip) installeren en de migratie in werking stellen.

  4. Installeer het uid pakket van de migratieverbetering com.adobe.guides.uuid-verbetering-1.2.110.zip.

  5. Schakel draagraketten voor de volgende workflows uit met de URL: http://<server-name>/libs/cq/workflow/content/console.html .

    • Workflow voor DAM-update-middelen
    • DAM-workflow Metagegevens terugschrijven
    note note
    NOTE
    In het ideale geval moeten alle draagraketten voor workflows die op een willekeurig pad binnen content/dam worden uitgevoerd, worden uitgeschakeld.

  6. Werk de volgende configuraties bij volgens de voorgestelde wijzigingen:

    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
    Configuratie Eigenschap Waarde
    com.adobe.fmdita.config.ConfigManager Launchers voor naverwerking inschakelen Uitschakelen
    com.adobe.fmdita.config.ConfigManager uuuid. regex ^GUID-(?<id>.*)
    com.adobe.fmdita.postprocess.version.PostProcessVersionObservation Version Postprocessing inschakelen Uitschakelen
    Day CQ-tagservice Validatie inschakelen (validation.enabled) Uitschakelen

  7. Voeg een afzonderlijk logger toe voor:

    • com.adobe.fmdita.uuid
    • com.adobe.guides.uuid.

  8. (Indien niet eerder uitgevoerd) Als er zich meer dan 100.000 DITA-bestanden in het systeem bevinden, werkt u de queryLimitReads under org.apache.jackrabbit.oak.query.QueryEngineSettingsService bij tot een hogere waarde (een waarde die groter is dan het aantal aanwezige elementen, bijvoorbeeld 200.000).

    table 0-row-3 1-row-3
    PID Eigenschappensleutel Waarde van eigenschap
    org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Waarde: 200000
    Standaardwaarde: 100000

Migratie

  1. Start http://<server-name>/libs/fmdita/clientlibs/xmleditor_uuid_upgrade/page.html .

    de verbeteringslusje van het Systeem in migratie

    note note
    NOTE
    Als u "DITA-elementback-up inschakelen" kiest, worden de tijdelijke back-upbestanden opgeslagen onder /content/uuid-upgrade en worden de back-ups van het DITA-bestand verwijderd wanneer de migratie van een bestand is voltooid.

  2. Selecteer verbetering van het Systeem van het linkerpaneel om de migratie in werking te stellen. Het wordt aanbevolen alle gegevens tegelijk te migreren, aangezien het systeem batchverwerking optimaal intern afhandelt. Alleen bestanden die geen DITA-elementen zijn en niet worden gebruikt in DITA-elementen, kunnen worden overgeslagen voor migratie.

  3. (Optioneel) Selecteer de mappen waarvoor u de migratie wilt overslaan. Gebruik deze optie om deze mappen later te migreren of om de migratie over te slaan. Zorg ervoor dat deze omslagen geen activa DITA hebben en niet door (en in de toekomst niet door) om het even welke activa DITA worden bedoeld. Bijvoorbeeld content/dam/projects .

  4. Selecteer toelaten dita activa steun om een steun van activa vóór migratie tot stand te brengen. Deze reservekopie wordt gebruikt om terug te draaien als er een fout optreedt bij het migreren van een bestand. De back-up wordt verwijderd als de migratie succesvol is. Dit vertraagt echter het migratieproces.

  5. Start de migratie.

    note note
    NOTE
    Download de volledige logboeken en bekijk of er fouten zijn opgetreden. Als om het even welke fout of uitzondering wordt gevonden ga niet maar bevestig eerst de fout. Veelvoorkomende fouten worden weergegeven aan het einde van dit artikel.

  6. Zodra de migratie is voltooid, is het rapport beschikbaar om te downloaden en kunnen volledige logboeken ook worden gedownload.

  7. Selecteer Rapport van de Download terwijl de migratie loopt om te controleren of alle dossiers in de omslag correct worden bevorderd en of alle eigenschappen slechts voor die omslag werken.

    note note
    NOTE
    De migratie van de inhoud kan op een omslagniveau, volledige /content/dam, of de zelfde omslag (herun migratie) worden in werking gesteld.

    Het is ook belangrijk om ervoor te zorgen dat de migratie van inhoud wordt uitgevoerd voor alle media-elementen, zoals afbeeldingen en afbeeldingen die u hebt gebruikt in de DITA-inhoud.

  8. Zodra alle dossiers worden gemigreerd, uitgezochte Verbetering van de Basislijn/van het Overzicht van het linkerpaneel om de basislijnen en overzicht op het omslagniveau te migreren.

Basislijn en overzicht lusje in migratie

NOTE
Als u het systeem opnieuw opstart of als de migratie is afgebroken, wordt het script hervat wanneer u het opnieuw uitvoert met dezelfde parameters als voorheen. Neem contact op met het succesteam van uw klant als u problemen krijgt die te wijten zijn aan de sluiting.

De rapporten uit elke stap analyseren

Stap: De Verbetering van het Systeem

Samenvatting na voltooiing van proces
Hoe interpreteren?
Handeling
Totaal aantal bestanden: 345997
Het totale aantal bestanden dat is verwerkt in de opgegeven reeks mappen.
NA
Aantal bestanden bijgewerkt: 344516
Aantal bestanden dat is gemigreerd naar UUID.
NA
Aantal bestanden bijgewerkt met fouten: 29
Er zijn fouten opgetreden in deze bestanden en deze moeten dezelfde zijn als de fouten die worden gemeld in de pre-migratiestap.
NA
Aantal overgeslagen bestanden: 1452
Sommige bestanden in de DAM-opslagplaats hebben mogelijk subassets en deze subassets worden overgeslagen omdat ze niet in aanmerking komen voor UUID-migratie.
NA
Aantal bestanden kon niet worden bijgewerkt: 0
Als de telling niet 0 is, dan moeten de logboeken voor om het even welke kwesties worden geanalyseerd.
Controleer de uitzondering, u kunt de fout moeten bevestigen en de migratie opnieuw in werking stellen.
Totale genomen tijd: 2 :40: 06.157

Stap: De Basislijnen van de verbetering

Samenvatting na voltooiing van proces
Hoe interpreteren?
Handeling
Totaal aantal bestanden: 4833
Aantal DITA-kaarten met ten minste 1 basislijn.
Aantal bestanden bijgewerkt: 4705
Aantal kaarten DITA, met succes bijgewerkt met alle basislijnen.
Aantal bestanden bijgewerkt met fouten: 0
Aantal kaarten DITA waarvan basislijnen niet verbeterden.
Aantal overgeslagen bestanden: 1647
Aantal DITA-kaarten zonder basislijn.
Aantal bestanden kon niet worden bijgewerkt: 128
Het aantal basislijnvoorwerpen die ongeldig waren (zij waren leeg) is vermeld in het rapport (Excel).
Controleren of er andere fouten zijn dan: baselineObj not found on

Postmigratie

  1. Zodra de migratie wordt voltooid, bevestigt de uitgezochte systeemverbetering van het linkerpaneel en bevestigt de outputdossiers vóór en na de migratie om ervoor te zorgen dat de migratie succesvol is.

    bevestigt systeemverbeteringslusje in migratie

  2. Nadat de server is gemigreerd, kunt u de volgende workflows en configuraties (inclusief alle andere workflows die aanvankelijk tijdens de migratie waren uitgeschakeld) inschakelen om te blijven werken aan de server:

    • Workflow voor DAM-update-middelen
    • DAM-metagegevensworkflow
    note note
    NOTE
    In het ideale geval zouden alle draagraketten voor workflows die vóór de migratie op een willekeurig pad binnen content/dam werden uitgevoerd, moeten worden ingeschakeld.

  3. Schakel de volgende configuraties in:

    table 0-row-3 1-row-3 2-row-3 3-row-3
    Configuratie Eigenschap Waarde
    com.adobe.fmdita.config.ConfigManager laat de Lancers van het Werkschema van de Verwerking na toe Inschakelen
    com.adobe.fmdita.postprocess.version.PostProcessVersionObservation laat Versie Postprocessing toe Inschakelen
    Day CQ-tagservice laat bevestiging (validation.enabled) toe Inschakelen

  4. Assets-eigenschappen om na migratie te controleren:

    table 0-row-4 1-row-4
    Configuratie Eigenschap Waarde vóór migratie op niet-UUID Waarde voor namigratie op UUID
    com.adobe.fmdita.config.ConfigManager titel van het Gebruik voor AEM de paginanamen van de Plaats Onwaar (standaardwaarde) Waar
    note note
    NOTE
    Als vóór migratie, het bezit, Titel van het Gebruik voor AEM de paginanamen van de Plaats binnen com.adobe.fmdita.config.ConfigManager, geplaatst aan Vals, dan na migratie moet dit bezit worden bijgewerkt.

  5. Nadat de validatie is uitgevoerd, kan het grootste deel van de schijfruimte worden vrijgemaakt door compactie uit te voeren (zie https://experienceleague.adobe.com/docs/experience-manager-65/deploying/deploying/revision-cleanup.html?lang=en).

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178