Migration von Nicht-UUID-zu-UUID-Inhalten id226TI0U20XA

Installieren Sie das Vormigrationspaket com.adobe.guides.pre-uuid-migration-1.2.27.zip über Version 4.3.1.

Wenn mehr als 100.000 DITA-Dateien im System vorhanden sind, aktualisieren Sie die Konfigurationen für die Abfragebegrenzung, damit das Skript funktioniert:

• Navigieren Sie zu /system/console/configMgr and increase both the configs to more than number of assets - queryLimitInMemory und queryLimitReads under org.apache.jackrabbit.oak.query.QueryEngineSettingsService

Starten Sie http://<server-name>/libs/fmdita/clientlibs/xmleditor_uuid_upgrade/page.html.

Wählen Sie im linken Bereich die Option Kompatibilitätsbewertung aus und durchsuchen Sie den Ordnerpfad für alle Assets./content/dam

Überprüfen Sie die Kompatibilität, um die folgenden Informationen aufzulisten:

• Gesamtzahl der Dateien
• Geschätzte Migrationszeit
• Fehlerfreie Dateien
• Dateien mit GUID-Dateinamen

Registerkarte

Wenn der Fehler auftritt, analysieren Sie die Protokolle und beheben Sie diese Fehler. Sie können die Kompatibilitätsmatrix erneut ausführen, nachdem Sie die Fehler behoben haben.

Wählen Sie im linken Bereich Überprüfungen konfigurieren aus. Wählen Sie dann map und preset der Zuordnung aus, um sie zu konfigurieren. In der aktuellen Liste der Ausgabeprüfungen werden die vor der Migration vorhandenen Ausgabedateien angezeigt. Sie können anhand der Ausgabedateien validiert werden, die nach der Migration generiert wurden.

Durch die Auswahl mehrerer und großer DITA-Maps können Sie überprüfen, ob der gesamte Inhalt ohne Probleme erfolgreich migriert wurde. Durch die Auswahl von Vorgaben mit Grundlinien wird außerdem sichergestellt, dass Grundlinien und Versionen erfolgreich migriert werden.

(Optional) Führen Sie eine Versionsbereinigung für den Inhalt durch, um unnötige Versionen zu entfernen und den Migrationsprozess zu beschleunigen. Um die Versionsbereinigung durchzuführen, wählen Sie im Migrationsbildschirm die Option Versionsbereinigung aus und wechseln Sie mithilfe der URL http://<server- name>/libs/fmdita/clientlibs/xmleditor_uuid_upgrade/page.html zur Benutzeroberfläche.

Führen Sie die UUID-Migration nur auf einer Autoreninstanz aus.

Stellen Sie sicher, dass die folgende Infrastruktur bereit ist:

• Die Autoreninstanz wird in Bezug auf CPU und Speicher aktualisiert, um eine schnellere Verarbeitung und zusätzlichen Speicher zu unterstützen, der für Massenaktivitäten benötigt wird. Wenn die aktuell zugewiesene CPU und der Arbeitsspeicher beispielsweise 8 vCPU und 24 GB Heap sind, verwenden Sie für diese Aktivität die doppelte Größe.
• Der gesamte Festplattenspeicher und der temporäre Speicherplatz (crx-quickstart directory) sollten einen Puffer von 10-mal so viel haben, wie bereits belegt ist. Nachdem Sie die Migration abgeschlossen haben, können Sie den Großteil des Festplattenspeichers durch Ausführen der Komprimierung zurückgewinnen.
• Führen Sie Offline-Tar-Verdichtung aus, bevor Sie diese Aktivität starten.
• Stellen Sie sicher, dass während des Fensters dieser Migration keine Indizierung oder Systemwartung geplant ist.

Installieren Sie die UUID-Version der unterstützten Version über die Nicht-UUID-Version. Wenn Sie z. B. den Nicht-UUID-Build 4.3.1 verwenden, müssen Sie die UUID-Version 4.3.2 com.adobe.fmdita-6.5-uid-4.3.2.1977.zip) installieren und die Migration ausführen.

Installieren Sie das uuid migration upgrade package com.adobe.guides.uuid-upgrade-1.2.110.zip.

Deaktivieren Sie Starter für die folgenden Workflows mithilfe der URL: http://<server-name>/libs/cq/workflow/content/console.html.

• Workflow „DAM-Update-Asset“
• DAM-Metadaten-Writeback-Workflow

Aktualisieren Sie die folgenden Konfigurationen gemäß den vorgeschlagenen Änderungen:

Fügen Sie eine separate Protokollfunktion für hinzu:

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

(Wenn nicht bereits geschehen) Wenn mehr als 100.000 DITA-Dateien im System vorhanden sind, aktualisieren Sie die queryLimitReads unter org.apache.jackrabbit.oak.query.QueryEngineSettingsService auf einen größeren Wert (ein beliebiger Wert, der größer ist als die Anzahl der vorhandenen Assets, z. B. 200.000).

Starten Sie http://<server-name>/libs/fmdita/clientlibs/xmleditor_uuid_upgrade/page.html.

Wählen Sie im linken Bereich die Option Systemaktualisierung aus, um die Migration auszuführen. Es wird empfohlen, alle Daten gleichzeitig zu migrieren, da das System die Stapelverarbeitung intern optimal handhabt. Nur Dateien, die keine DITA-Assets sind und in keinen DITA-Assets verwendet werden, können zur Migration übersprungen werden.

(Optional) Wählen Sie die Ordner aus, für die Sie die Migration überspringen möchten. Verwenden Sie diese Option, um diese Ordner später zu migrieren oder die Migration zu überspringen. Stellen Sie sicher, dass diese Ordner keine DITA-Assets aufweisen und nicht von DITA-Assets referenziert werden (und zukünftig nicht von referenziert werden). Zum Beispiel: content/dam/projects.

Wählen Sie Dia Asset-Sicherung aktivieren aus, um vor der Migration eine Asset-Sicherung zu erstellen. Diese Sicherung wird für das Rollback verwendet, falls bei der Migration einer Datei ein Fehler auftritt. Die Sicherung wird gelöscht, wenn die Migration erfolgreich war. Dies verlangsamt jedoch den Migrationsprozess.

Starten Sie die Migration.

Sobald die Migration abgeschlossen ist, steht der Bericht zum Herunterladen zur Verfügung und komplette Protokolle können ebenfalls heruntergeladen werden.

Wählen Sie Bericht herunterladen , während die Migration ausgeführt wird, um zu überprüfen, ob alle Dateien im Ordner korrekt aktualisiert wurden und ob alle Funktionen nur für diesen Ordner funktionieren.

Außerdem muss sichergestellt werden, dass die Inhaltsmigration für alle Medien-Assets erfolgt, z. B. für Bilder und Grafiken, die Sie im DITA-Inhalt verwendet haben.

Nachdem alle Dateien migriert wurden, wählen Sie im linken Bereich die Option Grundlinien-/Überprüfungsaktualisierung aus, um die Grundlinien zu migrieren und auf Ordnerebene zu überprüfen.

Nachdem die Migration abgeschlossen ist, wählen Sie im linken Bereich die Option Systemaktualisierung überprüfen aus und validieren Sie die Ausgabedateien vor und nach der Migration, um sicherzustellen, dass die Migration erfolgreich ist.

Nach der erfolgreichen Migration des Servers können Sie die folgenden Workflows und Konfigurationen (einschließlich aller anderen Workflows, die während der Migration ursprünglich deaktiviert wurden) aktivieren, um weiterhin auf dem Server zu arbeiten:

• Workflow „DAM-Update-Asset“
• DAM-Metadaten-Workflow

Aktivieren Sie die folgenden Konfigurationen:

Assets-Eigenschaften zum Überprüfen der Post-Migration:

Nach Abschluss der Validierung kann der Großteil des Festplattenspeichers durch Ausführen der Komprimierung zurückgewonnen werden (siehe https://experienceleague.adobe.com/docs/experience-manager-65/deploying/deploying/revision-cleanup.html?lang=de).