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. Ceci 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 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 par la suite 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.
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 le service clientèle d’Adobe vous demande de le faire.
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.
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 :
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.
AEM 6.5 s’accompagne de deux nouveaux modes pour la phase de compression du processus de nettoyage des révisions en ligne :
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 :
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
, gardez à l’esprit que la compression complète sera exécutée le(s) jour(s) défini(s) dans la valeur, l’autre mode de compression étant exécuté 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écutera 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.
En outre, prenez les éléments suivants en considération :
Lors de l’utilisation des nouveaux modes de compression, gardez à l’esprit les points suivants :
RevisionCleanupTaskHealthCheck
indique 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.TarMK GC: running tail compaction
TarMK GC: no base state available, running full compaction instead
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.
Questions | Réponses |
De quoi dois-je tenir compte lorsque j’effectue une mise à niveau vers 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(nt) 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. |
Questions | Réponses | |
Pourquoi dois-je faire migrer le référentiel ? | 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 :
|
|
Le format Tar précédent est-il toujours pris en charge ? | Seul le nouveau Oak Segment Tar est pris en charge dans AEM 6.3 ou les versions ultérieures. | |
La migration du contenu est-elle toujours obligatoire ? | Oui. À moins de commencer avec une nouvelle instance, vous devrez toujours migrer le contenu. | |
Puis-je effectuer la mise à niveau vers 6.3 ou une version ultérieure et effectuer la migration plus tard (par exemple, en utilisant une autre fenêtre de maintenance) ? | Non, comme nous l’avons expliqué ci-dessus, la migration du contenu est obligatoire. | |
Les temps d’interruption peuvent-ils être évités durant la migration ? | Non. Il s’agit d’une opération unique qui ne peut pas être effectuée sur une instance en cours d’exécution. | |
Que se passe-t-il si j’exécute accidentellement le mauvais format de référentiel ? | Si vous essayez d’exécuter le module oak-segment sur un référentiel oak-segment-tar (ou inversement), le démarrage échoue avec une IllegalStateException, avec le message « Format de segment invalide ». Il n’y aura aucune corruption de données. | |
Une réindexation des index de recherche est-elle nécessaire ? | Non. La migration de oak-segment vers oak-segment-tar introduit des modifications dans le format du conteneur. Les données contenues ne sont pas affectées et ne sont pas modifiées. | |
Comment calculer au mieux l’espace disque attendu pendant et après la migration ? | La migration équivaut à recréer le magasin de segments dans le nouveau format. Vous pouvez l’utiliser pour estimer l’espace disque supplémentaire nécessaire lors de la migration. Après la migration, l’ancien magasin de segments peut être supprimé pour libérer de l’espace. | |
Comment estimer au mieux la durée de la migration ? | Les performances de la migration peuvent être sensiblement améliorées si un nettoyage des révisions hors ligne est exécuté en amont. Nous conseillons à tous les clients de l’exécuter en tant que conditions préalables à la mise à niveau. En règle générale, la durée de la migration doit être similaire à celle de la tâche de nettoyage des révisions hors ligne, en supposant que cette dernière ait été effectuée avant la migration. |
Questions | Réponses | |
À quelle fréquence le nettoyage des révisions en ligne doit-il être exécuté ? | Une fois par jour. Il s’agit de la configuration par défaut dans le tableau de bord des opérations. | |
Comment puis-je configurer l’heure de début de la tâche de maintenance du nettoyage des révisions en ligne ? | Consultez la section Exécution du nettoyage des révisions en ligne. | |
Existe-t-il une fréquence maximale ne devant pas être dépassée pour le nettoyage des révisions en ligne ? | Il est recommandé d’exécuter le nettoyage des révisions en ligne une fois par jour, tel que configuré par défaut. |
|
Quels sont les indicateurs clés permettant de déterminer à quelle fréquence le nettoyage des révisions en ligne doit être effectué ? | Il n’est pas nécessaire de déterminer la fréquence, étant donné que le nettoyage des révisions en ligne est configuré en tant que tâche de maintenance et s’exécute automatiquement de façon quotidienne. | |
Pourquoi le nettoyage des révisions en ligne ne récupère-t-il pas de l’espace lorsqu’il est exécuté pour la première fois ? | Le nettoyage des révisions en ligne récupère les anciennes révisions par génération. Une nouvelle génération est générée chaque fois que le nettoyage des révisions s’exécute. Seul le contenu vieux d’au moins deux générations sera récupéré, ce qui signifie qu’il n’y a rien à récupérer lors d’une première exécution. | |
Pourquoi le premier nettoyage des révisions en ligne ne permet-il pas de récupérer de l’espace lorsqu’il est exécuté après le nettoyage des révisions hors 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. |
|
L’auteur et la publication ont-ils des fenêtres de nettoyage des révisions en ligne différentes ? | Cela dépend des heures de travail et des modèles de trafic de la présence en ligne du client. Les fenêtres de maintenance doivent être configurées en dehors des heures d’exploitation majeures pour garantir un nettoyage efficace. S’il existe plusieurs instances de publication AEM (ferme TarMK), les fenêtres de maintenance pour le nettoyage des révisions en ligne doivent être fragmentées. | |
Existe-t-il des conditions préalables pour exécuter le nettoyage des révisions en ligne ? | Le nettoyage des révisions en ligne est disponible uniquement avec AEM 6.3 et les versions ultérieures. Aussi, si vous utilisez une ancienne version d’AEM, vous devrez effectuer une migration vers le nouvel Oak Segment Tar. |
|
Quels sont les facteurs qui déterminent la durée du nettoyage des révisions en ligne ? | Les facteurs sont les suivants :
|
|
Les auteurs peuvent-ils travailler pendant l’exécution du nettoyage des révisions en ligne ? | Oui, le nettoyage des révisions en ligne peut gérer les écritures simultanées. Cependant, le nettoyage des révisions en ligne fonctionne plus rapidement et plus efficacement sans transactions d’écriture simultanées. Il est recommandé de planifier la tâche de maintenance du nettoyage des révisions en ligne à un moment relativement calme sans beaucoup de trafic. | |
Quelles sont les conditions minimales requises en matière d’espace disque et de mémoire de tas lors de l’exécution du nettoyage des révisions en ligne ? | L’espace disque est surveillé en permanence lors du nettoyage des révisions en ligne. Si l’espace disque disponible tombe en dessous d’une valeur critique, le processus sera annulé. La valeur critique est de 25 % de l’empreinte disque actuelle du référentiel et elle n’est pas configurable. 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. L’espace libre du tas est surveillé en permanence pendant le processus de nettoyage. Si l’espace libre du tas tombe sous une valeur critique, le processus est 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 charge utile attendue, le processus de nettoyage obtiendra suffisamment de mémoire. |
|
Quel est l’impact attendu sur les performances pendant l’exécution du nettoyage des révisions en ligne ? | Le nettoyage des révisions en ligne est un processus en arrière-plan qui lit et écrit dans le référentiel en même temps que les opérations système normales. En particulier, il peut être nécessaire d’acquérir un accès exclusif au référentiel pendant une courte période, ce qui empêche d’autres threads d’écrire dans le référentiel. | |
Quelle est la durée estimée d’exécution du nettoyage des révisions en ligne ? | Cela ne devrait pas prendre plus de 2 heures d’après les derniers tests de performance que nous avons réalisés en interne. | |
Que faire si le nettoyage des révisions en ligne dure plus longtemps ? |
|
|
Que se passe-t-il si le nettoyage des révisions en ligne dépasse la fenêtre de maintenance configurée ? | Assurez-vous que d’autres tâches de maintenance ne retardent pas son exécution. Cela peut être le cas si plus de tâches de maintenance que de nettoyage des révisions en ligne sont exécutées dans la même fenêtre de maintenance. Notez que les tâches de maintenance sont exécutées de manière séquentielle sans ordre configurable. | |
Pourquoi le nettoyage de la mémoire est-il ignoré ? | 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 sera ignorée. Vous trouverez, ci-dessous, des entrées de journaux pertinentes pour la phase d’estimation :
|
|
Est-il possible d’annuler en toute sécurité la compression automatique si l’impact sur les performances est trop élevé ? | Oui. Depuis AEM 6.3, il est possible de l’arrêter en toute sécurité via la fenêtre des tâches de maintenance du tableau de bord des opérations ou via JMX. | |
Si l’instance AEM est arrêtée pendant une tâche de nettoyage programmée, le processus s’arrête-t-il de manière sécurisée ou l’arrêt est-il bloqué jusqu’à la réalisation complète de la compression ? | Le nettoyage des révisions est interrompu et le référentiel va s’arrêter en toute sécurité. | |
Que se passe-t-il si le système tombe en panne pendant le nettoyage des révisions en ligne ? | Dans de tels cas, il n’existe aucun risque de corruption des données. L’espace mémoire restant sera libéré lors d’une exécution ultérieure. | |
Qu’arrive-t-il lorsque vous n’effectuez pas le nettoyage des révisions en ligne ? | Le niveau de performances se dégrade au fil du temps. | |
Quelles révisions sont collectées ? | Par défaut, le nettoyage des révisions en ligne collecte uniquement les révisions datant d’au moins 24 heures. | |
Qu’arrive-t-il s’il y a beaucoup trop d’interférences des écritures simultanées avec le référentiel ? | 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 passera 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 sera abandonné au profit de validations simultanées. a durée de la compression forcée dépend des facteurs suivants :
|
|
Comment le nettoyage des révisions en ligne est-il exécuté sur une instance de secours ? |
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-il libérer plus d’espace disque que le nettoyage des révisions en ligne ? | 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. |
|
Observations relatives aux opérations de fichiers mappés par la mémoire |
|
|
Que doit-on surveiller pendant le nettoyage des révisions en ligne ? |
|
|
Comment vérifier si le nettoyage des révisions en ligne s’est terminé avec succès ? | Vous pouvez vérifier si le nettoyage des révisions en ligne s’est terminé correctement en vérifiant les journaux. Par exemple, « En conséquence, un message « |
|
Où trouver les statistiques des dernières exécutions de nettoyage des révisions en ligne ? | Le statut, la progression et les statistiques sont présentés via JMX ( Les progrès peuvent être suivis à partir de l’attribut Vous pouvez obtenir une référence du MBean à l’aide de la variable N’oubliez pas que les statistiques sont disponibles uniquement avec le dernier démarrage de système. L’outil de surveillance externe peut être utilisé pour conserver les données au-delà de la disponibilité d’AEM. Consultez la documentation AEM pour joindre les vérifications d’intégrité à Nagios en tant qu’exemple d’outil de surveillance externe. |
|
Quelles sont les entrées de journal pertinentes ? |
Consultez également la section Dépannage basé sur les messages d’erreur ci-dessous. |
|
Comment vérifier combien d’espace a été récupéré une fois le nettoyage des révisions en ligne terminé ? | Un message se trouve dans le journal à la fin du cycle de nettoyage : « TarMK GC #3: cleanup completed », incluant la taille du référentiel et la quantité de déchets récupérés. |
|
Comment vérifier l’intégrité du référentiel une fois le nettoyage des révisions en ligne terminé ? | 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 :
|
|
Comment détecter si le nettoyage des révisions en ligne a échoué et quelles sont les étapes de récupération ? | Les conditions d’échec comportent des messages de journal AVERTISSEMENT ou ERREUR commençant par « TarMK GC ». Consultez également la section Dépannage basé sur les messages d’erreur ci-dessous. | |
Quelles sont les informations présentées dans la vérification de l’intégrité du nettoyage des révisions ? Comment et quand contribue-t-elle aux niveaux de statut codés par des couleurs ? | 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îtra en VERT si la dernière exécution de la tâche de maintenance en ligne de nettoyage des révisions a été effectuée avec succès. Il apparaîtra en JAUNE si la tâche de maintenance du nettoyage des révisions en ligne a été annulée une fois. Le statut apparaîtra 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 de la vérification de l’intégrité sera réinitialisé après le redémarrage du système. Ainsi, une instance nouvellement redémarrée affichera un état vert sur le contrôle de l’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. Consultez la documentation AEM pour joindre les vérifications d’intégrité à Nagios en tant qu’exemple d’outil de surveillance externe. |
|
Comment surveiller le nettoyage automatique sur une instance secondaire ? |
Le statut, la progression et les statistiques sont présentés via JMX à l’aide de la variable MBean Vous pouvez obtenir une référence du MBean à l’aide de 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. Consultez également la documentation AEM pour joindre les contrôles d’intégrité à Nagios en tant qu’exemple d’outil de surveillance externe. Les fichiers de journal peuvent aussi être utilisés pour vérifier le statut, le progrès et les statistiques du nettoyage automatique. |
|
Que doit-on surveiller pendant le nettoyage automatique sur une instance secondaire ? |
|
Quel est le pire qui puisse arriver si vous n’exécutez pas le nettoyage des révisions en ligne ? | L’instance AEM ne disposera plus d’espace disque, ce qui causera des pannes d’exploitation. | |
Un trafic élevé d’utilisateurs risque-t-il de causer des problèmes d’exécution du nettoyage des révisions en ligne sur une instance de publication ? | Le trafic élevé d’utilisateurs peut impacter la réussite de l’exécution de la phase de compression. |
|
D’après la vérification d’intégrité et les entrées du journal, le processus de nettoyage des révisions en ligne a échoué trois fois de suite. Que doit-on faire pour assurer le succès du nettoyage des révisions en ligne ? | Vous pouvez prendre plusieurs mesures pour trouver et résoudre le problème :
|
|
Que doit-on faire une fois l’alerte de vérification d’intégrité activée ? | Voir le point précédent. | |
Que se passe-t-il lorsque le nettoyage des révisions en ligne est à court de temps pendant la fenêtre maintenance planifiée ? | Le nettoyage des révisions en ligne sera annulé et les restes seront supprimés. Elle recommence la prochaine fois que la fenêtre de maintenance est planifiée. | |
Qu’est-ce qui cause l’enregistrement des instances SegmentNotFoundException dans le fichier error.log et comment puis-je les récupérer ? |
Un
|
Le fichier error.log sera détaillé si des incidents surviennent 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 :
Phase | Messages du journal | Explication | Étapes suivantes |
---|---|---|---|
Estimation | TarMK GC #2 : estimation ignorée car la compression est suspendue. | La phase d’estimation est ignorée lorsque la compression est désactivée par configuration sur le système. | Activation du nettoyage des révisions en ligne. |
S/O | TarMK GC #2 : estimation interrompue : ${REASON}. Phase de compression ignorée. | La phase d’estimation s’est interrompue prématurément. Quelques exemples d’événements qui peuvent interrompre la phase d’estimation : pas suffisamment de mémoire ou d’espace disque sur le système hôte. | Dépend de la raison donnée. |
Compression | TarMK GC #2 : compression en pause. | Tant que la phase de compression est mise en pause par la configuration, ni la phase d’estimation, ni la phase de compression ne seront exécutées. | Activation du nettoyage des révisions en ligne. |
S/O | TarMK GC #2 : compression annulée : ${REASON}. | La phase de compression s’est interrompue prématurément. Quelques exemples d’événements qui peuvent interrompre la phase de compression : pas suffisamment de mémoire ou d’espace disque sur le système hôte. De plus, vous pouvez annuler la compression en éteignant le système ou en l’annulant de façon explicite par le biais des interfaces d’administration telles que la fenêtre de maintenance du tableau de bord des opérations. | Dépend de la raison donnée. |
S/O | TarMK GC #2 : la compression a échoué à la minute 32,902 (1 974 140 ms), après 5 cycles. | Ce message ne signifie pas qu’il existe une erreur irrécupérable, mais seulement que la compression s’est terminée après un certain nombre de tentatives. Lisez également le paragraphe suivant. | Lisez la Documentation Oak suivante et la dernière question sur l’Exécution du nettoyage des révisions en ligne. |
Nettoyage | TarMK GC #2 : nettoyage interrompu. | Le nettoyage a été annulé du fait de l’arrêt du référentiel. Aucun impact sur la cohérence n’est attendu. En outre, l’espace disque ne sera probablement pas récupéré dans sa totalité. Il sera récupéré lors du prochain cycle de nettoyage des révisions. | Découvrez pourquoi le référentiel s’est arrêté et essayez d’éviter de l’éteindre pendant les périodes de maintenance. |
Utilisez une version de l’outil Oak-run dont le numéro de version (majeure et mineure) correspond à la version principale Oak de votre installation AEM. Par exemple, si votre instance AEM dispose de la version de base 1.22.x d’Oak, vous devez utiliser la dernière version de l’outil Oak-run 1.22.x.
Adobe 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.
Vous pouvez également effacer les anciens points de contrôle avant la maintenance (étapes 2 et 3 de la procédure ci-dessous). Cela est recommandé uniquement pour les instances qui comportent plus de 100 points de contrôle.
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
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 seront consignés. La valeur par défaut est 150000, ce qui signifie que les 150000 premiers nœuds compacts figureront dans le journal pendant l’opération. Utilisez-la conjointement 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 plan 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 une version d’entrepôt de segments sans correspondance.
Le paramètre --force
met à niveau l’entrepôt de segments vers la version la plus récente, qui est incompatible avec les versions précédentes d’Oak. Tenez également compte du fait qu’aucune rétrogradation 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>
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 :
Quels sont les facteurs qui déterminent la durée du nettoyage des révisions hors ligne ? | La taille du référentiel et la quantité de révisions devant être nettoyées déterminent la durée du nettoyage. |
Quelle différence y a-t-il entre une révision et une version de page ? |
|
Comment accélérer la tâche de nettoyage des révisions hors ligne si elle n’est pas terminée au bout de 8 heures ? | Si la tâche de nettoyage n’est pas terminée au bout de 8 heures et que les images mémoire de threads font apparaître que la zone réactive principale est InMemoryCompactionMap.findEntry , utilisez le paramètre suivant avec l’outil oak-run version 1.4 ou une version ultérieure : -Dtar.PersistCompactionMap=true . Gardez à l’esprit que le paramètre -Dtar.PersistCompactionMap a été supprimé dans Oak version 1.6. |