例：シンプルなDXPクラスターの作成

DXP クラスタリングを習得する迅速かつ簡単な方法は、 Docker コンテナを使用して 1 台のマシンに 2 ノードの DXP クラスタ環境をセットアップすることです。 この例では、データベース、検索エンジン、およびファイル ストアのサーバー コンテナーとともに、2 つの DXP サーバー コンテナーを作成します。

主な手順は次のとおりです。

1. データベースサーバーを起動する
2. ファイルストアサーバーを起動する
3. 検索エンジンサーバーを起動する
4. 各ノードの検索エンジンを設定する
5. DXPクラスターを開始する
6. DXPクラスターをテストする

データベースサーバーを起動する

DXPクラスターには、すべてのDXPクラスターノードからアクセスできるデータソースが必要です。 データソースは、JNDIデータソースにするか、データベースサーバーまたはデータベースサーバークラスターへの直接接続にすることができます。 DXP バージョンがサポートするデータベース サーバーについては、 互換性マトリックス を参照してください。

データベースサーバーとDXPデータベースを作成します。

1. MariaDB Dockerコンテナを起動します。

   docker run --name some-mariadb -e MYSQL_ROOT_PASSWORD=my-secret-pw -d mariadb:10.2
   

2. コンテナ上のシェルで、 DXP データベースを作成します。

   データベースサーバーにサインインします。

   docker exec -it some-mariadb bash -c "/usr/bin/mysql -uroot -pmy-secret-pw"
   

   DXP用のデータベースを作成します。

   create database dxp_db default character set utf8mb4 collate utf8mb4_unicode_ci;
   

   データベースセッションを終了します。

   quit
   

   bashセッションを終了します。

   exit
   

データベースサーバーでDXP用の準備が整いました。 詳細については、 クラスターノードのデータベース構成 を参照してください。

ファイルストアサーバーを起動する

DXPクラスターには、すべてのDXPクラスターノードからアクセスできるファイルストアが必要です。 便宜上、この例では DXP データベースに構成された DBStore ファイル ストア を使用します。 この例ですでに起動しているデータベースサーバーには、ファイルストアが含まれています。 すべてのファイル ストア タイプの構成については、 ファイル ストレージの構成 を参照してください。

検索エンジンサーバーを起動する

DXPクラスターには、すべてのDXPクラスターノードからアクセス可能な検索エンジン（個別のプロセスとして実行）が必要です。 詳細については、「 検索エンジンのインストール 」を参照してください。

Elasticsearchサーバーを作成して設定します。

1. Elasticsearchサーバーのデータボリュームを保存するためのローカルフォルダを設定します。 例えば、

   mkdir -p elasticsearch/es_data_volume
   

2. elasticsearchという名前のElasticsearchコンテナを起動します。

   docker run -it --name elasticsearch -p 9200:9200 -p 9300:9300 -e cluster.name=LiferayElasticsearchCluster -e ES_JAVA_OPTS="-Xms512m -Xmx512m" -v $(pwd)/elasticsearch/es_data_volume:/var/lib/elasticsearch/data elasticsearch:6.8.7
   

   注

   コンテナーが 最大仮想メモリ領域 vm.max_map_count [xxxxx] が低すぎると報告する場合は、少なくとも [xxxxxx]まで増やしてから、次のようなコマンドを使用して vm.max_map_count を十分な値に設定します: sudo sysctl -w vm.max_map_count=[xxxxxx]。 次に、コンテナを起動します。

3. 必要なElasticsearchプラグインをインストールします。

   docker exec -it elasticsearch bash -c '/usr/share/elasticsearch/bin/elasticsearch-plugin install analysis-icu && /usr/share/elasticsearch/bin/elasticsearch-plugin install analysis-kuromoji && /usr/share/elasticsearch/bin/elasticsearch-plugin install analysis-smartcn && /usr/share/elasticsearch/bin/elasticsearch-plugin install analysis-stempel'
   

検索エンジンは検索インデックスを管理する準備ができました。

ノードごとに検索エンジンサーバーを設定する

設定ファイル を使用して、各 DXP ノードの Elasticsearch を設定します。

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

   mkdir -p dxp-1/files/osgi/configs dxp-2/files/osgi/configs
   

2. dxp-1サーバーノードのElasticsearchを設定します。

   cat <<EOT >> dxp-1/files/osgi/configs/com.liferay.portal.search.elasticsearch6.configuration.ElasticsearchConfiguration.config
   operationMode="REMOTE"
   transportAddresses="elasticsearch:9300"
   clusterName="LiferayElasticsearchCluster"
   EOT
   

3. dxp-2サーバーノードのElasticsearchを設定します。

   cat <<EOT >> dxp-2/files/osgi/configs/com.liferay.portal.search.elasticsearch6.configuration.ElasticsearchConfiguration.config
   operationMode="REMOTE"
   transportAddresses="elasticsearch:9300"
   clusterName="LiferayElasticsearchCluster"
   EOT
   

これらの設定ファイルを、DXPサーバーコンテナのバインドマウントを介してクラスターノードからアクセスできるようにします。

DXPクラスターを開始する

1. docker network inspect bridge コマンドを実行して、 elasticsearch および some-mariadb コンテナのコンテナ IP アドレスを取得します。 bridgeネットワークがデフォルトネットワークです。

   重要

   後続の docker run コマンドで、 [IP アドレス] を elasticsearch および some-mariadb コンテナの IP アドレスに置き換えます。

2. dxp-1を開始します。

   読みやすいように拡張されたコマンド：

   docker run -it \
      --add-host elasticsearch:[IP address] \
      --add-host some-mariadb:[IP address] \
      -e LIFERAY_JDBC_PERIOD_DEFAULT_PERIOD_JNDI_PERIOD_NAME="" \
      -e LIFERAY_JDBC_PERIOD_DEFAULT_PERIOD_DRIVER_UPPERCASEC_LASS_UPPERCASEN_AME=org.mariadb.jdbc.Driver \
      -e LIFERAY_JDBC_PERIOD_DEFAULT_PERIOD_URL="jdbc:mariadb://some-mariadb:3306/dxp_db?useUnicode=true&characterEncoding=UTF-8&useFastDateParsing=false" \
      -e LIFERAY_JDBC_PERIOD_DEFAULT_PERIOD_USERNAME=root \
      -e LIFERAY_JDBC_PERIOD_DEFAULT_PERIOD_PASSWORD=my-secret-pw \
      -e LIFERAY_CLUSTER_PERIOD_LINK_PERIOD_ENABLED=true \
      -e LIFERAY_CLUSTER_PERIOD_LINK_PERIOD_CHANNEL_PERIOD_LOGIC_PERIOD_NAME_PERIOD_CONTROL=control-channel-logic-name-1 \
      -e LIFERAY_CLUSTER_PERIOD_LINK_PERIOD_CHANNEL_PERIOD_LOGIC_PERIOD_NAME_PERIOD_TRANSPORT_PERIOD_NUMBER0=transport-channel-logic-name-1 \
      -e LIFERAY_CLUSTER_PERIOD_LINK_PERIOD_AUTODETECT_PERIOD_ADDRESS=some-mariadb:3306 \
      -e LIFERAY_WEB_PERIOD_SERVER_PERIOD_DISPLAY_PERIOD_NODE=true \
      -e LIFERAY_DL_PERIOD_STORE_PERIOD_IMPL=com.liferay.portal.store.db.DBStore \
      --name dxp-1 \
      -p 11311:11311 \
      -p 8009:8009 \
      -p 8080:8080 \
      -v $(pwd)/dxp-1:/mnt/liferay \
      liferay/portal:7.4.3.132-ga132
   

   1行に凝縮されたコマンド：

   docker run -it --name dxp-1 --add-host elasticsearch:[IP address] --add-host some-mariadb:[IP address] -e LIFERAY_JDBC_PERIOD_DEFAULT_PERIOD_JNDI_PERIOD_NAME="" -e LIFERAY_JDBC_PERIOD_DEFAULT_PERIOD_DRIVER_UPPERCASEC_LASS_UPPERCASEN_AME=org.mariadb.jdbc.Driver -e LIFERAY_JDBC_PERIOD_DEFAULT_PERIOD_URL="jdbc:mariadb://some-mariadb:3306/dxp_db?useUnicode=true&characterEncoding=UTF-8&useFastDateParsing=false" -e LIFERAY_JDBC_PERIOD_DEFAULT_PERIOD_USERNAME=root -e LIFERAY_JDBC_PERIOD_DEFAULT_PERIOD_PASSWORD=my-secret-pw -e LIFERAY_CLUSTER_PERIOD_LINK_PERIOD_ENABLED=true -e LIFERAY_CLUSTER_PERIOD_LINK_PERIOD_CHANNEL_PERIOD_LOGIC_PERIOD_NAME_PERIOD_CONTROL=control-channel-logic-name-1 -e LIFERAY_CLUSTER_PERIOD_LINK_PERIOD_CHANNEL_PERIOD_LOGIC_PERIOD_NAME_PERIOD_TRANSPORT_PERIOD_NUMBER0=transport-channel-logic-name-1 -e LIFERAY_CLUSTER_PERIOD_LINK_PERIOD_AUTODETECT_PERIOD_ADDRESS=some-mariadb:3306 -e LIFERAY_WEB_PERIOD_SERVER_PERIOD_DISPLAY_PERIOD_NODE=true -e LIFERAY_DL_PERIOD_STORE_PERIOD_IMPL=com.liferay.portal.store.db.DBStore --name dxp-1 -p 11311:11311 -p 8009:8009 -p 8080:8080 -v $(pwd)/dxp-1:/mnt/liferay liferay/portal:7.4.3.132-ga132
   

3. dxp-2を起動します。

   読みやすいように拡張されたコマンド：

   docker run -it \
      --add-host elasticsearch:[IP address] \
      --add-host some-mariadb:[IP address] \
      -e LIFERAY_JDBC_PERIOD_DEFAULT_PERIOD_JNDI_PERIOD_NAME="" \
      -e LIFERAY_JDBC_PERIOD_DEFAULT_PERIOD_DRIVER_UPPERCASEC_LASS_UPPERCASEN_AME=org.mariadb.jdbc.Driver \
      -e LIFERAY_JDBC_PERIOD_DEFAULT_PERIOD_URL="jdbc:mariadb://some-mariadb:3306/dxp_db?useUnicode=true&characterEncoding=UTF-8&useFastDateParsing=false" \
      -e LIFERAY_JDBC_PERIOD_DEFAULT_PERIOD_USERNAME=root \
      -e LIFERAY_JDBC_PERIOD_DEFAULT_PERIOD_PASSWORD=my-secret-pw \
      -e LIFERAY_CLUSTER_PERIOD_LINK_PERIOD_ENABLED=true \
      -e LIFERAY_CLUSTER_PERIOD_LINK_PERIOD_CHANNEL_PERIOD_LOGIC_PERIOD_NAME_PERIOD_CONTROL=control-channel-logic-name-2 \
      -e LIFERAY_CLUSTER_PERIOD_LINK_PERIOD_CHANNEL_PERIOD_LOGIC_PERIOD_NAME_PERIOD_TRANSPORT_PERIOD_NUMBER0=transport-channel-logic-name-2 \
      -e LIFERAY_CLUSTER_PERIOD_LINK_PERIOD_AUTODETECT_PERIOD_ADDRESS=some-mariadb:3306 \
      -e LIFERAY_WEB_PERIOD_SERVER_PERIOD_DISPLAY_PERIOD_NODE=true \
      -e LIFERAY_DL_PERIOD_STORE_PERIOD_IMPL=com.liferay.portal.store.db.DBStore \
      --name dxp-2 \
      -p 11312:11311 \
      -p 9009:8009 \
      -p 9080:8080 \
      -v $(pwd)/dxp-2:/mnt/liferay \
      liferay/portal:7.4.3.132-ga132
   

   1行に凝縮されたコマンド：

   docker run -it --add-host elasticsearch:[IP address] --add-host some-mariadb:[IP address] -e LIFERAY_JDBC_PERIOD_DEFAULT_PERIOD_JNDI_PERIOD_NAME="" -e LIFERAY_JDBC_PERIOD_DEFAULT_PERIOD_DRIVER_UPPERCASEC_LASS_UPPERCASEN_AME=org.mariadb.jdbc.Driver -e LIFERAY_JDBC_PERIOD_DEFAULT_PERIOD_URL="jdbc:mariadb://some-mariadb:3306/dxp_db?useUnicode=true&characterEncoding=UTF-8&useFastDateParsing=false" -e LIFERAY_JDBC_PERIOD_DEFAULT_PERIOD_USERNAME=root -e LIFERAY_JDBC_PERIOD_DEFAULT_PERIOD_PASSWORD=my-secret-pw -e LIFERAY_CLUSTER_PERIOD_LINK_PERIOD_ENABLED=true -e LIFERAY_CLUSTER_PERIOD_LINK_PERIOD_CHANNEL_PERIOD_LOGIC_PERIOD_NAME_PERIOD_CONTROL=control-channel-logic-name-2 -e LIFERAY_CLUSTER_PERIOD_LINK_PERIOD_CHANNEL_PERIOD_LOGIC_PERIOD_NAME_PERIOD_TRANSPORT_PERIOD_NUMBER0=transport-channel-logic-name-2 -e LIFERAY_CLUSTER_PERIOD_LINK_PERIOD_AUTODETECT_PERIOD_ADDRESS=some-mariadb:3306 -e LIFERAY_WEB_PERIOD_SERVER_PERIOD_DISPLAY_PERIOD_NODE=true -e LIFERAY_DL_PERIOD_STORE_PERIOD_IMPL=com.liferay.portal.store.db.DBStore --name dxp-2 -p 11312:11311 -p 9009:8009 -p 9080:8080 -v $(pwd)/dxp-2:/mnt/liferay liferay/portal:7.4.3.132-ga132
   

--add-host [ドメイン]:[IP アドレス] オプション は、ドメイン名を IP アドレスにマッピングする /etc/hosts ファイル エントリ を追加します。 これにより、構成 (環境変数、ポータル プロパティ、 .config ファイルなど) がドメイン名でサーバーを参照できるようになります。

-e ［variable］=［value］オプションは、DXPコンテナ環境変数を設定します。 詳細については、 付録A: 環境設定 を参照してください。

DXP クラスター ノード コンテナーには、次の固有の設定があります。

DXPノードにアクセスする

DXPクラスターノードは、次のURLで入手できます。

• DXP-1：http://localhost:8080
• DXP-2：http://localhost:9080

次の図は、クラスターノードのホームページを示しています。

各ノードのコンテナIDとポート（ノード： ［id］:［port］）は、各ページの下部に表示されます。 LIFERAY_WEB_PERIOD_SERVER_PERIOD_DISPLAY_PERIOD_NODE=true環境設定により、この表示機能が有効になりました。 docker container ls コマンドを使用して、コンテナの ID を見つけることができます。

コンテンツを検索エンジンにインデックス付けする

1. コントロール パネル → 構成 → 検索に移動します。

2. [インデックス アクション] タブで、 [すべての検索インデックスの再インデックス化] と [すべてのスペル チェック インデックスの再インデックス化]をクリックします。

コンテンツは検索エンジンにインデックス付けされます。 詳細については、 検索の概要 を参照してください。

DXPクラスターをテストする

ノード間のデータ同期をテストします。

1. クラスタノードの1つにコンテンツを追加します。 たとえば、New Stuffという名前の新しいウィジェットページを追加し、それに言語セレクタウィジェットを追加します。

2. 他のクラスターノードのUIを更新します。

両方のノードに同じ新しいコンテンツが表示されます。

これで作業中の DXPクラスタを作成できました！

次のステップ

DXP クラスター用にデータベース を構成します。

付録A：環境設定

サンプルの DXP サーバー コンテナーでは、これらの設定が使用されます。

詳細については、Env/ポータル プロパティ の定義を参照してください。

関連トピック

• クラスタノードのデータベース構成
• Configuring Cluster Link