All Products
Search
Document Center

ApsaraDB for MongoDB:Update the minor version of an instance

Last Updated:Feb 20, 2025

This topic describes how to update the minor version of an ApsaraDB for MongoDB instance to the latest version in the ApsaraDB for MongoDB console.

Prerequisites

  • A replica set or sharded cluster instance is used.

  • The instance is not running the latest minor version. When you use the latest minor version, the Update Minor Version button is not displayed for the instance.

Usage notes

  • You cannot downgrade the minor version of an instance after you update the minor version.

  • After you update the minor version of an instance, the instance is restarted and is disconnected from your application for less than 30 seconds. We recommend that you perform the minor version update during off-peak hours or make sure that your application can automatically reconnect to the instance.

  • If the minor version of your instance is not the latest version, the system may update the minor version to the latest version to ensure higher performance and stability when you perform the following operations:

    Operation

    Description

    Upgrade the major version of an instance

    The minor version of an instance that uses cloud disks or local disks is updated to the latest version.

    Restart an instance, a component, or a node

    The minor version of an instance that uses cloud disks or local disks is updated to the latest version.

    Important

    During the node restart, the system does not update the minor version of the instance.

    Migrate data

    If the instance to which you want to migrate data is a new instance, the minor version of the new instance is the latest version by default.

    Change the configurations of an instance

    The minor version of an instance that uses local disks is updated to the latest version.

    Important

    The system does not update the minor version of the instance when you change only the storage capacity of the instance.

    Restore backup data to a new instance by point in time

    By default, the minor version of the new instance to which data is restored from the original instance is the latest version.

    Restore the databases of an instance

    By default, the minor version of the new instance to which data is restored from the original instance is the latest version.

Procedure

  1. Go to the Replica Set Instances or Sharded Cluster Instances page. In the top navigation bar, select the region in which the instance resides and the resource group to which the instance belongs. Then, find the instance and click the ID of the instance.

  2. Click Update Minor Version on the right side of the Specifications section.

    Note
    • When you use the latest minor version, the Update Minor Version button is not displayed for the instance.

    • During the upgrade, the instance is upgraded to the latest minor version. You cannot customize the version available for upgrade.

  3. In the Update Minor Version message, view the version release notes and determine whether to update the minor version of the instance.

    • If you want to update the minor version of the instance, click OK.

    • Otherwise, click Cancel.

    If the instance status changes from Upgrading Version to Running, the minor version update is complete.