ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。

Elasticsearch 8へのアップグレード

7.4 U81+、7.3 U31+

Elasticsearch 8 は、最新の Liferay DXP Quarterly および Portal GA リリースですぐにサポートされ、推奨されています。特定のバージョンの互換性の詳細については、検索エンジン互換性マトリックスを参照してください。

重要

Elasticsearchをアップグレードする前に、既存のデータをバックアップしてください。アップグレード中またはアップグレード後に何か問題が発生した場合は、破損していないインデックスのスナップショットを使用して以前のバージョンにロールバックしてください。 Elasticsearch のバックアップの手順に従います。
新しいElasticsearchクラスタをインストールし、アップグレードしたLiferayに接続することは可能ですが、ElasticsearchクラスタにLiferay DXP 7.2や7.3の検索の調整機能用のインデックスのようにプライマリストレージとして使用するインデックスがあった場合、一部のデータが失われる可能性があります。 Liferay 7.2 および 7.3 の検索チューニングインデックスのバックアップと復元および 7.4 での検索チューニングインデックスのインポートを参照してください。。

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

すべての Liferay インデックスをバックアップします。システムとバージョンによっては、追加のインデックスをバックアップする必要がある場合があります。 Elasticsearch のバックアップを参照してください。
新しい Elasticsearch インストールを準備します。
Elasticsearchをアップグレードします
X-Pack セキュリティを使用している場合、Elasticsearch 8 ではデフォルトで有効になっています。無効にするには、次のプロパティを追加します。
```
xpack.security.enabled: false
```
セキュリティ構成の詳細については、 Elasticsearch のセキュリティ保護を参照してください。
Liferay で Elasticsearch 接続を設定します。
注
- Elasticsearch 7 にバンドルされているコネクタは、Elasticsearch の REST API 互換性を介して Elasticsearch 8 に接続します。該当するシステム設定と構成ファイル名については、コネクタリファレンスガイドを参照してください。
- Elasticsearch 8 では、ドキュメントタイプが削除されました。したがって、既存の追加のタイプマッピングとタイプマッピングのオーバーライドのコネクタ設定から LiferayDocumentType 宣言を削除する必要があります。詳細については、 Liferay Elasticsearch コネクタの詳細設定を参照してください。これらの設定を使用していない場合は、変更する必要はありません。
Liferay を再起動します; 必要に応じて、すべての検索インデックスとスペルチェックインデックスを再作成します。
スナップショットから検索調整インデックスを復元します。以前にこれらの機能を使用していた場合は、これらのインデックスにデータが保存されている可能性があります。
検索調整エントリが引き継がれていることを確認します。

Elasticsearchのアップグレード

ローリング再起動対応バージョンを使用している場合は、ダウンタイムを最小限に抑え、すべてのデータの再インデックス作成の必要性をなくすため、Elasticsearch クラスターをアップグレードするにはローリングアップグレードを実行することが推奨される方法です。それ以外の場合は、完全なクラスター再起動アップグレードガイドに従ってください。スナップショットと復元のアプローチを使用してインデックスをバックアップすると、再インデックスも回避できます。ただし、Elasticsearch と一緒に Liferay をアップグレードする場合は、マッピングと設定の変更を考慮して、必ず再インデックスを行う必要があります。

新しい Elasticsearch サーバーをインストールした場合、Liferay データベースがアップグレードされたら、UI から完全または同時再インデックスをトリガーすることで、ほとんどの Liferay インデックスを復元できます。

注

Liferay 7.2/7.3 では、検索チューニング (結果のランキングと同義語) インデックスとカスタムインデックスはデータベースストレージによってバックアップされません。 Liferay 7.2/7.3 用に新しい Elasticsearch サーバーをセットアップする場合、または Liferay 7.2/7.3 からアップグレードして新しい Elasticsearch サーバーをセットアップする場合は、これらのインデックスをアップグレード前のインデックスのスナップショットから復元する必要があります。

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

LiferayがElasticsearchクラスタに接続されたら、Liferayのデータを新しいElasticsearchのインストレーションに取り込むために、fullまたはconcurrent reindexを実行します。場合によっては、再インデックスが不要なことがあります。

アップグレードシナリオ	再インデックスが必要です
Liferayはアップグレードされました Elasticsearchはアップグレードされていません	✔
Liferayがアップグレードされました Elasticsearchがアップグレードされました	✔
Elasticsearchはローリング再起動を使用してアップグレードされました Liferayはアップグレードされていません	✘
Elasticsearchは完全なクラスタ再起動を使用してアップグレードされました Liferayはアップグレードされていません	✘
Elasticsearch を最初からインストールしました。インデックスは復元されませんでした。	✔

シナリオで再インデックスが必要な場合は、次の手順に従ってください。

会社、システム、スペルチェックのインデックスを再作成します。グローバルメニュー () から、 コントロールパネル → 構成 → 検索に移動します。「すべての検索インデックスの再インデックス」エントリの実行をクリックします。
ワークフローメトリックインデックスを再インデックスします。グローバルメニュー () から、 アプリケーション → ワークフロー—メトリックに移動します。設定メニュー（）を開き、 「すべて再インデックス」をクリックします。各仮想インスタンスについて、この作業を繰り返します。