diff --git a/docs/products/valkey/howto/migrate-caching-valkey-to-aiven-for-valkey.md b/docs/products/valkey/howto/migrate-caching-valkey-to-aiven-for-valkey.md new file mode 100644 index 00000000..7f664d05 --- /dev/null +++ b/docs/products/valkey/howto/migrate-caching-valkey-to-aiven-for-valkey.md @@ -0,0 +1,92 @@ +--- +title: Migrate Aiven for Caching or Valkey to Aiven for Valkey™ +--- +import ConsoleLabel from "@site/src/components/ConsoleIcons" +import ConsoleIcon from "@site/src/components/ConsoleIcons" + +Migrate your Aiven for Caching or Valkey databases to Aiven for Valkey™ using the Aiven Console migration tool. + +## Prerequisites + +Before starting the migration process, ensure the following: + +- A target [Aiven for Valkey service](/docs/products/valkey/get-started). +- Source database details: + - **Hostname or connection string**: 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 with sufficient permissions to access the data. + - **Password**: The password used to connect to the database. +- Firewall rules updated or temporarily disabled to allow traffic between source and + target databases. +- A source Aiven for Caching or Valkey service secured with SSL. +- A publicly accessible source Aiven for Caching or Valkey service or one with a VPC peering + connection between private networks. You'll need the VPC ID and cloud name. + +:::note +The migration does not include service user accounts or commands in progress. +::: + + +## Database migration steps + +1. Log in to the [Aiven Console](https://console.aiven.io/) and select the + Aiven for Valkey service for your migration. +1. Go to from the sidebar. +1. Scroll to > **Migrate database** to start the + migration. +1. Follow the wizard to guide you through the migration process. + +### Step 1: Configure + +In the migration wizard, review the prerequisites and click **Get started** to begin. + +### Step 2: Validate + +In the migration screen, enter the connection details: + +- Hostname +- Port +- Username +- Password + +Select **SSL encryption recommended** for a secure connection, and click **Run check**. + +The [Aiven Console](https://console.aiven.io/) validates the database configurations. If +any errors occur, follow the on-screen instructions to resolve them and rerun the check. + +### Step 3: Migrate + +Once validation is complete, click **Start migration** to begin migrating data to +Aiven for Valkey. + +### Step 4: Replicate + +While the migration is in progress: + +- You can close the migration wizard and monitor the progress later from the + page. +- To stop the migration, click **Stop migration** in the migration progress window. + Data already transferred to Aiven for Valkey is preserved. + +To prevent conflicts during replication: + +- Do not create or delete databases on the source service. +- Avoid network or configuration changes that might disrupt the connection between source + and target databases, such as firewall modifications. + +If the migration fails, resolve the issue and click **Start over**. + +### Step 5: Close and complete the migration + +After the migration, select one of the following: + +- **Stop replication**: If no further synchronization is needed, and you are ready + to switch to Aiven for Valkey after testing. +- **Keep replicating**: If continuous data synchronization is needed. Avoid system + updates or configuration changes during active replication to prevent unintended + migrations. + +:::note +When replication is active, Aiven for Valkey ensures your data stays in sync by +continuously synchronizing new writes from the source database. diff --git a/sidebars.ts b/sidebars.ts index 40cf1107..2e664625 100644 --- a/sidebars.ts +++ b/sidebars.ts @@ -1895,6 +1895,13 @@ const sidebars: SidebarsConfig = { 'products/valkey/howto/connect-java', ], }, + { + type: 'category', + label: 'Data migration', + items: [ + 'products/valkey/howto/migrate-caching-valkey-to-aiven-for-valkey', + ], + }, { type: 'category', label: 'Read replica',