Data Grid Library Mode

手順

1. Red Hat カスタマーポータルにログインします。
2. Software Downloads for Data Grid に移動します。
3. Red Hat Data Grid 8.1 Maven リポジトリーをダウンロードします。
4. アーカイブされた Maven リポジトリーをローカルファイルシステムにデプロイメントします。
5. README.md ファイルを開き、適切なインストール手順に従います。

手順

1. プロジェクト pom.xml を開いて編集します。
2. 正しい Data Grid バージョンで version.infinispan プロパティーを定義します。

3. dependencyManagement セクションに infinispan-bom を含めます。

   BOM(Bill of Materials) は、依存関係バージョンを制御します。これにより、バージョンの競合が回避され、プロジェクトに依存関係として追加する Data Grid アーティファクトごとにバージョンを設定する必要がなくなります。

4. pom.xml を保存して閉じます。

手順

1. infinispan-core-11.0.9.Final-redhat-00001.jar ファイル内の default-configs ディレクトリーで、デフォルトの JGroups スタック default-jgroups-*.xml を見つけます。

2. 次のいずれかを行います。

   • infinispan.xml ファイルの stack 属性を使用します。

     <infinispan>
       <cache-container default-cache="replicatedCache">
         <transport cluster="${infinispan.cluster.name}"
                    stack="udp" 

     1

     
                    node-name="${infinispan.node.name:}"/>
       </cache-container>
     </infinispan>

     Copy to Clipboard Toggle word wrap

     1

     クラスタートランスポートには default-jgroups-udp.xml を使用します。

   • addProperty() メソッドを使用して JGroups スタックファイルを設定します。

     GlobalConfiguration globalConfig = new GlobalConfigurationBuilder().transport()
             .defaultTransport()
             .clusterName("qa-cluster")
             .addProperty("configurationFile", "default-jgroups-udp.xml") 

     1

     
             .build();

     Copy to Clipboard Toggle word wrap

     1

     クラスタートランスポートに default-jgroups-udp.xml スタックを使用します。

手順

1. infinispan.xml ファイルに新しい JGroups スタック宣言を作成します。

   <infinispan>
     <jgroups>
       <stack name="my-stack"> 

   1

   
       </stack>
     </jgroups>
   </infinispan>

   Copy to Clipboard Toggle word wrap

   1

   "my-stack" という名前のカスタム JGroups スタックを作成します。

2. extends 属性を追加し、プロパティーを継承する JGroups スタックを指定します。

   <infinispan>
     <jgroups>
       <stack name="my-stack" extends="tcp"> 

   1

   
       </stack>
     </jgroups>
   </infinispan>

   Copy to Clipboard Toggle word wrap

   1

   デフォルトの TCP スタックから継承します。

3. stack.combine 属性を使用して、継承されたスタックに設定されたプロトコルのプロパティーを変更します。

4. stack.position 属性を使用して、カスタムスタックの場所を定義します。

   たとえば、以下のようにデフォルトの TCP スタックで Gosssip ルーターと対称暗号化を使用して評価できます。

   <jgroups>
     <stack name="my-stack" extends="tcp">
       <TCPGOSSIP initial_hosts="${jgroups.tunnel.gossip_router_hosts:localhost[12001]}"
                stack.combine="REPLACE"
                stack.position="MPING" /> 

   1

   
       <FD_SOCK stack.combine="REMOVE"/> 

   2

   
       <VERIFY_SUSPECT timeout="2000"/> 

   3

   
       <SYM_ENCRYPT sym_algorithm="AES"
                    keystore_name="mykeystore.p12"
                    keystore_type="PKCS12"
                    store_password="changeit"
                    key_password="changeit"
                    alias="myKey"
                    stack.combine="INSERT_AFTER"
                    stack.position="VERIFY_SUSPECT" /> 

   4

   
     </stack>
   </jgroups>

   Copy to Clipboard Toggle word wrap

   1

   MPING の代わりに TCPGOSSIP プロトコルを検出メカニズムとして使用します。

   2

   FD_SOCK プロトコルをスタックから削除します。

   3

   VERIFY_SUSPECT プロトコルのタイムアウト値を変更します。

   4

   SYM_ENCRYPT プロトコルをスタックの VERIFY_SUSPECT プロトコルの後に追加します。

5. スタック名を transport 設定の stack 属性の値として指定します。

   <infinispan>
     <jgroups>
       <stack name="my-stack" extends="tcp">
        ...
       </stack>
       <cache-container name="default" statistics="true">
         <transport cluster="${infinispan.cluster.name}"
                    stack="my-stack" 

   1

   
                    node-name="${infinispan.node.name:}"/>
      </cache-container>
     </jgroups>
   </infinispan>

   Copy to Clipboard Toggle word wrap

   1

   クラスタートランスポートに "my-stack" を使用するように Data Grid を設定します。

6. Data Grid ログをチェックして、スタックを使用していることを確認します。

   [org.infinispan.CLUSTER] ISPN000078: Starting JGroups channel cluster with stack my-stack

   Copy to Clipboard Toggle word wrap

手順

1. カスタム JGroups スタックファイルをアプリケーションクラスパスに配置します。

   または、外部スタックファイルを宣言する際に絶対パスを指定することもできます。

2. stack-file 要素を使用して、外部スタックファイルを参照します。

   <infinispan>
     <jgroups>
        <stack-file name="prod-tcp" path="prod-jgroups-tcp.xml"/> 

   1

   
     </jgroups>
     <cache-container default-cache="replicatedCache">
       <transport stack="prod-tcp" /> 

   2

   
       <replicated-cache name="replicatedCache"/>
     </cache-container>
     ...
   </infinispan>

   Copy to Clipboard Toggle word wrap

   1

   "prod-jgroups-tcp.xml" 定義を使用する "prod-tcp" という名前のスタックを作成します。

   2

   クラスタートランスポートに "prod-tcp" を使用するように Data Grid を設定します。