Upgrading an OCI Cache Cluster's Cache Engine

Change the cache engine used by an OCI Cache 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.

During the upgrade process, you can'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.

Note

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.

    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 OCI Cache Clusters.
    2. On the cluster details page, select More Actions, and then select 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 select Upgrade in the warning message.
    3. Select the version to upgrade to from the list.
    4. Select Upgrade.
  • Use the oci redis redis-cluster 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 redis-cluster update --software-version VALKEY_7_2 --redis-cluster-id <cluster_OCID>...[OPTIONS]
    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.
  • Run the UpdateRedisCluster operation to upgrade a cluster's cache engine. Specify the cache engine version in the UpdateRedisClusterDetails softwareVersion attribute.