Skip to content

Commit f729f75

Browse files
DOCSP-44009 Backport DOCSP-43363 EOL MongoDB 4.2 and below in Ops Manager 8.0 (#368) (#416)
<!-- Add a description of your PR here (optional) --> - [DOCSP-44009](https://jira.mongodb.org/browse/DOCSP-44009) ### Self-Review Checklist - [ ] [Define](https://wiki.corp.mongodb.com/display/DE/Taxonomy+tagging+instructions) taxonomy [values](https://wiki.corp.mongodb.com/display/DE/Docs+Taxonomy) at top of page. - [ ] Add genre facets (tutorial or reference), as in this [example PR](10gen/cloud-docs#5042). - [ ] Add programmingLanguage (if necessary). - [ ] Add meta keywords (if necessary). - [ ] Resolve any new warnings or errors in the build. - [ ] Proofread for spelling and grammatical errors. - [ ] Check staging for rendering issues. - [ ] Confirm links are working. --------- Co-authored-by: John Williams <[email protected]>
1 parent a0311b6 commit f729f75

File tree

65 files changed

+421
-1952
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

65 files changed

+421
-1952
lines changed

config/redirects

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1077,3 +1077,6 @@ raw: ${bucket_prefix}/v3.5/troubleshooting -> ${base}/master/troubleshooting/
10771077
[v5.0-*]: ${bucket_prefix}/${version}/reference/api/whitelist-get-for-current-user -> ${base}/${version}/reference/api/access-list-get-for-current-user
10781078
[v5.0-*]: ${bucket_prefix}/${version}/reference/api/whitelist-get-for-ip-address -> ${base}/${version}/reference/api/access-list-get-for-ip-address
10791079
[v5.0-*]: ${bucket_prefix}/${version}/reference/api/whitelist -> ${base}/${version}/reference/api/access-list
1080+
1081+
# DOCSP-43363 EOL of MDB versions less than and equal to v4.2
1082+
[v8.0-*]: ${bucket_prefix}/${version}/reference/api/checkpoints -> ${base}/${version}/reference/api/nav/backup-and-restore

source/admin/backup/resource-usage-page.txt

Lines changed: 0 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -26,16 +26,6 @@ basis for all projects for which you enabled backup.
2626
* - Column Title
2727
- Content
2828

29-
* - HEAD Usage
30-
- Displays the following statistics for the :opsmgr:`head database </reference/glossary/#std-term-head-database>`
31-
of any backup job with |fcv-link| 4.0 or earlier:
32-
33-
- :dbcommand:`Data Size <dbStats>`
34-
- :dbcommand:`Storage Size <dbStats>`
35-
- File Size: The sum of the uncompressed size of each file in
36-
the HEAD database
37-
- :manual:`Storage Engine </core/storage-engines>`
38-
3929
* - Oplog Receiving (last 24 hours)
4030
- Displays statistics for oplog throughput over the past 24 hours.
4131

source/application.txt

Lines changed: 49 additions & 120 deletions
Original file line numberDiff line numberDiff line change
@@ -77,39 +77,14 @@ snapshots of data from the MongoDB processes you have specified.
7777
Backup Workflow
7878
~~~~~~~~~~~~~~~
7979

80-
Backups rely upon the
81-
:manual:`MongoDB version compatibility</reference/command/setFeatureCompatibilityVersion>`
82-
of your database.
83-
This Feature Compatibility Version ranges from the current version to
84-
one version earlier. For MongoDB 4.2, the FCV can be ``4.0`` or
85-
``4.2``.
80+
Backups rely upon the :manual:`MongoDB version compatibility
81+
</reference/command/setFeatureCompatibilityVersion>` of your database.
82+
For MongoDB 4.4, the FCV can be ``4.2`` or ``4.4``.
8683

87-
.. tabs::
84+
.. include:: /includes/backup/wtchk-process-overview-main-om.rst
8885

89-
.. tab:: FCV 4.2 or later
90-
:tabid: fcv42
91-
92-
.. include:: /includes/backup/wtchk-process-overview-main-om.rst
93-
94-
The {+mdbagent+} uses WiredTiger's incremental backup cursor to
95-
capture the incremental changes.
96-
97-
.. tab:: FCV 4.0 or earlier
98-
:tabid: fcv40
99-
100-
Once backup has started, |mms| backs up the data as an ongoing
101-
and continuous process. This process continues creating snapshots
102-
as long as the head database remains synchronized with the
103-
database.
104-
105-
.. include:: /includes/backup/legacy-process-overview-main-om.rst
106-
107-
The {+mdbagent+} then tails each replica set's :manual:`oplog </reference/glossary/#std-term-oplog>`
108-
to maintain on disk a standalone database, called a
109-
:opsmgr:`head database </reference/glossary/#std-term-head-database>`. |mms| maintains one
110-
head database for each backed-up replica set. The head
111-
database stays consistent with the original :manual:`primary </reference/glossary/#std-term-primary>` up
112-
to the last oplog that the {+mdbagent+} supplies.
86+
The {+mdbagent+} uses WiredTiger's incremental backup cursor to capture
87+
the incremental changes.
11388

11489
The backup process works in this manner regardless of how snapshots are
11590
stored.
@@ -121,57 +96,47 @@ Backup takes and stores snapshots based on a user-defined
12196
:ref:`snapshot retention policy <snapshot-frequency-and-retention>`.
12297
Sharded cluster snapshots temporarily stop the balancer. The snapshots
12398
then can insert a marker token into all shards and config servers in
124-
the cluster. |mms| takes a :manual:`snapshot </reference/glossary/#std-term-snapshot>` when the marker tokens
99+
the cluster. |mms| takes a :manual:`snapshot
100+
</reference/glossary/#std-term-snapshot>` when the marker tokens
125101
appear in the snapshot data.
126102

127-
.. tabs::
128-
:hidden:
129-
130-
.. tab:: FCV 4.2 or later
131-
:tabid: fcv42
132-
133-
|mms| can back up data as a full or incremental backup. |mms|
134-
requires a full backup:
135-
136-
- For your first backup.
137-
- After a snapshot has been deleted.
138-
- If the blockstore block size has been changed.
103+
How much storage capacity you need depends on both the number of
104+
snapshots and the type of snapshot storage you choose. The following
105+
table outlines the differences in snapshot stores:
139106

140-
Incremental backups reduce network transfer and storage costs.
107+
.. list-table::
108+
:header-rows: 1
109+
:widths: 25 75
141110

142-
.. tab:: FCV 4.0 or earlier
143-
:tabid: fcv40
111+
* - Snapshot Store
112+
- Description
144113

145-
How much storage capacity you need depends on both the number
146-
of snapshots and the type of snapshot storage you choose. The
147-
following table outlines the differences in snapshot stores:
114+
* - MongoDB blockstore
115+
- Only the differences between each successive :manual:`snapshot
116+
</reference/glossary/#std-term-snapshot>` are stored. Compression
117+
and block-level :term:`deduplication` reduce the size of snapshot
118+
data.
148119

149-
.. list-table::
150-
:header-rows: 1
151-
:widths: 25 75
120+
* - |aws| |s3| bucket
121+
- Only the differences between each successive :manual:`snapshot
122+
</reference/glossary/#std-term-snapshot>` are stored. Compression
123+
and block-level :term:`deduplication` reduce the size of snapshot
124+
data.
152125

153-
* - Snapshot Store
154-
- Description
126+
* - |s3| bucket
127+
- Only the differences between each successive :manual:`snapshot
128+
</reference/glossary/#std-term-snapshot>` are stored. Compression
129+
and block-level :term:`deduplication` reduce the size of snapshot
130+
data.
155131

156-
* - MongoDB blockstore
157-
- Only the differences between each successive
158-
:manual:`snapshot </reference/glossary/#std-term-snapshot>` are stored. Compression and
159-
block-level :term:`deduplication` reduce the size of
160-
snapshot data.
132+
All snapshots represent a full backup. |mms| can back up data as a full
133+
or incremental backup. |mms| requires a full backup:
161134

162-
* - |aws| |s3| bucket
163-
- Only the differences between each successive
164-
:manual:`snapshot </reference/glossary/#std-term-snapshot>` are stored. Compression and
165-
block-level :term:`deduplication` reduce the size of
166-
snapshot data.
135+
- For your first backup.
136+
- After a snapshot has been deleted.
137+
- If the blockstore block size has been changed.
167138

168-
* - |s3| bucket
169-
- Only the differences between each successive
170-
:manual:`snapshot </reference/glossary/#std-term-snapshot>` are stored. Compression and
171-
block-level :term:`deduplication` reduce the size of
172-
snapshot data.
173-
174-
All snapshots represent a full backup.
139+
Incremental backups reduce network transfer and storage costs.
175140

176141
To learn more about how to configure backups, see
177142
:doc:`Backup Configuration Options </core/backup-preparations>`.
@@ -184,61 +149,25 @@ Restore Data
184149
Backup can restore data from a complete scheduled snapshot or from
185150
a selected point between snapshots.
186151

187-
.. tabs::
188-
:hidden:
189-
190-
.. tab:: FCV 4.2 or later
191-
:tabid: fcv42
192-
193-
You can restore :manual:`sharded clusters </reference/glossary/#std-term-sharded-cluster>` and
194-
:manual:`replica sets </reference/glossary/#std-term-replica-set>` from selected points in time.
195-
196-
.. tab:: FCV 4.0 or earlier
197-
:tabid: fcv40
198-
199-
- For :manual:`sharded clusters </reference/glossary/#std-term-sharded-cluster>`, you can restore
200-
from :ref:`checkpoints <checkpoint>` between snapshots.
201-
202-
- For :manual:`replica sets </reference/glossary/#std-term-replica-set>`, you can restore from
203-
selected points in time.
152+
You can restore :manual:`sharded clusters
153+
</reference/glossary/#std-term-sharded-cluster>` and :manual:`replica
154+
sets </reference/glossary/#std-term-replica-set>` from selected points
155+
in time.
204156

205157
When you restore from a :manual:`snapshot </reference/glossary/#std-term-snapshot>`, |mms| reads directly from
206158
the snapshot storage. You can restore the snapshot:
207159

208160
- To another cluster.
209161
- To download the snapshot files from an |https| link.
210162

211-
.. tabs::
212-
:hidden:
213-
214-
.. tab:: FCV 4.2 or later
215-
:tabid: fcv42
216-
217-
When you restore from a point in time, |mms| does the following:
163+
When you restore from a point in time, |mms| does the following:
218164

219-
1. Restores a full snapshot from the snapshot storage.
220-
#. Applies stored :manual:`oplogs </reference/glossary/#std-term-oplog>` until it reaches the
221-
specified point.
222-
#. Delivers the snapshot and oplog updates using the same
223-
|https| mechanisms.
224-
225-
You can configure how much of the oplog you want to keep per
226-
backup. This affects the amount of time a point-in-time restore
227-
can cover.
228-
229-
.. tab:: FCV 4.0 or earlier
230-
:tabid: fcv40
231-
232-
When you restore from a checkpoint or point in time, |mms| does the following:
233-
234-
1. Restores a full snapshot from the snapshot storage.
235-
#. Applies stored :manual:`oplogs </reference/glossary/#std-term-oplog>` until it reaches the
236-
specified point.
237-
#. Delivers the snapshot and oplog updates using the same |https| mechanisms.
238-
To enable checkpoints, see :ref:`enable-cluster-checkpoints`.
239-
240-
You can configure how much of the oplog you want to keep per
241-
backup. This affects how much time a checkpoint and
242-
point-in-time restore can cover.
165+
1. Restores a full snapshot from the snapshot storage.
166+
#. Applies stored :manual:`oplogs </reference/glossary/#std-term-oplog>`
167+
until it reaches the specified point.
168+
#. Delivers the snapshot and oplog updates using the same |https| mechanisms.
169+
170+
You can configure how much of the oplog you want to keep per backup.
171+
This affects the amount of time a point-in-time restore can cover.
243172

244173
.. include:: /includes/extracts/toc-application-introduction.rst

source/core/backup-overview.txt

Lines changed: 25 additions & 102 deletions
Original file line numberDiff line numberDiff line change
@@ -11,25 +11,10 @@ Backup Process
1111
:class: singlecol
1212

1313
Backups depend upon which :manual:`version of MongoDB your database is
14-
compatible </reference/command/setFeatureCompatibilityVersion>`. This
15-
Feature Compatibility Version ranges from the current version to one
16-
version earlier. For MongoDB 4.2, the FCV can be ``4.0`` or ``4.2``.
14+
compatible </reference/command/setFeatureCompatibilityVersion>`. For
15+
MongoDB 4.4, the FCV can be ``4.2`` or ``4.4``.
1716

18-
.. tabs::
19-
20-
.. tab:: FCV 4.2 or later
21-
:tabid: fcv42
22-
23-
.. include:: /includes/backup/wtchk-process-overview.rst
24-
25-
.. tab:: FCV 4.0 or earlier
26-
:tabid: fcv40
27-
28-
Once backup has started, |mms| backs up the data as a ongoing and
29-
continuous process. This process continues creating snapshots as
30-
long as the head database remains synchronized with the database.
31-
32-
.. include:: /includes/backup/legacy-process-overview.rst
17+
.. include:: /includes/backup/wtchk-process-overview.rst
3318

3419
.. _backup-stages:
3520

@@ -45,66 +30,33 @@ Operational States
4530

4631
The following table lists the states of a backup job:
4732

48-
.. tabs::
49-
:hidden:
50-
51-
.. tab:: FCV 4.2 or later
52-
:tabid: fcv42
53-
54-
.. list-table::
55-
:widths: 60 20 20
56-
:header-rows: 1
57-
58-
* - State
59-
- Retain Old Snapshots
60-
- Create New Snapshots
61-
62-
* - ``Active``
63-
- Yes
64-
- Yes
65-
66-
* - ``Stopped``
67-
- Yes
68-
- No
69-
70-
* - ``Inactive``
71-
- No
72-
- No
73-
74-
* - ``Misconfigured``
75-
- Yes
76-
- No
77-
78-
.. note::
33+
.. list-table::
34+
:widths: 60 20 20
35+
:header-rows: 1
7936

80-
The ``Misconfigured`` state applies only to :ref:`regional-backup`.
37+
* - State
38+
- Retain Old Snapshots
39+
- Create New Snapshots
8140

82-
.. tab:: FCV 4.0 or earlier
83-
:tabid: fcv40
41+
* - ``Active``
42+
- Yes
43+
- Yes
8444

85-
.. list-table::
86-
:widths: 20 27 27 26
87-
:header-rows: 1
45+
* - ``Stopped``
46+
- Yes
47+
- No
8848

89-
* - State
90-
- Retain Old Snapshots
91-
- Create New Snapshots
92-
- Apply Oplogs
49+
* - ``Inactive``
50+
- No
51+
- No
9352

94-
* - ``Active``
95-
- Yes
96-
- Yes
97-
- Yes
53+
* - ``Misconfigured``
54+
- Yes
55+
- No
9856

99-
* - ``Stopped``
100-
- Yes
101-
- No
102-
- No
57+
.. note::
10358

104-
* - ``Inactive``
105-
- No
106-
- No
107-
- No
59+
The ``Misconfigured`` state applies only to :ref:`regional-backup`.
10860

10961
Change Operational States
11062
~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -113,18 +65,7 @@ Once backup jobs are active for a :opsmgr:`project </reference/glossary/#std-ter
11365
further intervention until they are stopped or terminated. The operator
11466
can change the state of a backup in the following ways:
11567

116-
.. tabs::
117-
:hidden:
118-
119-
.. tab:: FCV 4.2 or later
120-
:tabid: fcv42
121-
122-
.. include:: /includes/backup/wtchk-process-change-op-state.rst
123-
124-
.. tab:: FCV 4.0 or earlier
125-
:tabid: fcv40
126-
127-
.. include:: /includes/backup/legacy-process-change-op-state.rst
68+
.. include:: /includes/backup/wtchk-process-change-op-state.rst
12869

12970
.. _backup-initial-sync:
13071

@@ -133,25 +74,7 @@ Backup Process Flows
13374

13475
Once created, a backup job goes through the following process flow:
13576

136-
.. tabs::
137-
:hidden:
138-
139-
140-
.. tab:: FCV 4.2 or later
141-
:tabid: fcv42
142-
143-
.. include:: /includes/backup/wtchk-process-initial-backup.rst
144-
145-
.. tab:: FCV 4.0 or earlier
146-
:tabid: fcv40
147-
148-
**Initial Backup**
149-
150-
.. include:: /includes/backup/legacy-process-initial-backup.rst
151-
152-
**Subsequent Backups**
153-
154-
.. include:: /includes/backup/legacy-process-subsequent-backup.rst
77+
.. include:: /includes/backup/wtchk-process-initial-backup.rst
15578

15679
.. _regional-backup:
15780

0 commit comments

Comments
 (0)