第6章 クラスター化された JBoss EAP の起動

このトピックでは、mod_cluster および VPC なしでクラスター化された JBoss EAP AMI を起動する手順について説明します。

クラスター化された JBoss EAP AMI をスタンドアロンサーバーインスタンスで開始するには、事前設定された S3_PING JGroups スタックが含まれる /opt/rh/eap8/root/usr/share/wildfly/docs/examples/configs/standalone-ec2-ha.xml ファイルのサンプルを使用できます。詳細は、Reliable group communication with JGroups ドキュメントの S3_PING を参照してください。この standalone-ec2-ha.xml プロファイルファイルは、/opt/rh/eap/root/usr/share/wildfly/docs/examples/configs/ から JBoss EAP 設定ディレクトリー /opt/rh/eap8/root/usr/share/wildfly/standalone/configuration/ にコピーされる必要があります。その後、以下の行を JBoss EAP サービス設定ファイルに追加する必要があります。

WILDFLY_SERVER_CONFIG=standalone-ec2-ha.xml

undertow サブシステムのスタンドアロンサーバーインスタンスごとに、固有の instance-id を設定する必要があります。instance-id の値は、standalone-ec2-ha.xml ファイルを編集して、あるいは管理 CLO を使用して手動で設定できます。たとえば、以下のように管理 CLI を使用して instance-id を設定できます。

/subsystem=undertow:write-attribute(name=instance-id,value={${jboss.jvmRoute}})

Jboss.jvmRoute の値は JAVA_OPTS 変数を使用して standalone.conf に指定できます。

EC2 設定ファイルの jgroups サブシステムでは、クラスターメンバーを検出するために S3_PING 固有のプロパティーが必要です。S3、シークレットアクセスキー、および検出に使用する S3 バケットにアクセスキーを指定する必要があります。これらのプロパティーは Java オプションとして指定するか、編集して、あるいは CLI を使用して XML ファイルに直接追加することができます。

検出用に S3 バケットを作成する必要があります。詳細は、Amazon Simple Storage Service Documentation を参照してください。必要なパーミッションの設定が必要になることもあります。JGroups スタックは、他のノードとの通信に使用される IP アドレスにバインドする必要があります。これは、S3 Java オプションとともに /opt/rh/eap8/root/usr/share/wildfly/bin/standalone.conf ファイルに Java オプションを追加することで行うことができます。たとえば、プライベート IP アドレスが 10.10.10.10 の場合は、以下の行を standalone.conf ファイルに追加します。

JAVA_OPTS="$JAVA_OPTS -Djboss.bind.address.private=10.10.10.10
-Djboss.jgroups.aws.s3_ping.region_name=<S3_REGION_NAME>
-Djboss.jgroups.aws.s3_ping.bucket_name=<S3_BUCKET_NAME>"

サンプルアプリケーション: /opt/rh/eap8/root/usr/share/java/eap8-jboss-ec2-eap-samples/cluster-demo.war をデプロイして、/opt/rh/eap8/root/usr/share/wildfly/standalone/log/server.log でログを確認し、JBoss EAP サーバーがクラスターを作成していることを確認できます。