@@ -242,17 +242,14 @@ Downgrade Procedure
242242
243243 mongod --dbpath </path-to-data-folder>
244244
245- To learn more about starting a ``mongod`` process, see
246- :ref:`start-mongod-processes`.
247-
248245 .. step:: Wait for the member to enter the ``SECONDARY`` state.
249246
250247 Before downgrading the next secondary, wait for the
251248 member to recover to the ``SECONDARY`` state. To check
252249 the member's state, use the :method:`rs.status()`
253250 method in :binary:`~bin.mongosh`.
254251
255- .. step:: Repeat to downgrade for each secondary member.
252+ .. step:: Repeat the previous steps to downgrade each secondary member.
256253
257254 .. step:: Downgrade the shard arbiter, if any.
258255
@@ -297,9 +294,6 @@ Downgrade Procedure
297294
298295 mongod --dbpath </path-to-mongodb-datafiles>
299296
300- To learn more about starting a ``mongod`` process, see
301- :ref:`start-mongod-processes`.
302-
303297 .. step:: Wait for the member to enter the ``ARBITER`` state.
304298
305299 Before downgrading the primary, wait for the member
@@ -314,8 +308,9 @@ Downgrade Procedure
314308
315309 .. step:: Step down the primary.
316310
317- In :binary:`~bin.mongosh`, use :method:`rs.stepDown()` to step
318- down the primary and force the normal failover procedure.
311+ In :binary:`~bin.mongosh`, use :method:`rs.stepDown()`
312+ to step down the primary and start an election for a
313+ new primary:
319314
320315 .. code-block:: javascript
321316
@@ -334,7 +329,7 @@ Downgrade Procedure
334329
335330 .. step:: Shut down the former primary member.
336331
337- To shutdown the former primary, connect to the
332+ To shut down the former primary, connect to the
338333 deployment using :binary:`mongosh` and run the
339334 following command:
340335
@@ -350,7 +345,97 @@ Downgrade Procedure
350345
351346 mongod --dbpath </path-to-mongodb-datafiles>
352347
353- To learn more about starting a ``mongod`` process, see
354- :ref:`start-mongod-processes`.
355-
356348 .. step:: Repeat for the remaining shards.
349+
350+ .. step:: Downgrade the config servers.
351+
352+ .. procedure::
353+ :style: connected
354+
355+ .. step:: Downgrade the shard's secondary members of the
356+ config servers replica set (CSRS) one at a time:
357+
358+ .. procedure::
359+ :style: normal
360+
361+ .. step:: Shut down the secondary.
362+
363+ Connect to the secondary and run the following command:
364+
365+ .. code-block:: javascript
366+
367+ db.adminCommand( { shutdown: 1 } )
368+
369+ .. step:: Restart the member.
370+
371+ To start a ``mongod`` process, run the following command:
372+
373+ .. code-block:: javascript
374+
375+ mongod --dbpath </path-to-data-folder>
376+
377+ .. step:: Wait for the member to enter the ``SECONDARY`` state.
378+
379+ Before downgrading the next secondary, wait for the
380+ member to recover to the ``SECONDARY`` state. To check
381+ the member's state, use the :method:`rs.status()`
382+ method in :binary:`~bin.mongosh`.
383+
384+ .. step:: Repeat the previous steps to downgrade each secondary member.
385+
386+ .. step:: Downgrade the config server primary.
387+
388+ .. procedure::
389+ :style: normal
390+
391+ .. step:: Step down the primary.
392+
393+ In :binary:`~bin.mongosh`, run :method:`rs.stepDown()`
394+ to step down the primary and start an election for a
395+ new primary:
396+
397+ .. code-block:: javascript
398+
399+ rs.stepDown()
400+
401+ .. step:: Verify that the primary has stepped down.
402+
403+ Run the following command:
404+
405+ .. code-block::
406+
407+ rs.status()
408+
409+ Verify that the primary has stepped down and another
410+ member has assumed the ``PRIMARY`` state.
411+
412+ .. step:: Shut down the former primary member.
413+
414+ To shut down the former primary, connect to the
415+ deployment using :binary:`mongosh` and run the
416+ following command:
417+
418+ .. code-block:: javascript
419+
420+ db.adminCommand( { shutdown: 1 } )
421+
422+ .. step:: Restart the :binary:`~bin.mongod` with the |oldversion| binary.
423+
424+ To start a ``mongod`` process, run the following command:
425+
426+ .. code-block:: javascript
427+
428+ mongod --dbpath </path-to-mongodb-datafiles>
429+
430+ .. step:: Re-enable the balancer.
431+
432+ After you downgrade all of the sharded cluster components, connect
433+ to a :binary:`~bin.mongos` and run the following command to
434+ re-enable the balancer:
435+
436+ .. code-block:: javascript
437+
438+ sh.startBalancer()
439+
440+ The :method:`sh.startBalancer()` method also enables auto-splitting
441+ for the sharded cluster.
0 commit comments