@@ -80,41 +80,33 @@ procedure:
8080Upgrading 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
119111Changes
120112-------
0 commit comments