Utiliser oak-run.jar pour gérer les index

La commande d’index oak-run.jar regroupe plusieurs fonctionnalités permettant de gérer 200 index Oak dans AEM, depuis la collecte des statistiques d’index, l’exécution des contrôles de cohérence d’index et la réindexation des index eux-mêmes.

NOTE
Dans cet article et les vidéos, les termes indexation et réindexation sont interchangeables et considérés comme la même opération.

Bases de la commande d’index oak-run.jar

  • La version de oak-run.jar utilisée doit correspondre à la version d’Oak utilisée sur l’instance AEM.

  • La gestion des index à l’aide de oak-run.jar tire parti de la commande index avec différents indicateurs pour prendre en charge différentes opérations.

    • java -jar oak-run*.jar index ...

Statistiques d’index

  • oak-run.jar vide toutes les définitions d’index, toutes les statistiques d’index importantes et tout le contenu d’index en vue d’une analyse hors ligne.
  • La collecte des statistiques d’index peut s’exécuter en toute sécurité sur les instances AEM en cours d’utilisation.

Contrôle de cohérence d’index

  • oak-run.jar détermine rapidement si les index Lucene Oak sont corrompus.
  • Il est recommandé de lancer l’exécution sur une instance AEM en cours d’utilisation pour les niveaux de contrôle de cohérence 1 et 2.

Indexation en ligne TarMK avec oak-run.jar tarmkonlineindexingwithoakrunjar

  • L’indexation en ligne de TarMK avec oak-run.jar est plus rapide que de définir reindex=true sur le nœud oak:queryIndexDefinition. Malgré cette augmentation des performances, l’indexation en ligne avec oak-run.jar nécessite toujours une fenêtre de maintenance pour effectuer l’indexation.

  • L’indexation en ligne de TarMK avec oak-run.jar ne doit pas être exécutée sur des instances AEM en dehors de la fenêtre de maintenance des instances AEM.

Indexation hors ligne TarMK avec oak-run.jar

  • L’indexation hors ligne de TarMK avec oak-run.jar constitue la méthode d’indexation basée sur oak-run.jar la plus simple pour TarMK, car elle nécessite une seule commande oak-run.jar. Toutefois, elle requiert l’arrêt de l’instance AEM.

Indexation hors bande TarMK avec oak-run.jar

  • L’indexation hors bande sur TarMK avec oak-run.jar réduit l’impact de l’indexation sur les instances AEM en cours d’utilisation.
  • L’indexation hors bande est l’approche d’indexation recommandée pour les installations AEM où le temps de réindexation/indexation dépasse les fenêtres de maintenance disponibles.

Indexation en ligne MongoMK avec oak-run.jar

  • L’indexation en ligne avec oak-run.jar sur MongoMK et RDBMK est la méthode recommandée pour la réindexation/indexation des installations AEM MongoMK (et RDBMK). Aucune autre méthode ne doit être utilisée pour MongoMK ou RDBMK.
  • Cette indexation ne doit être exécutée que sur une seule instance AEM du cluster.
  • L’indexation en ligne de MongoMK peut être exécutée en toute sécurité sur un cluster AEM en cours d’exécution, car la traversée du référentiel ne se produit que sur un seul nœud MongoDB, ce qui permet aux autres nœuds de continuer à traiter des demandes sans affecter considérablement les performances.

La commande d’index oak-run.jar pour effectuer une indexation en ligne de MongoMK est identique à l’indexation en ligne TarMK avec oak-run.jar à la différence que le paramètre de magasin de segments pointe vers l’instance MongoDB qui contient le magasin de nœuds.

java -jar oak-run*.jar index
 --reindex
 --index-paths=/oak:index/lucene
 --read-write
 --fds-path=/path/to/datastore mongodb://server:port/aem

Documents annexes

recommendation-more-help
c92bdb17-1e49-4e76-bcdd-89e4f85f45e6