Skip to content

Commit c63ae7a

Browse files
authored
1 parent 06d77e2 commit c63ae7a

File tree

3 files changed

+62
-20
lines changed

3 files changed

+62
-20
lines changed

source/core/backup-preparations.txt

Lines changed: 58 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -84,8 +84,8 @@ Backup Method Features
8484
- MongoDB Blockstore
8585

8686
* - Snapshot Types
87-
- Complete [1]_
88-
- Complete [1]_
87+
- Complete *****
88+
- Complete *****
8989
- Many partial
9090
- Many partial
9191
- Many partial
@@ -132,20 +132,19 @@ Backup Method Features
132132
- Lower
133133
- Medium
134134

135-
.. [1]
136-
To perform an incremental backup to a
137-
:term:`File System Store`, the {+mdbagent+}
138-
slices each :manual:`storage engine </core/storage-engines/>`
139-
file in the path specified for backup into block(s) of
140-
data and transfers only changed block(s) to |onprem|.
141-
|onprem| creates a new :manual:`snapshot </reference/glossary/#std-term-snapshot>` from received
142-
block(s) and copies the remaining unchanged block(s)
143-
from the previous full backup snapshot. Each incremental
144-
backup snapshot stored to a file system saves
145-
network I/O. Each such backup snapshot contains a full
146-
copy of all required files from a backed up MongoDB
147-
deployment and does not :term:`de-duplicate <deduplication>`
148-
records.
135+
***** To perform an incremental backup to a
136+
:term:`File System Store`, the {+mdbagent+}
137+
slices each :manual:`storage engine </core/storage-engines/>`
138+
file in the path specified for backup into block(s) of
139+
data and transfers only changed block(s) to |onprem|.
140+
|onprem| creates a new :manual:`snapshot </reference/glossary/#std-term-snapshot>` from received
141+
block(s) and copies the remaining unchanged block(s)
142+
from the previous full backup snapshot. Each incremental
143+
backup snapshot stored to a file system saves
144+
network I/O. Each such backup snapshot contains a full
145+
copy of all required files from a backed up MongoDB
146+
deployment and does not :term:`de-duplicate <deduplication>`
147+
records.
149148

150149
.. note:: **When Do You Use a Particular Backup Method?**
151150

@@ -186,7 +185,45 @@ your database increases beyond 2 TB of uncompressed data:
186185

187186
.. include:: /includes/backup/fact-backup-with-blockstores.rst
188187

189-
.. include:: /includes/fact-backup-sizing-recommendation.rst
188+
These size recommendations are a best practice. They are not a
189+
limitation of the MongoDB database or |mms|.
190+
191+
Backup and restore can use large amounts of CPU, memory, storage,
192+
and network bandwidth.
193+
194+
.. example::
195+
196+
Your stated network throughput, such as 10 Gbps or 100 Gbps, is
197+
a *theoretical* maximum. That value doesn't account for sharing
198+
or throttling of network traffic.
199+
200+
Consider the following scenario:
201+
202+
- You want to back up a 2 TB database.
203+
- Your hosts support a 10 Gbps TCP connection from |mms| to its
204+
backup storage.
205+
- The network connection has very low packet loss and a low round
206+
trip delay time.
207+
208+
A *full* backup of your data would take *more than 30 hours to
209+
complete*. [#]_
210+
211+
This doesn't account for disk read and write speeds, which can be,
212+
at most, 3 Gbps reads and 1 Gbps writes for a single or mirrored
213+
NVMe storage device.
214+
215+
The time required to complete each successive incremental backup
216+
depends on write load.
217+
218+
If you :doc:`shard this database
219+
</tutorial/convert-replica-set-to-sharded-cluster>`
220+
into 4 shards, each shard runs its backup separately. This results
221+
in a backup that takes less than 8 hours to complete.
222+
223+
.. [#]
224+
These throughput figures were calculated using the `Network
225+
Throughput Calculator <https://wintelguy.com/wanperf.pl>`__ and
226+
assume no additional network compression.
190227

191228
.. _snapshot-frequency-and-retention:
192229

@@ -364,6 +401,10 @@ time across all shards for sharded clusters. This ensures that snapshots
364401
include all documents written to every shard and node as of the
365402
scheduled snapshot time.
366403

404+
.. important::
405+
406+
.. include:: /includes/fact-backup-standalone-restriction.rst
407+
367408
.. include:: /release-notes/release-advisories/advisories-v4.2-backup.rst
368409

369410
Shared File System

source/includes/fact-backup-sizing-recommendation.rst

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,4 +33,3 @@ and network bandwidth.
3333
into 4 shards, each shard runs its backup separately. This results
3434
in a backup that takes less than 8 hours to complete.
3535

36-
Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1-
Only sharded clusters or replica sets can be backed up. To back up a
2-
standalone :manual:`mongod </reference/program/mongod/#mongodb-binary-bin.mongod>` process, you must
1+
Sharded clusters and replica sets are the only deployment types you can back up if
2+
your databases run MongoDB FCV 4.2 and earlier. To back up a
3+
standalone :manual:`mongod </reference/program/mongod/#mongodb-binary-bin.mongod>` process
4+
running MongoDB FCV 4.2 or earlier, you must
35
:doc:`convert it to a single-member replica set </tutorial/convert-standalone-to-replica-set>`.

0 commit comments

Comments
 (0)