Upgrade a Redis Software database

Upgrade a Redis Software database.

Redis Software

Default Redis database versions

When you upgrade an existing database, it uses the latest bundled Redis version unless you specify a different version with the redis_version option in the REST API or rladmin upgrade db.

To view available Redis database versions:

  • In the Cluster Manager UI, see Redis database versions on the Cluster > Configuration screen.

  • Send a GET /nodes REST API request and see supported_database_versions in the response.

The default Redis database version differs between Redis Software releases as follows:

Redis
Software		 Bundled Redis
DB versions		 Default DB version
(upgraded/new databases)
8.0.10 6.2, 7.2, 7.4, 8.0, 8.2, 8.4 8.4
8.0.6 6.2, 7.2, 7.4, 8.0, 8.2 8.2
8.0.2 6.2, 7.2, 7.4, 8.0, 8.2 8.2
7.22.x 6.2, 7.2, 7.4 7.4
7.8.x 6.2, 7.2, 7.4 7.4
7.4.x 6.0, 6.2, 7.2 7.2
7.2.4 6.0, 6.2, 7.2 7.2
6.4.2 6.0, 6.2 6.2
6.2.x 6.0, 6.2 6.0

Upgrade prerequisites

Before upgrading a database:

  • Review the relevant release notes for any preparation instructions.

  • Verify that both the current database version and the target database version are supported by the cluster's Redis Software version.

    To determine the current database version:

    • Use the Cluster Manager UI to open the Configuration tab for the database and select The About database button About.

    • (Optional) Use the rladmin status extra all command to display configuration details:

      rladmin status extra all

      When the database compatibility version is outdated, OLD REDIS VERSION appears in the command output.

  • Verify the cluster is fully upgraded and operational.

    Use the Cluster Manager UI to display the Configuration tab for the cluster. The tab displays the cluster version information and the Redis database compatibility version.

  • Check client compatibility with the database version.

    If you run Redis Stack commands with Go-Redis versions 9 and later or Lettuce versions 6 and later, set the client’s protocol version to RESP2 before upgrading your database to Redis version 7.2 to prevent potential application issues due to RESP3 breaking changes. See Client prerequisites for Redis 7.2 upgrade for more details and examples.

  • To avoid data loss during the upgrade, back up your data.

    You can export the data to an external location, enable replication, or enable persistence.

    When choosing how to back up data, keep the following in mind:

    • To reduce downtime when replication is enabled, a failover is performed before restarting the primary (master) database.

    • When persistence is enabled without replication, the database is unavailable during restart because the data is restored from the persistence file. AOF persistence restoration is slower than snapshot restoration.

Upgrade database

To upgrade a database:

  1. Complete all prerequisites before starting the upgrade.

  2. Optionally, back up the database to minimize the risk of data loss.

  3. Upgrade the database and its modules from the Databases screen or an individual database's Configuration screen in the Cluster Manager UI. During the upgrade process, the database will restart without losing any data.

    To upgrade a database from the Databases screen:

    1. Expand the database in the Databases list to show details.

      The database details are expanded, including an upgrade option.

    2. Click Upgrade.

    3. For Select version, choose the Redis version for the database upgrade from the list.

    4. Click Upgrade.

    5. After the upgrade process finishes, check the expanded database details to verify that the Redis version is set to the expected value.

    To upgrade a database from its Configuration screen:

    1. Select the database from the Databases list and go to its Configuration screen.

    2. Click the More actions button (⋮).

    3. Select Upgrade version from the list.

      The upgrade version option is selected in the more actions list.

    4. For Select version, choose the Redis version for the database upgrade from the list.

    5. Click Upgrade.

    6. After the upgrade process finishes, click the About button (ⓘ) and verify that the Redis version is set to the expected value.

RATE THIS PAGE
Back to top ↑