diff --git a/menu/navigation.json b/menu/navigation.json index 39924ba4f6..1ec20e14df 100644 --- a/menu/navigation.json +++ b/menu/navigation.json @@ -2414,11 +2414,25 @@ "label": "How to", "slug": "how-to" }, + { + "items": [ + { + "label": "Migrating to Managed MongoDB®", + "slug": "migrating-to-managed-mongodb" + } + ], + "label": "Additional Content", + "slug": "additional-content" + }, { "items": [ { "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/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..718b6223df --- /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](/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..01385c5220 --- /dev/null +++ b/pages/managed-mongodb-databases/api-cli/cluster-to-cluster-sync.mdx @@ -0,0 +1,54 @@ +--- +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 +dates: + validation: 2025-06-30 + posted: 2025-06-30 +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) 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). + + + 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). + +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