If you have data in a single-region Redis Enterprise Software database that you want to migrate to an Active-Active database, you’ll need to create a new Active-Active database and migrate the data into the new database as a Replica Of the existing database. This process will gradually populate the data in the Active-Active database.

Before data migration starts, all data is flushed from the Active-Active database. The data is migrated to the Active-Active instance where you configured migration, and the data from that instance is copied to the other Active-Active instances.

When data migration is finished, turn off migration and connect your applications to the Active-Active database.

Active-Active data migration process

Prerequisites

  • During the migration, any applications that connect to the Active-Active database must be read-only to ensure the dataset is identical to the source database during the migration process. However, you can continue to write to the source database during the migration process.

  • If you used the mDNS protocol for the cluster name (FQDN), the client mDNS prerequisites must be met in order to communicate with other clusters.

Migrate from a Redis Enterprise cluster

You can migrate a Redis Enterprise database from the same cluster or a different cluster.

Migrate from the same cluster

To migrate a database to Active-Active in the same Redis Enterprise cluster:

  1. Create a new Active-Active database. For prerequisites and detailed instructions, see Create an Active-Active geo-replicated database.

  2. After the Active-Active database is active, click Edit on the Configuration screen.

  3. Expand the Migrate to Active-Active section:

    Migrate to Active-Active section.
  4. Click + Add source database.

  5. In the Migrate to Active-Active dialog, select Current cluster:

    Migrate to Active-Active dialog with Current cluster tab selected.
  6. Select the source database from the list.

  7. Click Add source.

  8. Click Save.

Migrate from a different cluster

Note:
For a source database on a different Redis Enterprise Software cluster, you can compress the replication data to save bandwidth.

To migrate a database to Active-Active in different Redis Enterprise clusters:

  1. Sign in to the Cluster Manager UI of the cluster hosting the source database.

    1. In Databases, select the source database and then select the Configuration tab.

    2. In the Replica Of section, select Use this database as a source for another database.

    3. Copy the Replica Of source URL.

      Copy the Replica Of source URL from the Connection link to destination dialog.

      To change the internal password, select Regenerate password.

      If you regenerate the password, replication to existing destinations fails until their credentials are updated with the new password.

  2. Sign in to the Cluster Manager UI of the destination database’s cluster.

  3. Create a new Active-Active database. For prerequisites and detailed instructions, see Create an Active-Active geo-replicated database.

  4. After the Active-Active database is active, click Edit on the Configuration screen.

  5. Expand the Migrate to Active-Active section:

    Migrate to Active-Active section.
  6. Click + Add source database.

  7. In the Migrate to Active-Active dialog, select External:

    Migrate to Active-Active dialog with External tab selected.
  8. For Source database URL, enter the Replica Of source URL you copied in step 1.

  9. Click Add source.

  10. Click Save.

Migrate from open source Redis

To migrate an open source Redis database to Active-Active:

  1. Create a new Active-Active database. For prerequisites and detailed instructions, see Create an Active-Active geo-replicated database.

  2. After the Active-Active database is active, click Edit on the Configuration screen.

  3. Expand the Migrate to Active-Active section:

    Migrate to Active-Active section.
  4. Click + Add source database.

  5. In the Migrate to Active-Active dialog, select External:

    Migrate to Active-Active dialog with External tab selected.
  6. Enter the Source database URL:

    • If the database has a password:

      redis://:<password>@<host>:<port>
      

      Where the password is the Redis password represented with URL encoding escape characters.

    • If the database does not have a password:

      redis://<host>:<port>
      
  7. Click Add source.

  8. Click Save.

Stop sync after migration

  1. Wait until the migration is complete, indicated by the Status Synced.

    Note:
    Migration can take minutes to hours to complete depending on the dataset size and network quality.
  2. On the Active-Active database’s Configuration screen, click Edit.

  3. In the Migrate to Active-Active section, click Stop sync:

    The Migrate to Active-Active section shows the Active-Active database is synced with the source database.
  4. In the Stop synchronization dialog, click Stop to proceed.

  5. Redirect client connections to the Active-Active database after Status changes to Sync stopped:

    The Migrate to Active-Active section shows the Active-Active database stopped syncing with the source database.