Valkey and Redis OSS
With Valkey and Redis OSS, you initiate version upgrades to your cluster or replication group by modifying it using the ElastiCache console, the AWS CLI, or the ElastiCache API and specifying a newer engine version.
You can also cross upgrade from Redis OSS to Valkey. For more information on cross upgrades, see How to upgrade from Redis OSS to Valkey.
| How to modify clusters and replication groups | |
|---|---|
| Caches | Replication groups |
| Using the ElastiCache AWS Management Console | Using the AWS Management Console |
| Using the AWS CLI with ElastiCache | Using the AWS CLI |
| Using the ElastiCache API | Using the ElastiCache API |
Memcached
With Memcached, to start version upgrades to your cluster, you modify it and specify a newer engine version. You can do this by using the ElastiCache console, the AWS CLI, or the ElastiCache API:
-
To use the AWS Management Console, see – Using the ElastiCache AWS Management Console.
-
To use the AWS CLI, see Using the AWS CLI with ElastiCache.
-
To use the ElastiCache API, see Using the ElastiCache API.
How to upgrade from Redis OSS to Valkey
Valkey is designed as a drop-in replacement for Redis OSS 7. You can upgrade from Redis OSS to Valkey using the Console, API, or CLI, by specifying the new engine and major engine version. The endpoint IP address and all other aspects of the application will not be changed by the upgrade. When upgrading from Redis OSS 5.0.6 and higher you will experience no downtime.
Note
When upgrading from earlier Redis OSS versions than 5.0.6, you may experience a failover time of 30 to 60 seconds during the DNS propagation.
To upgrade an existing Redis OSS (cluster mode disabled) single-node cluster to the Valkey engine, first follow these steps: Creating a replication group using an existing cluster. Once the Redis OSS (cluster mode disabled) single-node cluster has been added to a replication group, you can cross-engine upgrade to Valkey.
Upgrading a replication group from Redis OSS to Valkey
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 8.0For Windows:
aws elasticache modify-replication-group ^
--replication-group-id myReplGroup ^
--engine valkey ^
--engine-version 8.0If you have a custom cache parameter group applied to the existing Redis OSS 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 OSS static parameter values as the existing Redis OSS custom parameter group.
For Linux, macOS, or Unix:
aws elasticache modify-replication-group \
--replication-group-id myReplGroup \
--engine valkey \
--engine-version 8.0 \
--cache-parameter-group-name myParamGroupFor Windows:
aws elasticache modify-replication-group ^
--replication-group-id myReplGroup ^
--engine valkey ^
--engine-version 8.0 ^
--cache-parameter-group-name myParamGroupUpgrading a Redis OSS serverless cache to Valkey with the CLI
For Linux, macOS, or Unix:
aws elasticache modify-serverless-cache \
--serverless-cache-name myCluster \
--engine valkey \
--major-engine-version 8 For Windows:
aws elasticache modify-serverless-cache ^
--serverless-cache-name myCluster ^
--engine valkey ^
--major-engine-version 8 Upgrading Redis OSS to Valkey with the Console
Upgrading from Redis OSS 5 to Valkey
Select the Redis OSS cache to upgrade.
An Upgrade to Valkey window should appear. Select the Upgrade to Valkey button.
Go to Cache settings, and then select Engine version. The most recent version of Valkey is recommended.
If this cache is serverless, then you will need to update the parameter group. Go to the Parameter groups area of Cache settings, select an appropriate parameter group such as default.valkey8.
Select Upgrade.
This cache will now be listed in the Valkey area of the console.
Note
Upgrading directly from Redis OSS 4 or lower to Valkey may include a longer failover time of 30 to 60 seconds during the DNS propagation.
Resolving blocked Valkey or Redis OSS engine
upgrades
As shown in the following table, your Valkey or Redis OSS engine upgrade operation is blocked if you have a pending scale up operation.
| Pending operations | Blocked operations |
|---|---|
| Scale up | Immediate engine upgrade |
| Engine upgrade | Immediate scale up |
| Scale up and engine upgrade | Immediate scale up |
| Immediate engine upgrade |
To resolve a blocked Valkey or Redis OSS engine upgrade
-
Do one of the following:
-
Schedule your Redis OSS or Valkey engine upgrade operation for the next maintenance window by clearing the Apply immediately check box.
With the CLI, use
--no-apply-immediately. With the API, useApplyImmediately=false. -
Wait until your next maintenance window (or after) to perform your Redis OSS engine upgrade operation.
-
Add the Redis OSS scale up operation to this cluster modification with the Apply Immediately check box chosen.
With the CLI, use
--apply-immediately. With the API, useApplyImmediately=true.This approach effectively cancels the engine upgrade during the next maintenance window by performing it immediately.
-
