Skip to content

Commit bfc29d7

Browse files
author
matulef
committed
Update source/release-notes/2.2.txt
Improve explanation for sharded cluster upgrade.
1 parent 2f0bf66 commit bfc29d7

File tree

1 file changed

+15
-23
lines changed

1 file changed

+15
-23
lines changed

source/release-notes/2.2.txt

Lines changed: 15 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -80,41 +80,33 @@ procedure:
8080
Upgrading a Shard Cluster
8181
~~~~~~~~~~~~~~~~~~~~~~~~~
8282

83-
If your cluster uses authentication, use the following upgrade
84-
procedure:
83+
We recommend the following upgrade procedure for a sharded cluster:
84+
85+
- :ref:`disable the balancer <sharding-balancing-disable-temporally>`,
8586

8687
- Upgrade all :program:`mongos` instances *first*, in any order.
8788

8889
- Upgrade all of the :program:`mongod` config server instances *one at
89-
a time*. When you have *fewer* than *three* config servers active,
90-
the cluster metadata will be read-only which will prevent (and abort)
91-
all chunk migrations and chunk splits.
90+
a time* using the :ref:`stand alone <2.2-upgrade-standalone>` procedure.
91+
When you have *fewer* than *three* config servers active, the cluster
92+
metadata will be read-only which will prevent (and abort)
93+
all chunk migrations and chunk splits.
9294

93-
- Upgrade all remaining cluster components. Use the :ref:`upgrade
95+
- Upgrade all remaining cluster components, using the :ref:`upgrade
9496
procedure for replica sets <2.2-upgrade-replica-set>` for each of
95-
the shards and the :ref:`stand alone <2.2-upgrade-standalone>`
96-
procedure for each of the config servers. You may upgrade the
97-
components of your cluster in any order.
97+
the shards.
9898

99-
If your cluster *does not* use authentication, you may upgrade the
100-
components of the cluster in any order, using the :ref:`upgrade
101-
procedure for replica sets <2.2-upgrade-replica-set>` for each of the
102-
shards and the :ref:`stand alone <2.2-upgrade-standalone>` procedure
103-
for each of the config servers.
99+
- re-enable the balancer.
104100

105-
.. note::
101+
If your cluster uses authentication, you must upgrade the components in
102+
the order above. If your cluster does not use authentication, you can
103+
upgrade the mongos instances, config servers, and shards in any order.
106104

107-
Balancing does not work in *mixed* 2.0 and 2.2 deployments. For the
108-
best results:
109-
110-
- :ref:`disable the balancer <sharding-balancing-disable-temporally>`,
105+
.. note::
111106

112-
- upgrade the :program:`mongos`, if using authentication,
107+
Balancing does not currently work in *mixed* 2.0.x and 2.2.0 deployments.
113108

114-
- upgrade all :program:`mongod` instances, including all shard
115-
components and configuration instances in the cluster, and
116109

117-
- re-enable the balancer.
118110

119111
Changes
120112
-------

0 commit comments

Comments
 (0)