Scaling and configuring Your Azure Cosmos DB for MongoDB vCore cluster

APPLIES TO: MongoDB vCore

Azure Cosmos DB for MongoDB vCore provides seamless scalability and high availability. This document serves as a quick guide for developers who want to learn how to scale and configure their clusters. When changes are made, they're performed live to the cluster without downtime.

Prerequisites

To change the configuration of your cluster, use the Scale section of the Azure Cosmos DB for MongoDB vCore cluster page in the Azure portal. The portal includes real-time costs for these changes.

Tip

For this guide, we recommend using the resource group name msdocs-cosmos-howto-rg.

  1. Sign in to the Azure portal.

  2. Navigate to the existing Azure Cosmos DB for MongoDB vCore cluster page.

  3. From the Azure Cosmos DB for MongoDB vCore cluster page, select the Scale navigation menu option.

    Screenshot of the Scale option on the page for an Azure Cosmos DB for MongoDB vCore cluster.

Change the cluster tier

The cluster tier you select influences the amount of vCores and RAM assigned to your cluster. You can change the cluster tier to suit your needs at any time without downtime. For example, you can increase from M50 to M60 or decrease M50 to M40 using the Azure portal.

  1. To change the cluster tier, select the new tier from the drop-down menu.

    Screenshot of the cluster tier option in the Scale page of a cluster.

    Note

    This change is performed live to the cluster without downtime.

  2. Select Save to persist your change.

Increase disk size

You can increase the storage size to give your database more room to grow. For example, you can increase the storage from 128 GB to 256 GB.

  1. To increase the storage size, select the new size from the drop-down menu.

    Screenshot of the storage per shard option in the Scale page of a cluster.

    Note

    This change is performed live to the cluster without downtime. Also, storage size can only be increased, not decreased.

  2. Select Save to persist your change.

Enable or disable high availability

You can enable or disable high availability (HA) to suit your needs. HA avoids database downtime by maintaining replica shards of every primary shard in a cluster. If a primary shard goes down, incoming connections are automatically redirected to its replica shard, ensuring that there's minimal downtime.

  1. To enable or disable HA, toggle the checkbox option.

    Screenshot of the high availability checkbox in the Scale page of a cluster.

  2. Select Save to persist your change.

Next steps

In this guide, we've shown that scaling and configuring your Cosmos DB for MongoDB vCore cluster in the Azure portal is a straightforward process. The Azure portal includes the ability to adjust the cluster tier, increase storage size, and enable or disable high availability without any downtime.