Oak-run は、コマンドラインでのすべてのインデックス作成の使用例をサポートします。JMX レベルで操作する必要はありません。次に Oak-run アプローチのメリットを示します。
oak-run
ツールでインデックス作成操作を実行する際に活用できるユースケースのリストを以下に示します。
このシナリオについて詳しくは、使用例 1 - インデックスの整合性チェックを参照してください。
oak-run.jar
Lucene Oak インデックスが破損しているかどうかをすばやく判断します。このシナリオについて詳しくは、使用例 2 - インデックス統計を参照してください。
oak-run.jar
すべてのインデックス定義、重要なインデックス統計およびインデックス内容をオフライン分析用にダンプします。様々なインデックス再作成アプローチを使用すべき状況についてのデシジョンツリーを次の図に示します。
このシナリオについて詳しくは、使用例 3 - インデックス再作成を参照してください。
テキスト事前抽出(AEM 6.3 まで存在した機能)を使用して、インデックス再作成までの時間を削減できます。テキスト事前抽出は、すべてのインデックス再作成アプローチと連携して使用できます。
oak-run.jar
のインデックス作成アプローチに応じて、次の図に示す「インデックス再作成の実行」ステップのどちら側にも様々なステップがあります。
オレンジは、AEM がメンテナンスウィンドウ内にある必要があるアクティビティを意味します。
このシナリオについて詳しくは、インデックス再作成 - DocumentNodeStore を参照してください。
これは、MongoMK(および RDBMK)AEM インストールのインデックスを再作成する場合にお勧めする方法です。他の方法は使用しないでください。
このプロセスは、クラスターの単一の AEM インスタンスに対してのみ実行する必要があります。
このシナリオについて詳しくは、インデックス再作成 - SegmentNodeStore を参照してください。
コールドスタンバイに関する考慮事項(TarMK)
AEM パブリッシュファーム(AEM パブリッシュファームは常に TarMK である必要があります)
このシナリオについて詳しくは、オンラインのインデックス再作成 - SegmentNodeStore を参照してください。
これは、oak-run.jar の新しいインデックス作成機能の導入前に使用された方法です。Oak インデックスの reindex=true
プロパティを設定することで行うことができます。
この方法は、インデックス作成のための時間とパフォーマンスへの影響をお客様が受け入れられる場合に使用できます。これは、小~中規模の AEM インストールでよくある事例です。
このシナリオについて詳しくは、オンラインのインデックス再作成 - SegmentNodeStore - AEM インスタンス実行中を参照してください。
oak-run.jar を使用した TarMK のオンラインインデックス再作成は、上記の TarMK のオンラインインデックス再作成より高速です。ただし、メンテナンスウィンドウ中に実行する必要があり、時間は短くなりますが、インデックス再作成の実行に必要な手順が増えます。
オレンジ色は、メンテナンス期間中に AEM を実行する必要がある操作を示します。
このシナリオについて詳しくは、オンラインのインデックス再作成 - SegmentNodeStore - AEM インスタンスのシャットダウンを参照してください。
TarMK のオフラインインデックス再作成は、必要な oak-run.jar
コメントが 1 つだけなので、oak-run.jar
ベースの TarMK 用インデックス再作成アプローチとしては最も簡単です。ただし、AEM インスタンスをシャットダウンする必要があります。
赤は、AEM をシャットダウンする必要がある操作を意味します。
このシナリオについて詳しくは、Out of Band のインデックス再作成 - SegmentNodeStore を参照してください。
Out-of-band インデックス再作成は、使用中の AEM インスタンスに対するインデックス再作成の影響を最小化します。
赤は、AEM をシャットダウンしたほうがよい操作を意味します。
このシナリオについて詳しくは、ユースケース 4 - インデックス定義の更新を参照してください。
ACS Ensure Index は、コミュニティがサポートするプロジェクトで、アドビサポートはサポートしていません。
これにより、コンテンツパッケージを介したインデックス定義の送信が可能になり、reindex フラグを true
に設定すれば、後でインデックスが再作成されることになります。これは、インデックス再作成に時間がかからない小規模なセットアップで機能します。
詳しくは、ACS Ensure Index のドキュメントを参照してください。
oak-run.jar
以外の方法を使用したインデックス再作成の時間またはパフォーマンスへの影響が大きすぎる場合、次の oak-run.jar
ベースのアプローチを使用して、TarMK ベースの AEM インストール環境に Lucene インデックス定義をインポートしてインデックスを再作成できます。
oak-run.jar
以外の方法を使用したインデックス再作成の時間またはパフォーマンスへの影響が大きすぎる場合、次の oak-run.jar
ベースのアプローチを使用して、MongoMK ベースの AEM インストール環境に Lucene インデックス定義をインポートしてインデックスを再作成できます。