Instructions de mise à niveau de la version 2024.10.0
Cet article décrit les instructions de mise à niveau et la matrice de compatibilité de la version 2024.10.0 d’Adobe Experience Manager Guides as a Cloud Service.
Pour plus d’informations sur les nouvelles fonctionnalités et améliorations, voir la section Nouveautés de la version 2024.10.0.
Pour connaître la liste des problèmes résolus dans cette version, voir la section Problèmes résolus dans la version 2024.10.0.
Matrice de compatibilité
Cette section répertorie la matrice de compatibilité des applications logicielles prises en charge par la version 2024.10.0 d’Experience Manager Guides as a Cloud Service.
FrameMaker et FrameMaker Publishing Server
Connecteur Oxygen
Version du modèle de base de connaissances
Mise à niveau vers la version 2024.10.0
Experience Manager Guides est automatiquement mis à niveau lors de la mise à niveau de la version actuelle (la plus récente) de l’as a Cloud Service Experience Manager.
- ui_config.json (peut avoir été défini dans les profils de dossier)
Effectuez les étapes suivantes pour Experience Manager Guides as a Cloud Service si vous ne l’avez pas fait auparavant pour votre version existante :
Procédure d’activation du déclencheur d’un script via un servlet
(Uniquement si vous utilisez une version antérieure à la version de juin 2023 de Experience Manager Guides as a Cloud Service)
Une fois l’installation terminée, vous pouvez choisir d’ACCÉDER au déclencheur pour lancer la tâche de traduction :
POST :
http://localhost:4503/bin/guides/script/start?jobType=translation-map-upgrade
Réponse :
{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/translation-map-upgrade/1683190032886",
"status": "SCHEDULED"
}
Dans la réponse précédente JSON, la clé lockNodePath
contient le chemin d’accès au noeud créé dans le référentiel pointant vers la tâche envoyée. Il est automatiquement supprimé une fois la tâche terminée, puis vous pouvez vous référer à ce noeud pour connaître le statut de la tâche.
Patientez jusqu’à ce que cette tâche soit terminée avant de passer aux étapes suivantes.
GET
http://<aem_domain>/var/dxml/executor-locks/translation-map-upgrade/1683190032886.json
Étapes de post-traitement du contenu existant pour utiliser le rapport de lien rompu
(Uniquement si vous utilisez une version antérieure à la version de juin 2023 de Experience Manager Guides as a Cloud Service)
Effectuez les étapes suivantes pour post-traiter le contenu existant et utiliser le nouveau rapport de lien rompu :
-
(Facultatif) S’il existe plus de 100 000 fichiers DITA dans le système, mettez à jour les
queryLimitReads
etqueryLimitInMemory
sousorg.apache.jackrabbit.oak.query.QueryEngineSettingsService
vers une valeur plus grande (toute valeur supérieure au nombre de ressources présentes, par exemple 200 000), puis redéployez.-
Suivez les instructions de la section Remplacements de configuration dans Installation et configuration de l’as a Cloud Service Adobe Experience Manager Guides pour créer le fichier de configuration.
-
Dans le fichier de configuration, fournissez les détails (propriété) suivants pour configurer l’option
queryLimitReads
etqueryLimitInMemory
:table 0-row-3 1-row-3 2-row-3 PID Clé de propriété Valeur de la propriété org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Valeur : 200000 Valeur par défaut : 100000 org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitInMemory Valeur : 200000 Valeur par défaut : 100000
-
-
Exécutez une requête de POST sur le serveur (avec l’authentification correcte) -
http://<server>//bin/guides/reports/upgrade
. -
L’API renvoie un jobId. Pour vérifier l’état de la tâche, vous pouvez envoyer une demande de GET avec l’ID de la tâche au même point de terminaison -
http://<server>/bin/guides/reports/upgrade?jobId= {jobId}
(Par exemple :http://localhost:8080/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678
) -
Une fois la tâche terminée, la requête de GET précédente répond avec succès. Si la tâche échoue pour une raison quelconque, l’échec est visible à partir des journaux du serveur.
-
Revenez à la valeur par défaut ou à la valeur existante précédente de
queryLimitReads
si vous l’avez modifiée à l’étape 1.
Étapes pour indexer le contenu existant afin d’utiliser la nouvelle liste de rubrique et de recherche sous l’onglet Rapports :
(Uniquement si vous utilisez une version antérieure à la version de juin 2023 de Experience Manager Guides as a Cloud Service)
Effectuez les étapes suivantes pour indexer le contenu existant et utilisez le nouveau texte de recherche et de remplacement au niveau de la carte et de la liste des rubriques sous l’onglet rapports :
-
Exécutez une requête de POST sur le serveur (avec l’authentification correcte) -
http://<server:port>/bin/guides/map-find/indexing
. (Facultatif : vous pouvez transmettre des chemins spécifiques des cartes pour les indexer, toutes les cartes sont par défaut indexées|| Exemple :https://<Server:port>/bin/guides/map-find/indexing?paths=<path of the MAP in repository>
) -
Vous pouvez également transmettre un dossier racine pour indexer les mappages DITA d’un dossier spécifique (et de ses sous-dossiers). Par exemple,
http://<server:port\>/bin/guides/map-find/indexing?root=/content/dam/test
. Notez que si les paramètres paths et root sont transmis, seul le paramètre paths est pris en compte. -
L’API renvoie un jobId. Pour vérifier l’état de la tâche, vous pouvez envoyer une demande de GET avec l’ID de la tâche au même point de terminaison -
http://<server:port>/bin/guides/map-find/indexing?jobId={jobId}
(Par exemple :http://localhost:8080/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678
) -
Une fois la tâche terminée, la requête de GET précédente répond avec succès et indique si une correspondance a échoué. Les mappages indexés avec succès peuvent être confirmés à partir des journaux du serveur.
Procédure de gestion du conflit 'fmdita rewriter'
Experience Manager Guides dispose d’un module de réécriture sling personnalisée pour gérer les liens générés en cas de mappage croisé (liens entre les rubriques de deux cartes différentes).
Si votre code base comporte un autre module de réécriture sling personnalisé, utilisez une valeur 'order'
supérieure à 50, car Experience Manager Guides sling rewriter utilise 'order'
50. Pour le remplacer, vous devez disposer d’une valeur supérieure à 50. Pour plus d’informations, voir Pipelines de réécriture de sortie.
Pendant cette mise à niveau, puisque la valeur 'order'
est passée de 1000 à 50, vous devez fusionner le module de réécriture personnalisé existant, le cas échéant, avec fmdita-rewriter
.
Procédure de migration de l’arborescence B pour les fragments de contenu
Si les références ne s’affichent pas pour les fragments de contenu, vous pouvez choisir d’ACCÉDER au déclencheur pour lancer la tâche de migration :
POST :
http://localhost:4503/bin/guides/script/start?jobType=cf-reference-store-btree-migration
Réponse :
{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/cf-reference-store-btree-migration/1683190032886",
"status": "SCHEDULED"
}
Dans la réponse précédente, JSON, la clé lockNodePath
contient le chemin d’accès au noeud créé dans le référentiel, qui pointe vers la tâche envoyée. Il sera automatiquement supprimé une fois la tâche terminée. Vous pouvez vous reporter à ce noeud pour connaître l’état de la tâche.
Patientez jusqu’à ce que cette tâche soit terminée avant de passer aux étapes suivantes.
GET :
http://<aem_domain>/var/dxml/executor-locks/cf-reference-store-btree-migration/1683190032886.json