Upgrading Data Grid

• Data Grid 8.0 Documentation
• Data Grid 8.0 Component Details
• Supported Configurations for Data Grid 8.0

• Use custom UDP/TCP addresses as follows:

  -Djgroups.udp.address=172.18.1.13
-Djgroups.tcp.address=172.18.1.1

• Enable JMX as follows:

  <cache-container name="default"
                   statistics="true"> 

  1

  
    <jmx enabled="true" /> 

  2

  
    ...

  Copy to Clipboard Toggle word wrap

  1

  Enables statistics for the Cache Manager. This is the default.

  2

  Exports JMX MBeans.

Reference

• Getting Started with Data Grid Servers
• Network Interfaces: Server Guide
• Socket Bindings: Server Guide
• Endpoints: Server Guide
• Defining Property Realms: Server Guide
• Security: Server Guide
• Cluster Transport: Configuration Guide
• Creating Caches with the CLI
• Creating Caches through the REST API

• Use Tab auto-completion with the CLI:

  [//containers/default]> create cache --template=

  Copy to Clipboard Toggle word wrap

• Use the REST API:

  GET 127.0.0.1:11222/rest/v2/cache-managers/default/cache-configs/templates

  Copy to Clipboard Toggle word wrap

• Use the CLI.

  To create a cache named "myCache" with the DIST_SYNC cache template, run the following:

  [//containers/default]> create cache --template=org.infinispan.DIST_SYNC name=myDistributedCache

  Copy to Clipboard Toggle word wrap

• Use the REST API.

  To create a cache named "myCache", use the following POST invocation and include the cache definition in the request payload in XML or JSON format:

  POST /rest/v2/caches/myCache

  Copy to Clipboard Toggle word wrap

• Use Hot Rod clients.

  import org.infinispan.client.hotrod.RemoteCacheManager;
  import org.infinispan.client.hotrod.configuration.ConfigurationBuilder;
  import org.infinispan.client.hotrod.impl.ConfigurationProperties;
  import org.infinispan.commons.api.CacheContainerAdmin.AdminFlag;
  import org.infinispan.commons.configuration.XMLStringConfiguration;
  
  // Create a configuration for a locally running server.
  ConfigurationBuilder builder = new ConfigurationBuilder();
          builder.addServer().host("127.0.0.1").port(11222);
  
          manager = new RemoteCacheManager(builder.build());
      }
  
      ...
  
      private void createTemporaryCacheWithTemplate() {
              manager.administration()
                     //Override the default and create a volatile cache that
                     //does not survive cluster restarts.
                     .withFlags(AdminFlag.VOLATILE)
                     //Create a cache named myTemporaryCache that uses the
                     //distributed, synchronous cache template
                     //or return it if it already exists.
                     .getOrCreateCache("myTemporaryCache", "org.infinispan.DIST_SYNC");
          }

  Copy to Clipboard Toggle word wrap

• .proto schemas that provide a structured representation of your Java objects as Protobuf message types.
• Marshaller implementations to encode your Java objects to Protobuf format.

• Data Grid Library Mode does not include JBoss Marshalling by default. You must add the infinispan-jboss-marshalling dependency to your classpath.

• Data Grid servers do support JBoss Marshalling but clients must declare the marshaller to use, as in the following Hot Rod client configuration:

  .marshaller("org.infinispan.jboss.marshalling.core.JBossUserMarshaller");

• Spring integration does not yet support the default ProtoStream marshaller. For this reason you should use the Java Serialization Marshaller.
• To use the Java Serialization Marshaller, you must add classes to the deserialization whitelist.

Reference

• Data Grid Marshalling
• ProtoStream Marshalling
• Creating Context Initializers
• JBoss Marshalling
• Data Grid Spring Boot Starter
• Java Serialization Marshaller
• Adding Java Classes to Deserialization White Lists

New and Modified Elements and Attributes

• stack adds support for inline JGroups stack definitions.
• stack.combine and stack.position attributes let you override and modify JGroups stack definitions.
• metrics lets you configure how Data Grid exports metrics that are compatible with the Eclipse MicroProfile Metrics API.
• context-initializer lets you specify a SerializationContextInitializer implementation that initializes a Protostream-based marshaller for user types.
• key-transformers lets you register transformers that convert custom keys to String for indexing with Lucene.
• statistics now defaults to "false".

• address-count attribute for the off-heap element.
• protocol attribute for the transaction element.
• duplicate-domains attribute for the jmx element.
• advanced-externalizer
• custom-interceptors
• state-transfer-executor
• transaction-protocol

• deadlock-detection-spin
• compatibility
• write-skew
• versioning
• data-container
• eviction
• eviction-thread-policy

Reference

• Data Grid Configuration Schema
• Data Grid Configuration Guide

• Be contained within persistence elements.
• Include an xlmns namespace.

• Defaults to segmented="true" if the cache store implementation supports segmentation.
• Removes the singleton attribute for the store element. Use shared=true instead.

Reference

• Data Grid Configuration Schema
• Setting Up Persistent Storage
• Segmented Cache Stores
• JDBC String-Based Cache Stores

Reference

• Data Grid REST API

Reference

• Configuring Authentication Mechanisms for Hot Rod Java Clients

Reference

• Data Grid Library Mode
• Hot Rod Java Client Guide
• Getting the Store Migrator

Prerequisites

• Install a Data Grid cluster with the target upgrade version.

Procedure

• Configure your pom.xml for StoreMigrator as follows:

  <?xml version="1.0" encoding="UTF-8"?>
  <project xmlns="http://maven.apache.org/POM/4.0.0"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
      <modelVersion>4.0.0</modelVersion>
  
      <groupId>org.infinispan.example</groupId>
      <artifactId>jdbc-migrator-example</artifactId>
      <version>1.0-SNAPSHOT</version>
  
      <dependencies>
        <dependency>
          <groupId>org.infinispan</groupId>
          <artifactId>infinispan-tools</artifactId>
        </dependency>
        <!-- Additional dependencies -->
      </dependencies>
  
      <build>
        <plugins>
          <plugin>
            <groupId>org.codehaus.mojo</groupId>
            <artifactId>exec-maven-plugin</artifactId>
            <version>1.2.1</version>
            <executions>
              <execution>
                <goals>
                  <goal>java</goal>
                </goals>
              </execution>
            </executions>
            <configuration>
              <mainClass>org.infinispan.tools.store.migrator.StoreMigrator</mainClass>
              <arguments>
                <argument>path/to/migrator.properties</argument>
              </arguments>
            </configuration>
          </plugin>
        </plugins>
      </build>
  </project>

  Copy to Clipboard Toggle word wrap

Prerequisites

• Get infinispan-tools.jar.
• Create a migrator.properties file that configures the source and target cache stores.

Procedure

• If you build infinispan-tools.jar from source, do the following:

  1. Add infinispan-tools.jar and dependencies for your source and target databases, such as JDBC drivers, to your classpath.
  2. Specify migrator.properties file as an argument for StoreMigrator.

• If you pull infinispan-tools.jar from the Maven repository, run the following command:

  mvn exec:java