DokumentationAEMAEM-TutorialsAEM Foundation-Tutorials

Verwenden von oak-run.jar zum Verwalten von Indizes

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Experte
  • Entwickler

Der Index-Befehl oak-run.jar konsolidiert eine Reihe von Funktionen zur Verwaltung von Oak200 Indizes in AEM: der Erfassung von Indexstatistiken über die Durchführung von Indexkonsistenzprüfungen bis hin zur Neuindizierung von Indizes selbst.

NOTE
In diesem Artikel und in den Videos werden die Begriffe Indizierung und Neuindizierung synonym verwendet und als derselbe Vorgang betrachtet.

oak-run.jar Grundlagen zum Index-Befehl

https://video.tv.adobe.com/v/21475?quality=12&learn=on

  • Die verwendete Version von oak-run.jar muss mit der auf der AEM-Instanz verwendeten Version von Oak übereinstimmen.

  • Die Verwaltung von Indizes mit oak-run.jar nutzt den Befehl index mit verschiedenen Flags zur Unterstützung verschiedener Operationen.

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

Indexstatistiken

https://video.tv.adobe.com/v/21477?quality=12&learn=on

  • oak-run.jar sichert alle Indexdefinitionen, wichtige Indexstatistiken und Indexinhalte für Offline-Analysen.
  • Das Sammeln von Indexstatistiken kann sicher auf in Betrieb befindlichen AEM-Instanzen ausgeführt werden.

Indexkonsistenzprüfung

https://video.tv.adobe.com/v/21476?quality=12&learn=on

  • oak-run.jar ermittelt schnell, ob Lucene Oak-Indizes beschädigt sind.
  • Die Konsistenzprüfung kann problemlos auf einer verwendeten AEM-Instanz ausgeführt werden, um die Konsistenz auf den Ebenen 1 und 2 zu prüfen.

TarMK Online-Indizierung mit oak-run.jar tarmkonlineindexingwithoakrunjar

https://video.tv.adobe.com/v/21479?quality=12&learn=on

  • Die Online-Indizierung von TarMK über oak-run.jar ist schneller als die Einstellung von reindex=true auf dem Knoten oak:queryIndexDefinition. Trotz dieser Leistungssteigerung erfordert die Online-Indizierung mit oak-run.jar immer noch ein Wartungsfenster, um die Indizierung durchzuführen.

  • Die Online-Indizierung von TarMK mit oak-run.jar sollte nicht für AEM-Instanzen außerhalb des AEM-Instanzen-Wartungsfensters ausgeführt werden.

TarMK Offline-Indizierung mit oak-run.jar

https://video.tv.adobe.com/v/21478?quality=12&learn=on

  • Die Offline-Indizierung von TarMK unter Verwendung von oak-run.jar ist der einfachste oak-run.jar-basierte Indizierungsansatz für TarMK, da er einen einzigen oak-run.jar-Befehl erfordert, allerdings muss dazu die AEM-Instanz heruntergefahren werden.

TarMK Out-of-Band-Indizierung mit oak-run.jar

https://video.tv.adobe.com/v/21480?quality=12&learn=on

  • Die Out-of-Band-Indizierung auf TarMK mit oak-run.jar minimiert die Auswirkungen der Indizierung auf verwendete AEM-Instanzen.
  • Die Out-of-Band-Indizierung ist der empfohlene Indizierungsansatz für AEM-Installationen, bei denen die Zeit für die Neuindizierung/Indizierung die verfügbaren Wartungsfenster überschreitet.

MongoMK Online-Indizierung mit oak-run.jar

  • Der Online-Index mit oak-run.jar auf MongoMK und RDBMK ist die empfohlene Methode für die Neuindizierung von AEM-Installationen mit MongoMK (und RDBMK).  Es sollte keine andere Methode für MongoMK oder RDBMK angewendet werden.
  • Diese Indizierung muss nur für eine einzelne AEM-Instanz im Cluster ausgeführt werden.
  • Die Online-Indizierung von MongoMK kann sicher in einem laufenden AEM-Cluster ausgeführt werden, da der Repository-Durchlauf nur auf einem einzigen MongoDB-Knoten stattfindet, sodass die anderen Knoten weiterhin ohne nennenswerte Leistungseinbußen Anfragen bedienen können.

Der Index-Befehl von oak-run.jar zur Durchführung einer Online-Indizierung von MongoMK ist genauso wie die TarMK Online-Indizierung mit oak-run.jar, mit dem Unterschied, dass der Parameter für den Segment-Speicher auf die MongoDB-Instanz zeigt, die den Knotenspeicher enthält.

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

Hilfsmaterialien

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