Menu
Amazon ElastiCache
User Guide (API Version 2015-02-02)

Restoring From a Backup with Cluster Resizing

You can restore the data from a Redis .rdb backup file to a new cluster at any time.

The Amazon ElastiCache Redis restore process supports the following:

  • Upgrading from a Redis (cluster mode disabled) cluster to a Redis (cluster mode enabled) cluster running Redis version 3.2.4.

     

  • Migrating from one or more .rdb backup files you created from your self-managed Redis clusters to a single ElastiCache for Redis (cluster mode enabled) cluster.

    The .rdb files must be put in S3 to perform the restore.

     

  • Specifying a number of shards (API/CLI: node groups) in the new cluster that is different from the number of shards in the cluster that was used to create the backup file.

     

  • Specifying a different node type for the new cluster—larger or smaller. If scaling to a smaller node type, be sure that the new node type has sufficient memory for your data and Redis overhead. For more information, see Selecting Your Node Size.

     

  • Configuring the slots of the new Redis (cluster mode enabled) cluster differently than in the cluster that was used to create the backup file.

Important

You cannot restore from a backup created using a Redis (cluster mode enabled) cluster to a Redis (cluster mode disabled) cluster.

Whether you make any changes when restoring a cluster from a backup or not is governed by the choices you make in the Restore Cluster dialog box when using the ElastiCache console, or parameter values when using the AWS CLI or ElastiCache API to restore.

During the restore operation, ElastiCache creates the new cluster, and then populates it with data from the backup file. When this process is complete, the Redis cluster is warmed up and ready to accept requests.

Before you proceed

Be sure you have created a backup of the cluster you want to restore from. For more information, see Taking Manual Backups.

If you want to restore from an externally created backup, see Seeding a New Cluster with an Externally Created Backup (Redis).

The following procedures show you how to restore a backup to a new cluster using the ElastiCache console, the AWS CLI, or the ElastiCache API.

Restoring From a Backup (Console)

You can restore a Redis backup to either a single-node Redis (cluster mode disabled) cluster or to a Redis cluster with read replicas (replication group)— either Redis (cluster mode disabled) or Redis (cluster mode enabled).

To restore a backup to a new cluster (console)

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

  2. From the left navigation pane, choose Backups.

  3. In the list of backups, choose the box to the left of the backup name you want to restore from.

  4. Choose Restore.

  5. Complete the Restore Cluster dialog box. Be sure to complete all the "Required" fields and any of the others you want to change from the defaults.

    Redis (cluster mode disabled)

    1. Cluster ID – Required. The name of the new cluster.

    2. Engine version compatibility – The ElastiCache for Redis engine version you want to run.

    3. Cluster mode enabled (scale out) – Choose this to convert your Redis (cluster mode disabled) cluster to a Redis (cluster mode enabled) (the engine version will become 3.2.4.

      If you select Cluster mode enabled (scale out):

      1. Choose the number of shards you want in the new cluster (API/CLI: node groups).

      2. Choose the number of read replicas you want in each shard.

      3. Distribute your keys among the slots as you desire.

    4. Node Type – Specify the node type you want for the new cluster.

    5. Availability zone(s) – Specify how you want the cluster's availability zones selected.

    6. Port – Change this only if you want the new cluster to use a different port.

    7. Choose a VPC – Choose the VPC in which to create this cluster.

    8. Parameter Group – Choose a parameter group that reserves sufficient memory for Redis overhead for the node type you selected.

     

    Redis (cluster mode enabled)

    1. Cluster ID – Required. The name of the new cluster.

    2. Cluster mode enabled (scale out) – Choose this for a Redis (cluster mode enabled) cluster. Clear it for a Redis (cluster mode disabled) cluster.

    3. Node Type – Specify the node type you want for the new cluster.

    4. Number of Shards – Choose the number of shards you want in the new cluster (API/CLI: node groups).

    5. Replicas per Shard – Choose the number of read replica nodes you want in each shard.

    6. Slots and keyspaces – Choose how you want keys distributed among the shards. If you choose to specify the key distributions complete the table specifying the key ranges for each shard.

    7. Availability zone(s) – Specify how you want the cluster's availability zones selected.

    8. Port – Change this only if you want the new cluster to use a different port.

    9. Choose a VPC – Choose the VPC in which to create this cluster.

    10. Parameter Group – Choose a parameter group that reserves sufficient memory for Redis overhead for the node type you selected.

  6. When the settings are as you want them, choose Launch Cluster.

Restoring From a Backup (AWS CLI)

You can restore a Redis (cluster mode disabled) backup to either a single-node Redis (cluster mode disabled) cluster using the AWS CLI operation create-cache-cluster or a Redis cluster with read replicas (replication group)— either Redis (cluster mode disabled) or Redis (cluster mode enabled) using the AWS CLI operation create-replication-group and seeding it with a Redis .rdb file.

When using either the create-cache-cluster or create-replication-group operation, be sure to include the parameter --snapshot-name or --snapshot-arns to seed the new cluster or replication group with the data from the backup.

For more information, see the following:

Restoring From a Backup (ElastiCache API)

You can restore a Redis backup to either a single-node Redis (cluster mode disabled) cluster using the ElastiCache API operation CreateCacheCluster or to a Redis cluster with read replicas (replication group)— either Redis (cluster mode disabled) or Redis (cluster mode enabled) using the ElastiCache API operation CreateReplicationGrooup and seeding it with a Redis .rdb file.

When using either the CreateCacheCluster or CreateReplicationGroup operation, be sure to include the parameter SnapshotName or SnapshotArns to seed the new cluster or replication group with the data from the backup.

For more information, see the following: