Modifying an ElastiCache cluster - Amazon ElastiCache for Redis

Modifying an ElastiCache cluster

In addition to adding or removing nodes from a cluster, there can be times where you need to make other changes to an existing cluster, such as, adding a security group, changing the maintenance window or a parameter group.

We recommend that you have your maintenance window fall at the time of lowest usage. Thus it might need modification from time to time.

When you change a cluster's parameters, the change is applied to the cluster either immediately or after the cluster is restarted. This is true whether you change the cluster's parameter group itself or a parameter value within the cluster's parameter group. To determine when a particular parameter change is applied, see the Changes Take Effect section of the Details column in the tables for Redis-specific parameters.

To modify a cluster
  1. Sign in to the AWS Management Console and open the ElastiCache console at https://console.aws.amazon.com/elasticache/.

  2. From the list in the upper-right corner, choose the AWS Region where the cluster that you want to modify is located.

  3. In the navigation pane, choose the engine running on the cluster that you want to modify.

    A list of the chosen engine's clusters appears.

  4. In the list of clusters, for the cluster that you want to modify, choose its name.

  5. Choose Actions and then choose Modify.

    The Modify Cluster window appears.

  6. In the Modify Cluster window, make the modifications that you want. Options include:

    • Description

    • Cluster mode - To modify cluster mode from Disabled to Enabled, you must first set the cluster mode to Compatible.

      Compatible mode allows your Redis clients to connect using both cluster mode enabled and cluster mode disabled. After you migrate all Redis clients to use cluster mode enabled, you can then complete cluster mode configuration and set the cluster mode to Enabled.

    • Engine Version Compatibility

      Important

      You can upgrade to newer engine versions. If you upgrade major engine versions, for example from 5.0.6 to 6.0, you need to select a parameter group family that is compatible with the new engine version. For more information on doing so, see Engine versions and upgrading . However, you can't downgrade to older engine versions except by deleting the existing cluster and creating it again.

    • VPC Security Group(s)

    • Parameter Group

    • Node Type

      Note

      If the cluster is using a node type from the r6gd family, you can only choose a different node size from within that family. If you choose a node type from the r6gd family, data tiering will automatically be enabled. For more information, see Data tiering.

    • Multi-AZ

    • Auto failover (cluster mode disabled only)

    • Enable Automatic Backups

    • Backup Node Id

    • Backup Retention Period

    • Backup Window

    • Topic for SNS Notification

    The Apply Immediately box applies only to engine version modifications. To apply changes immediately, choose the Apply Immediately check box. If this box is not chosen, node type and engine version modifications are applied during the next maintenance window. Other modifications, such as changing the maintenance window, are applied immediately.

  7. Choose Modify.

To enable/disable log delivery
  1. From the list of clusters, choose the cluster you want to modify. Choose the Cluster name and not the checkbox beside it.

  2. On the Cluster details page, choose the Logs tab,

  3. To enable/disable slow logs, choose either Enable or Disable.

    If you choose enable:

    1. Under Log format, choose either JSON or Text.

    2. Under Log destination type, choose either CloudWatch Logs or Kinesis Firehose.

    3. Under Log destination, choose either Create new and enter either your CloudWatchLogs log group name or your Kinesis Data Firehose stream name. Or choose Select existing and then choose either your CloudWatchLogs log group name or your Kinesis Data Firehose stream name.

    4. Choose Enable.

To change your configuration:
  1. Choose Modify

  2. Under Log format, choose either JSON or Text.

  3. Under Destination Type, choose either CloudWatch Logs or Kinesis Firehose.

  4. Under Log destination, choose either Create new and enter your CloudWatchLogs log group name or your Kinesis Data Firehose stream name. Or choose Select existing and then choose your CloudWatchLogs log group name or your Kinesis Data Firehose stream name.

You can modify an existing cluster using the AWS CLI modify-cache-cluster operation. To modify a cluster's configuration value, specify the cluster's ID, the parameter to change and the parameter's new value. The following example changes the maintenance window for a cluster named my-cluster and applies the change immediately.

Important

You can upgrade to newer engine versions. If you upgrade major engine versions, for example from 5.0.6 to 6.0, you need to select a parameter group family that is compatible with the new engine version. For more information on doing so, see Engine versions and upgrading . However, you can't downgrade to older engine versions except by deleting the existing cluster and creating it again.

For Linux, macOS, or Unix:

aws elasticache modify-cache-cluster \ --cache-cluster-id my-cluster \ --preferred-maintenance-window sun:23:00-mon:02:00

For Windows:

aws elasticache modify-cache-cluster ^ --cache-cluster-id my-cluster ^ --preferred-maintenance-window sun:23:00-mon:02:00

The --apply-immediately parameter applies only to modifications in node type, engine version, and changing the number of nodes in a cluster. If you want to apply any of these changes immediately, use the --apply-immediately parameter. If you prefer postponing these changes to your next maintenance window, use the --no-apply-immediately parameter. Other modifications, such as changing the maintenance window, are applied immediately.

For more information, see the AWS CLI for ElastiCache topic modify-cache-cluster.

You can modify an existing cluster using the ElastiCache API ModifyCacheCluster operation. To modify a cluster's configuration value, specify the cluster's ID, the parameter to change and the parameter's new value. The following example changes the maintenance window for a cluster named my-cluster and applies the change immediately.

Important

You can upgrade to newer engine versions. If you upgrade major engine versions, for example from 5.0.6 to 6.0, you need to select a parameter group family that is compatible with the new engine version. For more information on doing so, see Engine versions and upgrading . However, you can't downgrade to older engine versions except by deleting the existing cluster and creating it again.

Line breaks are added for ease of reading.

https://elasticache.us-west-2.amazonaws.com/ ?Action=ModifyCacheCluster &CacheClusterId=my-cluster &PreferredMaintenanceWindow=sun:23:00-mon:02:00 &SignatureVersion=4 &SignatureMethod=HmacSHA256 &Timestamp=20150901T220302Z &X-Amz-Algorithm=&AWS;4-HMAC-SHA256 &X-Amz-Date=20150202T220302Z &X-Amz-SignedHeaders=Host &X-Amz-Expires=20150901T220302Z &X-Amz-Credential=<credential> &X-Amz-Signature=<signature>

The ApplyImmediately parameter applies only to modifications in node type, engine version, and changing the number of nodes in a cluster. If you want to apply any of these changes immediately, set the ApplyImmediately parameter to true. If you prefer postponing these changes to your next maintenance window, set the ApplyImmediately parameter to false. Other modifications, such as changing the maintenance window, are applied immediately.

For more information, see the ElastiCache API reference topic ModifyCacheCluster.