Migrate Between Plans

Need to change your MongoDB hosting plan from or to our Shared Hosting, Dedicated Hosting, or Bring Your Own Cloud (BYOC) models? Easily migrate your MongoDB cluster to a different plan type with just a few steps in the console.

Create a New MongoDB Cluster

Here are the steps to get started:

1. Log into the ScaleGrid console.
2. Go to your MongoDB page, and click the green "New MongoDB Cluster" button in the upper-right.
3. Create a new cluster under the plan type you wish to migrate to by following these steps for creating a Dedicated, or BYOC MongoDB cluster.

🚧

Do not import during the MongoDB cluster creation process

Skip over the "Import" step when creating your new MongoDB cluster under the plan you're migrating to. We will import your MongoDB cluster you wish to migrate from after your new cluster has been created.

4. Once you've completed the MongoDB cluster creation steps, wait until your cluster status changes from "Creating" to "Running" (takes approximately 5-20 minutes depending on your cluster size), and then move onto the next section below.

Import Your MongoDB Cluster To The New Plan

Now that you've created your new MongoDB cluster under your desired plan, you can easily import your old cluster by following these steps:

🚧

Backup Your Old Cluster Before Proceeding

Importing a database(s) with the same name will overwrite its existing data. Please create a MongoDB On-Demand Backup if you would like to preserve the existing data in the cluster you are migrating from.

1. Go to your MongoDB page in the console, and select your newly created cluster.
2. Under the Overview tab, click on "Import Data".
3. In the import window that opens, select the second tab, "ScaleGrid cluster".
4. Select the MongoDB cluster you wish to migrate to the newly created cluster plan from the "Select source cluster" dropdown menu.
5. Click the green "Import" button to migrate your old MongoDB cluster to your new desired cluster plan.

👍

Your MongoDB import has now begun!

Your data will be migrated as soon as the import job is complete, and the time will vary based on the size of your data.

Configure Your New MongoDB Cluster

While your new MongoDB cluster is being created, check off these important steps to fully complete your setup process:

Grab Your MongoDB Cluster Credentials

Here are the steps to connect to MongoDB:

1. Go to the MongoDB Cluster Details page of your newly imported cluster.
2. Under the Overview tab, find your Credentials and click Show.
3. Copy your Connection String.
4. Use these details to update your MongoDB connection to your application, and cancel the previous connecting.

Confirm Your Successful MongoDB Data Migration

After the migration is complete, you'll receive an alert in your ScaleGrid console as well as confirmation to the email associated with your account. Make sure to also confirm the following:

• Data size and details match your imported cluster.
• Your MongoDB cluster is connected to your application.
• Your MongoDB Backup Schedule is configured.

Delete Your Old MongoDB Cluster

After completing and confirming all of the above steps, it is now safe to delete your old MongoDB cluster.

1. to the MongoDB Cluster Details page of your old cluster.
2. Under the Overview tab, click "Delete".
3. Enter the name of this cluster to confirm its deletion.
4. Click the green "Delete" button to permanently delete this cluster and all backups.

If you have any questions on the MongoDB migration process between ScaleGrid DBaaS plans, please do not hesitate to reach out to us at [email protected].