サンプルのCCRインストールの構成:データセンター間での複製
Liferay Enterprise Search(LES)サブスクライバー
この例では、Liferay DXPのクラスター横断レプリケーションモジュールとElasticsearchを構成して、2つの接続(一方のElasticsearchクラスターから1つのLiferay DXPクラスターノードへの読み取り/書き込み接続と、もう一方のElasticsearchクラスターから2番目のLiferay DXPクラスターノードへの読み取り接続)を設定します。
Liferay DXP 7.1、7.2、7.3の間の設定や手順の違いは、この説明書の中でインラインで記載されています。
localhost
で2つのシングルノードElasticsearchクラスターを使用し、それぞれに同じインデックスのコピーを設定します。 これは、クラスター横断レプリケーションのデータの局所性とディザスタリカバリのメリットを享受するために構成できる最も単純なシナリオです。
バニラのLiferay DXPインストールには、 クラスター横断レプリケーション で提示されるインデックスが含まれています。 Liferay DXPで使用されるすべてのElasticsearchクラスター(この例では2つのクラスター)には、これらのインデックスが必要です。
ここで提供されるElasticsearch API呼び出しは、Kibanaの開発ツールコンソールにコピーして貼り付けることができ、別のKibanaインストールまたはLES モニタリングウィジェットからアクセスできます。
Kibanaを使うには、複数のElasticsearchクラスタ(この例では2つのシングルノードクラスタ)が稼働していることを思い出してください。 elasticsearch.hosts:[ "http://localhost:<port>" ]
Kibana の kibana.yml
ファイルの設定は、リーダークラスタとフォロワークラスタが混在しないように、後述のインデックスやその他の設定を管理する際に、正しいポートを指す必要があります。 ここでは、リーダーのElasticsearchクラスタノードがポート9200
を、フォロワーがポート9202
を使用すると仮定しています。
クラスターLiferay DXP
各Liferay DXPノードには、次のプロパティを持つLiferay Home/portal-ext.properties
ファイルが必要です。
cluster.link.enabled=true
これは単純なクラスタリング構成です。 完全な構成については、クラスタリングを参照してください。
必要なElasticsearchプラグインのインストール
必要なElasticsearch プラグイン を必ずインストールしてください。
analysis-icu
analysis-stempel
analysis-kuromoji
analysis-smartcn
セキュリティの前提条件:認証と暗号化を設定する
通信(TLS/SSL)を暗号化し、Liferay DXPとElasticsearchノード間のユーザー認証を有効にするには、セキュリティを設定する必要があります。
-
ElasticsearchクラスターでX-Pack Securityを構成します。 ノード証明書が同じCAによって署名されており、リーダークラスターとフォロワークラスターのセキュリティ設定が一致していることを確認してください。
note後続のElasticsearchクラスタノードのHTTPおよびTransportレイヤでTLS/SSLが有効になっている必要があります。 Liferay DXPはHTTP経由でフォロアクラスタに接続し、フルリインデックスが実行された後、企業インデックスを再フォローします。
-
DXPノードを設定します。
Liferay DXP 7.3の場合、
ElasticsearchConfiguration.config
ファイルでElasticsearchの本番環境モード設定を構成してから、ElasticsearchConnectionConfiguration-[ccr/remote].config
ファイルで接続を個別に構成します。Liferay DXP 7.1および7.2の場合、
ElasticsearchConfiguration.config
でリモート接続を、ElasticsearchConnectionConfiguration-ccr.config
でリードオンリー接続を設定します。各接続にセキュリティ設定を含めます。 詳細は、Elasticsearchの保護を参照してください。 ローカルフォロワーデータセンターでのCCRの構成 では、ローカルDXPノードからの読み取り専用CCR接続に対するセキュリティの設定について説明しています。
完全な構成例は、こちらで提供しています。
クラスター横断レプリケーションモジュールのインストール
Liferay DXP 7.4より、Liferay Enterprise Search (LES)アプリケーションは、すべてのLiferay DXPバンドルとDockerコンテナに含まれています。 そのため、Liferay DXP 7.4+では、LPKGのインストールは不要です。 詳しくは、 LESの起動 をご覧ください。
-
LESダウンロードページ から、Elasticsearch LPKGのLiferay DXPクラスター横断レプリケーションをダウンロードします。
-
すべてのDXPノードにLPKGをインストールします。
クラスター横断レプリケーションを使用するLiferayDXP 7.1および7.2では複数のElasticsearch接続のみを使用するため、つながりUIは、クロスクラスターの場合、レプリケーションLPKGがデプロイされている場合、 検索管理パネル([コントロールパネル]> [構成]> [検索] — [つながり]タブの下)にのみ表示されます。 Liferay DXP 7.3では、つながりUIが常に表示されています。
前提条件のタスクがすべて完了し、クラスター横断レプリケーションモジュールがインストールされている場合は、リモートデータセンターでサーバーを構成して続行します。