TCPを介したユニキャストの構成

ネットワーク構成またはクラスター ノード間の地理的な距離により UDP マルチキャスト クラスタリングを使用できない場合は、TCP ユニキャストを構成できます。 ファイアウォールがノードを分離している場合、またはノードが地理的に異なる場所にある場合は、これを使用する必要があります。

ユニキャスト構成

ユニキャストを構成するには、次の手順を使用します。

1. JGroupsバインドアドレスパラメーターを各ノードのアプリサーバーのJVMに追加します。

   -Djgroups.bind_addr=[place your IP address or host name here]
   

   ノードのIPアドレスまたはホスト名を使用します。

2. ノードが互いを見つけるために使用する検出プロトコルを選択します。 プロトコルの選択肢は次のとおりです。

   • TCPPing
   • JDBCPing
   • S3_Ping
   • Rackspace_Ping

   どれを選択すればよいかわからない場合は、TCPPingを使用してください。 これらの残りのステップでは、TCPPingを使用します。 その他の詳細については、 代替検出プロトコル を参照してください。

3. tcp.xml ファイルを $LIFERAY.HOME/osgi/portal/com.liferay.portal.cluster.multiple.jar/lib​/​jgroups​-​[version].​Final​.​jar/tcp.xml から DXP がアクセスできる場所（DXP Web アプリケーションの WEB-INF/classes フォルダ内の jgroups というフォルダなど）に抽出します。

   WEB-INF/classes/jgroups/tcp.xml
   

   この tcp.xml 構成ファイルは、クラスター リンクの制御チャネルとトランスポート チャネルの両方に使用されることに注意してください。 別々の構成ファイルを使用するには、 「異なる制御チャネル ポートとトランスポート チャネル ポートの使用」を参照してください。

4. tcp.xml ファイルで、TCPバインドポートをノードの未使用ポートに設定します。 以下に例を示します。

   <TCP bind_port="7800"/>
   

5. tcp.xml ファイルで、ノードのIPアドレスとそのノードの未使用ポートを指定して、各ノードをTCPPingで検出できるようにします。 前のステップを基にして、以下は <TCPPing> 要素の例です。

   <TCP bind_port="7800"/>
   <TCPPING async_discovery="true"
       initial_hosts="192.168.224.154[7800],192.168.224.155[7800]"
       port_range="1"/>
   

   重要

   TCCPing が各チャネルを作成するために追加のポートをプローブできるように、 port_range が 1 に設定されていることに注意してください。 たとえば、 initial_hosts="HostA[7800],HostB[7800]の場合、TCCPing はポート 7800 と 7801 を使用して HostA と HostB の両方に接続しようとします。 必要なポート数（チャネル数から 1 を引いた数）をカバーするようにこの値を設定します。

   初期ホストについて：

   • 最初のホスト値がすべてのノードに対応していることを確認してください。 TCP XMLファイルまたはJVM引数で initial_hosts が指定されていない場合、 localhost が初期ホストです。

   • TCP XMLファイルで初期ホストを指定する代わりに、次のようなJVM引数を使用してアプリサーバーにそれらを指定することもできます。

   -Djgroups.tcpping.initial_hosts=192.168.224.154[7800],192.168.224.155[7800]
   

6. tcp.xml ファイルを各ノードの同じ場所にコピーして、TCPバインドポートが各ノードの未使用のポートに設定されていることを確認します。 必ず JVM 引数を参照してください。 たとえば、IPアドレス 192.168.224.155のノードで、次のようにTCPPingを構成します。

   <TCP bind_port="7800"/>
   <TCPPING async_discovery="true"
       initial_hosts="${jgroups.tcpping.initial_hosts:192.168.224.154[7800],192.168.224.155[7800]}"
       port_range="1"/>
   

7. 各ノードの portal-ext.properties ファイル にある Cluster Link プロパティ を変更して Cluster Link を有効にし、各 Cluster Link チャネルの TCP XML ファイルを指定します。 この例では MD5 ハッシュを使用します。

   cluster.link.enabled=true
   cluster.link.channel.properties.control=jgroups/tcp.xml
   cluster.link.channel.properties.transport.0=tcp.xml
   

上記のJGroups構成は、通常、Unicast over TCPに必要なすべての構成です。 しかし、非常に特殊なケースとして、 (そしてその場合のみ) クラスタノードが複数のネットワークに渡って配置されている場合、各ホストの external_addr TCP transport parameter にファイアーウォールの外部 (public IP) アドレスを設定しなければなりません。 この種の構成は通常、ノードが地理的に離れている場合にのみ必要です。 これを設定することにより、別々のネットワークにデプロイされたクラスター化されたノード（たとえば、異なるファイアウォールによって分離されたノード）は互いに通信できます。 この構成は、システムのセキュリティ監査でフラグが立てられる場合があります。 詳細については、 JGroups ドキュメント を参照してください。

注

singleton_name TCP 属性は JGroups v4.0.0 で非推奨となり、JGroups v 4.1.1-Final を使用する Liferay DXP 7.2 SP1 および Liferay Portal GA2 以降では削除されました。

これで、TCPクラスタリングを介したユニキャストがセットアップされました。

代替発見プロトコル

TCP Pingは、大部分のユースケースに適合するために使用できるデフォルトの検出プロトコルです。 ただし、以下で説明する他の検出プロトコルを使用することもできます。

JDBC Ping

TCP Pingを使用してクラスターメンバーを検出する代わりに、すべてのノードがアクセスできる中央データベースを使用して、お互いを見つけやすくすることができます。 クラスターメンバーは自分のメンバーを書き込み、このデータベースから他のメンバーのアドレスを読み取ります。 この構成を有効にするには、 ユニキャスト構成 手順で参照されている TCPPING タグを、対応する JDBC_PING タグに置き換えます。

<JDBC_PING
    connection_url="[place the URL to your database here]"
    connection_username="[place your user name here]"
    connection_password="[place your password here]"
    connection_driver="[place your driver name here]"/>

JDBC 接続値の例については、 データベース テンプレートを参照してください。 JDBC Ping の詳細については、 JGroups ドキュメントを参照してください。

S3 ping

Amazon S3 Pingは、AmazonのEC2クラウドサービスで実行されているサーバーに使用できます。 各ノードは小さなファイルをS3バケットにアップロードし、他のすべてのノードはこのバケットからファイルを読み取って他のノードを検出します。 ノードが離れると、そのファイルは削除されます。

S3 Ping を設定するには、 ユニキャスト設定 ステップの TCPPING タグを、対応する S3_PING タグに置き換えます。

<S3_PING
    secret_access_key="[SECRETKEY]"
    access_key="[ACCESSKEY]"
    location="ControlBucket"/>

上記のパラメーターの値としてAmazonキーを指定します。 S3 Ping の詳細については、 JGroups ドキュメントを参照してください。

その他のping

JGroupsは、Rackspace Ping、BPing、File Pingなど、クラスターメンバーがお互いを発見するための他の手段を提供します。 これらの検出方法の詳細については、 JGroups ドキュメント を参照してください。

異なる制御およびトランスポートチャネルポートの使用

制御チャネルとトランスポートチャネルは、異なるポートを使用するように構成できます。 個別の制御チャネルポートとトランスポートチャネルポートを使用すると、制御トラフィックとトランスポートトラフィックを監視でき、情報を分離して問題を診断できます。

次の手順では、Unicast over TCPPingを使用してアプローチを示します。

1. 各ノードでアプリサーバーのJVMにパラメーターを追加します。

   -Djgroups.bind_addr=[node_ip_address]
   

2. $LIFERAY.HOME/osgi/marketplace/Liferay Foundation - Liferay Portal - Impl.lpkg/com.liferay.Portal.cluster.multiple-[version].jar/lib/jgroups-[version].Final.jar/tcp.xmlからtcp.xmlファイルをDXPにアクセスできる場所に展開します。 jar/lib/jgroups-[version].Final.jar/tcp.xmlを、DXPウェブアプリケーションのWEB-INF/classesフォルダ内のjgroupsというフォルダなど、DXPでアクセス可能な場所に移動します。

3. 同じ場所に tcp.xmlのコピーを作成し、両方のファイルの名前を変更して、1つを制御チャネル用に、もう1つをトランスポートチャネル用に指定します。 たとえば、次のファイル名を使用できます。

   • tcp-control.xml
   • tcp-transport.xml

4. cluster.link.autodetect.address プロパティを空の値に設定して、アドレスの自動検出を無効にします。

   cluster.link.autodetect.address=
   

5. ノードの portal-ext.properties ファイル にある Cluster Link プロパティ を変更して Cluster Link を有効にし、各 Cluster Link チャネルの TCP XML ファイルを指定します。

   cluster.link.enabled=true
   cluster.link.channel.properties.control=/jgroups/tcp-control.xml
   cluster.link.channel.properties.transport.0=/jgroups/tcp-transport.xml
   

6. 各 tcp-*。xml ファイルのTCPおよび検出プロトコルタグ（たとえば、TCPPingを使用している場合は TCPPing タグ）を変更して、各ノードのIPアドレスとバインドポートを考慮します。

垂直方向にクラスタリングしている場合（つまり、同じ物理システムまたは仮想システムで複数のサーバーを実行している場合）、すべてのチャネルは、ディスカバリ通信に未使用の一意のバインドポートを使用する必要があります。 各 tcp-*。xml ファイルで、TCPタグの bind_port 属性を一意の未使用ポートに割り当てます。

たとえば、最初の2つのノードがこれらのバインドポートを割り当てる場合があります。

ノード	プロパティファイル	港
ノード1	tcp-control.xml	7800
ノード1	tcp-transport.xml	7801
ノード2	tcp-control.xml	7802
ノード2	tcp-transport.xml	7803

次に、同じシステム（つまり、同じIPアドレス）で実行されているノードのバインドポートを使用するTCPおよびTCPPing要素の例を示します。

ノード1 tcp-control.xml

<TCP bind_port="7800"/>
<TCPPING async_discovery="true"
    initial_hosts="192.168.224.154[7800],192.168.224.154[7802]"
    port_range="0"/>

ノード1 tcp-transport.xml

<TCP bind_port="7801"/>
<TCPPING async_discovery="true"
    initial_hosts="192.168.224.154[7801],192.168.224.154[7803]"
    port_range="0"/>

ノード2 tcp-control.xml

<TCP bind_port="7802"/>
<TCPPING async_discovery="true"
    initial_hosts="192.168.224.154[7800],192.168.224.154[7802]"
    port_range="0"/>

ノード2 tcp-transport.xml

<TCP bind_port="7803"/>
<TCPPING async_discovery="true"
    initial_hosts="192.168.224.154[7801],192.168.224.154[7803]"
    port_range="0"/>

キャッシュできるエンティティを追加した場合、またはシステムのキャッシュ構成を調整したい場合は、モジュールを使用して行うことができます。 キャッシュの設定方法については、 キャッシュ設定を参照してください。

関連トピック

• クラスタリンクの構成
• Clustering for High Availability