升级 Data Grid


Red Hat Data Grid 8.5

将 Data Grid 升级到 8.5

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、黑名单和白名单。由于此项工作十分艰巨,这些更改将在即将推出的几个发行版本中逐步实施。详情请查看 CTO Chris Wright 的信息

第 1 章 Data Grid 8 升级备注

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

1.1. 升级到 Data Grid 8.5

阅读以下信息,以确保从之前版本的 Data Grid 8 升级到 8.5。

删除
  • Kryo 和 Protostuff marshallers 已删除。
  • 已删除了扩展统计模块。
  • JCACHE CDI 不再被支持。
  • 不再支持 Spring 5.x 和 Spring Boot 2.x。
  • 不再提供 Red Hat JBoss EAP 模块。
更改类的软件包

以下类已移到不同的软件包中:

  • org.infinispan.util.TimeoutException 已移到 org.infinispan.commons.TimeoutException
  • org.infinispan.util.concurrent.IsolationLevel 已移到 org.infinispan.configuration.IsolationLevel
删除类、方法和属性

以下方法和属性已被删除:

  • All :使用 schema < 10.0 的配置文件。
  • commons: Start.priorityStop.priority
  • core: AdvancedCache.with (ClassLoader), AdvancedCache.getEvictionManager (), AdvancedCache.getAsyncInterceptorChain (), AdvancedCache.getComponentRegistry ()
  • core: AnyScopeComponentFactory.construct (Class)
  • core: Cache.getListeners ()
  • core: ConfigurationBuilder.classLoader (), ConfigurationBuilder.customInterceptors ()
  • Core: DataRehashedEvent.getUnionConsistentHash()
  • core: EmbeddedCacheManager.getListeners (), EmbeddedCacheManager.getTransport (), EmbeddedCacheManager.removeCache (String), EmbeddedCacheManager.getGlobalComponentRegistry ()
  • core: FlagAffectedCommand.setFlags,FlagAffedctedCommand.addFlags,FlagAffectedCommand.hasFlag
  • core: IntCacheStream.filterKeySegments (Set<Integer>)
  • core: JMXStatisticsConfiguration
  • core: GlobalConfiguration.DEFAULT_MARSHALL_VERSION
  • Core; LocalizedCacheTopology.getDistributionForSegment(int)
  • core: NamedComponentFactory
  • core: PersistenceUtil.loadAndStoreInDataContainer
  • core: TopologyChangedEvent.getConsistentHashAtStart ()TopologyChangedEvent.getConsistentHashAtEnd ()
  • core: Transport.invokeRemotely () Transport.waitForView () Transport.backupRemotely () AbstractTransport
  • Core: ValueMatcher.nonExistentEntryCanMatch
  • core: WriteCommand.updateStatusFromRemoteResponse
  • core: state transfer pool
  • 计数器: syncStrongCounterSyncWeakCounter
  • 热随机客户端: org.infinispan.client.hotrod.marshall.ProtoStreamMarshaller
  • 服务器和客户端:密钥存储证书密码
  • RocksDB Store: 到期队列大小
  • Remote Store: transport factory 和 maxIdle
指标

当 name- as-tags 设为 true 时,JGroups 和跨站点指标名称会改变,其中集群名称和站点的名称不再存在于指标名称中,而是作为标签。

例如,当您将 name -as-tags 设置为 false 时,指标会根据频道命名,从而导致同一目的有多个指标:

# TYPE vendor_jgroups_xsite_frag4_get_number_of_sent_fragments gauge
# HELP vendor_jgroups_xsite_frag4_get_number_of_sent_fragments Number of sent fragments
vendor_jgroups_xsite_frag4_get_number_of_sent_fragments{cluster="xsite",node="..."} 0.0
# TYPE vendor_jgroups_cluster_frag4_get_number_of_sent_fragments gauge
# HELP vendor_jgroups_cluster_frag4_get_number_of_sent_fragments Number of sent fragments
vendor_jgroups_cluster_frag4_get_number_of_sent_fragments{cluster="cluster",node="..."} 2.0
Copy to Clipboard Toggle word wrap

当您将 name -as-tags 设置为 true 时,指标会被简化,集群和站点名称会显示为标签:

# TYPE vendor_jgroups_frag4_get_number_of_sent_fragments gauge
# HELP vendor_jgroups_frag4_get_number_of_sent_fragments Number of sent fragments
vendor_jgroups_frag4_get_number_of_sent_fragments{cache_manager="default",cluster="xsite",node="..."} 0.0
vendor_jgroups_frag4_get_number_of_sent_fragments{cache_manager="default",cluster="cluster",node="..."} 2.0
Copy to Clipboard Toggle word wrap
SecurityManager

在 Java Development Kit (JDK) 17 中删除 SecurityManager 时,不再支持与 SecurityManager 集成。

jakarta 和 Java EE
  • Data Grid 已更新为只使用 jakarta Referrer 软件包。
  • 如果您需要旧的 javax …​ 软件包,则应使用 Data Grid 8.4.x。
  • transitional *-jakarta jars (包括 jakarta jakartajavax xz 软件包)已被删除。
热 Rod 客户端默认设置

Data Grid 引入了对 Hot Rod 客户端属性的更改。

ssl_hostname_validation

添加了新属性 ssl_hostname_validation,默认值为 true。此属性启用基于 RFC 2818 的 TLS 主机名验证。

另外,在启用主机名验证时,需要设置 sni_host_name

Expand
表 1.1. 默认属性更改
属性Data Grid 8.5之前的版本

connect_timeout

2000 ms / 2 秒

60000 ms / 60 秒

socket_timeout

2000 ms / 2 秒

60000 ms / 60 秒

max_retries

3

10

min_evictable_idle_time

180000 ms / 3 分钟

1800000 ms / 30 分钟

sasl_mechanism

SCRAM-SHA-512

SCRAM-SHA-256

Data Grid 8.5 引入了对搜索的以下更改。

索引
  • property 属性已被删除。
  • auto-config 属性已被删除。
  • index 属性已被删除。
索引注解
  • Hibernate Search 5 注解不再被支持。
  • @ProtoDoc 注解现已弃用。
安全性

PrincipalRoleMapper 现在只适用于组,而不是组和用户主体。使用 cache-manager.security.authorization.group-only-mapping=false 配置使用旧行为。

有关 PrincipalRoleMapper API 的更多信息,请参阅 角色和权限映射程序

分散的缓存删除

scattered 缓存模式已被删除。改为使用分布式缓存。有关缓存模式的详情,请参考 缓存模式

全局状态

默认情况下,如果在持久全局状态下找到悬停的锁定文件,则 Data Grid 将不会启动,表示未清理的关闭。您可以通过配置全局状态 unclean-shutdown-action 设置来更改默认行为。如需更多信息,请参阅 全局永久位置

持久性

availability-interval 的默认值增加到 30 秒。以上默认为 1 秒。

soft-index 文件存储

要计算片段数量,只有缓存片段的数量而不是使用索引片段配置,就像之前完成的一样。

RESP 端点

Data Grid 8.5 对 RESP 端点包括以下更改:

  • RESP 端点缓存现在要求关键存储介质类型为 application/octet-stream
  • 您可以将默认过期时间应用到 RESP 端点使用的缓存配置。
客户端监听程序删除事件传播

要在 CacheEventConverter 上支持新的 includeOldValue 方法更改,客户端监听程序删除事件现在也会传播,即使事件没有删除值。

注意

删除事件默认不包含任何值

NearCache SPI 更新

前面的 NearCache SPI 在并发更新中存在一个问题,其中过时的条目可能存储在接近的缓存中。NearCache SPI 已更新,以解决此问题。

至少从 8.1 升级

如果要从 8.0 升级,您必须首先升级到 8.1。Data Grid 8.0 中的持久数据与以后的版本不兼容二进制数据。要解决这种不兼容的问题,Data Grid 8.2 及更新的版本会在集群启动时自动转换来自 Data Grid 8.1 的现有持久性缓存存储。但是,Data Grid 不会从 Data Grid 8.0 转换缓存存储。

第 2 章 为 Data Grid Server 集群执行滚动升级

执行数据网格集群的滚动升级,在不停机或数据丢失的版本之间更改,并通过 Hot Rod 协议迁移数据。

2.1. 设置目标 Data Grid 集群

创建一个使用您计划升级到的 Data Grid 版本的集群,然后使用远程缓存存储将源集群连接到目标集群。

先决条件

  • 使用目标集群所需的版本安装 Data Grid Server 节点。
重要

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

流程

  1. 以 JSON 格式创建远程缓存存储配置,允许目标集群连接到源集群。

    远程缓存存储在目标集群上,使用 Hot Rod 协议从源集群检索数据。

    {
      "remote-store": {
        "cache": "myCache",
        "shared": true,
        "raw-values": true,
        "security": {
          "authentication": {
            "digest": {
              "username": "username",
              "password": "changeme",
              "realm": "default"
            }
          }
        },
        "remote-server": [
          {
            "host": "127.0.0.1",
            "port": 12222
          }
        ]
      }
    }
    Copy to Clipboard Toggle word wrap
  2. 使用 Data Grid 命令行界面(CLI)或 REST API 将远程缓存存储配置添加到目标集群,以便它可以连接到源集群。

    • CLI:在目标集群中使用 migrate cluster connect 命令。

      [//containers/default]> migrate cluster connect -c myCache --file=remote-store.json
      Copy to Clipboard Toggle word wrap
    • REST API:使用一个 POST 请求,该请求在有效负载中包含远程存储配置,并带有 rolling-upgrade/source-connection 方法。

      POST /rest/v2/caches/myCache/rolling-upgrade/source-connection
      Copy to Clipboard Toggle word wrap
  3. 对您要迁移的每个缓存重复前面的步骤。
  4. 将客户端切换到目标集群,以便它开始处理所有请求。

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

如果您需要迁移索引缓存,您必须首先迁移内部 ___protobuf_metadata 缓存,以便源集群中定义的 .proto 模式也会存在于目标集群上。

2.2. 将数据同步到目标集群

当您设置目标 Data Grid 集群并将其连接到源集群时,目标集群可以使用远程缓存存储和按需加载数据的客户端请求。要将数据完全迁移到目标集群,以便您可以停用源集群,您可以同步数据。此操作从源集群读取数据并将其写入目标集群。数据会并行迁移到目标集群中的所有节点,每个节点都接收数据的子集。您必须对要迁移到目标集群的每个缓存执行同步。

先决条件

  • 使用适当的 Data Grid 版本设置目标集群。

流程

  1. 使用 Data Grid 命令行界面(CLI)或 REST API 开始同步您要迁移到目标集群的每个缓存。

    • CLI:使用 migrate cluster synchronize 命令。

      migrate cluster synchronize -c myCache
      Copy to Clipboard Toggle word wrap
    • REST API:将 ?action=sync-data 参数与 POST 请求一起使用。

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

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

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

    • CLI:使用 migrate cluster disconnect 命令。

      migrate cluster disconnect -c myCache
      Copy to Clipboard Toggle word wrap
    • REST API:指示 DELETE 请求。

      DELETE /rest/v2/caches/myCache/rolling-upgrade/source-connection
      Copy to Clipboard Toggle word wrap

后续步骤

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

第 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 提供 CLI migrate store 命令,用于为最新的数据网格缓存存储实施重新创建数据。

存储 migrator 从以前的 Data Grid 版本获取缓存存储作为源,并使用缓存存储实现作为目标。

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

存储 migrator 还允许您将数据从一种类型的缓存存储迁移到另一种缓存存储。例如,您可以从基于 JDBC 字符串的缓存存储迁移到 SIFS 缓存存储。

重要

存储 migrator 无法将数据从分段缓存存储迁移到:

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

3.2. 配置缓存存储 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
      source.version=<version>
      Copy to Clipboard Toggle word wrap

      重要

      要从分段缓存存储迁移数据,还必须使用 source.segment_count 属性配置片段数量。片段的数量必须与 Data Grid 配置中的 cluster.hash.numSegments 匹配。如果缓存存储的片段数量与对应缓存的片段数量不匹配,则数据网格无法从缓存存储读取数据。

    2. target. 前缀添加到目标缓存存储的所有配置属性中。

      目标缓存存储示例

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

3.2.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

选填

marshaller.class

指定自定义 marshaller 类。

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

marshaller.allow-list.classes

指定允许反序列化的完全限定类名称列表。

选填

marshaller.allow-list.regexps

指定以逗号分隔的正则表达式列表,用于决定允许哪些类反序列化。

选填

marshaller.externalizers

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

选填

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

dialect

指定底层数据库的 dialect。

必填

version

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

* 8 用于 Data Grid 7.2.x

* 9 用于 Data Grid 7.3.x

* 10 用于 Data Grid 8.0.x

* 11 用于 Data Grid 8.1.x

* 12 用于 Data Grid 8.2.x

* 13 用于 Data Grid 8.3.x

仅用于源存储。

connection_pool.connection_url

指定 JDBC 连接 URL。

必填

connection_pool.driver_class

指定 JDBC 驱动程序的类。

必填

connection_pool.username

指定数据库用户名。

必填

connection_pool.password

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

必填

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.infinispan.commons.marshall.JavaSerializationMarshaller
target.marshaller.allow-list.classes=org.example.Person,org.example.Animal
target.marshaller.allow-list.regexps="org.another.example.*"
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.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
属性描述value

必填/选填

位置

设置数据库目录。

必填

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.3. 迁移 Data Grid 缓存存储

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

先决条件

  • 获取 Data Grid CLI。
  • 创建 migrator.properties 文件,以配置源和目标缓存存储。

流程

  • 运行 migrate store -p /path/to/migrator.properties CLI 命令

法律通告

Copyright © 2024 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

© 2026 Red Hat