Elasticsearchのトラブルシューティング：よくある問題

ElasticsearchとLiferayの設定中に発生する可能性がある問題点をリストアップしました。その他の接続固有のエラーについては、 Elasticsearch接続のトラブルシューティングで説明しています。

クラスター名

elasticsearch.ymlのcluster.nameプロパティの値は、Liferay Elasticsearchコネクターで設定されたclusterNameプロパティと一致する必要があります。

Elasticsearchコネクター設定のtransportAddressesプロパティの値には、Elasticsearchノードが実行されている有効なホストとポートが少なくとも1つ含まれている必要があります。 Liferayを組み込みモードで実行していて、スタンドアロンのElasticsearchノードまたはクラスターを起動すると、ポート9300が占有されていることが検出され、ポート9301に切り替わります。その後、LiferayのElasticsearchコネクターをリモートモードに設定すると、引き続きデフォルトのポート（9300）でElasticsearchを検索します。クラスターのマスターノードとデータノードのアドレスがすべて記載されていることを確認してください。

Elasticsearchへの接続では、コネクター設定オプションについて詳しく説明しています。

ネットワークホストアドレス

Liferay 7.3以降では、バンドルされている sidecar Elasticsearchサーバーは、デフォルトでポート 9201 で実行されます。これは、ElasticsearchのデフォルトのHTTPポート（9200）を使用してリモートのElasticsearchインストールのnetworkHostAddressを設定しても、競合が発生しないことを意味します。トランスポートアドレスと同様に、クラスターのすべてのマスターノードとデータノードのアドレスがすべて記載されていることを確認してください。

クラスタースニッフィング（追加設定）

Elasticsearchクラスターは複数のノードタイプを持つことができます。 Elasticsearchコネクターでデフォルトで有効になっているクラスタースニッフィングは、transportAddressesプロパティで設定されたdataノードを検索します。使用可能なものがない場合、コネクターはコンソールログにNoNodeAvailableExceptionをスローする可能性があります。このエラーを回避し、クラスタースニッフィングを継続して使用するには、少なくとも1つのデータノードのトランスポートアドレスを設定してください。

クラスタースニッフィングを無効にするには、clientTransportSniff=falseを.configファイルに追加するか、［システム設定］の［クライアント・トランスポート・スニフ］プロパティの選択を解除します。

Docker接続の拒否

Liferay DXPコンテナは、接続を確立するためにElasticsearch IPを認識する必要があります。以下のような因数を渡して、docker runフェーズでElasticsearchコンテナ名をElasticsearchサーバーホストIPアドレスにマッピングする/etc/hosts/エントリーを追加します。

--add-host elasticsearch:[IP address]

実行中のすべてのコンテナのIPアドレスを取得するには、

docker network inspect bridge

設定ファイル名

LiferayをElasticsearchに接続する際に問題が発生した場合（LiferayログにNoNodeAvailableExceptionメッセージが表示されるなど）、最初に実行する手順の1つは、設定ファイルに適切な名前が付けられていることを確認することです。認識できない設定ファイルは処理されず、結果としてさまざまなエラーが発生する可能性があります。

Elasticsearchの非推奨ログを無効にする

LiferayのElasticsearchコネクターで使用されるElasticsearch APIが廃止予定となる場合があります。 Liferayに必要な機能に影響がない場合でも、以下の警告ログメッセージが表示される可能性があります。

[2019-07-16T14:47:05,779][WARN ][o.e.d.c.j.Joda           ] [
ode_name]'y' year should be replaced with 'u'. Use 'y' for year-of-era. Prefix your date format with '8' to use the new specifier.
[2019-07-16T14:47:06,007][WARN ][o.e.d.c.s.Settings       ] [
ode_name][xpack.ssl.certificate] setting was deprecated in Elasticsearch and will be removed in a future release! See the breaking changes documentation for the next major version.
[2019-07-16T14:47:06,007][WARN ][o.e.d.c.s.Settings       ] [
ode_name][xpack.ssl.certificate_authorities] setting was deprecated in Elasticsearch and will be removed in a future release! See the breaking changes documentation for the next major version.
[2019-07-16T14:47:06,008][WARN ][o.e.d.c.s.Settings       ] [
ode_name][xpack.ssl.key] setting was deprecated in Elasticsearch and will be removed in a future release! See the breaking changes documentation for the next major version.
[2019-07-16T14:47:06,463][WARN ][o.e.d.x.c.s.SSLService   ] [
ode_name]SSL configuration [xpack.http.ssl] relies upon fallback to another configuration for [key configuration, trust configuration], which is deprecated.
[2019-07-16T14:47:06,464][WARN ][o.e.d.x.c.s.SSLService   ] [
ode_name]SSL configuration [xpack.security.transport.ssl.] relies upon fallback to another configuration for [key configuration, trust configuration], which is deprecated.
1. 07-16T14:47:05,779][WARN ][o.e.d.c.j.Joda           ] [

これらの警告は機能上の問題を示すものではなく、無効にすることができます（方法については、 Deprecation Logging を参照してください）。