From 088de1cdea5e62f3add19d955cab5dfd6bc83e66 Mon Sep 17 00:00:00 2001 From: Rachel Elledge Date: Fri, 12 Dec 2025 11:36:02 -0600 Subject: [PATCH] DOC-6039 RS: Removed upgrade module from 8.0.x rladmin reference and fixed some wording on older versions --- .../cli-utilities/rladmin/upgrade.md | 8 ++- .../cli-utilities/rladmin/upgrade.md | 8 ++- .../cli-utilities/rladmin/upgrade.md | 8 ++- .../cli-utilities/rladmin/upgrade.md | 49 ++----------------- 4 files changed, 12 insertions(+), 61 deletions(-) diff --git a/content/operate/rs/7.22/references/cli-utilities/rladmin/upgrade.md b/content/operate/rs/7.22/references/cli-utilities/rladmin/upgrade.md index b55b551977..4c5977bcd2 100644 --- a/content/operate/rs/7.22/references/cli-utilities/rladmin/upgrade.md +++ b/content/operate/rs/7.22/references/cli-utilities/rladmin/upgrade.md @@ -5,7 +5,7 @@ categories: - docs - operate - rs -description: Upgrades the version of a module or Redis Enterprise Software for a database. +description: Upgrades the version of a module or Redis for a database. headerRange: '[1-2]' linkTitle: upgrade toc: 'true' @@ -13,11 +13,9 @@ weight: $weight url: '/operate/rs/7.22/references/cli-utilities/rladmin/upgrade/' --- -Upgrades the version of a module or Redis Enterprise Software for a database. - ## `upgrade db` -Schedules a restart of the primary and replica processes of a database and then upgrades the database to the latest version of Redis Enterprise Software. +Schedules a restart of the primary and replica processes of a database and then upgrades the database to the latest version of Redis. For more information, see [Upgrade an existing Redis Software Deployment]({{< relref "/operate/rs/7.22/installing-upgrading/upgrading" >}}). @@ -49,7 +47,7 @@ As of Redis Enterprise Software version 7.8.2, `upgrade db` will always upgrade | force_discard | | Forces `discard_data` if replication or persistence is enabled | | keep_crdt_protocol_version | | Keeps the current CRDT protocol version | | keep_redis_version | | Upgrades to a new patch release, not to the latest major.minor version. Deprecated as of Redis Enterprise Software v7.8.2. To upgrade modules without upgrading the Redis database version, set `redis_version` to the current Redis database version instead. | -| latest_with_modules | | Upgrades the Redis Enterprise Software version and all modules in the database. As of Redis Enterprise Software version 7.8.2, `upgrade db` will always upgrade modules. | +| latest_with_modules | | Upgrades the Redis version and all modules in the database. As of Redis Enterprise Software version 7.8.2, `upgrade db` will always upgrade modules. | | parallel_shards_upgrade | integer
'all' | Maximum number of shards to upgrade all at once | | preserve_roles | | Performs an additional failover to guarantee the shards' roles are preserved | | redis_version | Redis version | Upgrades the database to the specified version instead of the latest version | diff --git a/content/operate/rs/7.4/references/cli-utilities/rladmin/upgrade.md b/content/operate/rs/7.4/references/cli-utilities/rladmin/upgrade.md index 0dd3559062..28524f0807 100644 --- a/content/operate/rs/7.4/references/cli-utilities/rladmin/upgrade.md +++ b/content/operate/rs/7.4/references/cli-utilities/rladmin/upgrade.md @@ -5,7 +5,7 @@ categories: - docs - operate - rs -description: Upgrades the version of a module or Redis Enterprise Software for a database. +description: Upgrades the version of a module or Redis for a database. headerRange: '[1-2]' linkTitle: upgrade toc: 'true' @@ -13,11 +13,9 @@ weight: $weight url: '/operate/rs/7.4/references/cli-utilities/rladmin/upgrade/' --- -Upgrades the version of a module or Redis Enterprise Software for a database. - ## `upgrade db` -Schedules a restart of the primary and replica processes of a database and then upgrades the database to the latest version of Redis Enterprise Software. +Schedules a restart of the primary and replica processes of a database and then upgrades the database to the latest version of Redis. For more information, see [Upgrade an existing Redis Software Deployment]({{< relref "/operate/rs/7.4/installing-upgrading/upgrading" >}}). @@ -47,7 +45,7 @@ As of v6.2.4, the default behavior for `upgrade db` has changed. It is now cont | force_discard | | Forces `discard_data` if replication or persistence is enabled | | keep_crdt_protocol_version | | Keeps the current CRDT protocol version | | keep_redis_version | | Upgrades to a new patch release, not to the latest major.minor version | -| latest_with_modules | | Upgrades the Redis Enterprise Software version and all modules in the database | +| latest_with_modules | | Upgrades the Redis version and all modules in the database | | parallel_shards_upgrade | integer
'all' | Maximum number of shards to upgrade all at once | | preserve_roles | | Performs an additional failover to guarantee the shards' roles are preserved | | redis_version | Redis version | Upgrades the database to the specified version instead of the latest version | diff --git a/content/operate/rs/7.8/references/cli-utilities/rladmin/upgrade.md b/content/operate/rs/7.8/references/cli-utilities/rladmin/upgrade.md index 201e3ae1bb..b2afbde2ae 100644 --- a/content/operate/rs/7.8/references/cli-utilities/rladmin/upgrade.md +++ b/content/operate/rs/7.8/references/cli-utilities/rladmin/upgrade.md @@ -5,7 +5,7 @@ categories: - docs - operate - rs -description: Upgrades the version of a module or Redis Enterprise Software for a database. +description: Upgrades the version of a module or Redis for a database. headerRange: '[1-2]' linkTitle: upgrade toc: 'true' @@ -13,11 +13,9 @@ weight: $weight url: '/operate/rs/7.8/references/cli-utilities/rladmin/upgrade/' --- -Upgrades the version of a module or Redis Enterprise Software for a database. - ## `upgrade db` -Schedules a restart of the primary and replica processes of a database and then upgrades the database to the latest version of Redis Enterprise Software. +Schedules a restart of the primary and replica processes of a database and then upgrades the database to the latest version of Redis. For more information, see [Upgrade an existing Redis Software Deployment]({{< relref "/operate/rs/7.8/installing-upgrading/upgrading" >}}). @@ -49,7 +47,7 @@ As of Redis Enterprise Software version 7.8.2, `upgrade db` will always upgrade | force_discard | | Forces `discard_data` if replication or persistence is enabled | | keep_crdt_protocol_version | | Keeps the current CRDT protocol version | | keep_redis_version | | Upgrades to a new patch release, not to the latest major.minor version. Deprecated as of Redis Enterprise Software v7.8.2. To upgrade modules without upgrading the Redis database version, set `redis_version` to the current Redis database version instead. | -| latest_with_modules | | Upgrades the Redis Enterprise Software version and all modules in the database. As of Redis Enterprise Software version 7.8.2, `upgrade db` will always upgrade modules. | +| latest_with_modules | | Upgrades the Redis version and all modules in the database. As of Redis Enterprise Software version 7.8.2, `upgrade db` will always upgrade modules. | | parallel_shards_upgrade | integer
'all' | Maximum number of shards to upgrade all at once | | preserve_roles | | Performs an additional failover to guarantee the shards' roles are preserved | | redis_version | Redis version | Upgrades the database to the specified version instead of the latest version | diff --git a/content/operate/rs/references/cli-utilities/rladmin/upgrade.md b/content/operate/rs/references/cli-utilities/rladmin/upgrade.md index 8e61d84142..093991b0bb 100644 --- a/content/operate/rs/references/cli-utilities/rladmin/upgrade.md +++ b/content/operate/rs/references/cli-utilities/rladmin/upgrade.md @@ -5,18 +5,16 @@ categories: - docs - operate - rs -description: Upgrades the version of a module or Redis Enterprise Software for a database. +description: Upgrades a database's Redis version and modules. headerRange: '[1-2]' linkTitle: upgrade toc: 'true' weight: $weight --- -Upgrades the version of a module or Redis Enterprise Software for a database. - ## `upgrade db` -Schedules a restart of the primary and replica processes of a database and then upgrades the database to the latest version of Redis Enterprise Software. +Schedules a restart of the primary and replica processes of a database and then upgrades the database to the latest version of Redis. For more information, see [Upgrade an existing Redis Software Deployment]({{< relref "/operate/rs/installing-upgrading/upgrading" >}}). @@ -30,7 +28,7 @@ rladmin upgrade db { db: | } [ keep_crdt_protocol_version ] [ redis_version ] [ force ] - [ { latest_with_modules | and module module_name version module_args } ] + [ and module module_name version module_args ] ``` As of v6.2.4, the default behavior for `upgrade db` has changed. It is now controlled by a new parameter that sets the default upgrade policy used to create new databases and to upgrade ones already in the cluster. To learn more, see [`tune cluster default_redis_version`]({{< relref "/operate/rs/references/cli-utilities/rladmin/tune#tune-cluster" >}}). @@ -48,7 +46,6 @@ As of Redis Enterprise Software version 7.8.2, `upgrade db` will always upgrade | force_discard | | Forces `discard_data` if replication or persistence is enabled | | keep_crdt_protocol_version | | Keeps the current CRDT protocol version | | keep_redis_version | | Upgrades to a new patch release, not to the latest major.minor version. Deprecated as of Redis Enterprise Software v7.8.2. To upgrade modules without upgrading the Redis database version, set `redis_version` to the current Redis database version instead. | -| latest_with_modules | | Upgrades the Redis Enterprise Software version and all modules in the database. As of Redis Enterprise Software version 7.8.2, `upgrade db` will always upgrade modules. | | parallel_shards_upgrade | integer
'all' | Maximum number of shards to upgrade all at once | | preserve_roles | | Performs an additional failover to guarantee the shards' roles are preserved | | redis_version | Redis version | Upgrades the database to the specified version instead of the latest version | @@ -71,43 +68,3 @@ active - SMUpgradeBDB wait_for_version .completed - SMUpgradeBDB Done ``` - -## `upgrade module` - -Upgrades Redis modules in use by a specific database. Deprecated as of Redis Enterprise Software v7.8.2. Use [`upgrade db`](#upgrade-db) instead. - -For more information, see [Upgrade modules]({{< relref "/operate/oss_and_stack/stack-with-enterprise/install/upgrade-module" >}}). - -```sh -rladmin upgrade module - db_name { db: | } - module_name - version - module_args -``` - -### Parameters - -| Parameters | Type/Value | Description | -|----------------------------|--------------------------|------------------------------------------------------------------------------------------------------------------------| -| db_name | db:\
name | Upgrade a module for the specified database | -| module_name | 'ReJSON'
'graph'
'search'
'bf'
'rg'
'timeseries' | Redis module to upgrade | -| version | module version number | Upgrades the module to the specified version | -| module_args | 'keep_args'
string | Module configuration options | - -For more information about module configuration options, see [Module configuration options]({{< relref "/operate/oss_and_stack/stack-with-enterprise/install/add-module-to-database#module-configuration-options" >}}). - -### Returns - -Returns `Done` if the upgrade completed. Otherwise, it returns an error. - -### Example - -```sh -$ rladmin upgrade module db_name db:8 module_name graph version 20812 module_args "" -Monitoring 21ac7659-e44c-4cc9-b243-a07922b2a6cc -active - SMUpgradeBDB init -active - SMUpgradeBDB wait_for_version -Ocompleted - SMUpgradeBDB -Done -```