Documentation

サイドカーまたはEmbedded モードのElasticsearchの使用

ZIPファイルまたはDockerイメージを介してインストールされたLiferay Tomcatバンドルには、Liferayで始まるElasticsearchノードが含まれています。 Liferay 7.3のノードはサイドカーサーバーとして別のJVMで実行され、Liferay 7.2のノードはLiferayサーバーに組み込まれています。

Elasticsearchサーバーには、次のURLからアクセスできます。

サイドカーサーバーの出力例は次のとおりです。

{
  "name" : "liferay",
  "cluster_name" : "LiferayElasticsearchCluster",
  "cluster_uuid" : "DGRDj1_DS7Km2Y_kaaNqxg",
  "version" : {
    "number" : "7.9.0",
    "build_flavor" : "unknown",
    "build_type" : "unknown",
    "build_hash" : "a479a2a7fce0389512d6a9361301708b92dff667",
    "build_date" : "2020-08-11T21:36:48.204330Z",
    "build_snapshot" : false,
    "lucene_version" : "8.6.0",
    "minimum_wire_compatibility_version" : "6.8.0",
    "minimum_index_compatibility_version" : "6.0.0-beta1"
  },
  "tagline" : "You Know, for Search"
}

バンドルされているElasticsearchサーバーは開発とテストには便利ですが、どちらも本番環境には適していません。

注釈

本番環境でサポートされている構成ではありませんが、KibanaをインストールしてバンドルされているElasticsearchサーバーを監視することは、開発やテストの際に役立ちます。 KibanaがビルドしたOSSのみhttps://www.elastic.co/downloads/kibana-ossをインストールすることに注意してください。

HSQLのような組み込みデータベースを本番環境で実行したり、バンドルされたElasticsearchサーバーを本番環境で実行したりしないでください。 代わりに、Elasticsearchをスタンドアロンサーバーまたはサーバーノードのクラスターとしてリモートモードで実行します。

重要

Synonym SetsとResult Rankingsは、検索インデックスを一次データの保存に使用するアプリケーションです。 Liferayのデータベースにデータは保存されません。 そのため、サイドカーや組み込みのElasticsearchを使用しているときにSynonym SetsやResult Rankingsが設定されていた場合、リモートのElasticsearchサーバに切り替えてインデックスを再作成しても、それらの設定は``復元されません。 その代わり、シノニムセットと結果ランキングをリモートのElasticsearchクラスタに手動で取り込む必要があります。 インデックスを維持するためのElasticの スナップショットと復元 機能の詳細は アップグレードガイド を参照してください。

バンドルされているElasticsearchサーバーのユースケース

デフォルトのElasticsearchサーバー(サイドカーおよびEmbedded)の一般的な使用法は次のとおりです。

  • カスタムの 検索とインデックスコード のテスト

  • Kibanaを介してElasticsearchで直接クエリを実行して検索クエリを開発する

  • 検索の調整機能のテスト

  • 検索ウィジェットの調査と設定

アプリサーバーの違い

Liferay DXP 7.3およびLiferay Portal 7.3 GA4のTomcatバンドルとDockerイメージには、Elasticsearchサイドカーサーバーがバンドルされていますが、サポートされているアプリケーションサーバーにLiferay WARをインストールする場合には、いくつかの重要な違いがあります。

Liferay DXPのフレーバー

デフォルトのElasticsearch

事前インストール

手動による介入が必要

Tomcatバンドル:7.3 GA4+

サイドカー

Tomcat:7.3 GA4+

サイドカー

✘ (自動ダウンロードされました)

Dockerタグ: 7.3 GA4

サイドカー

JBoss:7.3 GA4+

サイドカー

✘ (自動ダウンロードされました)

Wildfly:7.3 GA4+

サイドカー

✘ (自動ダウンロードされました)

WebSphere:7.3 GA4+

サイドカー

Weblogic:7.3 GA4+

サイドカー

すべてのフレーバー:7.2/7.3 GA3-

Embedded

Tomcat以外のアプリケーションサーバーのバンドルをダウンロードした場合、サーバーを起動すると、Elasticsearchディストリビューションがオンザフライでダウンロードされ、サイドカーサーバーとして起動されます。

WebSphereおよびWeblogicアプリケーションサーバーへのLiferay DXP 7.3のインストール手順には、サイドカーサーバーの初期化に必要なElasticsearchアーカイブを手動で提供するための手順が含まれています。

重要

バンドルされているElasticsearchサーバは、開発およびテスト目的に有用であり、本番環境では使用しないでください。 リモート検索エンジンのインストールについては、 Elasticsearchをインスト0るする を参照してください。

Embeddedとサイドカーの比較

ElasticsearchサーバーのEmbeddedモードとサイドカーモードの比較を次に示します。

Embedded

サイドカー

安全な接続を構成できません

安全な接続を構成できません

ElasticsearchのOSSバージョンを使用します

ElasticsearchのOSSバージョンを使用します

http://localhost:9200で実行します

http://localhost:9201で実行します

すべてのLiferayディストリビューションに事前インストールされています

常に事前インストールされているわけではありません

本番環境ではサポートされていません

本番環境ではサポートされていません

アプリサーバーに特別な手順は必要ありません

一部のアプリサーバー では追加の手順が必要です