How to trigger cross-engine upgrade from Redis OSS to Valkey - Amazon ElastiCache
Serverless cross engine upgrades

How to trigger cross-engine upgrade from Redis OSS to Valkey

You can upgrade an existing Redis OSS replication group (v4 or after) to the Valkey engine using Console, API or CLI.

Note

If you want to upgrade an existing Redis OSS (cluster mode disabled) single-node cluster to the Valkey engine, you must first add it to a replication group by following these pre-requisite steps: Creating a replication group using an existing cluster.

If you have an existing Redis OSS replication group that is using the default cache parameter group, you can upgrade to Valkey by specifying the new engine and engine version with modify-replication-group API.

For Linux, macOS, or Unix:

aws elasticache modify-replication-group \
   --replication-group-id myReplGroup \
   --engine valkey \
   --engine-version 7.2

For Windows:

aws elasticache modify-replication-group ^
   --replication-group-id myReplGroup ^
   --engine valkey ^
   --engine-version 7.2

If you have a custom cache parameter group applied to the existing redis replication group you wish to upgrade, you will need to pass a custom Valkey cache parameter group in the request as well. The input Valkey custom parameter group must have the same Redis static parameter values as the existing Redis custom parameter group.

For Linux, macOS, or Unix:

aws elasticache modify-replication-group \
   --replication-group-id myReplGroup \
   --engine valkey \
   --engine-version 7.2 \
   --cache-parameter-group-name myParamGroup

For Windows:

aws elasticache modify-replication-group ^
   --replication-group-id myReplGroup ^
   --engine valkey ^
   --engine-version 7.2 ^
   --cache-parameter-group-name myParamGroup

Redis OSS to Valkey cross-engine upgrade for ElastiCache Serverless

You can upgrade an existing Redis OSS serverless cache to Valkey engine using the Console, API or CLI, by specifying the new engine and major engine version with the modify-serverless-cache API.

For Linux, macOS, or Unix:

aws elasticache modify-serverless-cache \
   --serverless-cache-name myCluster \
   --engine valkey \
   --major-engine-version 7

For Windows:

aws elasticache modify-serverless-cache ^
   --serverless-cache-name myCluster ^
   --engine valkey ^
   --major-engine-version 7