oak-run.jar を使用したインデックスの管理

最終更新日: 2024-01-29
  • トピック:
  • Search
    このトピックの詳細を表示
  • 作成対象:
  • Experienced
    Developer

oak-run.jar の index コマンドには、インデックス統計の収集、インデックスの整合性チェックの実行、インデックス自体の作成/再作成など、AEM で Oak200 インデックスを管理するための様々な機能が統合されています。

メモ

この記事とビデオでは、インデックス作成とインデックス再作成という用語が同じ意味に使用され、同じ操作と見なされています。

oak-run.jar index コマンドの基本

  • 使用される oak-run.jar のバージョンは、AEM インスタンスで使用される Oak のバージョンと一致する必要があります。

  • oak-run.jar を使用してインデックスを管理する場合は、index コマンドを様々なフラグと共に活用して、様々な操作をサポートします。

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

インデックスの統計

  • oak-run.jar では、すべてのインデックス定義、重要なインデックス統計およびインデックス内容をオフライン分析用にダンプします。
  • インデックス統計の収集は、使用中の AEM インスタンスで安全に実行できます。

インデックスの整合性チェック

  • oak-run.jar では、Lucene Oak インデックスが破損しているかどうかをすばやく判別します。
  • 整合性チェックレベル 1 および 2 の場合は、使用中の AEM インスタンスで整合性チェックを安全に実行できます。

oak-run.jar を使用した TarMK オンラインインデックス作成

  • oak-run.jar を使用した TarMK のオンラインインデックス作成は、oak:queryIndexDefinition ノードで reindex=true を設定するよりも高速です。パフォーマンスは向上しますが、oak-run.jar を使用したオンラインインデックス作成には、インデックス作成を実行するためのメンテナンスウィンドウが必要です。

  • oak-run.jar を使用した TarMK のオンラインインデックス作成を、AEM インスタンスのメンテナンスウィンドウ外で AEM インスタンスに対して実行することは​できません

oak-run.jar を使用した TarMK オフラインインデックス作成

  • oak-run.jar を使用した TarMK のオフラインインデックス作成は、単一の oak-run.jar コマンドのみ必要なので、TarMK を対象とする oak-run.jar ベースの最もシンプルなインデックス作成アプローチですが、使用するには、AEM インスタンスをシャットダウンする必要があります。

oak-run.jar を使用した TarMK アウトオブバンドインデックス作成

  • oak-run.jar を使用した TarMK でのアウトオブバンドインデックス作成により、使用中の AEM インスタンスに対するインデックス作成の影響を最小限に抑えることができます。
  • アウトオブバンドインデックス作成は、インデックス作成/再作成に要する時間が使用可能なメンテナンスウィンドウを超える場合に、AEM インストールで推奨されるインデックス作成アプローチです。

oak-run.jar を使用した MongoMK オンラインインデックス作成

  • MongoMK や RDBMK で oak-run.jar を使用したオンラインインデックス作成は、MongoMK(および RDBMK)の AEM インストールのインデックス作成/再作成に推奨される方法です。MongoMK または RDBMK には、それ以外の方法を使用しないでください。
  • このインデックス作成は、クラスター内の単一の AEM インスタンスに対してのみ実行する必要があります。
  • MongoMK のオンラインインデックス作成は、リポジトリトラバーサルが 1 つの MongoDB ノードでのみ発生し、その他のノードがパフォーマンスへの重大な影響を受けずにリクエストを処理し続けることができるので、実行中の AEM クラスターに対して安全に実行できます。

MongoMK のオンラインインデックス作成を実行する oak-run.jar インデックスコマンドは、 TarMK オンラインインデックス作成と同じ( oak-run.jar を使用した場合)ですが、セグメントストアパラメーターがノードストアを含んだ MongoDB インスタンスを指している点が異なります。

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

サポート資料

このページ