Data Grid 移行ガイド

• Data Grid 8.0 ドキュメント
• Data Grid 8.0 コンポーネントの詳細
• Data Grid 8.0 でサポートされる設定

• カスタム UDP/TCP アドレスを以下のように使用します。

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

• 以下のように JMX を有効にします。

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

  1

  
    <jmx enabled="true" /> 

  2

  
    ...

  Copy to Clipboard Toggle word wrap

  1

  キャッシュマネージャーの統計を有効にします。これがデフォルトです。

  2

  JMX MBean をエクスポートします。

参照資料

• 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

• CLI で Tab のオートコンプリートを使用します。

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

  Copy to Clipboard Toggle word wrap

• REST API を使用します。

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

  Copy to Clipboard Toggle word wrap

• CLI の使用

  DIST_SYNC キャッシュテンプレートで myCache という名前のキャッシュを作成するには、以下を実行します。

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

  Copy to Clipboard Toggle word wrap

• REST API を使用します。

  myCache という名前のキャッシュを作成するには、以下の POST 呼び出しを使用し、XML または JSON 形式のリクエストペイロードにキャッシュ定義を追加します。

  POST /rest/v2/caches/myCache

  Copy to Clipboard Toggle word wrap

• Hot Rod クライアントを使用します。

  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

• Java オブジェクトの構造化表現を Protobuf メッセージタイプとして提供する .proto スキーマ。
• Java オブジェクトを Protobuf 形式にエンコードするための Marshaller の実装。

• Data Grid ライブラリーモードには、デフォルトで JBoss マーシャリングが含まれていません。infinispan-jboss-marshalling 依存関係をクラスパスに追加します。

• Data Grid サーバーは JBoss マーシャリングをサポートしますが、クライアントは以下の Hot Rod クライアント設定のように使用するマーシャラーを宣言する必要があります。

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

• Spring インテグレーションは、デフォルトの ProtoStream マーシャラーをサポートしていません。このため、Java Serialization Marshaller を使用する必要があります。
• Java Serialization Marshaller を使用するには、クラスを非シリアル化ホワイトリストに追加する必要があります。

参照資料

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

新規および変更された要素と属性

• stack は、インライン JGroups スタック定義のサポートを追加します。
• stack.combine 属性と stack.position 属性を使用すると、JGroups スタック定義をオーバーライドおよび変更できます。
• metric 使用すると、Data Grid が Eclipse Micro Profile Metrics API と互換性のあるメトリックをエクスポートする方法を設定できます。
• context-initializer を使用すると、ユーザータイプの Protostream ベースのマーシャラーを初期化する SerializationContextInitializer 実装を指定できます。
• key-transformers を使用すると、Lucene でインデックスを作成するためにカスタムキーを文字列に変換するトランスフォーマーを登録できます。
• statistics はデフォルトで false になりました。

• off-heap 要素の address-count 属性。
• transaction 要素の protocol 属性。
• jmx 要素の duplicate-domains 属性。
• advanced-externalizer
• custom-interceptors
• state-transfer-executor
• transaction-protocol

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

参照資料

• Data Grid 設定スキーマ
• Data Grid Configuration Guide

• persistence 要素内に含まれます。
• xlmns namespace を含めます。

• キャッシュストアの実装がセグメントをサポートする場合は、デフォルトで segmented="true" に設定されます。
• store 要素の singleton 属性を削除します。代わりに shared=true を使用してください。

参照資料

• Data Grid 設定スキーマ
• 永続ストレージのセットアップ
• セグメント化されたキャッシュストア
• JDBC 文字列ベースのキャッシュストア

参照資料

• Data Grid REST API

参照資料

• Configuring Authentication Mechanisms for Hot Rod Java Clients

参照資料

• Data Grid Library Mode
• Hot Rod Java クライアントガイド
• Store Migrator の取得

手順

• StoreMigrator の pom.xml を以下のように設定します。

  <?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

前提条件

• infinispan-tools.jar を取得します。
• ソースおよびターゲットのキャッシュストアを設定する migrator.properties ファイルを作成します。

手順

• ソースから infinispan-tools.jar をビルドする場合は、以下を実行します。

  1. JDBC ドライバーなどのソースおよびターゲットのデータベースの infinispan-tools.jar および依存関係をクラスパスに追加します。
  2. migrator.properties ファイルを StoreMigrator の引数として指定します。

• Maven リポジトリーから infinispan-tools.jar をプルする場合は、以下のコマンドを実行します。

  mvn exec:java

• org.infinispan.commons.marshall.AdvancedExternalizer
• org.infinispan.commons.marshall.Externalizer
• @SerializeWith

• Uberjars(Maven 依存関係および個別の JAR ファイルに置き換え)
• EAP モジュール (EAP Infinispan サブシステムによって置き換え)
• Cassandra キャッシュストア
• Apache Spark コネクター
• Apache Hadoop コネクター
• Red Hat Fuse 7.3 以降では Apache Camel コンポーネント jboss-datagrid-7.3-camel-library に代わる camel-infinispan コンポーネントが提供されます。
• REST キャッシュストア
• REST API v1(REST API v2 に置き換え)
• 互換性モード
• 分散実行
• CLI キャッシュローダー
• LevelDB キャッシュストア
• infinispan-cloud (infinispan-core のデフォルト設定)
• org.infinispan.atomic パッケージ
• Hot Rod クライアントの RemoteCache API での getBulk() メソッド
• C3P0 および HikariCP 接続プールを介した JDBC PooledConnectionFactory
• OSGI サポート
• infinispan.server.hotrod.workerThreads システムプロパティー
• JON プラグイン