Skip to content

Commit 697d15b

Browse files
authored
DOCSP-28521 Sharded Backup Note (#2695)
* DOCSP-28521 Adds note for backing up sharded clusters * Fixes formatting * Fixes per Dave
1 parent 8b414a9 commit 697d15b

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
@@ -196,6 +196,8 @@ re-enable it:
196196
Disable Balancing During Backups
197197
--------------------------------
198198

199+
.. include:: /includes/fact-backup-shard
200+
199201
If MongoDB migrates a :term:`chunk` during a :doc:`backup
200202
</core/backups>`, you can end with an inconsistent snapshot
201203
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)