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

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 6
com.liferay.portal.search.elasticsearch6.configuration.ElasticsearchConfiguration.config
Liferay 7.2.x
Elasticsearch 7.x
Elasticsearch 7
com.liferay.portal.search.elasticsearch7.configuration.ElasticsearchConfiguration.config
Liferay 7.3、7.4、四半期リリース
Elasticsearch 7.x/8.x
Elasticsearch 7
com.liferay.portal.search.elasticsearch7.configuration.ElasticsearchConfiguration.config

Elasticsearch接続 (ファクトリ)
com.liferay.portal.search.elasticsearch7.configuration.ElasticsearchConnectionConfiguration-[connectionId].config
Liferay DXP 2026.Q1+
Elasticsearch 8.19+
Elasticsearch 8
com.liferay.portal.search.elasticsearch8.configuration.ElasticsearchConfiguration.config

Elasticsearch接続 (ファクトリ)
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 の設定エントリから削除されます。

システム設定フィールド名
設定ファイルのシンタックスとデフォルト値
説明(クリックして展開)
利用可能
一般接続設定
トラックの総ヒット数
trackTotalHits=B"true"この設定は非推奨となり、「トラックの総ヒット数制限」に置き換えられました。
Liferay 7.2+
(Connector to Elasticsearch 7)
トラックの総ヒット数制限
trackTotalHitsLimit="2147483647"検索結果はこの値まで正確にカウントされます。値を低く設定すると、検索パフォーマンスが向上する場合があります。最小許容値は、最大結果ウィンドウ値です。許容される最大値は2147483647です。
Liferay 2025.Q4+
生産モード有効
productionModeEnabled=B"false"生産モードを有効にする。 Liferay 7.3 では、 productionModeEnabled非推奨の設定operationModeに取って代わります。このチェックボックスがオンになっている場合、本番モードが有効になり、運用モードの設定は無視されます。本番モードを有効にするには、リモートのスタンドアロンElasticsearchクラスターに接続する必要があります。無効のままにした場合、利用可能な場合は動作モードの設定が使用されます。
Liferay 7.3、7.4、四半期ごとのリリース
インデックスの再作成が必要です
インデックス名プレフィックス
indexNamePrefix="liferay-"検索インデックス名の接頭辞として使用する文字列値を設定します。デフォルト値は通常の状況下では変更すべきではありません。変更する場合は、ポータル全体のインデックスを再作成する操作を実行し、その後、Elasticsearch管理コンソールを使用して古いインデックスを手動で削除する必要があります。
Liferay 7.2+
再インデックスが必要
7.3.x→会社およびシステムインデックスレプリカの数
7.2.x→インデックスレプリカ数
indexNumberOfReplicas="0-all" Liferayの各企業およびシステムインデックスごとにレプリカ数を設定します。設定されていない場合、レプリカは使用されません。この値を変更するには、すべてのコンテンツの再インデックス作成が必要です。デフォルト値は、コネクターに同梱されている "index-settings-defaults.json "というファイルに定義されています。
Liferay 7.2+
再インデックスが必要
7.3.x→会社およびシステムインデックスシャードの数
7.2.x→インデックスシャード数
indexNumberOfShards="1" Liferayの会社インデックスおよびシステムインデックスを作成する際に使用するシャード数を設定します。設定されていない場合は、単一のシャードが使用されます。この値を変更するには、すべてのコンテンツの再インデックス作成が必要です。デフォルト値は、コネクタに同梱されている「index-settings-defaults.json」というファイルで定義されています。
Liferay 7.2+
最大結果ウィンドウ
indexMaxResultWindow="10000"検索クエリから返される結果の最大数を設定します。ポータルプロパティのindex.search.limit同じ値に設定してください。デフォルトの検索結果権限フィルタ設定におけるsearchQueryResultWindowLimitは、この値を超えてはなりません。追加インデックス構成でindex.max_result_window同時に設定している場合は、このプロパティを使用しないでください。
Liferay 7.4 U72/GA72+
例外のみをログに記録する
logExceptionsOnly=B"true"このブール値の設定がtrueの場合、Elasticsearchからの例外のみをログに記録し、例外を再スローしません。
Liferay 7.2以降
競合が発生した場合は再試行する
retryOnConflict="5"ドキュメントを取得してから更新するまでの間にドキュメントが更新されたためにバージョン競合が発生した場合に試行する再試行回数を整数値で設定します(詳細については、こちらを参照してください)。
Liferay 7.1以降は使用されなくなりました
最大接続数
maxConnections="75" HTTP接続の最大数を設定します。
Liferay 7.4 U67/GA67+
ルートごとの最大接続数
maxConnectionsPerRoute="75"ルートごとにHTTP接続の最大数を設定します。
Liferay 7.4 U67/GA67+
圧縮有効
compressionEnabled=B"true" RESTクライアントがgzipを使用してリクエストとレスポンスを圧縮するように設定するか、無効にするかを選択します。
Liferay DXP 2026.Q1+
セキュリティ設定
認証が有効になっています
authenticationEnabled=B"false"ユーザー名とパスワードを使用したElasticsearchへの認証を有効または無効にします。
Liferay 7.3、7.4、四半期ごとのリリース
ユーザー名
username="elastic" 「認証を有効にする」がチェックされている場合、Elasticsearchへの認証に使用するユーザー名を設定します。
Liferay 7.3、7.4、四半期ごとのリリース
パスワード
password="" 「認証を有効にする」がチェックされている場合は、Elasticsearchへの認証に使用するパスワードを設定してください。
Liferay 7.3、7.4、四半期ごとのリリース
HTTP SSL が有効
httpSSLEnabled="false" TLS/SSLを有効または無効にします。
Liferay 7.3、7.4、四半期ごとのリリース
トラストストアの種類
truststoreType="pkcs12" HTTP SSLが有効になっている場合は、トラストストアの種類を設定してください。お使いのJDKバージョンでサポートされているフォーマットを選択してください(例: jksまたはpkcs12 )。
Liferay 7.3、7.4、四半期ごとのリリース
トラストストアパス
truststorePath="/path/to/localhost.p12" HTTP SSLが有効になっている場合は、トラストストアファイルへのパスを設定してください。
Liferay 7.3、7.4、四半期ごとのリリース
トラストストアパスワード
truststorePassword="" HTTP SSLが有効になっている場合は、トラストストアのパスワードを設定してください。
Liferay 7.3、7.4、四半期ごとのリリース
ELASTICSEARCH接続設定
アクティブ
active=B"false"必要に応じて接続を有効化または無効化してください。 Elasticsearch 7 の設定の [リモート クラスタ接続 ID] 設定で選択されている場合は、その接続を非アクティブ化しないでください。
Liferay 7.3、7.4、四半期ごとのリリース
接続ID
connectionId=""接続に固有のIDを設定してください。有効になっている場合、この接続はElasticsearch 7構成の「リモートクラスタ接続ID」プロパティで選択できるようになります。
Liferay 7.3、7.4、四半期ごとのリリース
RESTクライアント設定
ネットワークホストアドレス
networkHostAddresses="[http://localhost:9200]" Liferayからクライアントリクエストを送信するように、リモートHTTPホストを設定します。これは、RESTクライアント接続を構成するため、Liferay 7.3、7.4、および四半期ごとのリリースで必須です。リクエストはRESTクライアントによってラウンドロビン・ノード選択戦略を使って分散される。。
Liferay 7.3、7.4、四半期ごとのリリース
RESTクライアントロガーレベル
RESTClientLoggerLevel="ERROR" DXP 7.3 U4以降、DXP 7.4 GA1以降、およびPortal 7.4 GA5以降では非推奨です。
Liferay 7.3、7.4、四半期ごとのリリース
トランスポートクライアント設定(埋め込み & リモート)
動作モード
operationMode="EMBEDDED"操作モードは、組み込み型とリモート型の2種類から選択できます。リモートのスタンドアロンElasticsearchクラスターに接続するには、「REMOTE」に設定してください。 Liferayを内部Elasticsearchインスタンスで起動するには、「EMBEDDED」に設定してください。組み込み動作モードは本番環境ではサポートされておらず、「開発モード」の機能とみなされます。
Liferay 7.2 Liferay 7.3以降は非推奨となり、プロダクションモード有効化に置き換えられました。
クラスター名
clusterName="LiferayElasticsearchCluster"クラスター名は、Liferay 7.2 のトランスポート クライアントでのみ必要です。統合するクラスターを宣言する文字列値を設定します。 Liferay 7.3、7.4、および四半期ごとのリリースでは、接続はRESTクライアントを介して管理されるため、このプロパティは開発モード時に組み込みクラスタに名前を付けるためにのみ使用されます。
Liferay 7.2-
7.3、7.4、および四半期ごとのリリースでは、これは開発モードに適用されます
交通機関の住所
transportAddresses=["localhost:9300"]接続先のElasticsearchリモートノードのアドレスの文字列値を設定します。この値は、操作モードをリモートに設定する場合に必須です(詳細についてはこちらをご覧ください)。必要に応じて、ノードの数を指定してください。
Liferay 7.2
クライアントトランスポートスニッフィング
clientTransportSniff=B"true"このブール値をtrueに設定すると、クラスタスニッフィングが有効になり、クラスタ内の利用可能なデータノードを動的に検出できます(詳細については、こちらを参照してください)。
Liferay 7.2
クライアントトランスポートのクラスタ名を無視する
clientTransportIgnoreClusterName=B"false"接続されたノードのクラスタ名の検証を無視するには、このブール値をtrueに設定してください(詳細については、こちらを参照してください)。
Liferay 7.2
クライアントトランスポートピングタイムアウト
clientTransportPingTimeout=""クライアントノードがノードからのping応答を待つ時間(秒単位)を設定します。設定されていない場合は、デフォルトの Elasticsearch client.transport.ping_timeoutが使用されます。
Liferay 7.2
クライアントトランスポートノードサンプラー間隔
clientTransportNodesSamplerInterval=""この文字列値を設定して、クライアントノードがリストされ接続されているノードをサンプリング/pingする頻度を指示します(詳細については、こちらを参照してください)。
Liferay 7.2
その他の設定
リモートクラスタ接続ID
remoteClusterConnectionId=リモートのElasticsearchクラスターへの接続に使用する接続IDを選択してください。利用可能な接続は、Elasticsearch接続システム設定のエントリで定義されています。この値が設定されていない場合、リモートクラスタ接続にはElasticsearch 7エントリの接続構成が使用されます。
Liferay 7.3、7.4、四半期リリースでLESクロス・クラスタ・レプリケーションを使用する場合
開発モード設定(埋め込み & サイドカー)
追加構成
additionalConfigurations=""組み込みElasticsearchのカスタム設定用の文字列値をYML形式で設定します。参照: Liferay Elasticsearchコネクタの高度な設定。
Liferay 7.2+
Bootstrap Mlock すべて
bootstrapMlockAll="false"ブール値の設定で、 trueに設定すると、プロセスのアドレス空間をRAMにロックしようとし、Elasticsearchのメモリがスワップアウトされるのを防ぎます(詳細については、こちらを参照)。
Liferay 7.2+
組み込みHTTPポート
embeddedHttpPort="9201"この設定は、組み込みモードにのみ適用されます。操作モードを「組み込み」に設定した場合に作成される組み込みElasticsearchノードのHTTPポートを設定します。
Liferay 7.2 Liferay 7.3.x 以降は非推奨となり、 Sidecar HTTP Portに置き換えられました。
HTTP有効
httpEnabled=B"true"このチェックボックスがオンになっている場合、HTTPレイヤーが有効になります。チェックを外すと、RESTリクエストを直接処理することを想定していないノードではHTTPレイヤーが無効になります。
Liferay 7.1.x 以降は非推奨です。
HTTP CORS 許可 オリジン
httpCORSAllowOrigin="/https?:\\/\\/localhost(:[0-9]+)?/" HTTP CORSが有効になっている場合に許可する文字列のオリジンを設定します(詳細については、こちらを参照してください)。
Liferay 7.2+
HTTP CORS 設定
httpCORSConfigurations= HTTP CORS のカスタム設定の文字列値を YML 形式 ( elasticsearch.yml) で設定します (詳細については、こちらを参照してください)。
Liferay 7.2+
HTTP CORSが有効
httpCORSEnabled=B"true"クロスオリジンリソース共有を無効にするには、このブール値をfalseに設定してください。 falseに設定すると、別のオリジンのブラウザはElasticsearchにリクエストを送信できなくなります。 Elasticsearch HeadなどのWebフロントエンドツールは接続できない場合があります(詳細についてはこちらをご覧ください)。
Liferay 7.2以降
ネットワークホスト
networkHost=""この文字列値を設定すると、ノードはこのホスト名またはIPアドレスにバインドし、このホストをクラスタ内の他のノードに公開(アドバタイズ)するように指示されます。これは、バインドホストとパブリッシュホストを同時に設定するショートカットです(詳細については、こちらをご覧ください)。
Liferay 7.2以降
ネットワークバインドホスト
networkBindHost=""ノードが着信リクエストをリッスンできるようにバインドするネットワークインターフェースの文字列値を設定します(詳細については、こちらを参照してください)。
Liferay 7.2以降
ネットワーク公開ホスト
networkPublishHost=""ノードがクラスタ内の他のノードに通知する単一のインターフェースの文字列値を設定することで、それらのノードがそのインターフェースに接続できるようになります(詳細については、こちらを参照してください)。
Liferay 7.2以降
トランスポートTCPポート
transportTcpPort=""ノード間の通信に使用するポートの文字列値を設定します。単一の値または範囲を受け入れます(詳細についてはこちらをご覧ください)。
Liferay 7.2以降
Zen Discovery ユニキャストホストポート
discoveryZenPingUnicastHostsPort="9300-9400" discovery.zen.ping.unicast.hostsの値を作成する際に使用するポート範囲の文字列値を設定します。複数のElasticsearchノードを同じコンピュータ上のさまざまなポートでゴシップルーターとして機能させることができます(詳細については、こちらを参照してください)。バージョン7.3以降は非推奨となり、直接の代替機能はありません。
Liferay 7.2
サイドカーの設定
ノード名
nodeName=組み込み型Elasticsearchサーバーのノード名を指定します。リモート Elasticsearch サーバーのノード名は、 elasticsearch.ymlファイルで設定されます。
Liferay 7.3、7.4、四半期ごとのリリース
サイドカーデバッグ
sidecarDebug=B"false"サイドカープロセスのデバッグモードを有効にするには、これをtrueに設定してください。
Liferay 7.3、7.4、四半期ごとのリリース
サイドカーのデバッグ設定
sidecarDebugSettings="-agentlib:jdwp=transport=dt_socket,address=8001,server=y,suspend=y,quiet=y"サイドカープロセスのデバッグに使用するJVMオプションを設定します。
Liferay 7.3、7.4、四半期ごとのリリース
サイドカーの心拍間隔
sidecarHeartbeatInterval="10000"サイドカープロセスの状態を検出するために使用するハートビート間隔をミリ秒単位で設定します。
Liferay 7.3、7.4、四半期ごとのリリース
サイドカー ホーム
sidecarHome="elasticsearch7"サイドカープロセスを開始するために使用するサイドカーベースフォルダのパスを設定します。
Liferay 7.3、7.4、四半期ごとのリリース
サイドカーHTTPポート
sidecarHttpPort="9200"この設定は、サイドカーとしてElasticsearchを搭載したLiferay 7.3にのみ適用されます。サイドカーElasticsearchノードのHTTPポート範囲を設定します。 AUTOに設定すると、9201~9300の範囲のポートを自動的に検索します。設定されていない場合は、組み込みHTTPポートの値(デフォルトは9201 )が使用されます。
Liferay 7.3、7.4、四半期ごとのリリース
サイドカーJVMオプション
sidecarJVMOptions="-Xms1g\|-Xmx1g\|-XX:+AlwaysPreTouch"サイドカープロセスで使用されるJVMオプションを設定します。
Liferay 7.3、7.4、四半期ごとのリリース
サイドカーシャットダウンタイムアウト
sidecarShutdownTimeout="10000"サイドカープロセスが強制的にシャットダウンされるまでの待機時間をミリ秒単位で設定します。
Liferay 7.3、7.4、四半期ごとのリリース
詳細設定
再インデックスが必要です
追加のインデックス構成
additionalIndexConfigurations="" Liferayインデックスのカスタム設定の文字列値をJSONまたはYML形式で設定します(詳細については、Elasticsearchのインデックス作成APIを参照してください)。参照: Liferay Elasticsearchコネクタの高度な設定。
Liferay 7.2以降
再インデックスが必要
追加の型マッピング
additionalTypeMappings="" LiferayDocumentTypeのカスタム マッピングの文字列値を JSON 形式で設定します (詳細については、Elasticsearch Put Mapping API を参照してください)。参照: Liferay Elasticsearch Connector の高度な構成。
Liferay 7.2以降
再インデックスが必要
型マッピングのオーバーライド
overrideTypeMappings=""ここでの設定は、Liferayのデフォルトの型マッピングを上書きします。これは高度な機能であり、本当に必要な場合にのみ使用してください。この値を設定すると、Liferayのソースコード内のデフォルトのマッピング(例えば、 index-mappings.json )は完全に無視されるため、変更するセグメントだけでなく、マッピング定義全体をこのプロパティに含めてください。
Liferay 7.2以降
プロキシホスト
proxyHost=""クライアント接続用のプロキシホストを設定します。
Liferay DXP 7.3 FP1+/SP1+ および Liferay Portal GA7+
プロキシポート
proxyPort="0"クライアント接続用のプロキシポートを設定します。
Liferay DXP 7.3 FP1+/SP1+ および Liferay Portal GA7+
プロキシユーザー名
proxyUserName=""プロキシ接続用のプロキシユーザー名を設定します。
Liferay DXP 7.3 FP1+/SP1+ および Liferay Portal GA7+
プロキシパスワード
proxyPassword=""プロキシに接続するためのパスワードを設定してください。
Liferay DXP 7.3 FP1+/SP1+ および Liferay Portal GA7+