Migration du contenu non UUID vers UUID id226TI0U20XA

Installez le package de pré-migration com.adobe.guides.pre-uuid-migration-1.2.27.zip sur la version 4.3.1.

Si le système contient plus de 100 000 fichiers DITA, mettez à jour les configurations de limite de requête pour que le script fonctionne :

• Accédez à /system/console/configMgr and increase both the configs to more than number of assets - queryLimitInMemory et queryLimitReads under org.apache.jackrabbit.oak.query.QueryEngineSettingsService

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

Sélectionnez Évaluation de la compatibilité dans le panneau de gauche et parcourez le chemin du dossier /content/dam pour toutes les ressources.

Vérifiez la compatibilité pour lister les informations suivantes :

• Total des fichiers
• Durée estimée de la migration
• Nombre de fichiers en erreur
• Fichiers avec nom de fichier GUID

Si l’erreur s’affiche, analysez les journaux et corrigez-les. Vous pouvez réexécuter la matrice de compatibilité après avoir corrigé les erreurs.

Sélectionnez Configurer les validations dans le panneau de gauche. Ensuite, Sélectionner la carte et Sélectionner le paramètre prédéfini de la carte pour les configurer. La liste de validation de sortie actuelle affiche les fichiers de sortie présents avant la migration et peut être validée par rapport aux fichiers de sortie générés après la migration.

En sélectionnant plusieurs mappages DITA de grande taille, vous pouvez vérifier que tout le contenu a bien été migré sans problème. La sélection de paramètres prédéfinis avec des lignes de base permet également de s’assurer que les lignes de base et les versions sont migrées avec succès.

(Facultatif) Effectuez la purge des versions sur le contenu pour supprimer les versions inutiles et accélérer le processus de migration. Pour effectuer la purge de version, sélectionnez l’option Purge de version dans l’écran de migration et accédez à l’interface utilisateur à l’aide de l’URL http://<server- name>/libs/fmdita/clientlibs/xmleditor_uuid_upgrade/page.html.

Exécutez la migration UID uniquement sur une instance d’auteur.

Assurez-vous que l’infrastructure suivante est prête :

• L’instance d’auteur est mise à niveau en termes de processeur et de mémoire afin de prendre en charge un traitement plus rapide et une mémoire supplémentaire nécessaire pour l’activité en masse. par exemple, si le processeur et la mémoire alloués actuels sont 8 vCPU et 24 Go heap, utilisez le double de la taille pour cette activité.
• L’espace disque global et l’espace disque temporaire (crx-quickstart directory) doivent avoir une mémoire tampon de 10 fois ce qui est déjà consommé. Une fois la migration terminée, vous pouvez récupérer la plus grande partie de l’espace disque en exécutant la compression.
• Exécutez Compression Tar hors ligne avant de démarrer cette activité.
• Assurez-vous qu'aucune indexation ou maintenance du système n'est planifiée pendant la fenêtre de cette migration.

Installez la version UID de la version prise en charge sur la version non UUID. Par exemple, si vous utilisez la version 4.3.1 non UUID, vous devez installer l’UUID version 4.3.2 com.adobe.fmdita-6.5-uuid-4.3.2.1977.zip) et lancer la migration.

Installez le package de mise à niveau de migration uuid com.adobe.guides.uuid-upgrade-1.2.110.zip.

Désactivez les lanceurs pour les workflows suivants à l’aide de l’URL : http://<server-name>/libs/cq/workflow/content/console.html.

• Workflow Ressource de mise à jour de la gestion des DAM
• Workflow d’écriture différée des métadonnées de gestion des actifs numériques

Mettez à jour les configurations suivantes en fonction des modifications suggérées :

Ajoutez un journal distinct pour :

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

(Si ce n’est pas le cas précédemment) S’il existe plus de 100 000 fichiers DITA dans le système, mettez à jour le queryLimitReads situé sous org.apache.jackrabbit.oak.query.QueryEngineSettingsService vers une valeur plus grande (toute valeur supérieure au nombre de ressources présentes, par exemple 200 000).

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

Sélectionnez Mise à niveau du système dans le panneau de gauche pour exécuter la migration. Il est recommandé de migrer toutes les données à la fois, car le système gère de manière optimale le traitement par lot en interne. Seuls les fichiers qui ne sont pas des ressources DITA et qui ne sont utilisés dans aucune ressource DITA peuvent être ignorés pour la migration.

(Facultatif) Sélectionnez les dossiers pour lesquels vous souhaitez ignorer la migration. Utilisez cette option pour migrer ces dossiers ultérieurement ou omettez de les migrer. Assurez-vous que ces dossiers ne contiennent aucune ressource DITA et ne sont référencés par aucune ressource DITA (et qu’à l’avenir, ils ne le seront pas). Par exemple, content/dam/projects.

Sélectionnez Activer la sauvegarde de ressource dita pour créer une sauvegarde de ressource avant la migration. Cette sauvegarde est utilisée pour la restauration en cas d’erreur lors de la migration d’un fichier. La sauvegarde est supprimée si la migration aboutit. Toutefois, cela ralentit le processus de migration.

Lancez la migration.

Une fois la migration terminée, le rapport peut être téléchargé et des logs entiers peuvent également être téléchargés.

Sélectionnez Télécharger le rapport pendant la migration pour vérifier si tous les fichiers du dossier sont correctement mis à niveau et si toutes les fonctionnalités ne fonctionnent que pour ce dossier.

En outre, il est important de s’assurer que la migration du contenu est effectuée pour toutes les ressources multimédias, telles que les images et les graphiques que vous avez utilisés dans le contenu DITA.

Une fois tous les fichiers migrés, sélectionnez Baseline/Review Upgrade dans le panneau de gauche pour migrer les lignes de base et effectuer une révision au niveau du dossier.

Une fois la migration terminée, sélectionnez Valider la mise à niveau du système dans le panneau de gauche et validez les fichiers de sortie avant et après la migration pour vous assurer que la migration est réussie.

Après la migration du serveur, activez les workflows et configurations suivants (y compris tous les autres workflows désactivés initialement pendant la migration) pour continuer à fonctionner sur le serveur :

• Workflow Ressource de mise à jour de la gestion des DAM
• Workflow de métadonnées de gestion des actifs numériques

Activez les configurations suivantes :

Propriétés Assets pour examiner la post-migration :

Une fois la validation terminée, la plupart de l’espace disque peut être récupéré en exécutant la compression (voir https://experienceleague.adobe.com/docs/experience-manager-65/deploying/deploying/revision-cleanup.html?lang=en).