Nettoyage de révision
- S'applique à :
- Experience Manager 6.5
- Rubriques :
- Administration
Créé pour :
- Administration
Présentation
Chaque mise à jour du référentiel crée une révision du contenu. Par conséquent, avec chaque mise à jour, la taille du référentiel augmente. Les anciennes révisions doivent être nettoyées pour libérer des ressources de disque. Cela est important pour éviter une croissance incontrôlée du référentiel. Cette fonctionnalité de maintenance est appelée Nettoyage des révisions. Elle est disponible en tant que routine hors ligne depuis Adobe Experience Manager (AEM) 6.0.
Une version en ligne de cette fonctionnalité, appelée Nettoyage des révisions en ligne, a été introduite dans AEM 6.3 et les versions ultérieures. Par rapport au nettoyage des révisions hors ligne où l’instance AEM doit être arrêtée, le nettoyage des révisions en ligne peut être exécuté pendant que l’instance AEM est en ligne. Le nettoyage des révisions en ligne est activé par défaut. Il s’agit de la méthode recommandée pour effectuer un nettoyage des révisions.
Remarque : Regardez la vidéo pour découvrir comment utiliser le nettoyage des révisions en ligne.
Le processus de nettoyage des révisions se compose de trois phases : estimation, compression et nettoyage. L’estimation détermine si la phase suivante (compression) doit être exécutée ou non en fonction de la quantité d’espace mémoire pouvant être récupérée. Lors de la phase de compression, les segments et les fichiers tar sont réécrits sans aucun contenu inutilisé. La phase de nettoyage supprime ensuite les anciens segments, y compris l’espace mémoire qu’ils peuvent contenir. Le mode hors ligne peut généralement libérer de l’espace, car le mode en ligne doit tenir compte de la plage de travail d’AEM, qui empêche la collecte de segments supplémentaires.
Pour plus d’informations sur le nettoyage des révisions, cliquez sur les liens suivants :
Vous pouvez aussi consulter la documentation Oak officielle.
Quand utiliser le nettoyage des révisions en ligne plutôt que le nettoyage des révisions hors ligne ?
Le nettoyage des révisions en ligne est la méthode recommandée pour effectuer un nettoyage des révisions. L’utilisation du nettoyage des révisions hors ligne doit être limitée à des cas exceptionnels, par exemple, avant d’effectuer une migration vers un nouveau format de stockage ou si l’Assistance clientèle d’Adobe vous demande de le faire.
Comment exécuter le nettoyage des révisions en ligne
Le nettoyage des révisions en ligne est configuré par défaut pour s’exécuter automatiquement une fois par jour sur les instances de création et de publication AEM. Il vous suffit de définir la fenêtre de maintenance pendant une période où l’activité des utilisateurs et utilisatrices est la moins importante. Vous pouvez configurer la tâche de nettoyage des révisions en ligne comme suit :
-
Dans la fenêtre principale, accédez à Outils - Opérations - Tableau de bord - Maintenance ou sur :
https://serveraddress:serverport/libs/granite/operations/content/maintenance.html
-
Déplacez le curseur au-dessus de la fenêtre de maintenance quotidienne, puis cliquez sur l’icône Paramètres.
-
Saisissez les valeurs souhaitées (répétition, heure de début, heure de fin) et cliquez sur Enregistrer.
Autrement, si vous désirez effectuer le nettoyage manuellement, procédez comme ceci :
-
Accédez à Outils - Opérations - Tableau de bord- Maintenance ou directement sur
https://serveraddress:serverport/libs/granite/operations/content/maintenance.html. -
Cliquez sur la fenêtre de maintenance quotidienne.
-
Déplacez le curseur au-dessus de l’icône Nettoyage des révisions.
-
Cliquez sur Exécuter.
Exécuter le nettoyage des révisions en ligne après le nettoyage des révisions hors ligne
Le processus de nettoyage des révisions récupère les anciennes révisions par génération. Cela signifie que chaque fois que vous exécutez le nettoyage des révisions, une nouvelle génération est créée et conservée sur le disque. Il existe cependant une différence entre les deux types de nettoyage des révisions : le processus hors ligne conserve une seule génération, alors que le processus en ligne en conserve deux. Voici donc ce qui se passe lorsque vous exécutez le nettoyage des révisions en ligne après le nettoyage hors ligne :
- Après la première exécution du nettoyage des révisions en ligne, la taille du référentiel double. Cela est dû au fait que deux générations sont à présent conservées sur le disque.
- Au cours des exécutions ultérieures, la taille du référentiel augmentera temporairement pendant la création de la génération, puis reviendra à la taille qui était la sienne après la première exécution, étant donné que le processus de nettoyage des révisions en ligne récupère la génération précédente.
En outre, gardez à l’esprit que, selon le type et le nombre de validations, chaque génération peut avoir une taille différente de la précédente, de sorte que la taille finale peut varier d’une exécution à l’autre.
Il est donc recommandé d’opter pour une taille de disque au moins deux à trois fois supérieure à celle estimée initialement pour le référentiel.
Modes de compression complète et partielle
AEM 6.5 s’accompagne de deux nouveaux modes pour la phase de compression du processus de nettoyage des révisions en ligne :
- Le mode Compression complète réécrit tous les segments et fichiers tar dans l’ensemble du référentiel. La phase de nettoyage suivante peut donc libérer la quantité maximale d’espace mémoire dans le référentiel. Étant donné que la compression complète affecte l’ensemble du référentiel, une quantité de ressources système et un temps considérables sont nécessaires pour son exécution. La compression complète correspond à la phase de compression dans AEM 6.3.
- Le mode Compression des révisions les plus récentes ne réécrit que les segments et fichiers tar les plus récents dans le référentiel. Les segments et les fichiers tar les plus récents sont ceux qui ont été ajoutés depuis la dernière exécution de compression complète ou partielle. La phase de nettoyage suivante ne peut donc que libérer l’espace mémoire dans la partie récente du référentiel. Étant donné que la compression partielle ne concerne qu’une partie du référentiel, elle consomme beaucoup moins de ressources système qu’une compression complète et se révèle bien plus rapide.
Ces modes de compression constituent un compromis entre efficacité et consommation des ressources : bien que la compression partielle soit moins efficace, elle a également moins d’impact sur le fonctionnement normal du système. En revanche, la compression complète est plus efficace, mais a davantage de répercussions sur les opérations normales du système.
AEM 6.5 s’enrichit également d’un mécanisme de déduplication du contenu plus efficace au cours de la compression, ce qui a pour effet de réduire l’empreinte du référentiel sur le disque.
Les deux graphiques ci-dessous présentent les résultats des tests réalisés en laboratoire interne. Ils illustrent la réduction des délais d’exécution moyens et de l’empreinte moyenne sur le disque dans AEM 6.5 par rapport à AEM 6.3 :
Configuration de la compression complète et partielle
La configuration par défaut exécute la compression partielle les jours de la semaine et la compression complète le dimanche. Vous pouvez modifier cette configuration par défaut en utilisant la nouvelle valeur de configuration full.gc.days de la tâche de maintenance RevisionCleanupTask.
Lorsque vous configurez la valeur full.gc.days, la compression complète est exécutée les jours définis dans la valeur, la compression partielle étant exécutée les jours non définis. Par exemple, si vous configurez la compression complète pour qu’elle s’exécute le dimanche, la compression partielle s’exécute du lundi au samedi. Si, par exemple, vous configurez la compression complète pour qu’elle s’exécute tous les jours de la semaine, la compression partielle ne s’exécute pas du tout.
Considérez également que :
- La compression des révisions les plus récentes est moins efficace et a un impact moindre sur les opérations normales du système. Elle est donc destinée à être exécutée pendant les jours ouvrables.
- La compression complète est plus efficace, mais a davantage de répercussions sur les opérations normales du système. Elle est donc destinée à être exécutée pendant les jours ouvrables.
- La compression complète et la compression partielle doivent être planifiées pour fonctionner pendant les heures creuses.
Résolution des problèmes
Lors de l’utilisation des nouveaux modes de compression, gardez à l’esprit les points suivants :
- Vous pouvez surveiller l’activité d’entrée/sortie (E/S), par exemple : opérations d’E/S, processeur en attente d’E/S, taille de la file d’attente de validation. Cela permet de déterminer si le système devient lié aux E/S et nécessite une mise à niveau.
- La tâche
RevisionCleanupTaskHealthCheckindique le statut d’intégrité global du nettoyage des révisions en ligne. Le fonctionnement est le même que dans AEM 6.3 et ne fait pas la distinction entre compression complète et partielle. - Les messages du journal contiennent des informations pertinentes sur les modes de compression. Par exemple, lorsque le nettoyage des révisions en ligne démarre, les messages de journal correspondants indiquent le mode de compression. De plus, dans certains cas, le système rétablit la compression complète lorsqu’une compression partielle était prévue. Les messages du journal indiquent cette modification. Les exemples de journaux ci-dessous indiquent le mode de compression et comment passer de la compression complète à la compression partielle :
TarMK GC: running tail compaction
TarMK GC: no base state available, running full compaction instead
Limites connues
Dans certains cas, l’alternance entre le modes de compression complète et partielle retarde le processus de nettoyage. Plus précisément, le référentiel s’accroît après une compression complète (sa taille double). L’espace supplémentaire sera récupéré lors de la compression partielle suivante, lorsque le référentiel sera inférieur à la taille de compression pré-complète. Les exécutions de tâches de maintenance parallèles doivent également être évitées.
Il est recommandé d’opter pour une taille de disque au moins deux à trois fois supérieure à celle estimée initialement pour le référentiel.
Foire aux questions sur le nettoyage des révisions en ligne
Remarques concernant la mise à niveau AEM 6.5
Le format de persistance de TarMK change avec AEM 6.5. Ces modifications ne nécessitent aucune étape de migration proactive. Les référentiels existants font l’objet d’une migration progressive, un processus totalement transparent. Le processus de migration est lancé la première fois qu’AEM 6.5 (ou les outils associés) accède au référentiel.
Une fois que la migration vers le format de persistance AEM 6.5 a été lancée, le référentiel ne peut plus revenir au format de persistance AEM 6.3 précédent.
Migration vers Oak Segment Tar
Dans AEM 6.3, des modifications au niveau du format de stockage étaient nécessaires, notamment pour améliorer les performances et l’efficacité du nettoyage des révisions en ligne. Ces modifications ne sont pas rétrocompatibles et les référentiels créés avec l’ancien segment Oak (AEM 6.2 et versions antérieures) doivent être migrés.
Autres avantages liés à la modification du format de stockage :
- Amélioration de l’évolutivité (taille du segment optimisée).
- Récupération de l’espace mémoire du magasin de données plus rapide.
- Travail de base pour les améliorations futures.
Exécution du nettoyage des révisions en ligne
Le nettoyage des révisions hors ligne récupère tout sauf la dernière génération par rapport aux deux dernières générations de nettoyage des révisions en ligne. Dans le cas d’un nouveau référentiel, le nettoyage des révisions en ligne ne récupère aucun espace lorsqu’il est exécuté pour la première fois après le nettoyage des révisions hors ligne, car aucune génération n’est suffisamment ancienne pour être récupérée.
Lisez également la section « Exécution du nettoyage des révisions en ligne après le nettoyage des révisions hors ligne » de ce chapitre.
Les facteurs sont les suivants :
- Taille du référentiel
- Chargement sur le système (requêtes par minute, en particulier opérations d’écriture)
- Modèle d’activité (lectures et écritures)
- Spécifications matérielles (performances du processeur, mémoire, IOPS)
L’espace disque est surveillé en permanence lors du nettoyage des révisions en ligne. Si l’espace disque disponible descend en dessous d’une valeur critique, le processus est annulé. La valeur critique est de 25 % de l’empreinte disque actuelle du référentiel et elle n’est pas configurable.
Adobe recommande d’opter pour une taille de disque au moins deux à trois fois supérieure à celle estimée initialement pour le référentiel.
L’espace libre du tas est surveillé en permanence pendant le processus de nettoyage. Si l’espace libre du tas descend sous une valeur critique, le processus sera annulé. La valeur critique est configurée via org.apache.jackrabbit.oak.segment.SegmentNodeStoreService#MEMORY_THRESHOLD. La valeur par défaut est 15%.
Les recommandations pour le dimensionnement minimal du tas de compression ne sont pas séparées des recommandations de dimensionnement de la mémoire d’AEM. En règle générale : si une instance AEM est suffisamment bien dimensionnée pour gérer les cas d’utilisation et la payload attendue, le processus de nettoyage obtiendra suffisamment de mémoire.
- Assurez-vous qu’il est exécuté tous les jours.
- Assurez-vous qu’il est exécuté lorsque les activités du référentiel sont minimales en configurant les fenêtres de maintenance dans le tableau de bord des opérations de manière adéquate.
- Faites évoluer les ressources du système (processeur, mémoire, E/S).
Le nettoyage des révisions repose sur une phase d’estimation pour décider s’il y a suffisamment d’espace mémoire à libérer. L’estimateur compare la taille actuelle à la taille du référentiel après sa dernière compression. Si la taille dépasse le delta configuré, le nettoyage s’exécute. La taille du delta est définie sur 1 Go. Cela signifie que si la taille du référentiel n’a pas augmenté de 1 Go depuis le dernier nettoyage, la nouvelle itération du nettoyage des révisions est ignorée.
Vous trouverez, ci-dessous, des entrées de journaux pertinentes pour la phase d’estimation :
- Revision GC runs: Size delta is N% or N/N (N/N bytes), so running compaction
- Revision GC does not run: Size delta is N% or N/N (N/N bytes), so skipping compaction for now
S’il y a des écritures simultanées sur le système, le nettoyage des révisions en ligne peut nécessiter un accès exclusif à l’écriture pour pouvoir effectuer les changements à la fin d’un cycle de compression. Le système passe en mode forceCompact, comme expliqué de manière détaillée dans la Documentation oak. Lors de la compression forcée, un verrou d’écriture exclusif est acquis afin de valider enfin les modifications sans interférence d’écriture simultanée. Pour limiter l’impact sur les temps de réponse, une valeur de délai d’expiration peut être définie. Cette valeur est définie sur une minute par défaut, ce qui signifie que si la compression forcée ne se termine pas dans un délai d’une minute, le processus de compression est abandonné au profit de validations simultanées.
a durée de la compression forcée dépend des facteurs suivants :
- matériel : spécifiquement IOPS. La durée diminue avec davantage d’IOPS.
- taille de la banque de segments : la durée augmente avec la taille du magasin de segments.
Dans une configuration Cold Standby, seule l’instance principale doit être configurée pour exécuter le nettoyage des révisions en ligne. Sur l’instance de secours, le nettoyage des révisions en ligne n’a pas besoin d’être programmé de manière spécifique.
L’opération correspondante sur une instance de secours est le nettoyage automatique. Cela correspond à la phase de nettoyage du nettoyage des révisions en ligne. Le nettoyage automatique est exécuté sur l’instance secondaire après l’exécution du nettoyage des révisions en ligne sur l’instance principale.
Les phases d’estimation et de compression ne seront pas exécutées sur une instance secondaire.
Le nettoyage des révisions hors ligne peut supprimer immédiatement les anciennes révisions, tandis que le nettoyage des révisions en ligne doit tenir compte des anciennes révisions toujours référencées par la pile d’applications. Le premier peut ainsi libérer de l’espace de manière plus agressive que le second où l’effet est amorti au cours de quelques cycles de récupération de l’espace mémoire.
Lisez également la section « Exécution du nettoyage des révisions en ligne après le nettoyage des révisions hors ligne » de ce chapitre.
- Dans les environnements Windows, ’accès standard aux fichiers est toujours appliqué ; l’accès mappé par la mémoire n’est donc pas utilisé. n règle générale, il est conseillé d’allouer toute la mémoire vive (RAM) disponible au tas et d’augmenter la taille de segmentCache. Pour augmenter la taille de segmentCache, ajoutez l’option segmentCache.size à org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.config (par exemple : segmentCache.size=20480). N’oubliez pas de laisser de la mémoire vive pour le système d’exploitation et d’autres processus.
- Dans les environnements non Windows, augmentez la taille de la mémoire physique pour améliorer le mappage de mémoire du référentiel.
Surveillance du nettoyage des révisions en ligne
- L’espace disque doit être surveillé lorsque le nettoyage des révisions en ligne est activé. S’il n’y a pas suffisamment d’espace disque, soit le processus de nettoyage n’est pas lancé, soit il s’arrête de manière préventive.
- Vérifiez les journaux pendant la durée d’exécution du nettoyage des révisions en ligne. Cela ne devrait pas durer plus de 2 heures.
- Nombre de points de contrôle. S’il existe plus de 3 points de contrôle durant l’exécution de la compression, il est recommandé de nettoyer les points de contrôle.
Vous pouvez vérifier si le nettoyage des révisions en ligne s’est terminé correctement en vérifiant les journaux.
Par exemple, « TarMK GC #{}: compaction completed in {} ({} ms), after {} cycles » signifie que l’étape de compression a été effectuée avec succès, sauf si elle a été précédée du message « TarMK GC #{}: compaction gave up compacting concurrent commits after {} cycles », ce qui signifie qu’il y avait trop de charge simultanée.
En conséquence, un message « TarMK GC #{}: cleanup completed in {} ({} ms » s’affiche lorsque l’étape de nettoyage est terminée.
Le statut, la progression et les statistiques sont présentés via JMX (SegmentRevisionGarbageCollection MBean). Pour plus d’informations sur le MBean SegmentRevisionGarbageCollection, lisez le paragraphe suivant.
Les progrès peuvent être suivis à partir de l’attribut EstimatedRevisionGCCompletion de SegmentRevisionGarbageCollection MBean.
Vous pouvez obtenir une référence du MBean à l’aide de la variable ObjectName org.apache.jackrabbit.oak:name="Segment node store revision garbage collection",type="SegmentRevisionGarbageCollection".
Les statistiques sont disponibles uniquement à partir du dernier démarrage du système. L’outil de surveillance externe peut être utilisé pour conserver les données au-delà de la disponibilité d’AEM.
- Le nettoyage des révisions en ligne a démarré/s’est arrêté
- Le nettoyage des révisions en ligne se compose de trois phases : estimation, compression et nettoyage. La phase d’estimation peut forcer l’omission des phases de compression et de nettoyage si le référentiel ne contient pas suffisamment de résidus. Dans la dernière version d’AEM, le message «
TarMK GC #{}: estimation started» marque le début de l’estimation, «TarMK GC #{}: compaction started, strategy={}» marque le début de la compression et « TarMK GC #{}: cleanup started. Current repository size is {} ({} bytes» marque le début du nettoyage.
- Le nettoyage des révisions en ligne se compose de trois phases : estimation, compression et nettoyage. La phase d’estimation peut forcer l’omission des phases de compression et de nettoyage si le référentiel ne contient pas suffisamment de résidus. Dans la dernière version d’AEM, le message «
- Espace disque gagné par le nettoyage de révision
- L’espace n’est récupéré que lorsque la phase de nettoyage est terminée. La fin de la phase de nettoyage est marquée par le message du journal « T
arMK GC #{}: cleanup completed in {} ({} ms». La taille après nettoyage est {} ({} octets) et l’espace récupéré{} ({} octets). Le poids/la profondeur de la carte de compression est {}/{} ({} octets/{}).
- L’espace n’est récupéré que lorsque la phase de nettoyage est terminée. La fin de la phase de nettoyage est marquée par le message du journal « T
- Un problème s’est produit pendant le nettoyage des révisions.
- Il existe de nombreuses conditions d’échec. Elles comportent toutes des messages AVERTISSEMENT ou ERREUR du journal commençant par « TarMK GC ».
Consultez également la section Dépannage basé sur les messages d’erreur ci-dessous.
TarMK GC #3: cleanup completed », incluant la taille du référentiel et la quantité de déchets récupérés.Une vérification de l’intégrité du référentiel n’est pas nécessaire après le nettoyage des révisions en ligne.
Cependant, vous pouvez effectuer les actions suivantes pour vérifier le statut du référentiel après le nettoyage :
- Une vérification transversale du référentiel
- Utilisez l’outil oak-run une fois le processus de nettoyage terminé pour rechercher les incohérences. Pour plus d’informations sur la procédure à suivre, consultez la section Documentation Apache. Il n’est pas nécessaire de désactiver AEM pour exécuter l’outil.
Le contrôle de l’intégrité du nettoyage des révisions est intégré au Tableau de bord des opérations.
Le statut apparaît en VERT si la dernière exécution de la tâche de maintenance de nettoyage des révisions en ligne a été effectuée avec succès.
Il apparaît en JAUNE si la tâche de maintenance du nettoyage des révisions en ligne a été annulée une fois.
Le statut apparaît en ROUGE si la tâche de maintenance du nettoyage des révisions en ligne a été annulée trois fois d’affilée. Dans ce cas, une interaction manuelle est nécessaire ou le nettoyage des révisions en ligne va probablement continuer à échouer. Pour plus d’informations, reportez-vous à la section Dépannage ci-dessous.
Veuillez aussi noter que le statut du contrôle d’intégrité est réinitialisé après le redémarrage du système. Ainsi, une instance qui vient d’être redémarrée affiche un statut vert sur le contrôle d’intégrité du nettoyage des révisions. L’outil de surveillance externe peut être utilisé pour conserver les données au-delà de la disponibilité d’AEM.
Le statut, la progression et les statistiques sont exposés via JMX en utilisant le MBean SegmentRevisionGarbageCollection. Consultez également la Documentation Oak qui suit.
Vous pouvez obtenir une référence du MBean à l’aide de ObjectName org.apache.jackrabbit.oak:name="Segment node store revision garbage collection",type="SegmentRevisionGarbageCollection".
Notez que les statistiques sont disponibles uniquement à partir du dernier démarrage du système. L’outil de surveillance externe peut être utilisé pour conserver les données au-delà de la disponibilité d’AEM.
Les fichiers de journal peuvent aussi être utilisés pour vérifier le statut, la progression et les statistiques du nettoyage automatique.
- L’espace disque doit être surveillé lors de l’exécution du nettoyage automatique.
- Le délai d’exécution (via les journaux) pour vous assurer que 2 heures ne sont pas dépassées.
- La taille de l’entrepôt de segments après l’exécution du nettoyage automatique. La taille de l’entrepôt de segments sur l’instance de secours doit être à peu près le même que celle de l’instance principale.
Dépannage du nettoyage des révisions en ligne
Vous pouvez prendre plusieurs mesures pour trouver et résoudre le problème :
-
Tout d’abord, vérifiez les entrées du journal.
-
Selon les informations contenues dans les journaux, prenez les mesures appropriées :
- Si les journaux montrent cinq cycles de compression ratés ainsi qu’un long délai du cycle
forceCompact, programmez une fenêtre de maintenance pendant une période calme durant laquelle la quantité d’écriture du référentiel est faible. Vous pouvez vérifier les écritures du référentiel dans l’outil de surveillance des mesures du référentiel à l’adresse https://serveraddress:serverport/libs/granite/operations/content/monitoring/page.html. - Si le nettoyage s’est arrêté à la fin de la fenêtre de maintenance, assurez-vous que la configuration de la fenêtre de maintenance dans l’interface utilisateur Tâches de maintenance est assez longue.
- Si la mémoire de tas disponible n’est pas suffisante, assurez-vous que l’instance dispose de suffisamment de mémoire.
- En cas de réaction tardive, le magasin de segments risque d’augmenter trop pour que le nettoyage des révisions en ligne se termine, même dans une fenêtre de maintenance plus longue. Par exemple, si aucun nettoyage des révisions en ligne n’a réussi au cours de la dernière semaine, il est recommandé de planifier une maintenance hors ligne et d’exécuter le nettoyage des révisions hors ligne afin de ramener le magasin de segments à une taille gérable.
- Si les journaux montrent cinq cycles de compression ratés ainsi qu’un long délai du cycle
SegmentNotFoundException dans le fichier error.log et comment puis-je les récupérer ?Un SegmentNotFoundException est enregistré par TarMK lorsqu’il tente d’accéder à une unité de stockage (un segment) qu’il ne peut pas localiser. Trois scénarios peuvent provoquer ce problème :
- Une application qui contourne les mécanismes d’accès recommandés (tels que Sling et l’API JCR) et utilise une API/SPI de niveau inférieur pour accéder au référentiel, puis dépasse la durée de conservation d’un segment. En d’autres termes, elle conserve une référence à une entité plus longue que la durée de conservation autorisée par le nettoyage des révisions en ligne (24 heures par défaut). Ce cas est transitoire et ne conduit pas à la corruption des données. Pour effectuer une restauration, l’outil exécuté par Oak doit être utilisé pour confirmer la nature transitoire de l’exception (la vérification exécutée par Oak ne doit signaler aucune erreur). Pour cela, cette instance doit être déconnectée et relancée plus tard.
- Un événement externe a provoqué la corruption des données sur le disque. Il peut s’agir d’une défaillance du disque, d’un manque d’espace disque ou d’une modification accidentelle des fichiers de données requis. Dans ce cas, l’instance doit être mise hors ligne et réparée à l’aide de la vérification oak-run. Pour plus d’informations sur la façon de procéder à la vérification exécutée par Oak, lisez la documentation Apache suivante.
- Traitez toutes les autres occurrences via l’Assistance clientèle Adobe.
Dépannage basé sur les messages d’erreur
Le fichier error.log sera détaillé si des incidents se produisent pendant le processus de nettoyage des révisions en ligne. La matrice suivante vise à expliquer les messages les plus courants et à fournir des solutions possibles :
Comment exécuter le nettoyage des révisions hors ligne
CAUTIONAdobe propose un outil appelé Oak-run pour effectuer le nettoyage des révisions. Il peut être téléchargé à l’emplacement suivant :
https://repo1.maven.org/maven2/org/apache/jackrabbit/oak-run/
L’outil est un fichier jar exécutable qui peut être exécuté manuellement pour compresser le référentiel. Le processus est appelé nettoyage des révisions hors ligne, car le référentiel doit être arrêté pour pouvoir exécuter correctement l’outil. Veillez à planifier le nettoyage en fonction de votre fenêtre de maintenance.
Pour obtenir des instructions sur la façon d’augmenter la performance du processus de nettoyage, reportez-vous à la section Amélioration de la performance du nettoyage des révisions hors ligne.
NOTE-
Assurez-vous toujours de disposer d’une sauvegarde récente de l’instance AEM.
Arrêtez AEM.
-
(Facultatif) Utilisez l’outil pour rechercher les anciens points de contrôle :
java -jar oak-run.jar checkpoints install-folder/crx-quickstart/repository/segmentstore -
(Facultatif) Supprimez ensuite les points de contrôle non référencés :
java -jar oak-run.jar checkpoints install-folder/crx-quickstart/repository/segmentstore rm-unreferenced -
Exécutez la compression et attendez qu’elle soit terminée :
java -jar -Dsun.arch.data.model=32 oak-run.jar compact install-folder/crx-quickstart/repository/segmentstore
Amélioration des performances du nettoyage des révisions hors ligne
L’outil oak-run présente plusieurs fonctionnalités qui visent à améliorer les performances du processus de nettoyage des révisions et à réduire la fenêtre de maintenance autant que possible.
La liste comprend plusieurs paramètres de ligne de commande, comme décrit ci-dessous :
-
-mmap. Vous pouvez le définir sur true ou false. S’il est défini sur true, l’accès mappé à la mémoire est utilisé. S’il est défini sur false, l’accès aux fichiers est utilisé. S’il n’est pas spécifié, l’accès mappé à la mémoire est utilisé sur les systèmes 64 bits et l’accès aux fichiers est utilisé sur les systèmes 32 bits. Sous Windows, l’accès aux fichiers standard est toujours appliqué et cette option est ignorée. Ce paramètre remplace le paramètre -Dtar.memoryMapped.
-
-Dupdate.limit. Définit le seuil de vidage d’une transaction temporaire sur le disque. La valeur par défaut est 10000.
-
-Dcompress-interval. Nombre d’entrées du mappage de compression à conserver jusqu’à la compression du mappage actuel. La valeur par défaut est 1000000. Si une mémoire de tas suffisante est disponible, vous devez augmenter cette valeur sur un nombre encore plus élevé pour accélérer le débit. Ce paramètre a été supprimé dans Oak version 1.6 et est sans effet.
-
-Dcompaction-progress-log. Nombre de nœuds compactés qui sont consignés. La valeur par défaut est 150000, ce qui signifie que les 150 000 premiers nœuds compacts figurent dans le journal pendant l’opération. Utilisez-la avec le paramètre suivant décrit ci-dessous.
-
-Dtar.PersistCompactionMap. Définissez ce paramètre sur true pour utiliser l’espace disque plutôt que la mémoire disponible pour la persistance du mappage de compression. Nécessite l’outil oak-run 1.4 ou une version ultérieure. Pour plus de détails, reportez-vous à la question 3 dans la section FAQ sur le nettoyage des révisions hors ligne. Ce paramètre a été supprimé dans Oak version 1.6 et est sans effet.
-
–force. Force la compression et ignore toute version de magasin de segments sans correspondance.
CAUTION--force met à niveau le magasin de segments vers la version la plus récente, qui est incompatible avec les versions précédentes d’Oak. Sachez également qu’aucun déclassement n’est possible. En règle générale, vous devez utiliser ces paramètres avec précaution et uniquement si vous savez comment les utiliser.Exemple des paramètres utilisés :
java -Dupdate.limit=10000 -Dcompaction-progress-log=150000 -Dlogback.configurationFile=logback.xml -Xmx8g -jar oak-run-*.jar checkpoints <repository>
Autres méthodes de déclenchement du nettoyage des révisions
Outre les méthodes présentées ci-dessus, vous pouvez déclencher le mécanisme de nettoyage des révisions à l’aide de la console JMX comme suit :
- Ouvrez la console JMX en accédant à http://localhost:4502/system/console/jmx.
- Cliquez sur le MBean RevisionGarbageCollection.
- Dans la fenêtre suivante, cliquez sur startRevisionGC(), puis sur Appeler pour démarrer la tâche de nettoyage de la mémoire.
FAQ sur le nettoyage des révisions hors ligne
- Révision Oak : Oak organise tout le contenu dans une grande hiérarchie d’arborescence qui se compose de nœuds et de propriétés. Chaque instantané ou révision de cette arborescence de contenu est immuable et les modifications apportées à l’arborescence sont exprimées sous la forme d’une séquence de nouvelles révisions. En règle générale, chaque modification de contenu déclenche une nouvelle révision. Consultez également le Lien de suivi.
- Version de page : le contrôle de version crée un « instantané » d’une page à un moment spécifique dans le temps. En règle générale, une nouvelle version est créée lorsqu’une page est activée. Pour plus d’informations, consultez la section Utilisation des versions de page.
InMemoryCompactionMap.findEntry, utilisez le paramètre suivant avec l’outil oak-run version 1.4 ou une version ultérieure : -Dtar.PersistCompactionMap=true. Le paramètre -Dtar.PersistCompactionMap a été supprimé dans Oak version 1.6.