Skip to main content

Migrate from Redis®* to Aiven for Caching using Aiven Console

Migrate your Redis®* databases, whether on-premise or cloud-hosted, to Aiven for Caching, using Aiven Console's guided wizard.

important

Migrating from Google Cloud Memorystore for Redis is not currently supported.

The version of the source Redis service cannot be higher than the version of the target Aiven for Caching service.

Prerequisites​

Before starting the migration process, ensure you have the following:

  • A target Aiven for Caching service. To create one, see Get started with Aiven for Caching.
  • Source database information:
    • Hostname or connection string: This is the public hostname, connection string, or IP address used to connect to the database. Refer to accessible from the public Internet.
    • Port: The port used to connect to the database.
    • Username: The username used to connect to the database. Ensure this user has sufficient permissions to access the data to migrate.
    • Password: The password used to connect to the database.
  • To enable traffic and connection between the source and target databases, ensure that you update or disable the firewalls that protect them. If necessary, you can temporarily disable the firewalls.
  • A source Redis®* service that is secured with SSL is a default migration requirement.
  • A publicly accessible source Redis®* service or a service with a VPC peering connection between private networks. The VPC ID and cloud name are required for the migration process.
note

AWS ElastiCache for Redis®* instances cannot have public IP addresses and require project VPC and peering connection.

Migrate a Redis database​

To migrate a Redis database to Aiven for Caching service:

  1. Log in to the Aiven Console, and select the target Aiven for Caching service for migrating the Redis® database.
  2. Click Service settings on the sidebar.
  3. Scroll to the Service management section, and click Actions > Import database. to initiate the import process.
  4. Follow the wizard to guide you through the database migration process.

Step 1: Configure​

Read through the guidelines on the Redis migration wizard and click Get started to proceed with the database migration.

Screenshot of the database migration wizard

Step 2: Validation​

  1. On the Database connection and validation screen, enter the following information to establish a connection to your source database:

    • Hostname: This is the public hostname, connection string, or IP address used to connect to the database.
    • Port: The port used to connect to the database.
    • Username: The username used to connect to the database.
    • Password: The password used to connect to the database.

  2. Select the SSL encryption recommended checkbox.

  3. Click the Run check to validate the connection. If the check returns any warning, resolve the issues before proceeding with the migration process.

    Connect to database

Step 3: Migration​

On the Database migration screen, click Start Migration to begin the migration.

Start database migration

While the migration is in progress, you can

  • Close the wizard by clicking Close window. To check the migration status anytime,return to the wizard from the service's overview page.
  • Continue writing to the target database.
  • Stop the migration by clicking Stop migration. Data that has already been migrated is retained, and you can initiate a new migration at any time
note

If you choose to stop the migration, this action immediately halts the replication of your data. However, any data that has already been migrated to Aiven is retained. You can initiate a new migration later, and this process overwrites any previously migrated databases.

Migration attempt failed?

If you receive such a notification, it is important to investigate the possible causes of the failure and address the issues. Once you have resolved the underlying problems, you can initiate the migration by choosing Start over.

Step 4: Close​

When the wizard informs you about the completion of the migration, you can choose one of the following options:

  • Click Close connection to disconnect the databases and stop the replication process if it is still active.

  • Click Keep replicating if the replication is ongoing and you wish to maintain the connection open for continuous data synchronization.

    Close database connection

Replication mode active?

Your data has been successfully migrated to the designated Aiven for Caching database, and any subsequent additions to the connected databases are being continuously synchronized.