From edeb1c33818b6ae9b146ec6c25c1322290eb9f5f Mon Sep 17 00:00:00 2001 From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com> Date: Thu, 26 Jun 2025 17:26:15 +0200 Subject: [PATCH 1/5] fix(mdb): migration pt1 --- .../additional-content/index.mdx | 8 ++++++ .../migrating-to-managed-mongodb.mdx | 25 +++++++++++++++++++ 2 files changed, 33 insertions(+) create mode 100644 pages/managed-mongodb-databases/additional-content/index.mdx create mode 100644 pages/managed-mongodb-databases/additional-content/migrating-to-managed-mongodb.mdx diff --git a/pages/managed-mongodb-databases/additional-content/index.mdx b/pages/managed-mongodb-databases/additional-content/index.mdx new file mode 100644 index 0000000000..5f03b3618e --- /dev/null +++ b/pages/managed-mongodb-databases/additional-content/index.mdx @@ -0,0 +1,8 @@ +--- +meta: + title: Managed MongoDB® - Additional Content + description: Managed MongoDB® Additional Content +content: + h1: Managed MongoDB® - Additional Content + paragraph: Managed MongoDB® Additional Content +--- 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 new file mode 100644 index 0000000000..51200d1f7a --- /dev/null +++ b/pages/managed-mongodb-databases/additional-content/migrating-to-managed-mongodb.mdx @@ -0,0 +1,25 @@ +--- +meta: +title: Migrating to Scaleway Managed MongoDB® +description: Learn how to migrate your MongoDB® databases to Scaleway Managed MongoDB® for improved performance and scalability +content: +h1: Migrating to Scaleway Managed MongoDB® +paragraph: Discover the benefits of migrating your MongoDB® databases to Scaleway Managed MongoDB® and get step-by-step guidance on the migration process +tags: databases mongodb migration managed-databases +dates: +validation: 2025-06-26 +categories: +- managed-databases +- mongodb +--- + +Scaleway Managed MongoDB® allows you to run your Database Instances without setting up or managing infrastructure. Scaleway is responsible for implementing and maintaining features that improve the performance, scalability and security of your Database Instances. + +If you have a self-managed MongoDB®, or you if use a different cloud provider, you can easily migrate your databases to Scaleway. + +The migration processes described below are defined by the expected downtime. You can select the right option for your use case, depending on your downtime tolerance. + +| 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) | From 99c33ad501ae40e6de16753de2f11370a2bf865c Mon Sep 17 00:00:00 2001 From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com> Date: Mon, 30 Jun 2025 13:34:31 +0200 Subject: [PATCH 2/5] fix(mdb): migration pt2 --- menu/navigation.json | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/menu/navigation.json b/menu/navigation.json index 39924ba4f6..c718f20911 100644 --- a/menu/navigation.json +++ b/menu/navigation.json @@ -2414,6 +2414,16 @@ "label": "How to", "slug": "how-to" }, + { + "items": [ + { + "label": "Migrating to Managed MongoDB®", + "slug": "migrating-to-managed-mongodb" + } + ], + "label": "Additional Content", + "slug": "additional-content" + }, { "items": [ { From 0d2f8118c05c4a893d5f2e7caf82ea61dc6ae147 Mon Sep 17 00:00:00 2001 From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com> Date: Mon, 30 Jun 2025 15:26:04 +0200 Subject: [PATCH 3/5] feat(mdb): mongosync - MTA-6186 (#5208) --- menu/navigation.json | 4 ++ .../migrating-to-managed-mongodb.mdx | 2 +- .../api-cli/cluster-to-cluster-sync.mdx | 51 +++++++++++++++++++ 3 files changed, 56 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..3bd80231f7 --- /dev/null +++ b/pages/managed-mongodb-databases/api-cli/cluster-to-cluster-sync.mdx @@ -0,0 +1,51 @@ +--- +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). \ No newline at end of file From bf01ec67133236ace734aab9d96e70bed5d058f6 Mon Sep 17 00:00:00 2001 From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com> Date: Mon, 30 Jun 2025 16:52:51 +0200 Subject: [PATCH 4/5] fix(mdb): reviews Co-authored-by: Jessica <113192637+jcirinosclwy@users.noreply.github.com> --- .../api-cli/cluster-to-cluster-sync.mdx | 5 ++++- 1 file changed, 4 insertions(+), 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 3bd80231f7..992644baaf 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 @@ -6,6 +6,9 @@ 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 +dates: + validation: 2025-06-30 + posted: 2025-06-30 categories: - managed-databases - mongodb @@ -41,7 +44,7 @@ Cluster-to-Cluster sync helps you migrate data from one cluster to another witho 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. + If the database you want to sync is bigger than 100 GB, 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). From 5d98710c87ae83b2ce8a18e96f328466f3e47e4e Mon Sep 17 00:00:00 2001 From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com> Date: Mon, 30 Jun 2025 17:54:29 +0200 Subject: [PATCH 5/5] fix(mdb): review walter --- .../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 992644baaf..01385c5220 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 @@ -40,7 +40,7 @@ Cluster-to-Cluster sync helps you migrate data from one cluster to another witho "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. +2. [Apply the `sync` role to the user](/managed-mongodb-databases/how-to/manage-users/#how-to-apply-a-role-to-a-user) for any database. 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).