Skip to content

Commit 362494b

Browse files
authored
DOCSP-28521 Sharded Backup Note (#2695) (#2713)
* DOCSP-28521 Sharded Backup Note (#2695) * DOCSP-28521 Adds note for backing up sharded clusters * Fixes formatting * Fixes per Dave * Fixes build error
1 parent bc61412 commit 362494b

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.rst
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
@@ -23,7 +23,11 @@ distributing sharded data around the cluster, so that each
2323
However, when creating backups from a sharded cluster it is important
2424
that you disable the balancer while taking backups to ensure that no
2525
chunk migrations affect the content of the backup captured by the
26-
backup procedure. Using the procedure outlined in the section
26+
backup procedure.
27+
28+
.. include:: /includes/fact-backup-shard.rst
29+
30+
Using the procedure outlined in the section
2731
:ref:`sharding-balancing-disable-temporarily` you can manually stop the
2832
balancer process temporarily. As an alternative, you can
2933
use the following procedure to define a balancing window so that the balancer

0 commit comments

Comments
 (0)