Elasticsearchへの接続

Elasticsearchをセットアップした後、Liferay Connector to Elasticsearch を使って Liferay に接続します。 接続の手順は、設定するコネクターによって異なります。 利用可能なLiferay Elasticsearchコネクター を参照してください。

ここでは、インストールや設定手順の主な違いについて説明します。

Liferay 7.2を使用している場合は、 Liferay 7.2：Elasticsearch 7コネクタのインストール にスキップしてください。

コネクタの設定

Liferay 7.3+ 用の Elasticsearch コネクタは設定ファイルで設定できます：

com.liferay.portal.search.elasticsearch7.configuration.ElasticsearchConfiguration.config

この同じファイルを使用して、Liferay 7.3および7.4とElasticsearch 7または8を接続することができます。 ご利用可能なElasticsearchのバージョンは、 Search Engine Compatibility Matrix をご覧ください。

デプロイするには、 [Liferay Home]/osgi/configs/に配置します。

Dockerの場合、

docker cp ~/path/to/com.liferay.portal.search.elasticsearch7.configuration.ElasticsearchConfiguration.config [container]:/mnt/liferay/files

または、ユーザーインターフェイスでコネクタを設定することもできます。 グローバルメニュー（）で、［コントロールパネル］→ ［システム設定］を開き、 ［検索］ のカテゴリーを開きます。 このエントリはElasticsearch 7と呼ばれます。

Liferay 7.3+コネクタのシンプル設定では、本番環境モード（productionModeEnabled="true"）が有効になり、各Elasticsearchノード（networkHostAddresses=["http://es-node:9200"]）へのURLが設定されます。

1. 次の設定ファイルを作成します。

   com.liferay.portal.search.elasticsearch7.configuration.ElasticsearchConfiguration.config
   

2. .configファイルで設定プロパティを指定します。 コメントアウトされたセキュリティプロパティを含む例を次に示します（暗号化が有効になっている場合は httpsネットワークホストアドレスを使用する必要があることに注意してください）。

   # In CE/DXP 7.3+, productionModeEnabled replaces operationMode (deprecated):
   productionModeEnabled=B"true"
   networkHostAddresses=["http://es-node1:9200","http://es-node3:9201","http://es-node3:9202"]
   # In CE/DXP 7.3+ the security settings are included in the ElasticsearchConfiguration
   # In CE/DXP 7.2 the security settings go in com.liferay.portal.search.elasticsearch7.configuration.XPackSecurityConfiguration.config
   # Authentication
   #authenticationEnabled=B"true"
   #username="elastic"
   #password="liferay"
   
   # TLS/SSL
   #networkHostAddresses=["https://es-node1:9200","https://es-node3:9201","https://es-node3:9202"]
   #httpSSLEnabled=B"true"
   #truststoreType="pkcs12"
   #trustStorePath="/PATH/TO/elastic-nodes.p12"
   #trustStorePassword="liferay"
   
   # Highly recommended for all non-prodcution usage (e.g., practice, tests, diagnostics):
   #logExceptionsOnly="false"
   

3. .configファイルを[Liferay Home]/osgi/configsフォルダに配置します。

Elasticsearchサーバーを名前で参照するには、各Elasticsearchサーバー名をDNSまたはLiferayサーバーの/etc/hosts ファイル内のIPアドレスにマップします。

Liferay 7.2：Elasticsearch 7コネクタのインストール

Elasticsearch 6コネクタを停止する

Liferay 7.2では、バンドルされているコネクタアプリケーションとAPIはElasticsearch 6用です。 Elasticsearch 7コネクタをインストールする前に、これらを無効にする必要があります。

1. 以下のようなファイルを作成します。

   com.liferay.portal.bundle.blacklist.internal.BundleBlacklistConfiguration.config
   

2. 以下のコンテンツをファイルに追加します。

   blacklistBundleSymbolicNames=[ \
       "com.liferay.portal.search.elasticsearch6.api", \
       "com.liferay.portal.search.elasticsearch6.impl", \
       "com.liferay.portal.search.elasticsearch6.spi", \
       "com.liferay.portal.search.elasticsearch6.xpack.security.impl", \
       "Liferay Connector to X-Pack Security [Elastic Stack 6.x] - Impl", \
       "Liferay Enterprise Search Security - Impl.lpkg" \
   ]
   

3. ファイルを[Liferay Home]/osgi/configsフォルダに配置します。

   Liferayサーバーを起動すると（まだ起動していない場合）、Liferayはこのファイルを読み取り、宣言されたバンドルの起動をブロックします。

   tip

   Docker: Liferay Home と Liferay インストールの他の重要なフォルダは、Docker コンテナの /mnt/liferay で here と記述してアクセスすることが可能です。 docker cp /path/to/local/file [container_name]:/mnt/liferay/files/osgi/configs でコンテナに設定ファイルを配置することができます。 その後、docker cp を使って Liferay Connector to Elasticsearch 7 LPKGファイルをデプロイすることができます。

Elasticsearch 7コネクタのインストール

1. Liferay Connector to Elasticsearch 7をダウンロードします。

   コネクタがElasticsearchのバージョンに対応していることを確認してください。 コネクタアプリケーションが新しいバージョン（7.18.0など）をサポートしている場合でも、コネクタのクライアントライブラリが古いバージョンのElasticsearch（7.17.1など）用である可能性があることに注意してください。 Liferayは、Elasticsearchのマイナーバージョンごとにコネクタをテストし、必要に応じて新しいアップデートコネクタバージョンを作成します。 コネクタの互換性については、 検索エンジンの互換性マトリックス を参照してください。

   • CE： Liferay CE Connector to Elasticsearch 7
   • DXP： Liferay Connector to Elasticsearch 7

2. LPKGをフォルダに配置してインストールします。

   [Liferay Home]/deploy
   

   Dockerの場合、

   docker cp ~/path/to/Liferay\ Connector\ to\ Elasticsearch.lpkg [container]:/mnt/liferay/deploy
   

   Liferayサーバーを起動すると（まだ起動していない場合）、LiferayはLPKGをデプロイします。

これで、コネクタを設定する準備が整いました。

Liferay7.2用のコネクタを設定する

1. 次のElasticsearch設定ファイルを作成します。

   com.liferay.portal.search.elasticsearch7.configuration.ElasticsearchConfiguration.config
   

2. .configファイルで設定プロパティを指定します。 ここでは、リモート動作モードを有効にし、各Elasticsearchノードのトランスポートアドレスを設定し、設定している接続を識別する例を示します。

   # com.liferay.portal.search.elasticsearch7.configuration.ElasticsearchConfiguration.config
   operationMode="REMOTE"
   transportAddresses="ip.of.elasticsearch.node:9300"
   # Highly recommended for all non-production usage (e.g., practice, tests, diagnostics):
   #logExceptionsOnly="false"
   

3. .configファイルを[Liferay Home]/osgi/configsフォルダに配置して、設定をデプロイします。

これでLiferayを開始する準備が整いました。

Liferayを開始してインデックスを再作成する

Elasticsearchがインストールされて動作している場合は、Liferayを起動します。 コントロールパネルで［設定→ 検索機能］に移動し、Elasticsearchの接続がアクティブになっていることを確認します。

検索インデックスとスペルチェックインデックスのインデックスを再作成します。 コントロールパネルの → 構成 → 検索の［インデックスアクション］タブで、この2つのアクションを起動します。

Liferay 7.3+では、［Workflow Metrics Settings］ウィンドウからワークフロー統計情報インデックスを再作成します。

1. グローバルメニュー（）から［アプリケーション］ → ［ワークフローメトリクス］に移動します。

2. アプリオプションメニュー（）から ［Settings］ ウィンドウを開きます。

3. ［すべてインデックスを再構築］ をクリックします。 この操作をシステム内の各仮想インスタンスに対して繰り返します。

Liferay 7.4 U45+/GA45+とLiferay DXP 7.3 U14+では、拡張ログが有効になっているため、システムインデックスとカンパニーインデックスの再インデックスの開始と終了を知ることができます。 例えば、

2023-01-09 20:44:17.730 INFO  [liferay/background_task-2][ReindexPortalBackgroundTaskExecutor:57] Start reindexing company 0
2023-01-09 20:44:53.677 INFO  [liferay/background_task-2][ReindexPortalBackgroundTaskExecutor:76] Finished reindexing company 0
2023-01-09 20:44:53.677 INFO  [liferay/background_task-2][ReindexPortalBackgroundTaskExecutor:57] Start reindexing company 20097
2023-01-09 20:45:00.986 INFO  [liferay/background_task-2][ReindexPortalBackgroundTaskExecutor:76] Finished reindexing company 20097

これでLiferayはリモートElasticsearchにコンテンツをインデックスするようになりました。

利用可能なLiferay Elasticsearchコネクタ

バンドルされているElasticsearchへのコネクタが、インストールに最適であるとは限りません。 Elasticsearchとの通信に使用できるコネクタ間の違いを理解することが重要です。

* コネクタ設定の Operation Mode (operationMode) 設定は非推奨となり、Production Mode Enabled (productionModeEnabled) に置き換えられました。

** Liferay Enterprise Search Security アプリケーションを通して。

互換性のあるElasticsearchのバージョンや必要なパッチレベルなど、詳細な互換性情報については、 検索エンジン互換性マトリクス を参照してください。

次のステップ

LiferayがElasticsearchに接続されたので、Elasticsearchの使用を開始できます。 本番環境では、LiferayサーバーとElasticsearchサーバー間の通信を保護する必要があります。 詳しくは、Elasticsearchの保護を参照してください。

関連トピック

• Elasticsearchの保護
• Elasticsearchコネクタの設定
• サイドカーまたはEmbedded モードのElasticsearchの使用
• Liferay エンタープライズサーチ
• ページの検索
• 検索の管理と調整