Upgrading the MongoDB version

1. Get a list of your MongoDB clusters using this command:

   yc managed-mongodb cluster list
   

2. Get information about the cluster you need and check the MongoDB version specified in the config.version property:

   yc managed-mongodb cluster get <cluster_name_or_ID>
   

3. Run the MongoDB upgrade:

   yc managed-mongodb cluster update <cluster_name_or_ID> \
      --mongodb-version=<new_version_number>
   

   As soon as you run the upgrade, the cluster status will change to UPDATING. Wait for the operation to complete and then check the cluster version.

4. After the upgrade, all MongoDB features that are not backward-compatible with the previous version will be disabled. To remove this restriction, run this command:

   yc managed-mongodb cluster update <cluster_name_or_ID> \
      --feature-compatibility-version=<new_version_number>
   

   Learn more about backward compatibility in the MongoDB documentation.

1. Open the current Terraform configuration file with an infrastructure plan.

   For more information about creating this file, see Creating clusters.

2. To the Managed Service for MongoDB cluster description, add the version field or change its value if it is already there:

   resource "yandex_mdb_mongodb_cluster" "<cluster_name>" {
     ...
     cluster_config {
       version = "<MongoDB_version>"
     }
   }
   

3. Make sure the settings are correct.

   1. Using the command line, navigate to the folder that contains the up-to-date Terraform configuration files with an infrastructure plan.

   2. Run the command:

      terraform validate
      

      If there are errors in the configuration files, Terraform will point to them.

4. Confirm updating the resources.

   1. Run the command to view planned changes:

      terraform plan
      

      If the resource configuration descriptions are correct, the terminal will display a list of the resources to modify and their parameters. This is a test step. No resources are updated.

   2. If you are happy with the planned changes, apply them:

      1. Run the command:

         terraform apply
         

      2. Confirm the update of resources.

      3. Wait for the operation to complete.

For more information, see the Terraform provider documentation.

resource "yandex_mdb_mongodb_cluster" "<cluster_name>" {
  ...
  timeouts {
    create = "1h30m" # An hour and a half
    update = "2h"    # Two hours
  }
}

To update the MongoDB version, use the update REST API method for the Cluster resource or the ClusterService/Update gRPC API call and provide the following in the request:

• Cluster ID in the clusterId parameter. To find out the cluster ID, get a list of clusters in the folder.
• MongoDB version which you are upgrading to, in the configSpec.version parameter.
• List of settings to update (in this case, configSpec.version), in the updateMask parameter.

After the upgrade, all MongoDB features that are not backward-compatible with the previous version will be disabled. To remove this restriction, use the update API method and provide the new version number in the call using the configSpec.featureCompatibilityVersion property.

Learn more about backward compatibility in the MongoDB documentation.