Indexation par l’intermédiaire du fichier Jar d’Oak-run indexing-via-the-oak-run-jar
Oak-run prend en charge tous les cas d’utilisation d’indexation sur la ligne de commande sans avoir à opérer au niveau JMX. Les avantages de l’approche oak-run sont les suivants :
- Elle constitue un nouvel ensemble d’outils d’indexation pour AEM 6.4.
- Elle réduit la durée de réindexation, ce qui a un effet bénéfique sur les délais de réindexation des référentiels de grande taille.
- Elle réduit la consommation des ressources au cours de la réindexation dans AEM, ce qui se traduit par de meilleures performances du système pour d’autres activités AEM.
- Oak-run fournit une prise en charge hors-bande : si les conditions d’exploitation ne vous permettent pas d’exécuter une réindexation sur les instances d’exploitation, un environnement cloné peut être utilisé à cette fin afin d’éviter un impact critique sur les performances.
Vous trouverez ci-dessous une liste de cas d’utilisation qui peuvent être utilisés lors de l’exécution d’opérations d’indexation au moyen de l’outil oak-run
.
Contrôles de cohérence d’index indexconsistencychecks
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.
Statistiques d’index indexstatistics
oak-run.jar
vide toutes les définitions d’index, toutes les statistiques d’index importantes, ainsi que tout le contenu d’index en vue d’une analyse hors ligne.- Son exécution est recommandée sur une instance AEM en cours d’utilisation.
Arborescence décisionnelle d’approche de réindexation reindexingapproachdecisiontree
Ce diagramme illustre une arborescence de décision concernant l’utilisation des diverses approches de réindexation.
Réindexation de MongoMK/RDMBMK reindexingmongomk
Pré-extraction de texte pour SegmentNodeStore et DocumentNodeStore textpre-extraction
La pré-extraction de texte (fonctionnalité d’AEM 6.3) peut être utilisée pour réduire le temps de réindexation. La pré-extraction de texte peut être utilisée avec toutes les approches de réindexation.
En fonction de l’approche d’indexation du fichier oak-run.jar
, diverses étapes sont effectuées de part et d’autre de l’étape « Procéder à la réindexation » dans le diagramme ci-dessous.
Réindexation en ligne pour MongoMK ou RDBMK à l’aide du fichier oak-run.jar onlinere-indexingformongomk
Il s’agit de la méthode recommandée pour réindexer les installations AEM MongoMK (et RDBMK). Aucune autre méthode ne doit être utilisée.
Exécutez ce processus uniquement sur une seule instance AEM du cluster.
Réindexation de TarMK re-indexingtarmk
-
Observations relatives à Cold Standby (TarMK)
- Il n’existe aucune considération spéciale pour les reprises à froid (Cold Standby). La synchronisation des instances Cold Standby change comme d’habitude.
-
Fermes de publication AEM (les fermes de publication AEM doivent toujours être TarMK)
- Dans le cas de fermes de publication, veuillez exécuter les étapes sur la totalité des publications OU sur une seule publication. Ensuite, clonez la configuration pour les autres publications (en prenant toutes les précautions habituelles lors du clonage d’instances AEM ; sling.id - doit ici pointer vers un élément).
Réindexation en ligne pour TarMK onlinere-indexingfortarmk
Il s’agit de la méthode utilisée avant l’introduction des nouvelles fonctionnalités d’indexation du fichier oak-run.jar. Elle peut être exécutée en définissant la propriété reindex=true
sur l’index Oak.
Cette approche peut être utilisée si les effets sur le temps et les performances à indexer sont acceptables pour la clientèle. C’est souvent le cas pour les installations AEM de petite et de moyenne tailles.
Réindexation en ligne de TarMK à l’aide du fichier oak-run.jar onlinere-indexingtarmkusingoak-run-jar
La réindexation en ligne de TarMK à l’aide du fichier oak-run.jar est plus rapide que la Réindexation en ligne pour TarMK décrite ci-dessus. Cependant, elle exige également d’être exécutée au cours d’une fenêtre de maintenance, en sachant que cette fenêtre sera plus étroite. Son exécution s’accompagne, en outre, d’étapes supplémentaires.
Réindexation hors ligne de TarMK à l’aide du fichier oak-run.jar offlinere-indexingtarmkusingoak-run-jar
La réindexation hors ligne de TarMK est la méthode de réindexation la plus simple basée sur le fichier oak-run.jar
, en ce sens qu’elle ne nécessite qu’un seul commentaire oak-run.jar
. Toutefois, elle nécessite que l’instance AEM soit arrêtée.
Réindexation hors-bande de TarMK à l’aide du fichier oak-run.jar out-of-bandre-indexingtarmkusingoak-run-jar
L’indexation hors bande réduit l’impact de l’indexation sur les instances AEM en cours d’utilisation.
Mise à jour des définitions d’indexation updatingindexingdefinitions
Création et mise à jour des définitions d’index sur TarMK à l’aide d’ACS Ensure Index creatingandupdatingindexdefinitionsontarmkusingacsensureindex
Celui-ci permet d’envoyer la définition d’index par le biais du package de contenu, ce qui entraîne une réindexation en définissant l’indicateur reindex sur true
. Cela fonctionne avec des petites configurations pour lesquelles la réindexation prend peu de temps.
Pour plus d’informations, reportez-vous à Documentation d’ACS Ensure Index.
Création et mise à jour des définitions d’index sur TarMK à l’aide du fichier oak-run.jar creatingandupdatingindexdefinitionsontarmkusingoak-run-jar
Si l’exécution d’une réindexation à l’aide de méthodes autres que oak-run.jar
s’avère trop pénalisante sur le plan de la durée et des performances, vous pouvez adopter l’approche suivante basée sur oak-run.jar
pour importer et réindexer des définitions d’index Lucene dans une installation AEM basée sur TarMK.
Création et mise à jour des définitions d’index sur MongoMK à l’aide du fichier oak-run.jar creatingandupdatingindexdefinitionsonmonogmkusingoak-run-jar
Si l’exécution d’une réindexation à l’aide de méthodes autres que oak-run.jar
s’avère trop pénalisante sur le plan de la durée et des performances, vous pouvez adopter l’approche suivante basée sur oak-run.jar
pour importer et réindexer des définitions d’index Lucene dans une installation AEM basée sur MongoMK.