Amazon ElastiCache for Redis
ElastiCache for Redis User Guide (API Version 2015-02-02)

Online Migration to ElastiCache

By using Online Migration, you can migrate your data from self-hosted Redis on Amazon EC2 to Amazon ElastiCache.

Overview

To migrate your data from Redis running on Amazon EC2 to Amazon ElastiCache requires an existing or newly created Amazon ElastiCache deployment. The deployment must have a configuration that is ready for migration. It also should be in line with the configuration that you want, including attributes like instance type and number of replicas.

Important

We strongly recommend you read the following sections in their entirety before beginning the online migration process.

The migration begins when you call the StartMigration API operation or AWS CLI command. The migration process makes the primary node of the ElastiCache deployment a replica for your source ElastiCache for Redis. Using Redis replication, data is synced between your source Redis and ElastiCache. After the data is in sync, you are nearly ready to cut over to ElastiCache. At this point, you make changes on the application side so your application can call ElastiCache post-migration.

After the client-side changes are ready, call the StopMigration API operation. This API operation promotes your ElastiCache deployment to your primary Redis deployment with primary and replica nodes (as applicable). Now you can redirect your client application to start writing data to ElastiCache. Throughout the migration, you can check the status of replication by running the redis-cli INFO command on your Redis on EC2 nodes and on the ElastiCache primary node.

Migration Steps

The following topics outline the process for migrating your data:

On this page: