Skip to content

Commit 2c6500b

Browse files
DOCSP-45626-include-note-related-to-pre-flight-failure-for-v4-2 (#779)
## Description The ticket requests to add additional info on resolving pre-flight checks failure when upgrading from v4.2, but there's an existing warning in the [Upgrade Ops Manager](https://www.mongodb.com/docs/ops-manager/current/tutorial/upgrade-ops-manager/) that states that "Ops Manager 8.0 doesn't support MongoDB 4.2 and earlier.": > Ops Manager 8.0 doesn't support MongoDB 4.2 and earlier. If you're using MongoDB 4.2 or earlier and want to upgrade to Ops Manager 8.0, you must upgrade to at least MongoDB 4.4. If you don't upgrade to at least MongoDB 4.4, Ops Manager fails [pre-flight checks](https://www.mongodb.com/docs/ops-manager/current/tutorial/resolve-pre-flight-check/#std-label-fix-local-mode-start-failure) and won't start. After upgrading to at least MongoDB 4.4, we still recommend that you upgrade to at least MongoDB 6.0 before upgrading to Ops Manager 8.0. I'm including the note in the [Resolve Pre-flight Check Failure](https://www.mongodb.com/docs/ops-manager/current/tutorial/resolve-pre-flight-check/) so that users are aware of the reason for failure and that they should be upgrading to at least v4.4. ## Jira Ticket - [DOCSP-45626](https://jira.mongodb.org/browse/DOCSP-45626) ## Staging - [STAGING](https://deploy-preview-779--docs-ops-manager.netlify.app/tutorial/resolve-pre-flight-check/) - [LATEST BUILD LOG](https://app.netlify.com/sites/docs-ops-manager/deploys/67d0807e0a9ea200082689f7) ### 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). - [x] Resolve any new warnings or errors in the build. - [x] Proofread for spelling and grammatical errors. - [x] Check staging for rendering issues. - [x] Confirm links are working.
1 parent f8c1a98 commit 2c6500b

File tree

4 files changed

+11
-2
lines changed

4 files changed

+11
-2
lines changed

source/includes/admonitions/warning/om8-manages-mdb-6-or-later.rst

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,8 @@
33
|onprem| 8.0 doesn't support MongoDB 4.2 and earlier. If you're using
44
MongoDB 4.2 or earlier and want to upgrade to |onprem| 8.0, you must
55
upgrade to at least MongoDB 4.4. If you don't upgrade to at least MongoDB 4.4,
6-
|onprem| fails :ref:`pre-flight checks <fix-local-mode-start-failure>` and won't start.
6+
|onprem| fails |pre-flight checks| and won't start.
77
After upgrading to at least MongoDB 4.4, we still recommend that you upgrade
8-
to at least MongoDB 6.0 before upgrading to |onprem| 8.0.
8+
to the :ref:`latest MongoDB version compatible <mongo-db-compatibility>`
9+
with |onprem| before upgrading to |onprem| 8.0.
910

source/reference/mongodb-compatibility.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
.. _mongo-db-compatibility:
2+
13
============================
24
MongoDB Compatibility Matrix
35
============================

source/tutorial/resolve-pre-flight-check.txt

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,10 @@ This tutorial outlines the steps to configure |onprem| temporarily to
2525
resolve the pre-flight check failure and return to :guilabel:`Local
2626
Mode` setting.
2727

28+
.. |pre-flight checks| replace:: pre-flight checks
29+
30+
.. include:: /includes/admonitions/warning/om8-manages-mdb-6-or-later.rst
31+
2832
Change Configuration File to Allow |onprem| to Start
2933
----------------------------------------------------
3034

source/tutorial/upgrade-ops-manager.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,8 @@ installation.
2222
Upgrade Path
2323
------------
2424

25+
.. |pre-flight checks| replace:: :ref:`pre-flight checks <fix-local-mode-start-failure>`
26+
2527
.. include:: /includes/admonitions/warning/om8-manages-mdb-6-or-later.rst
2628

2729
.. include:: /includes/upgrade-path-onprem-upgrade.rst

0 commit comments

Comments
 (0)