Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Online migration to ElastiCache

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

Overview

To migrate your data from open-source Redis OSS 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 such as instance type, number of shards, and number of replicas.

Online migration is designed for data migration from self-hosted open-source Redis OSS on Amazon EC2 to ElastiCache (Redis OSS), and not for moving data between ElastiCache (Redis OSS) clusters.

The migration begins when you call the StartMigration API operation or Amazon CLI command. When migrating Redis OSS cluster-mode disabled clusters, the migration process makes the primary node of the ElastiCache (Redis OSS) cluster a replica of your source Redis OSS primary. When migrating Redis OSS cluster-mode enabled clusters, the migration process makes the primary node of each ElastiCache shard a replica of your source cluster's corresponding shard owning the same slots.

After the client-side changes are ready, call the CompleteMigration API operation. This API operation promotes your ElastiCache deployment to your primary Redis OSS 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 OSS nodes and on the ElastiCache primary nodes.

Migration steps

The following topics outline the process for migrating your data: