Skip to content

Commit f019e28

Browse files
author
Sam Kleinman
committed
updates and clarifications to upgrade process
1 parent bec9c3f commit f019e28

File tree

1 file changed

+15
-10
lines changed

1 file changed

+15
-10
lines changed

source/release-notes/2.4-upgrade.txt

Lines changed: 15 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -26,8 +26,16 @@ This procedure applies only to upgrades from version 2.2. Earlier
2626
versions of MongoDB do not correctly handle epochs.
2727

2828
While the upgrade is in progress, you cannot make changes to the
29-
collection metadata. For example, you cannot add shards, drop databases,
30-
or drop collections, nor make other metadata changes.
29+
collection metadata. For example, you cannot perform operations that
30+
add shards, drop databases, or drop collections, or modify the
31+
metadata in any other way.
32+
33+
.. warning::
34+
35+
Once you upgrade to 2.4 and complete the upgrade procedure **do
36+
not** use 2.0 :program:`mongod` and :program:`mongos` processes in
37+
your cluster. 2.0 process may re-introduce old metadata formats
38+
into cluster metadata.
3139

3240
Sharded Cluster Upgrade Procedure
3341
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -88,13 +96,10 @@ procedure.
8896
option.
8997

9098
Once you have upgraded, *do not* introduce version 2.0 MongoDB
91-
processes into the sharded cluster. This can introduce in
92-
metadata problems.
93-
94-
.. is the following true?
95-
96-
This metadata change and the upgrade mechanism will help prevent
97-
errors caused by cross-version incompatibilities.
99+
processes into the sharded cluster. This can reintroduce old metadata
100+
formats into the config servers. The metadata change made by this
101+
upgrade process will help prevent errors caused by cross-version
102+
incompatibilities in future versions of MongoDB.
98103

99104
.. _upgrade-cluster-resync:
100105

@@ -164,7 +169,7 @@ To resync the config servers:
164169

165170
mongo <2.2 mongos port>
166171

167-
Then, use the following operation to reset the balancer process:
172+
Then, use the following operation to reset the upgrade process:
168173

169174
.. code-block:: javascript
170175

0 commit comments

Comments
 (0)