Elasticsearchコネクタ構成リファレンス
ここに記載されている構成情報は、Liferay Portal 7.2-7.4 CE および Liferay DXP 7.2-7.4 用の Elasticsearch 6 および Elasticsearch 7 コネクタの最新バージョン(バンドル版またはマーケットプレイス経由)と、すべての四半期リリースに適用されます。必要に応じて、正確なGA/Service Pack/Fix PackおよびMarketplaceのバージョンに関する適切な情報が提供されます。
- Liferay DXP 2026.Q1以降では、Elasticsearchへの接続を設定するために、ネイティブのElasticsearch 8設定エントリが使用されます。
- Liferay DXP 2026.Q1以前では、Elasticsearch 7のシステム設定エントリと対応する設定ファイルは、Elasticsearch 8への接続設定にも使用されます。
Elasticsearchへの接続は、システム設定(または対応する構成ファイル介して)のElasticsearch 6/7/8の設定エントリーで主に定義されます。 Liferay 7.3、7.4、および四半期ごとのリリースでは、ファクトリ構成Elasticsearch Connectionsを通じて、Elasticsearch への複数の接続を定義できます。どちらのエントリも、システム設定またはOSGi設定ファイルを通じて設定可能です。設定ファイルは、本番環境において推奨される方法です。
構成ファイルとシステム設定エントリ
| サーバーの接続 | システム設定エントリ/構成ファイル |
|---|---|
| Liferay 7.2.x Elasticsearch 6.x | Elasticsearch 6com.liferay.portal.search.elasticsearch6.configuration.ElasticsearchConfiguration.config |
| Liferay 7.2.x Elasticsearch 7.x | Elasticsearch 7com.liferay.portal.search.elasticsearch7.configuration.ElasticsearchConfiguration.config |
| Liferay 7.3、7.4、四半期リリース Elasticsearch 7.x/8.x | Elasticsearch 7com.liferay.portal.search.elasticsearch7.configuration.ElasticsearchConfiguration.configElasticsearch接続 (ファクトリ) com.liferay.portal.search.elasticsearch7.configuration.ElasticsearchConnectionConfiguration-[connectionId].config |
| Liferay DXP 2026.Q1+ Elasticsearch 8.19+ | Elasticsearch 8com.liferay.portal.search.elasticsearch8.configuration.ElasticsearchConfiguration.configElasticsearch接続 (ファクトリ) com.liferay.portal.search.elasticsearch8.configuration.ElasticsearchConnectionConfiguration-[connectionId].config |
Liferay 7.3、7.4、およびすべての四半期リリースでは、Elasticsearch Connections と呼ばれる追加の接続設定エントリがあります。これを使用してElasticsearchへの接続を定義できますが、接続を1つだけ設定する場合は、メインのElasticsearch設定エントリを引き続き使用できます。複数の接続を使用する場合は、適切な名前のファイルを使用して接続を定義します。
com.liferay.portal.search.elasticsearch8.configuration.ElasticsearchConnectionConfiguration-[connectionId].config
Elasticsearch 6にセキュリティを設定する場合は、別途Liferayの設定(およびLESのサブスクリプション)が必要です。詳細については、 「Elasticsearch のセキュリティ保護」を参照してください。
設定ファイルを [Liferay_Home]/osgi/configs にデプロイし、リスナーが設定を自動検出してデータベースに書き込みます。
構成プロパティ
以下の表で非推奨とされているすべての設定は、Elasticsearch 8 の設定エントリから削除されます。
| システム設定フィールド名 | 設定ファイルのシンタックスとデフォルト値 説明(クリックして展開) | 利用可能 |
|---|---|---|
| 一般接続設定 | ||
| トラックの総ヒット数 | この設定は非推奨となり、「トラックの総ヒット数制限」に置き換えられました。 | Liferay 7.2+ (Connector to Elasticsearch 7) |
| トラックの総ヒット数制限 | 検索結果はこの値まで正確にカウントされます。値を低く設定すると、検索パフォーマンスが向上する場合があります。最小許容値は、最大結果ウィンドウ値です。許容される最大値は2147483647です。 | Liferay 2025.Q4+ |
| 生産モード有効 | 生産モードを有効にする。 Liferay 7.3 では、 | Liferay 7.3、7.4、四半期ごとのリリース |
| インデックスの再作成が必要です インデックス名プレフィックス | 検索インデックス名の接頭辞として使用する文字列値を設定します。デフォルト値は通常の状況下では変更すべきではありません。変更する場合は、ポータル全体のインデックスを再作成する操作を実行し、その後、Elasticsearch管理コンソールを使用して古いインデックスを手動で削除する必要があります。 | Liferay 7.2+ |
| 再インデックスが必要 7.3.x→会社およびシステムインデックスレプリカの数 7.2.x→インデックスレプリカ数 | Liferayの各企業およびシステムインデックスごとにレプリカ数を設定します。設定されていない場合、レプリカは使用されません。この値を変更するには、すべてのコンテンツの再インデックス作成が必要です。デフォルト値は、コネクターに同梱されている "index-settings-defaults.json "というファイルに定義されています。 | Liferay 7.2+ |
| 再インデックスが必要 7.3.x→会社およびシステムインデックスシャードの数 7.2.x→インデックスシャード数 | Liferayの会社インデックスおよびシステムインデックスを作成する際に使用するシャード数を設定します。設定されていない場合は、単一のシャードが使用されます。この値を変更するには、すべてのコンテンツの再インデックス作成が必要です。デフォルト値は、コネクタに同梱されている「index-settings-defaults.json」というファイルで定義されています。 | Liferay 7.2+ |
| 最大結果ウィンドウ | 検索クエリから返される結果の最大数を設定します。ポータルプロパティの | Liferay 7.4 U72/GA72+ |
| 例外のみをログに記録する | このブール値の設定がtrueの場合、Elasticsearchからの例外のみをログに記録し、例外を再スローしません。 | Liferay 7.2以降 |
| 競合が発生した場合は再試行する | ドキュメントを取得してから更新するまでの間にドキュメントが更新されたためにバージョン競合が発生した場合に試行する再試行回数を整数値で設定します(詳細については、こちらを参照してください)。 | Liferay 7.1以降は使用されなくなりました |
| 最大接続数 | HTTP接続の最大数を設定します。 | Liferay 7.4 U67/GA67+ |
| ルートごとの最大接続数 | ルートごとにHTTP接続の最大数を設定します。 | Liferay 7.4 U67/GA67+ |
| 圧縮有効 | RESTクライアントがgzipを使用してリクエストとレスポンスを圧縮するように設定するか、無効にするかを選択します。 | Liferay DXP 2026.Q1+ |
| セキュリティ設定 | ||
| 認証が有効になっています | ユーザー名とパスワードを使用したElasticsearchへの認証を有効または無効にします。 | Liferay 7.3、7.4、四半期ごとのリリース |
| ユーザー名 | 「認証を有効にする」がチェックされている場合、Elasticsearchへの認証に使用するユーザー名を設定します。 | Liferay 7.3、7.4、四半期ごとのリリース |
| パスワード | 「認証を有効にする」がチェックされている場合は、Elasticsearchへの認証に使用するパスワードを設定してください。 | Liferay 7.3、7.4、四半期ごとのリリース |
| HTTP SSL が有効 | TLS/SSLを有効または無効にします。 | Liferay 7.3、7.4、四半期ごとのリリース |
| トラストストアの種類 | HTTP SSLが有効になっている場合は、トラストストアの種類を設定してください。お使いのJDKバージョンでサポートされているフォーマットを選択してください(例: | Liferay 7.3、7.4、四半期ごとのリリース |
| トラストストアパス | HTTP SSLが有効になっている場合は、トラストストアファイルへのパスを設定してください。 | Liferay 7.3、7.4、四半期ごとのリリース |
| トラストストアパスワード | HTTP SSLが有効になっている場合は、トラストストアのパスワードを設定してください。 | Liferay 7.3、7.4、四半期ごとのリリース |
| ELASTICSEARCH接続設定 | ||
| アクティブ | 必要に応じて接続を有効化または無効化してください。 Elasticsearch 7 の設定の [リモート クラスタ接続 ID] 設定で選択されている場合は、その接続を非アクティブ化しないでください。 | Liferay 7.3、7.4、四半期ごとのリリース |
| 接続ID | 接続に固有のIDを設定してください。有効になっている場合、この接続はElasticsearch 7構成の「リモートクラスタ接続ID」プロパティで選択できるようになります。 | Liferay 7.3、7.4、四半期ごとのリリース |
| RESTクライアント設定 | ||
| ネットワークホストアドレス | Liferayからクライアントリクエストを送信するように、リモートHTTPホストを設定します。これは、RESTクライアント接続を構成するため、Liferay 7.3、7.4、および四半期ごとのリリースで必須です。リクエストはRESTクライアントによってラウンドロビン・ノード選択戦略を使って分散される。。 | Liferay 7.3、7.4、四半期ごとのリリース |
| RESTクライアントロガーレベル | DXP 7.3 U4以降、DXP 7.4 GA1以降、およびPortal 7.4 GA5以降では非推奨です。 | Liferay 7.3、7.4、四半期ごとのリリース |
| トランスポートクライアント設定(埋め込み & リモート) | ||
| 動作モード | 操作モードは、組み込み型とリモート型の2種類から選択できます。リモートのスタンドアロンElasticsearchクラスターに接続するには、「REMOTE」に設定してください。 Liferayを内部Elasticsearchインスタンスで起動するには、「EMBEDDED」に設定してください。組み込み動作モードは本番環境ではサポートされておらず、「開発モード」の機能とみなされます。 | Liferay 7.2 Liferay 7.3以降は非推奨となり、プロダクションモード有効化に置き換えられました。 |
| クラスター名 | クラスター名は、Liferay 7.2 のトランスポート クライアントでのみ必要です。統合するクラスターを宣言する文字列値を設定します。 Liferay 7.3、7.4、および四半期ごとのリリースでは、接続はRESTクライアントを介して管理されるため、このプロパティは開発モード時に組み込みクラスタに名前を付けるためにのみ使用されます。 | Liferay 7.2- 7.3、7.4、および四半期ごとのリリースでは、これは開発モードに適用されます |
| 交通機関の住所 | 接続先のElasticsearchリモートノードのアドレスの文字列値を設定します。この値は、操作モードをリモートに設定する場合に必須です(詳細についてはこちらをご覧ください)。必要に応じて、ノードの数を指定してください。 | Liferay 7.2 |
| クライアントトランスポートスニッフィング | このブール値をtrueに設定すると、クラスタスニッフィングが有効になり、クラスタ内の利用可能なデータノードを動的に検出できます(詳細については、こちらを参照してください)。 | Liferay 7.2 |
| クライアントトランスポートのクラスタ名を無視する | 接続されたノードのクラスタ名の検証を無視するには、このブール値をtrueに設定してください(詳細については、こちらを参照してください)。 | Liferay 7.2 |
| クライアントトランスポートピングタイムアウト | クライアントノードがノードからのping応答を待つ時間(秒単位)を設定します。設定されていない場合は、デフォルトの Elasticsearch | Liferay 7.2 |
| クライアントトランスポートノードサンプラー間隔 | この文字列値を設定して、クライアントノードがリストされ接続されているノードをサンプリング/pingする頻度を指示します(詳細については、こちらを参照してください)。 | Liferay 7.2 |
| その他の設定 | ||
| リモートクラスタ接続ID | リモートのElasticsearchクラスターへの接続に使用する接続IDを選択してください。利用可能な接続は、Elasticsearch接続システム設定のエントリで定義されています。この値が設定されていない場合、リモートクラスタ接続にはElasticsearch 7エントリの接続構成が使用されます。 | Liferay 7.3、7.4、四半期リリースでLESクロス・クラスタ・レプリケーションを使用する場合 |
| 開発モード設定(埋め込み & サイドカー) | ||
| 追加構成 | 組み込みElasticsearchのカスタム設定用の文字列値をYML形式で設定します。参照: Liferay Elasticsearchコネクタの高度な設定。 | Liferay 7.2+ |
| Bootstrap Mlock すべて | ブール値の設定で、 | Liferay 7.2+ |
| 組み込みHTTPポート | この設定は、組み込みモードにのみ適用されます。操作モードを「組み込み」に設定した場合に作成される組み込みElasticsearchノードのHTTPポートを設定します。 | Liferay 7.2 Liferay 7.3.x 以降は非推奨となり、 Sidecar HTTP Portに置き換えられました。 |
| HTTP有効 | このチェックボックスがオンになっている場合、HTTPレイヤーが有効になります。チェックを外すと、RESTリクエストを直接処理することを想定していないノードではHTTPレイヤーが無効になります。 | Liferay 7.1.x 以降は非推奨です。 |
| HTTP CORS 許可 オリジン | HTTP CORSが有効になっている場合に許可する文字列のオリジンを設定します(詳細については、こちらを参照してください)。 | Liferay 7.2+ |
| HTTP CORS 設定 | HTTP CORS のカスタム設定の文字列値を YML 形式 ( | Liferay 7.2+ |
| HTTP CORSが有効 | クロスオリジンリソース共有を無効にするには、このブール値をfalseに設定してください。 | Liferay 7.2以降 |
| ネットワークホスト | この文字列値を設定すると、ノードはこのホスト名またはIPアドレスにバインドし、このホストをクラスタ内の他のノードに公開(アドバタイズ)するように指示されます。これは、バインドホストとパブリッシュホストを同時に設定するショートカットです(詳細については、こちらをご覧ください)。 | Liferay 7.2以降 |
| ネットワークバインドホスト | ノードが着信リクエストをリッスンできるようにバインドするネットワークインターフェースの文字列値を設定します(詳細については、こちらを参照してください)。 | Liferay 7.2以降 |
| ネットワーク公開ホスト | ノードがクラスタ内の他のノードに通知する単一のインターフェースの文字列値を設定することで、それらのノードがそのインターフェースに接続できるようになります(詳細については、こちらを参照してください)。 | Liferay 7.2以降 |
| トランスポートTCPポート | ノード間の通信に使用するポートの文字列値を設定します。単一の値または範囲を受け入れます(詳細についてはこちらをご覧ください)。 | Liferay 7.2以降 |
| Zen Discovery ユニキャストホストポート | | Liferay 7.2 |
| サイドカーの設定 | ||
| ノード名 | 組み込み型Elasticsearchサーバーのノード名を指定します。リモート Elasticsearch サーバーのノード名は、 | Liferay 7.3、7.4、四半期ごとのリリース |
| サイドカーデバッグ | サイドカープロセスのデバッグモードを有効にするには、これをtrueに設定してください。 | Liferay 7.3、7.4、四半期ごとのリリース |
| サイドカーのデバッグ設定 | サイドカープロセスのデバッグに使用するJVMオプションを設定します。 | Liferay 7.3、7.4、四半期ごとのリリース |
| サイドカーの心拍間隔 | サイドカープロセスの状態を検出するために使用するハートビート間隔をミリ秒単位で設定します。 | Liferay 7.3、7.4、四半期ごとのリリース |
| サイドカー ホーム | サイドカープロセスを開始するために使用するサイドカーベースフォルダのパスを設定します。 | Liferay 7.3、7.4、四半期ごとのリリース |
| サイドカーHTTPポート | この設定は、サイドカーとしてElasticsearchを搭載したLiferay 7.3にのみ適用されます。サイドカーElasticsearchノードのHTTPポート範囲を設定します。 AUTOに設定すると、9201~9300の範囲のポートを自動的に検索します。設定されていない場合は、組み込みHTTPポートの値(デフォルトは | Liferay 7.3、7.4、四半期ごとのリリース |
| サイドカーJVMオプション | サイドカープロセスで使用されるJVMオプションを設定します。 | Liferay 7.3、7.4、四半期ごとのリリース |
| サイドカーシャットダウンタイムアウト | サイドカープロセスが強制的にシャットダウンされるまでの待機時間をミリ秒単位で設定します。 | Liferay 7.3、7.4、四半期ごとのリリース |
| 詳細設定 | ||
| 再インデックスが必要です 追加のインデックス構成 | Liferayインデックスのカスタム設定の文字列値をJSONまたはYML形式で設定します(詳細については、Elasticsearchのインデックス作成APIを参照してください)。参照: Liferay Elasticsearchコネクタの高度な設定。 | Liferay 7.2以降 |
| 再インデックスが必要 追加の型マッピング | | Liferay 7.2以降 |
| 再インデックスが必要 型マッピングのオーバーライド | ここでの設定は、Liferayのデフォルトの型マッピングを上書きします。これは高度な機能であり、本当に必要な場合にのみ使用してください。この値を設定すると、Liferayのソースコード内のデフォルトのマッピング(例えば、 | Liferay 7.2以降 |
| プロキシホスト | クライアント接続用のプロキシホストを設定します。 | Liferay DXP 7.3 FP1+/SP1+ および Liferay Portal GA7+ |
| プロキシポート | クライアント接続用のプロキシポートを設定します。 | Liferay DXP 7.3 FP1+/SP1+ および Liferay Portal GA7+ |
| プロキシユーザー名 | プロキシ接続用のプロキシユーザー名を設定します。 | Liferay DXP 7.3 FP1+/SP1+ および Liferay Portal GA7+ |
| プロキシパスワード | プロキシに接続するためのパスワードを設定してください。 | Liferay DXP 7.3 FP1+/SP1+ および Liferay Portal GA7+ |