Data Grid Library Mode

Procedure

1. Log in to the Red Hat customer portal.
2. Navigate to the Software Downloads for Data Grid.
3. Download the Red Hat Data Grid 8.1 Maven Repository.
4. Extract the archived Maven repository to your local file system.
5. Open the README.md file and follow the appropriate installation instructions.

Procedure

1. Open your project pom.xml for editing.
2. Define the version.infinispan property with the correct Data Grid version.

3. Include the infinispan-bom in a dependencyManagement section.

   The Bill Of Materials (BOM) controls dependency versions, which avoids version conflicts and means you do not need to set the version for each Data Grid artifact you add as a dependency to your project.

4. Save and close pom.xml.

Procedure

1. Locate the default JGroups stacks, default-jgroups-*.xml, in the default-configs directory inside the infinispan-core-11.0.9.Final-redhat-00001.jar file.

2. Do one of the following:

   • Use the stack attribute in your infinispan.xml file.

     <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

     Uses default-jgroups-udp.xml for cluster transport.

   • Use the addProperty() method to set the JGroups stack file:

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

     1

     
             .build();

     Copy to Clipboard Toggle word wrap

     1

     Uses the default-jgroups-udp.xml stack for cluster transport.

Procedure

1. Create a new JGroups stack declaration in your infinispan.xml file.

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

   1

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

   Copy to Clipboard Toggle word wrap

   1

   Creates a custom JGroups stack named "my-stack".

2. Add the extends attribute and specify a JGroups stack to inherit properties from.

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

   1

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

   Copy to Clipboard Toggle word wrap

   1

   Inherits from the default TCP stack.

3. Use the stack.combine attribute to modify properties for protocols configured in the inherited stack.

4. Use the stack.position attribute to define the location for your custom stack.

   For example, you might evaluate using a Gossip router and symmetric encryption with the default TCP stack as follows:

   <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

   Uses the TCPGOSSIP protocol as the discovery mechanism instead of MPING.

   2

   Removes the FD_SOCK protocol from the stack.

   3

   Modifies the timeout value for the VERIFY_SUSPECT protocol.

   4

   Adds the SYM_ENCRYPT protocol to the stack after the VERIFY_SUSPECT protocol.

5. Specify the stack name as the value for the stack attribute in the transport configuration.

   <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

   Configures Data Grid to use "my-stack" for cluster transport.

6. Check Data Grid logs to ensure it uses the stack.

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

   Copy to Clipboard Toggle word wrap

Procedure

1. Put custom JGroups stack files on the application classpath.

   Alternatively you can specify an absolute path when you declare the external stack file.

2. Reference the external stack file with the stack-file element.

   <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

   Creates a stack named "prod-tcp" that uses the "prod-jgroups-tcp.xml" definition.

   2

   Configures Data Grid to use "prod-tcp" for cluster transport.