This repository was archived by the owner on May 1, 2025. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 39
DOCSP-47695-remove-live-upgrade #628
Merged
Merged
Changes from 5 commits
Commits
Show all changes
8 commits
Select commit
Hold shift + click to select a range
c280d67
DOCSP-47695-remove-live-upgrade
ltran-mdb2 806aedc
DOCSP-47695-remove-live-upgrade
ltran-mdb2 ab3e0e1
DOCSP-47695-remove-live-upgrade
ltran-mdb2 30632ac
DOCSP-47695 adding noindex page
ltran-mdb2 2e13fce
DOCSP-47695 adding noindex page
ltran-mdb2 cb5936d
DOCSP-47695 Maria comment
ltran-mdb2 309d745
DOCSP-47695 copy edits
ltran-mdb2 922de04
Merge branch 'master' into DOCSP-47695
ltran-mdb2 File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,83 @@ | ||
:orphan: | ||
|
||
.. meta:: | ||
:robots: noindex, nosnippet | ||
|
||
.. _c2c-live-upgrade: | ||
|
||
============= | ||
Live Upgrades | ||
============= | ||
|
||
.. default-domain:: mongodb | ||
|
||
.. contents:: On this page | ||
:local: | ||
:backlinks: none | ||
:depth: 2 | ||
:class: singlecol | ||
|
||
.. important:: | ||
|
||
Starting in version 1.11.0, ``mongosync`` does not support live upgrades. To | ||
upgrade to the most recent version, see :ref:`c2c-release-version-numbers`. | ||
|
||
|
||
Starting in ``mongosync`` 1.7.0, you can live upgrade ``mongosync`` without | ||
restarting data synchronization operations from the beginning. | ||
|
||
After the live upgrade, ``mongosync`` continues operations that were in | ||
progress before the upgrade. | ||
|
||
To live upgrade ``mongosync``, perform these steps: | ||
|
||
Steps | ||
----- | ||
|
||
.. procedure:: | ||
:style: normal | ||
|
||
.. step:: (Optional) Pause the ``mongosync`` processes | ||
|
||
To pause ``mongosync``, run :ref:`c2c-api-pause` on each running | ||
``mongosync`` process. | ||
|
||
You can resume the ``mongosync`` processes later from the paused | ||
state, as shown in the final step. | ||
|
||
.. tip:: | ||
|
||
If you don't want to immediately resume data synchronization | ||
operations after live upgrade, consider pausing the | ||
``mongosync`` processes. This is useful if you're coordinating | ||
operations from multiple ``mongosync`` processes. | ||
|
||
.. step:: Stop the ``mongosync`` processes | ||
|
||
Use your operating system to stop each running ``mongosync`` | ||
process. To stop a process, see your operating system | ||
documentation for the specific steps. | ||
|
||
.. step:: Download and install the new ``mongosync`` binaries | ||
|
||
To download and install the new ``mongosync`` binaries, see | ||
:ref:`download and install mongosync <c2c-install>`. | ||
|
||
.. step:: Initialize the ``mongosync`` processes | ||
|
||
To initialize the ``mongosync`` processes, see | ||
:ref:`Quickstart <c2c-quickstart>`. During initialization after a | ||
live upgrade, ``mongosync`` updates the persistent metadata. | ||
|
||
.. step:: Resume the ``mongosync`` processes | ||
|
||
If you paused any ``mongosync`` processes earlier in the optional | ||
first step, run :ref:`c2c-api-resume` on all ``mongosync`` | ||
processes. | ||
|
||
If a data synchronization operation was already in progress before the | ||
live upgrade, new features added in the latest ``mongosync`` version may | ||
not all be supported after the live upgrade. Performance improvements | ||
and bug fixes are always supported after the live upgrade. For more | ||
information on the new features that might be supported after a live | ||
upgrade, see the :ref:`1.7.0-c2c-release-notes`. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would instead say something like, Live Upgrade to mongosync 1.11 onwards is not supported, due to expanded permissions required for mongosync 1.11.
Initially we didn't want to get into the specific versions but after further consideration I think it's necessary to avoid sounding like we've gotten rid of Live Upgrade altogether. cc @ajayvijayakumar123 lmk if that messaging sounds good to you, thanks!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
yup sounds good!