Oak-run Jar を使用したインデックス作成

Oak-run は、コマンドラインでのすべてのインデックス作成の使用例をサポートします。JMX レベルで操作する必要はありません。次に Oak-run アプローチのメリットを示します。

1. AEM 6.4 用の新しいインデックス作成ツールセットです。
2. これにより、インデックスの再作成に要する時間が短縮され、大規模なリポジトリでのインデックスの再作成に役立ちます。
3. AEM でのインデックス再作成時のリソース消費を削減します。これにより、他の AEM アクティビティのシステムパフォーマンスが向上します。
4. Oak-runは、帯域外サポートを提供します。実稼動環境で実稼動インスタンスに対して再インデックスを実行できない場合は、重要なパフォーマンスへの影響を避けるために、クローン環境を使用してインデックスを再作成できます。

次に、oak-run ツールを使用したインデックス作成操作を実行する際に活用できる使用例のリストを示します。

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

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

インデックスの統計

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

インデックス再作成アプローチのデシジョンツリー

次の図に、様々なインデックス再作成アプローチを使用する状況に関するデシジョンツリーを示します。

MongoMK／RDMBMK のインデックス再作成

SegmentNodeStore および DocumentNodeStore のテキスト事前抽出

テキスト事前抽出（AEM 6.3 まで存在した機能）を使用して、インデックス再作成までの時間を削減できます。テキスト事前抽出は、すべてのインデックス再作成アプローチと連携して使用できます。

oak-run.jar インデックス作成アプローチに応じて、次の図のインデックス再作成の実行手順のどちらの側にも様々な手順があります。

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

これは、MongoMK（およびRDBMK） AEMインストールのインデックス再作成に推奨される方法です。 他の方法は使用しないでください。

このプロセスは、クラスターの単一の AEM インスタンスに対してのみ実行する必要があります。

TarMK のインデックス再作成

• コールドスタンバイに関する考慮事項（TarMK）

  • コールドスタンバイに関して特別な考慮事項はありません。コールドスタンバイインスタンスは、通常どおり変更を同期します。

• AEM パブリッシュファーム（AEM パブリッシュファームは常に TarMK である必要があります）

  • パブリッシュファームの場合は、すべてのパブリッシュで実行するか、単一のパブリッシュでこの手順を実行してから他のセットアップのクローンを作成する必要があります（AEM インスタンスのクローンを作成する際には、通常のすべての対策を取ります。sling.id をここの何かにリンクする必要があります）。

TarMK のオンラインインデックス再作成

これは、oak-run.jarの新しいインデックス作成機能が導入される前に使用された方法です。 Oak インデックスの reindex=true プロパティを設定することによっておこなうことができます。

この方法は、インデックス作成のための時間とパフォーマンスへの影響をお客様が受け入れられる場合に使用できます。これは、小～中規模の AEM インストールでよくある事例です。

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

oak-run.jarを使用したTarMKのオンラインインデックス再作成は、前述のTarMK🔗のオンラインインデックス再作成よりも高速です。 ただし、メンテナンスウィンドウ中にも実行する必要があります。ウィンドウが短くなり、インデックスの再作成を実行するためにより多くの手順が必要になるというメンションが表示されます。

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

TarMK のオフラインインデックス再作成は、1 つの oak-run.jar コメントが必要となる、TarMK 用の最も簡単な oak-run.jar ベースのインデックス再作成アプローチです。ただし、AEM インスタンスをシャットダウンする必要があります。

oak-run.jar を使用した TarMK の Out-of-band インデックス再作成

Out-of-band インデックス再作成は、使用中の AEM インスタンスに対するインデックス再作成の影響を最小化します。

インデックス作成定義の更新

ACS Ensure Index を使用した TarMK でのインデックス定義の作成と更新

これにより、コンテンツパッケージを介してインデックス定義を送信でき、後で再インデックスフラグをtrueに設定して再インデックスを実行できます。 これは、インデックスの再作成に時間がかからない小規模なセットアップで機能します。

詳しくは、ACS Ensure Index のドキュメントを参照してください。

oak-run.jar を使用した TarMK でのインデックス定義の作成と更新

oak-run.jar 以外の方法を使用したインデックス再作成の時間またはパフォーマンスへの影響が大きすぎる場合、次の oak-run.jar ベースのアプローチを使用して、TarMK ベースの AEM インストール環境に Lucene インデックス定義を読み込んでインデックスを再作成できます。

oak-run.jar を使用した MonogMK でのインデックス定義の作成と更新

oak-run.jar 以外の方法を使用したインデックス再作成の時間またはパフォーマンスへの影響が大きすぎる場合、次の oak-run.jar ベースのアプローチを使用して、MongoMK ベースの AEM インストール環境に Lucene インデックス定義を読み込んでインデックスを再作成できます。