Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

升级 Data Grid

Red Hat Data Grid 8.2

将 Data Grid 升级到 8.2

Red Hat Customer Content Services

摘要

将 Data Grid 集群从一个 8.x 版本升级到下一个版本。您可以执行滚动升级，以避免在 Data Grid 过程中转换数据的停机时间或离线升级以获得兼容性。

Red Hat Data Grid
复制链接

Data Grid 是一个高性能分布式内存数据存储。

无架构数据结构
将不同对象存储为键值对的灵活性。
基于网格的数据存储
旨在在集群中分发和复制数据。
弹性扩展
动态调整节点数量，以便在不中断服务的情况下满足需求。
数据互操作性
从不同端点在网格中存储、检索和查询数据。

Data Grid 文档
复制链接

红帽客户门户网站中提供了 Data Grid 的文档。

Data Grid 下载
复制链接

访问红帽客户门户上的 Data Grid 软件下载。

注意

您必须有一个红帽帐户才能访问和下载数据中心软件。

使开源包含更多
复制链接

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。我们从这四个术语开始：master、slave、黑名单和白名单。由于此项工作十分艰巨，这些更改将在即将推出的几个发行版本中逐步实施。有关更多详情，请参阅我们的首席技术官 Chris Wright 提供的消息。

第 1 章 Data Grid 8 升级备注
复制链接

在从一个 Data Grid 8 升级到另一个版本前，请查看本节中的详情。

1.1. 升级到 Data Grid 8.2
复制链接

阅读以下信息，以确保从之前版本的 Data Grid 8 升级到 8.2：

使用单个文件缓存存储升级部署

当将 Data Grid 升级到 8.2.0 时，包含 SingleFileStore 持久性配置的缓存可能会遇到导致数据崩溃的问题。

此问题只会影响到 Data Grid 8.2.0 的升级。从 Data Grid 8.2.1 开始，在升级过程中不再出现这个问题。

如果您已经从早期版本升级到 8.2.0，您应该尽快执行以下操作：

  1. 备份任何 $RHDG_HOME/server/dataAttr.dat 文件。
  2. 升级到 Data Grid 8.2.1 或更高版本。

成功升级后，Data Grid 会恢复任何损坏的数据，并在首次启动时恢复单个文件存储。

跨站点复制状态传输

对于通过跨站点复制将备份到其他集群的缓存，您应该在升级到 8.2 后执行状态传输。

从 Infinispan CLI 使用 site push-site-state 命令，如下所示： 

[//containers/default]> site push-site-state --cache=cacheName --site=NYC
Copy to Clipboard Toggle word wrap
至少从 8.1 升级

如果要从 8.0 升级，您必须首先升级到 8.1。Data Grid 8.0 中的持久性数据与 Data Grid 8.2 不兼容，因为用户序列化上下文与 8.2 中的 Data Grid serialization 上下文分开。要解决这种不兼容的问题，Data Grid 8.2 会在集群启动时自动转换 Data Grid 8.1 中的现有持久性缓存存储。但是，Data Grid 不会从 Data Grid 8.0 转换缓存存储。

迁移 ProtoStream marshaller 配置

Data Grid 8.2 升级 ProtoStream 库，它提供 marshalling 功能。作为 Data Grid 8.1 的升级过程的一部分，您还应查看 ProtoStream 迁移详情，以避免在 ProtoStream encodes 条目作为 Protobuf 中可能出现的任何数据兼容性问题。

此外，在 ProtoStream API 中弃用了 MessageMarshaller API 和 ProtoSchemaBuilder 注解。您应该将 Data Grid 8.1 中的任何序列化上下文初始化程序迁移到 AutoProtoSchemaBuilder 注解，作为升级到 Data Grid 8.2 的一部分。

第 2 章 为 Data Grid 服务器执行滚动升级
复制链接

执行数据网格集群的滚动升级，以便在版本之间更改，而不会停机或数据丢失。滚动升级通过 Hot Rod 将您的数据同时迁移到目标版本。

2.1. 设置目标集群
复制链接

创建一个运行目标 Data Grid 版本的集群，并使用远程缓存存储从源集群加载数据。

先决条件

  • 使用目标升级版本安装 Data Grid 集群。
重要

确保目标集群的网络属性不会与源集群的网络属性重叠。您应该在 JGroups 传输配置中为目标和源集群指定唯一名称。根据您的环境，您还可以使用不同的网络接口并指定端口偏移来保持目标和源集群分开。

流程

  1. 在目标集群上为您要从源集群迁移的每个缓存添加一个 RemoteCacheStore。

    远程缓存存储使用 Hot Rod 协议从远程网格集群检索数据。将远程缓存存储添加到目标集群时，它可以从源集群中完全加载数据来处理客户端请求。

  2. 将客户端切换到目标集群，以便它开始处理所有请求。

    1. 使用目标集群的位置更新客户端配置。
    2. 重新启动客户端。

2.1.1. Rolling 升级的远程缓存存储
复制链接

您必须使用特定的远程缓存存储配置来执行滚动升级，如下所示： 

<!-- Remote cache stores for rolling upgrades must disable passivation. -->
<persistence passivation="false">
   <!-- The value of the cache attribute matches the name of a cache in the source cluster. Target clusters load data from this cache using the remote cache store. -->
   <!-- The "protocol-version" attribute matches the Hot Rod protocol version of the source cluster. 2.5 is the minimum version and is suitable for any upgrade path. -->
   <!-- You should enable segmentation for remote cache stores only if the number of segments in the target cluster matches the number of segments for the cache in the source cluster. -->
   <remote-store xmlns="urn:infinispan:config:store:remote:12.1"
                 cache="myDistCache"
                 protocol-version="2.5"
                 hotrod-wrapping="true"
                 raw-values="true"
                 segmented="false">
      <!-- Configures authentication and encryption according to the security realm of the source cluster. -->
      <security>
        <authentication server-name="infinispan">
          <digest username="admin"
                  password="changeme"
                  realm="default"/>
        </authentication>
      </security>
      <!-- Points to the location of the source cluster. -->
      <remote-server host="127.0.0.1" port="11222"/>
   </remote-store>
</persistence>
Copy to Clipboard Toggle word wrap

参考

2.2. 将数据同步到目标集群
复制链接

当目标集群正在运行并处理使用远程缓存存储的客户端请求时，您可以按需加载数据，您可以将源集群的数据同步到目标集群。

此操作从源集群读取数据并将其写入目标集群。数据会并行迁移到目标集群中的所有节点，每个节点都接收数据的子集。您必须在 Data Grid 配置中为每个缓存执行同步。

流程

  1. 在您要迁移到目标集群的数据网格配置中启动每个缓存的同步操作。

    使用 Data Grid REST API，并通过 ?action=sync- data 参数调用 POST 请求。例如，要将名为"myCache"的数据从源集群同步到目标集群，请执行以下操作： 

    POST /v2/caches/myCache?action=sync-data
    Copy to Clipboard Toggle word wrap

    当操作完成后，Data Grid 使用复制到目标集群的条目总数进行响应。

    或者，您可以通过在 RollingUpgradeManager MBean 上调用 synchronizeData (migratorName=hotrod) 来使用 JMX。

  2. 断开目标集群中的每个节点与源集群的连接。

    例如，要从源集群断开"myCache"缓存，请调用以下 POST 请求： 

    POST /v2/caches/myCache?action=disconnect-source
    Copy to Clipboard Toggle word wrap

    要使用 JMX，请在 RollingUpgradeManager MBean 上调用 disconnectSource (migratorName=hotrod)。

后续步骤

同步源集群中的所有数据后，滚动升级过程已完成。现在，您可以停用源集群。

第 3 章 在缓存存储之间迁移数据
复制链接

Data Grid 提供了一个 Java 实用程序，用于在缓存存储之间迁移持久数据。

对于升级数据网格，主要版本之间的功能差异不允许在缓存存储之间向后兼容。您可以使用 StoreMigrator 转换数据，使其与目标版本兼容。

例如，升级到 Data Grid 8.0 将默认的 marshaller 更改为 Protostream。在以前的 Data Grid 版本中，缓存存储使用与 marshalling 的更改不兼容的二进制格式。这意味着 Data Grid 8.0 无法从带有之前 Data Grid 版本的缓存存储中读取。

在其他情况下，Data Grid 版本弃用或删除缓存存储实现，如 JDBC Mixed 和 Binary 存储。在这些情况下，您可以使用 StoreMigrator 转换为不同的缓存存储实现。

3.1. 缓存存储 Migrator
复制链接

Data Grid 提供 StoreMigrator.java 工具，它为最新的数据网格缓存存储实施重新创建数据。

StoreMigrator 从以前的 Data Grid 版本获取缓存存储作为源，并使用缓存存储实施作为目标。

运行 StoreMigrator 时，它会使用您使用 EmbeddedCacheManager 接口定义的缓存存储类型创建目标缓存。StoreMigrator 然后从源存储加载条目到内存中，然后将其放入目标缓存中。

StoreMigrator 还允许您将数据从一种类型的缓存存储迁移到另一种缓存存储。例如，您可以从基于 JDBC 字符串的缓存存储迁移到单文件缓存存储。

重要

StoreMigrator 无法将数据从分段缓存存储迁移到：

  • 非分段缓存存储。
  • 分段缓存存储，它们具有不同的片段数。

3.2. 获取 Store Migrator
复制链接

StoreMigrator 作为 Data Grid 工具库 infinispan-tools 的一部分，并包含在 Maven 存储库中。

流程

  • 为 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

3.3. 配置 Store Migrator
复制链接

在 migrator.properties 文件中为源和目标缓存存储设置属性。

流程

  1. 创建 migrator.properties 文件。

  2. 在 migrator.properties 中配置源缓存存储。

    1. 使用 source 预先填充所有配置属性，如下例所示： 

      source.type=SOFT_INDEX_FILE_STORE
source.cache_name=myCache
source.location=/path/to/source/sifs
      Copy to Clipboard Toggle word wrap

  3. 在 migrator.properties 中配置目标缓存存储。

    1. 使用 target 预先填充所有配置属性，如下例所示： 

      target.type=SINGLE_FILE_STORE
target.cache_name=myCache
target.location=/path/to/target/sfs.dat
      Copy to Clipboard Toggle word wrap

3.3.1. 存储 Migrator 属性
复制链接

在 StoreMigrator 属性中配置源和目标缓存存储。

Expand
表 3.1. 缓存存储类型属性
属性描述必填/选填

type

指定源或目标的缓存存储类型类型。

.type=JDBC_STRING

.type=JDBC_BINARY

.type=JDBC_MIXED

.type=LEVELDB

.type=ROCKSDB

.type=SINGLE_FILE_STORE

.type=SOFT_INDEX_FILE_STORE

.type=JDBC_MIXED

必填

Expand
表 3.2. 常见属性
属性描述值示例必填/选填

cache_name

命名存储后端的缓存。

.cache_name=myCache

必填

segment_count

指定可以使用分段的目标缓存存储的片段数量。

片段数量必须与 Data Grid 配置中的 cluster.hash.numSegments 匹配。

换句话说，缓存存储的片段数量必须与对应缓存的片段数匹配。如果片段数量不相同，则数据网格无法从缓存存储中读取数据。

.segment_count=256

选填

Expand
表 3.3. JDBC 属性
属性描述必填/选填

dialect

指定底层数据库的 dialect。

必填

version

指定源缓存存储的 marshaller 版本。设置以下值之一：

* 8 用于 Data Grid 7.2.x

* 9 用于 Data Grid 7.3.x

* 10 Data Grid 8.x

仅用于源存储。

例如： source.version=9

marshaller.class

指定自定义 marshaller 类。

使用自定义 marshallers 时需要此项。

marshaller.externalizers

指定以逗号分隔的自定义 AdvancedExternalizer 实现列表，以便以以下格式进行加载： [id]:<Externalizer class>

选填

connection_pool.connection_url

指定 JDBC 连接 URL。

必填

connection_pool.driver_class

指定 JDBC 驱动程序的类。

必填

connection_pool.username

指定数据库用户名。

必填

connection_pool.password

指定数据库用户名的密码。

必填

db.major_version

设置数据库主版本。

选填

db.minor_version

设置数据库次版本。

选填

db.disable_upsert

禁用数据库 upsert。

选填

db.disable_indexing

指定是否创建表索引。

选填

table.string.table_name_prefix

指定表名称的额外前缀。

选填

table.string.<id|data|timestamp>.name

指定列名称。

必填

table.string.<id|data|timestamp>.type

指定列类型。

必填

key_to_string_mapper

指定 TwoWayKey2StringMapper 类。

选填

注意

要从旧的 Data Grid 版本中迁移 Binary 缓存存储，请在以下属性中将 table.string view 改为 table.binary.\* ：

  • source.table.binary.table_name_prefix
  • source.table.binary.<id\|data\|timestamp>.name
  • source.table.binary.<id\|data\|timestamp>.type 
# Example configuration for migrating to a JDBC String-Based cache store
target.type=STRING
target.cache_name=myCache
target.dialect=POSTGRES
target.marshaller.class=org.example.CustomMarshaller
target.marshaller.externalizers=25:Externalizer1,org.example.Externalizer2
target.connection_pool.connection_url=jdbc:postgresql:postgres
target.connection_pool.driver_class=org.postrgesql.Driver
target.connection_pool.username=postgres
target.connection_pool.password=redhat
target.db.major_version=9
target.db.minor_version=5
target.db.disable_upsert=false
target.db.disable_indexing=false
target.table.string.table_name_prefix=tablePrefix
target.table.string.id.name=id_column
target.table.string.data.name=datum_column
target.table.string.timestamp.name=timestamp_column
target.table.string.id.type=VARCHAR
target.table.string.data.type=bytea
target.table.string.timestamp.type=BIGINT
target.key_to_string_mapper=org.infinispan.persistence.keymappers. DefaultTwoWayKey2StringMapper
Copy to Clipboard Toggle word wrap
Expand
表 3.4. RocksDB Properties
属性描述必填/选填

位置

设置数据库目录。

必填

compression

指定要使用的压缩类型。

选填 

# Example configuration for migrating from a RocksDB cache store.
source.type=ROCKSDB
source.cache_name=myCache
source.location=/path/to/rocksdb/database
source.compression=SNAPPY
Copy to Clipboard Toggle word wrap
Expand
表 3.5. SingleFileStore 属性
属性描述必填/选填

位置

设置包含缓存存储 .dat 文件的目录。

必填 

# Example configuration for migrating to a Single File cache store.
target.type=SINGLE_FILE_STORE
target.cache_name=myCache
target.location=/path/to/sfs.dat
Copy to Clipboard Toggle word wrap
Expand
表 3.6. SoftIndexFileStore Properties
属性描述值

必填/选填

位置

设置数据库目录。

必填

index_location

设置数据库索引目录。 

# Example configuration for migrating to a Soft-Index File cache store.
target.type=SOFT_INDEX_FILE_STORE
target.cache_name=myCache
target.location=path/to/sifs/database
target.location=path/to/sifs/index
Copy to Clipboard Toggle word wrap

3.4. 迁移缓存存储
复制链接

运行 StoreMigrator 将数据从一个缓存存储迁移到另一个缓存存储。

先决条件

  • 获取 infinispan-tools.jar.
  • 创建 migrator.properties 文件，以配置源和目标缓存存储。

流程

  • 如果从源构建 infinispan-tools.jar，请执行以下操作：

    1. 将源和目标数据库（如 JDBC 驱动程序）的 infinispan-tools.jar 和依赖项添加到您的类路径。
    2. 将 migrator.properties 文件指定为 StoreMigrator 的参数。

  • 如果您从 Maven 存储库拉取 infinispan-tools.jar，请运行以下命令：

    mvn exec:java

法律通告
复制链接

Copyright © 2023 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat