Oracle Cloud Infrastructure Documentation

Upgrading a Cluster

Upgrade the cache engine used by a cluster.

For clusters configured to use the REDIS_7_0 cache engine version, we recommend that you upgrade to the latest VALKEY-based cache engine. See OCI Cache Engine Version for a list of the cache engines supported by OCI Cache.

After the upgrade is complete, you can't rollback to the previous version, so we recommend that you test the upgrade version's functionality with your applications before you upgrade the cluster.

During the upgrade process, don't create or update data on the cluster. You can resume normal data operations for the cluster after the cluster's status changes to Active.

    1. On the Clusters list page, find the cluster that you want to work with. If you need help finding the list page or the cluster, see Listing Clusters.
    2. On the cluster details page, click More Actions, and then click Upgrade.
      Note

      If the cluster's cache engine is REDIS_7_0, a warning is displayed on the cluster details page, recommending that you upgrade the cluster to a Valkey-based cache engine. You can click Upgrade in the warning message.
    3. Select the version to upgrade to from the list.

    4. Click Upgrade.

  • Use the oci redis redis-cluster update command and required parameters to upgrade the cache engine for a cluster. Specify the cache engine version in the software-version parameter, as shown in the following sample:

    oci redis redis-cluster update --software-version VALKEY_7_2 --redis-cluster-id cluster_ocid...
    For information about using the CLI, see Command Line Interface (CLI). For a complete list of flags and options available for CLI commands, see the CLI Command Reference.
  • For information about using the API and signing requests, see REST APIs and Security Credentials. For information about SDKs, see Software Development Kits and Command Line Interface.

    Run the UpdateRedisCluster operation to upgrade a cluster's cache engine. Specify the cache engine version in the UpdateRedisClusterDetails softwareVersion attribute.