@@ -80,41 +80,33 @@ procedure:
80
80
Upgrading a Shard Cluster
81
81
~~~~~~~~~~~~~~~~~~~~~~~~~
82
82
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>`,
85
86
86
87
- Upgrade all :program:`mongos` instances *first*, in any order.
87
88
88
89
- 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.
92
94
93
- - Upgrade all remaining cluster components. Use the :ref:`upgrade
95
+ - Upgrade all remaining cluster components, using the :ref:`upgrade
94
96
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.
98
98
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.
104
100
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.
106
104
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::
111
106
112
- - upgrade the :program:`mongos`, if using authentication,
107
+ Balancing does not currently work in *mixed* 2.0.x and 2.2.0 deployments.
113
108
114
- - upgrade all :program:`mongod` instances, including all shard
115
- components and configuration instances in the cluster, and
116
109
117
- - re-enable the balancer.
118
110
119
111
Changes
120
112
-------
0 commit comments