Skip to content

Commit 31a632c

Browse files
authored
DOCSP-28521 Sharded Backup Note (#2695) (#2716)
* DOCSP-28521 Adds note for backing up sharded clusters * Fixes formatting * Fixes per Dave
1 parent 0a0f42d commit 31a632c

File tree

3 files changed

+25
-1
lines changed

3 files changed

+25
-1
lines changed

source/includes/fact-backup-shard.rst

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
2+
.. note::
3+
4+
Disabling the balancer is only necessary when **manually** taking backups,
5+
either by calling :program:`mongodump` or scheduling a task that calls
6+
``mongodump`` at a specific time.
7+
8+
You do **not** have to disable the balancer when using coordinated backup
9+
and restore processes:
10+
11+
- `MongoDB Atlas <https://www.mongodb.com/cloud/atlas?tck=docs_server>`_
12+
13+
- `MongoDB Cloud Manager
14+
<https://www.mongodb.com/cloud/cloud-manager?tck=docs_server>`_
15+
16+
- `MongoDB Ops Manager
17+
<https://www.mongodb.com/products/ops-manager?tck=docs_server>`_
18+

source/tutorial/manage-sharded-cluster-balancer.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -199,6 +199,8 @@ re-enable it:
199199
Disable Balancing During Backups
200200
--------------------------------
201201

202+
.. include:: /includes/fact-backup-shard
203+
202204
If MongoDB migrates a :term:`chunk` during a :doc:`backup
203205
</core/backups>`, you can end with an inconsistent snapshot
204206
of your :term:`sharded cluster`. Never run a backup while the balancer is

source/tutorial/schedule-backup-window-for-sharded-clusters.txt

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,11 @@ distributing sharded data around the cluster, so that each
2222
However, when creating backups from a sharded cluster it is important
2323
that you disable the balancer while taking backups to ensure that no
2424
chunk migrations affect the content of the backup captured by the
25-
backup procedure. Using the procedure outlined in the section
25+
backup procedure.
26+
27+
.. include:: /includes/fact-backup-shard
28+
29+
Using the procedure outlined in the section
2630
:ref:`sharding-balancing-disable-temporarily` you can manually stop the
2731
balancer process temporarily. As an alternative, you can
2832
use the following procedure to define a balancing window so that the

0 commit comments

Comments
 (0)