Skip to content

Commit 054532f

Browse files
authored
DOCSP-28521 Sharded Backup Note (#2695) (#2714)
* DOCSP-28521 Adds note for backing up sharded clusters * Fixes formatting * Fixes per Dave
1 parent f346b50 commit 054532f

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
@@ -207,6 +207,8 @@ re-enable it:
207207
Disable Balancing During Backups
208208
--------------------------------
209209

210+
.. include:: /includes/fact-backup-shard
211+
210212
If MongoDB migrates a :term:`chunk` during a :doc:`backup
211213
</core/backups>`, you can end with an inconsistent snapshot
212214
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 balancer

0 commit comments

Comments
 (0)