From 10dba3d7a73f8c0aa9e08feb7cbc0d31b35bb206 Mon Sep 17 00:00:00 2001 From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com> Date: Mon, 30 Jun 2025 15:23:07 +0200 Subject: [PATCH 1/3] fix(mdb): migration pt3 --- menu/navigation.json | 4 ++ .../migrating-to-managed-mongodb.mdx | 2 +- .../api-cli/cluster-to-cluster-sync.mdx | 58 +++++++++++++++++++ 3 files changed, 63 insertions(+), 1 deletion(-) create mode 100644 pages/managed-mongodb-databases/api-cli/cluster-to-cluster-sync.mdx diff --git a/menu/navigation.json b/menu/navigation.json index c718f20911..1ec20e14df 100644 --- a/menu/navigation.json +++ b/menu/navigation.json @@ -2429,6 +2429,10 @@ { "label": "Back up and restore MongoDB® Databases", "slug": "backup-and-restore" + }, + { + "label": "Migrating data with mongosync", + "slug": "cluster-to-cluster-sync" } ], "label": "API/CLI", diff --git a/pages/managed-mongodb-databases/additional-content/migrating-to-managed-mongodb.mdx b/pages/managed-mongodb-databases/additional-content/migrating-to-managed-mongodb.mdx index 51200d1f7a..718b6223df 100644 --- a/pages/managed-mongodb-databases/additional-content/migrating-to-managed-mongodb.mdx +++ b/pages/managed-mongodb-databases/additional-content/migrating-to-managed-mongodb.mdx @@ -22,4 +22,4 @@ The migration processes described below are defined by the expected downtime. Yo | Downtime tolerance | Recommended migration method | Benefits | | --- | --- | --- | | Can afford downtime | [Classic mongodump/mongorestore workflow](/managed-mongodb-databases/api-cli/backup-and-restore/) | Easy, straightforward | -| Cannot afford downtime | MongoDB® Cluster-to-Cluster sync tool (`mongosync` binary) | Zero downtime, real-time data sync, flexible migration windows, easy rollback. Refer to the official PostgreSQL documentation for a list of the tool's [limitations](https://www.mongodb.com/docs/cluster-to-cluster-sync/current/reference/limitations/#std-label-c2c-limitationsl) | +| Cannot afford downtime | [MongoDB® Cluster-to-Cluster sync tool](/managed-mongodb-databases/api-cli/cluster-to-cluster-sync) (`mongosync` binary) | Zero downtime, real-time data sync, flexible migration windows, easy rollback. Refer to the official PostgreSQL documentation for a list of the tool's [limitations](https://www.mongodb.com/docs/cluster-to-cluster-sync/current/reference/limitations/#std-label-c2c-limitationsl) | diff --git a/pages/managed-mongodb-databases/api-cli/cluster-to-cluster-sync.mdx b/pages/managed-mongodb-databases/api-cli/cluster-to-cluster-sync.mdx new file mode 100644 index 0000000000..a1d6648f3e --- /dev/null +++ b/pages/managed-mongodb-databases/api-cli/cluster-to-cluster-sync.mdx @@ -0,0 +1,58 @@ +--- +meta: + title: Migrating data with mongosync + description: This page shows you how to migrate data using MongoDB®'s Cluster-to-Cluster tool +content: + h1: Migrating data with mongosync + paragraph: This page provides a guide on how to migrate data using MongoDB®'s Cluster-to-Cluster tool +tags: databases mongodb migration mongosync data-synchronization +categories: + - managed-databases + - mongodb +--- + +Scaleway Managed MongoDB® is compatible with the [MongoDB® Cluster-to-Cluster tool](https://www.mongodb.com/docs/cluster-to-cluster-sync/current/quickstart/#std-label-c2c-quickstart). + +Cluster-to-Cluster sync helps you migrate data from one cluster to another without downtime through synchronization. Until the sync is finalized, the tool replicates and writes data from one cluster to another. + + + + Refer to the official PostgreSQL documentation for a list of Cluster-to-Cluster sync's [limitations](https://www.mongodb.com/docs/cluster-to-cluster-sync/current/reference/limitations/#std-label-c2c-limitationsl) + + + + + - A Scaleway account logged into the [console](https://console.scaleway.com) + - A [MongoDB® Database Instance](/managed-mongodb-databases/how-to/create-a-database-instance/) + - Installed a [MongoDB®-compatible client](https://www.mongodb.com/try/download/shell) + - Set up your [environment variables](/scaleway-cli/reference-content/environment-variables/#reserved-environment-variables) for the Scaleway API + +1. Create a user in your MongoDB® Instance. Make sure you replace ``, `` and `{instance_id}` with the user name of the user, its password and the MongoDB® Instance UUID, respectively. + + ``` + curl -X POST \ + -H "X-Auth-Token: $SCW_SECRET_KEY" \ + -H "Content-Type: application/json" \ + -d '{"name":"","password":""}' \ + "https://api.scaleway.com/mongodb/v1/regions/fr-par/instances/{instance_id}/users" + ``` + +2. [Apply the `sync` role to the user](/managed-mongodb-databases/how-to/manage-users/#how-to-apply-a-role-to-a-user). The `db_admin`role also allows you to sync. +3. [Download and install `mongosync` for your host system](https://www.mongodb.com/docs/cluster-to-cluster-sync/current/quickstart/#download-and-install-mongosync). + + + If the database you want to sync is bigger than 100GB, we recommend you use a [Scaleway Instance](/instances/how-to/create-an-instance) to sync. + + ``` +3. [Connect the clusters](https://www.mongodb.com/docs/cluster-to-cluster-sync/current/quickstart/#connect-the-clusters). + +4. [Migrate data between clusters](https://www.mongodb.com/docs/cluster-to-cluster-sync/current/quickstart/#migrate-data-between-clusters). + +5. [Finalize the cut-over process](https://www.mongodb.com/docs/cluster-to-cluster-sync/current/quickstart/#finalize-cutover-process). + + + + + + + From 7517a7552b8a7bf4f8dc7ea117555a4b3e336535 Mon Sep 17 00:00:00 2001 From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com> Date: Mon, 30 Jun 2025 15:25:24 +0200 Subject: [PATCH 2/3] fix(mdb): remove spaces --- .../api-cli/cluster-to-cluster-sync.mdx | 9 +-------- 1 file changed, 1 insertion(+), 8 deletions(-) diff --git a/pages/managed-mongodb-databases/api-cli/cluster-to-cluster-sync.mdx b/pages/managed-mongodb-databases/api-cli/cluster-to-cluster-sync.mdx index a1d6648f3e..e2f29e782d 100644 --- a/pages/managed-mongodb-databases/api-cli/cluster-to-cluster-sync.mdx +++ b/pages/managed-mongodb-databases/api-cli/cluster-to-cluster-sync.mdx @@ -48,11 +48,4 @@ Cluster-to-Cluster sync helps you migrate data from one cluster to another witho 4. [Migrate data between clusters](https://www.mongodb.com/docs/cluster-to-cluster-sync/current/quickstart/#migrate-data-between-clusters). -5. [Finalize the cut-over process](https://www.mongodb.com/docs/cluster-to-cluster-sync/current/quickstart/#finalize-cutover-process). - - - - - - - +5. [Finalize the cut-over process](https://www.mongodb.com/docs/cluster-to-cluster-sync/current/quickstart/#finalize-cutover-process). \ No newline at end of file From f1811436053b6e186c35667375a487f4fb549db4 Mon Sep 17 00:00:00 2001 From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com> Date: Mon, 30 Jun 2025 15:25:37 +0200 Subject: [PATCH 3/3] fix(mdb): remove code --- .../api-cli/cluster-to-cluster-sync.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/managed-mongodb-databases/api-cli/cluster-to-cluster-sync.mdx b/pages/managed-mongodb-databases/api-cli/cluster-to-cluster-sync.mdx index e2f29e782d..3bd80231f7 100644 --- a/pages/managed-mongodb-databases/api-cli/cluster-to-cluster-sync.mdx +++ b/pages/managed-mongodb-databases/api-cli/cluster-to-cluster-sync.mdx @@ -43,7 +43,7 @@ Cluster-to-Cluster sync helps you migrate data from one cluster to another witho If the database you want to sync is bigger than 100GB, we recommend you use a [Scaleway Instance](/instances/how-to/create-an-instance) to sync. - ``` + 3. [Connect the clusters](https://www.mongodb.com/docs/cluster-to-cluster-sync/current/quickstart/#connect-the-clusters). 4. [Migrate data between clusters](https://www.mongodb.com/docs/cluster-to-cluster-sync/current/quickstart/#migrate-data-between-clusters).