Mise à niveau d’Adobe Experience Manager Guides vers les versions 4.6.0 et ultérieures
Cet article fournit des instructions pour mettre à niveau vos versions Experience Manager Guides pour 4.6.0 et les versions ultérieures.
Vous pouvez mettre à niveau votre version actuelle de Experience Manager Guides vers la version 5.1.0 Service Pack 3 :
- Si vous utilisez la version 5.1.0 ou 5.1.x , vous pouvez directement effectuer la mise à niveau vers la version 5.1.0 du pack de services 3.
- Si vous utilisez la version 4.6.0, 4.6.x, 5.0.0 ou 5.0.x, vous devez effectuer la mise à niveau vers la version 5.1.0.
- Si vous utilisez une version antérieure à la version 4.6.0, consultez Mise à niveau d’Adobe Experience Manager Guides vers la version 4.4.0 et les versions antérieures pour obtenir des instructions de mise à niveau détaillées.
Pour plus d’informations, reportez-vous aux procédures suivantes :
Mise à niveau vers la version 5.1.0
Conditions préalables
Avant de lancer le processus de mise à niveau vers Experience Manager Guides 5.1.0, vérifiez que vous disposez des éléments suivants :
- Mise à niveau vers Experience Manager Guides version 4.6.3, 4.6.4, 5.0.0 ou 5.0.0 Service Pack 1.
- (Facultatif) A fermé toutes les tâches de traduction.
- Modification du niveau de journal en INFO pour
com.adobe.fmdita.translationservices.TranslationMapUpgradeScriptclasse et ajout de ces journaux dans un nouveau fichier journal, par exemple,logs/translation_upgrade.log.
Installer la version 5.1.0
Téléchargez le package de la version 5.1.0 à partir du portail de distribution logicielle 🔗 et suivez les instructions fournies dans Workflow de mise à niveau de l’installation et de la post-installation pour terminer la mise à niveau.
Mise à niveau vers la version 5.0.0
Conditions préalables
Avant de lancer le processus de mise à niveau vers Experience Manager Guides 5.0.0, vérifiez que vous disposez des éléments suivants :
- Mise à niveau vers Experience Manager Guides version 4.6.3, 4.6.1, 4.6.0 ou 4.4.
- (Facultatif) A fermé toutes les tâches de traduction.
- Modification du niveau de journal en INFO pour
com.adobe.fmdita.translationservices.TranslationMapUpgradeScriptclasse et ajout de ces journaux dans un nouveau fichier journal, par exemple,logs/translation_upgrade.log.
Installer la version 5.0.0
Téléchargez le package de la version 5.0.0 à partir du portail de distribution logicielle 🔗 et suivez les instructions fournies dans Workflow de mise à niveau de l’installation et de la post-installation pour terminer la mise à niveau.
Mise à niveau vers la version 4.6.0
La mise à niveau vers la version 4.6.0 dépend de la version actuelle de Experience Manager Guides. Si vous utilisez la version 4.4.0, 4.3.1, 4.3.0, 4.2 ou 4.2.1 (correctif 4.2.1.3), vous pouvez directement effectuer la mise à niveau vers la version 4.6.0.
Conditions préalables
Avant de lancer le processus de mise à niveau vers Experience Manager Guides 4.6.0, vérifiez que vous disposez des éléments suivants :
- Mise à niveau vers Experience Manager Guides version 4.3.1, 4.3.0 ou 4.2.1 (correctif 4.2.1.3).
- (Facultatif) A fermé toutes les tâches de traduction.
- Modification du niveau de journal en INFO pour
com.adobe.fmdita.translationservices.TranslationMapUpgradeScriptclasse et ajout de ces journaux dans un nouveau fichier journal, par exemple,logs/translation_upgrade.log.
Installer la version 4.6.0
Téléchargez le package de la version 4.6.0 à partir du portail de distribution logicielle 🔗 et suivez les instructions fournies dans Workflow de mise à niveau de l’installation et de la post-installation pour terminer la mise à niveau.
Workflow de mise à niveau de l’installation et post-installation
Installation du package de version
Pour installer le package de version, procédez comme suit :
-
Installez le package de version sur lequel vous souhaitez effectuer la mise à niveau.
-
Vous pouvez choisir d’appuyer sur le déclencheur pour démarrer la tâche de mise à niveau de la carte de traduction. Pour plus d’informations, consultez Activation du déclencheur de script via une servlet.
-
Une fois l’installation du package terminée, attendez le message suivant dans les journaux :
Completed the post deployment setup scriptLe message ci-dessus indique que toutes les étapes d’installation sont terminées.
Si vous rencontrez l’une des erreurs suivantes, signalez-les à votre équipe du succès client :
- Erreur dans le script de configuration de post-déploiement
- Exception lors du portage du MAP de traduction
- Impossible de transférer la carte de traduction de v1 vers v2 pour la propriété
-
(Facultatif) Mise à niveau du plug-in Oxygen Connector fourni avec la version vers laquelle vous effectuez la mise à niveau.
-
Effacez la mémoire cache du navigateur après l’installation du package.
Processus de post-installation
Après avoir installé Experience Manager Guides, vous pouvez fusionner les différentes configurations applicables de la version nouvellement installée avec votre configuration.
Workflow Ressource de mise à jour de la gestion des ressources numériques (Modifications de post-traitement):
-
Ouvrir l’URL :
code language-none http://localhost:4502/libs/cq/workflow/admin/console/content/models.html -
Sélectionnez workflow Ressource de mise à jour de la gestion des ressources numériques.
-
Sélectionnez Modifier.
-
Si le composant DXML Post Process Initiator est présent, assurez-vous que les personnalisations sont synchronisées.
-
En l’absence du composant DXML Post Process Initiator, procédez comme suit pour l’insérer :
-
Sélectionnez Insérer le composant (Responsable du post-traitement Experience Manager Guides comme étape finale du processus).
-
Configurez l’étape du processus avec les détails suivants :
Onglet courant :
-
Title : initiateur de post-processus DXML
-
Description : étape d’initialisation de post-traitement DXML qui déclenchera une tâche sling pour le post-traitement DXML de la ressource modifiée/créée
Onglet Processus
- Sélectionnez DXML Post Process Initiator dans le menu déroulant Process
- Sélectionnez Avance du gestionnaire
- Sélectionnez Terminé
-
-
-
Sélectionnez Synchronisation en haut à droite après avoir effectué les modifications. Vous recevrez une notification de succès.
note note NOTE Actualisez et vérifiez que les modifications personnalisées et l’étape de post-traitement Experience Manager Guides sont présentes dans le modèle de workflow final. -
Une fois que le workflow Ressource de mise à jour de gestion des ressources numériques est validé, vérifiez les configurations de lanceur correspondantes. Pour ce faire, accédez à l’interface de workflow d’AEM et ouvrez les lanceurs.
code language-http http://localhost:4502/libs/cq/workflow/content/console.htmlRecherchez les deux lanceurs suivants (qui doivent être actifs) correspondant au workflow Ressource de mise à jour de la gestion des ressources numériques et apportez-y des modifications(si nécessaire) :
-
Lanceur de « Node créé » pour le workflow Ressource de mise à jour de la gestion des ressources numériques- pour la condition
"jcr:content/jcr:mimeType!=video", la valeur « Globbing » doit être :code language-json /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original- 'excludeList' doit avoir des
"event-user-data:changedByWorkflowProcess". - Lanceur pour « Node modifié » pour workflow Ressource de mise à jour de la gestion des ressources numériques - pour la condition «
jcr:content/jcr:mimeType!=video», la valeur « Globbing » doit être :
code language-json /content/dam(/((?!/subassets|/translation_output).)*/)renditions/originalexcludeListaurait dû être"event-user-data:changedByWorkflowProcess".
- 'excludeList' doit avoir des
-
Une fois la mise à niveau terminée, assurez-vous que toutes les personnalisations/superpositions sont validées et mises à jour pour correspondre au nouveau code de l’application. Voici quelques exemples :
- Tous les composants superposés à partir de
/libs/fmditaor/libsshoulddoivent être comparés au nouveau code de produit et les mises à jour doivent être effectuées dans les fichiers superposés sous /apps. - Toutes les catégories de
clientlibutilisées à partir du produit doivent être examinées pour les modifications. Toutes les configurations remplacées\(examples below\)doivent être comparées aux dernières afin d’obtenir les dernières fonctionnalités : - elementmapping.xml
ui\_config.json\(may have been set in folder profiles\)com.adobe.fmdita.config.ConfigManagermodifié
- Tous les composants superposés à partir de
-
Si vous avez ajouté des personnalisations dans damAssetLucene, vous devrez peut-être les appliquer à nouveau. Après avoir effectué ces modifications, définissez la réindexation sur true. Cela réindexera tous les nœuds existants avec les personnalisations. Une fois l’opération terminée, l’indicateur de réindexation est de nouveau défini sur false. Cette opération peut prendre quelques heures en fonction du nombre de ressources dans le système.
Procédure de réindexation des index Experience Manager Guides
-
Ouvrez
crx/deet accédez au chemin d’accès de l’index :/oak:index/guidesAssetProperties -
Définissez la propriété reindex sur
true(falsepar défaut) et cliquez sur Enregistrer tout. -
Une fois la réindexation terminée, la propriété Reindex est définie sur
falseet le nombre de réindex est incrémenté de 1.note note NOTE Cela peut prendre quelques minutes, selon la quantité de données présentes. 4. Suivez les mêmes étapes pour d’autres index ajoutés ou modifiés : `guidesBulkActivation`, `guidesPeerLinkIndex` et `guidesKonnectTemplateIndex`.
Procédure d’indexation du contenu existant
Effectuez les étapes suivantes pour indexer le contenu existant :
-
Exécutez une requête POST au serveur (avec l’authentification correcte) -
http://<server:port\>/bin/guides/map-find/indexing. (Facultatif : vous pouvez transmettre des chemins spécifiques des mappages pour les indexer. Par défaut, tous les mappages sont indexés || Exemple :https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>) -
L’API renvoie un
jobId. Pour vérifier le statut de la tâche, vous pouvez envoyer une requête GET avec l’ID de tâche au même point d’entrée :http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}(par exemple :http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678). -
Une fois la tâche terminée, la requête GET ci-dessus répond avec succès et mentionne si des mappages ont échoué. Les mappages indexés avec succès peuvent être confirmés à partir des journaux du serveur.
Procédure à suivre pour gérer le conflit de 'fmdita rewriter'
Experience Manager Guides dispose d’un module custom sling rewriter qui gère les liens générés en cas de mappages croisés (liens entre les rubriques de deux mappages différents).
Si votre base de code contient un autre module de réécriture Sling personnalisé, utilisez une valeur de 'order' supérieure à 50, car le module de réécriture Sling de Experience Manager Guides utilise 'order' 50. Pour remplacer cela, vous avez besoin d’une valeur >50. Pour plus d’informations, consultez la section Pipelines de réécriture de sortie.
Lors de cette mise à niveau, puisque la valeur 'order' est modifiée de 1 000 à 50, vous devez fusionner le module de réécriture personnalisé existant, le cas échéant, avec 'fmdita-rewriter'.
Procédure de réindexation de damAssetLucene
La définition d’index est mise à jour pour damAssetLucene avec AEM Guides. Après la mise à niveau vers la version requise, reportez-vous à cet article pour réindexer damAssetLucene.
reindex=true et reindex-async=true pour /oak:index/damAssetLucene) sont mises à jour simultanément via l’opération Enregistrer .