Yandex Cloud
Documentation
PresentationContact UsTry it for free
© 2026 Direct Cursus Technology L.L.C.
Yandex StoreDoc
  • Getting started
    • Resource relationships
    • Networking in Yandex StoreDoc
    • Quotas and limits
    • Storage in Yandex StoreDoc
    • Backups
    • Replication
    • High availability clusters
    • Sharding
    • Host types
    • Users and roles
    • Maintenance
    • Supported clients
    • Yandex StoreDoc settings
    • Yandex StoreDoc versioning policy
  • Access management
  • Inspections and recommendations
  • Pricing policy
  • Terraform reference
  • Monitoring metrics
  • Audit Trails events
  • Public materials
  • Release notes

In this article:

  • Maintenance window
  • Maintenance workflow
  • Non-sharded cluster
  • Sharded cluster
  1. Concepts
  2. Maintenance

Maintenance in Yandex StoreDoc

Written by
Yandex Cloud
Updated at October 6, 2026
View in Markdown
  • Maintenance window
  • Maintenance workflow
    • Non-sharded cluster
    • Sharded cluster

Maintenance includes:

  • Automatic installation of DBMS updates and patches for hosts (including for stopped clusters).
  • Scheduled automatic storage expansion.
  • Other maintenance activities.

A major DBMS version update is not part of maintenance. For more information about migrating between versions, see Yandex StoreDoc version upgrade.

Maintenance windowMaintenance window

You can set your preferred maintenance start time using the Yandex Cloud interfaces (management console, CLI, Terraform, and API) when creating or updating a cluster:

  • The At any time option (default) allows performing maintenance at any time.
  • The By schedule option allows you to select the day of the week and UTC time interval for the maintenance. For example, you can choose the cluster's least busy time. Both active and stopped clusters are subject to maintenance operations. Maintenance operations may include DBMS updates, patches, etc.

In the management console, you select the maintenance start time as an hour interval. In other interfaces, you specify this interval by its sequence number, from 1 to 24.

For example, to start maintenance in the interval from 00:00 to 01:00, put 1; from 04:00 to 05:00, 5.

Note

To view maintenance task information, you need the managed-mongodb.maintenanceTask.viewer role or higher.

To manage maintenance tasks, you need the managed-mongodb.maintenanceTask.editor role or higher.

Maintenance workflowMaintenance workflow

The Yandex StoreDoc cluster maintenance workflow depends on the number of hosts and sharding.

Non-sharded clusterNon-sharded cluster

The maintenance procedure is as follows:

  1. Secondary replicas undergo maintenance one by one. Such hosts are queued randomly. If a secondary replica needs to be restarted during maintenance, it will become unavailable until maintenance is complete.
  2. The master host undergoes maintenance. If the master requires a restart during maintenance and becomes unavailable, one of the secondary replicas will take over its role. A single-host cluster will be unavailable during its maintenance. If your write request returns an error, repeat it later.

Sharded clusterSharded cluster

In sharded clusters, the maintenance procedure is as follows:

  1. The load balancer stops.

  2. Hosts with the MONGOINFRA role for standard sharding or MONGOCFG for advanced sharding undergo maintenance one by one. For hosts with the MONGOINFRA role, only MongoCFG is subject to maintenance. Host maintenance is run in the same way as it would in a non-sharded cluster:

    1. Secondary replicas undergo maintenance one by one. Such hosts are queued randomly. If a secondary replica needs to be restarted during maintenance, it will become unavailable until maintenance is complete.
    2. The master host undergoes maintenance. If the master requires a restart during maintenance and becomes unavailable, one of the secondary replicas will take over its role.
  3. Shards undergo maintenance one by one, in ascending order by shard number. Host maintenance in each shard is the same as in non-sharded clusters:

    1. Secondary replicas undergo maintenance one by one. Such hosts are queued randomly. If a secondary replica needs to be restarted during maintenance, it will become unavailable until maintenance is complete.
    2. The master host undergoes maintenance. If the master requires a restart during maintenance and becomes unavailable, one of the secondary replicas will take over its role. A single-host shard will be unavailable during its maintenance. If your write request returns an error, repeat it later.
  4. Hosts with the MONGOINFRA role for standard sharding or MONGOS for advanced sharding undergo maintenance one by one. For hosts with the MONGOINFRA role, MongoS is subject to maintenance. Such hosts are queued randomly. Any host that requires a restart during maintenance will be unavailable until maintenance is complete.

  5. The load balancer resumes its operation.

Was the article helpful?

Previous
Users and roles
Next
Supported clients
© 2026 Direct Cursus Technology L.L.C.