Oracle Cloud Infrastructure Documentation

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, select 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's details page, select 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. From the list, select the version to upgrade to, and then select either a custom configuration or the default configuration for the cluster.
    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.