oo

Elasticsearch 8へのアップグレード

7.4 u81+, 7.3 u31+

Elasticsearch 8は、最新のLiferay 7.4アップデートとGAリリースでサポートされ、推奨されています。 特定のバージョンの互換性の詳細については、 Search Engine Compatibility Matrix を参照してください。

important

Elasticsearchをアップグレードする前に、既存のデータをバックアップしてください。 アップグレード中またはアップグレード後に何か問題が発生した場合は、破損していないインデックスのスナップショットを使用して以前のバージョンにロールバックしてください。 Elasticsearchのバックアップ の手順に従ってください。

既存のElasticsearch 7サーバ(またはクラスタ)をElasticsearch 8にアップグレードするには、

  1. Liferay Companyとシステムインデックスをバックアップします

  2. 検索の調整のアプリケーション固有のインデックスをバックアップします (同義語セットと結果ランキング)。

  3. 新しいElasticsearchのインストールを準備する.

  4. Elasticsearch のアップグレード

  5. X-Packセキュリティを使用している場合、Elasticsearch 8ではデフォルトで有効になっています。 無効にするには、このプロパティを追加する:

    xpack.security.enabled: false
    

    セキュリティ設定の範囲の詳細については、 Elasticsearchの保護 を参照してください。

  6. Connector to Elasticsearch 8を設定してElasticsearchに接続します。

  7. Liferayを再起動し、すべての検索インデックスとスペルチェックインデックスを再作成します。

    note

    ローリングアップグレードを行った場合は、インデックスの再作成は必要ありません。

  8. スナップショットから検索調整インデックスを復元します。 以前にこれらの機能を使用していた場合は、これらのインデックスにデータが保存されている可能性があります。

  9. 検索調整エントリが引き継がれていることを確認します。

Elasticsearchのアップグレード

ローリング再スタート可能なバージョンを使用している場合、 ローリングアップグレード を行うことが、ダウンタイムを最小限に抑え、すべてのデータのインデックスを再作成する必要がなくなるため、Elasticsearch クラスタをアップグレードするおすすめの方法です。 それ以外の場合は、 フルクラスター再起動アップグレード ガイドに従ってください。

新しいElasticsearchサーバーをインストールし、アップグレード前のデータにインデックスしたい場合、Liferay データベースがアップグレード されると、UIから 再インデックス をトリガーすることで、ほとんどのLiferayインデックスを復元できます。 ただし、検索の調整(結果ランキングと同義語)インデックス、およびデータベースストレージにバックアップされていないカスタムインデックスは、 アップグレード前のインデックスのスナップショット から復元する必要があります。

Liferayを再起動してインデックスを再作成する

LiferayがElasticsearchクラスターに接続されたら、Liferayを再起動し、該当するインデックスを新しいElasticsearchインストールに再インデックスします。

  1. Liferayを再起動します。

  2. 完全なクラスタ再起動のアップグレードを実行した場合は、会社、システム、およびスペルチェックのインデックスの再作成が必要です。 グローバルメニュー(グローバルメニュー)から、 コントロールパネル設定検索 に移動します。 すべての検索 イ ンデ ッ ク ス を再インデ ッ ク ス ] 項目の 実行 をク リ ック。

  3. 完全なクラスタ再起動のアップグレードを実行した場合は、 Workflow Metrics インデックスのインデックスを再作成する必要があります。 : Global Menu (Global Menu) から、 ApplicationsWorkflow—Metrics に移動します。 設定メニュー (Options) を開き、 Reindex All をクリックします。 各仮想インスタンスについて、この作業を繰り返します。

これにより、Liferayデータベースに保存されているデータから作成されたインデックスが復元されます。 プライマリストレージとして使用されるインデックスを復元するには、 Elasticsearchのバックアップ を参照してください。

Capability:
Deployment Approach: