4.3.1 migration de contenu non UUID vers 4.3.2 UUID

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éder à /system/console/configMgr and increase both the configs to more than number of assets - queryLimitInMemory et queryLimitReads under org.apache.jackrabbit.oak.query.QueryEngineSettingsService

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

Sélectionnez Évaluation de la compatibilité dans le panneau de gauche et parcourez le chemin d’accès au dossier /content/dam pour toutes les ressources.

Vérifiez la compatibilité pour répertorier les informations suivantes :

• Total des fichiers
• Temps estimé pour la migration
• Nombre de fichiers en erreur
• Fichiers avec GUID filename

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 un mappage et Sélectionner un paramètre prédéfini du mappage pour les configurer. La liste actuelle de validation des sorties 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 ultérieurement après la migration.

En sélectionnant plusieurs plans DITA volumineux, vous pouvez vérifier que tout le contenu a bien été migré sans problème. La sélection de paramètres prédéfinis comportant des lignes de base garantit également la réussite de la migration des lignes de base et des versions.

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

Exécutez la migration UUID uniquement sur une instance de création.

Assurez-vous que les éléments suivants sont prêts pour l’infrastructure :

• L’instance d’auteur est mise à niveau en termes de CPU et de mémoire afin de prendre en charge un traitement plus rapide et la mémoire supplémentaire nécessaire à l’activité en bloc. par exemple, si la mémoire et le CPU actuellement alloués sont de 8 processeurs virtuels et un tas de 24 Go, utilisez le double de la taille de cette activité.
• L’espace disque global et l’espace disque temporaire (crx-quickstart directory) doivent avoir une mémoire tampon 10 fois supérieure à celle déjà consommée. Une fois la migration terminée, vous pouvez récupérer la majeure partie de l’espace disque en exécutant la compression.
• N’exécutez compression Tar hors ligne avant de démarrer cette activité.
• Assurez-vous qu’aucune indexation ou maintenance système n’est prévue pendant cette migration.

Installez la version UUID de la version prise en charge plutôt que la version non UUID. Par exemple, si vous utilisez la version 4.3.1 non-UUID, vous devez installer UUID version 4.3.2 com.adobe.fmdita-6.5-uuid-4.3.2.1977.zip) et exécuter la migration.

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

Désactivez les lanceurs pour les workflows suivants en utilisant 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 ressources numériques

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

Ajoutez un enregistreur distinct pour :

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

(Si ce n'est pas fait plus tôt) S'il y a plus de 100 000 fichiers DITA dans le système, mettez à jour le queryLimitReads sous org.apache.jackrabbit.oak.query.QueryEngineSettingsService à une valeur plus grande (toute valeur supérieure au nombre de ressources présentes, par exemple 200 000).

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

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 en une seule fois, car le système gère de manière optimale les traitements par lots en interne. Seuls les fichiers qui ne sont pas des ressources DITA et qui ne sont pas utilisés dans des ressources 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 ignorez leur migration. Assurez-vous que ces dossiers ne comportent aucune ressource DITA et qu'ils ne sont pas référencés par (et ne seront plus référencés par) aucune ressource DITA. Par exemple, content/dam/projects.

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

Démarrez la migration.

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

Sélectionnez Télécharger le rapport pendant l’exécution de la migration pour vérifier si tous les fichiers du dossier sont correctement mis à niveau et si toutes les fonctionnalités fonctionnent uniquement 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 Mise à niveau de référence/révision dans le panneau de gauche pour migrer les lignes de base et les réviser 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.

Une fois la migration du serveur terminée, activez les configurations et workflows suivants (y compris tous les autres workflows qui ont été désactivés initialement lors de la migration) pour continuer à travailler sur le serveur :

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

Activez les configurations suivantes :

Propriétés Assets à vérifier après la migration :

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