升级模块

在 Redis Enterprise 中升级模块以获取最新功能和修复。

注意

  • 如果升级单节点集群，它不会加载新集群版本捆绑的新模块。

  • 在将启用了 RediSearch 模块的数据库升级到 Redis 5.0 之前，必须将 RediSearch 模块升级到 1.4.2 或更高版本。

先决条件

在升级数据库中启用的模块之前，请在集群上安装新版本的模块。

为数据库升级模块

在集群上安装更新的模块后，您可以升级数据库以使用新模块版本。

警告
为数据库升级模块后，数据库分片将重新启动。这将导致该数据库在集群范围内的可用性短暂中断。

要升级为数据库启用的模块

  1. 连接到集群中节点的终端。

  2. 运行 rladmin status 以列出节点上的数据库。

  3. 复制使用要升级的模块的数据库名称。

  4. 查找确切的模块名称和版本

    1. 解压模块存档（zip）文件。
    2. 打开 JSON 文件。
    3. 在文件中查找模块名称和版本号。

    以下是 RediSearch 模块的 JSON 文件示例

  5. 要查看集群上模块的版本，请运行

    • rladmin status modules - 显示集群上可用的最新模块以及数据库使用的模块。
    • rladmin status modules all - 显示集群上可用的所有模块以及数据库使用的模块。

  6. 要将数据库升级到最新版本的 Redis 及其模块到最新版本而不更改模块参数

    • 对于 Redis Enterprise Software 7.8.2 或更高版本的集群，运行

      rladmin upgrade db < database-name | database-ID >

    • 对于早于 7.8.2 版本的集群，请包含 latest_with_modules 选项

      rladmin upgrade db < database-name | database-ID > latest_with_modules
    警告
    升级过程不验证模块升级参数，不正确的参数可能导致意外停机。在生产环境中升级模块之前，请在测试环境中测试模块升级命令。

    • 使用 keep_redis_version 升级模块，而不将数据库升级到最新 Redis 版本。

      从 Redis Enterprise Software 7.8.2 版本开始，keep_redis_version 已被弃用。要升级模块而不升级 Redis 数据库版本，请改为将 redis_version 设置为当前的 Redis 数据库版本。

    • 要指定要升级的模块，请为每个模块添加以下内容

      and module module_name <module_name> version <new_module_version_number> module_args "<module arguments>"

      对于模块参数，请使用以下之一

      • module_args "<module_arguments>" 替换现有的模块参数。

      • module_args "" 不带参数，以移除现有的模块参数。

      • module_args keep_args 使用现有的模块参数。

Redis Software v7.8.2 及更高版本的示例

以下模块升级示例支持 Redis Enterprise Software 7.8.2 及更高版本

  • 保留当前的 Redis 数据库版本（本例中为 7.2），并升级到启用的模块的最新版本

    rladmin upgrade db shopping-cart redis_version 7.2

  • 升级数据库以使用最新版本的 Redis 和启用的模块的最新版本

    rladmin upgrade db shopping-cart

已弃用的示例

从 Redis Enterprise Software 7.8.2 版本开始，以下模块升级示例已被弃用，但仍受支持。

  • 保留当前的 Redis 版本，并升级到启用的模块的最新版本

    rladmin upgrade db shopping-cart keep_redis_version latest_with_modules

  • 将数据库升级到最新 Redis 版本，并将 RediSearch 升级到 1.6.7 并指定参数

    rladmin upgrade db shopping-cart and module db_name shopping-cart module_name ft version 10607 module_args "PARTITIONS AUTO"

  • 将数据库升级到最新 Redis 版本，并将 RedisBloom 升级到 2.2.1 版本，不带参数

    rladmin upgrade db db:3 and module db_name shopping-cart module_name bf version 20201 module_args ""

  • 将 RedisJSON 升级到 1.0.4，使用现有参数，并将 RedisBloom 升级到 2.2.1 版本，不带参数

    rladmin upgrade module db_name MyDB module_name ReJSON version 10004 module_args keep_args and module db_name MyDB module_name bf version 20201 module_args ""

  • 升级数据库以使用最新版本的 Redis 并使用启用的模块的最新版本

    rladmin upgrade db shopping-cart latest_with_modules
评价此页面
回到顶部 ↑