Utilisation de oak-run.jar pour gérer les index

oak-run.jarLa commande d’index de Oak regroupe un certain nombre de fonctionnalités permettant de gérer200 index 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.

REMARQUE

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.

oak-run.jar base des commandes d’index

  • 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 utilise la commande index avec différents indicateurs pour prendre en charge différentes opérations.

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

Statistiques sur les 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 de l’index

  • oak-run.jar détermine rapidement si les index Lucene Oak sont corrompus.
  • La vérification de cohérence peut être exécutée en toute sécurité sur l’instance AEM en cours d’utilisation pour les niveaux de contrôle de cohérence 1 et 2.

Indexation TarMK en ligne avec oak-run.jar

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

  • L’indexation en ligne de TarMK à l’aide de oak-run.jar doit ne pas être exécutée par rapport aux 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 à l’aide de oak-run.jar est l’approche d’indexation la plus simple oak-run.jar pour TarMK, car elle nécessite une seule commande oak-run.jar, mais elle nécessite l’arrêt de l’instance d’AEM.

Indexation hors bande TarMK avec oak-run.jar

  • L’indexation hors-bande sur TarMK à l’aide de oak-run.jar réduit l’impact de l’indexation sur les instances d’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 MongoMK Online avec oak-run.jar

  • L’index en ligne avec oak-run.jar sur MongoMK et RDBMK est la méthode recommandée pour réindexer les installations MongoMK (et RDBMK) AEM. 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 de la grappe.
  • L’indexation en ligne de MongoMK peut s’exécuter 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 noeud MongoDB, ce qui permet aux autres de continuer à traiter des requêtes sans impact significatif sur les performances.

La commande d’index oak-run.jar pour effectuer une indexation en ligne de MongoMK est la 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 noeuds.

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

Sur cette page