@@ -242,17 +242,14 @@ Downgrade Procedure
242
242
243
243
mongod --dbpath </path-to-data-folder>
244
244
245
- To learn more about starting a ``mongod`` process, see
246
- :ref:`start-mongod-processes`.
247
-
248
245
.. step:: Wait for the member to enter the ``SECONDARY`` state.
249
246
250
247
Before downgrading the next secondary, wait for the
251
248
member to recover to the ``SECONDARY`` state. To check
252
249
the member's state, use the :method:`rs.status()`
253
250
method in :binary:`~bin.mongosh`.
254
251
255
- .. step:: Repeat to downgrade for each secondary member.
252
+ .. step:: Repeat the previous steps to downgrade each secondary member.
256
253
257
254
.. step:: Downgrade the shard arbiter, if any.
258
255
@@ -297,9 +294,6 @@ Downgrade Procedure
297
294
298
295
mongod --dbpath </path-to-mongodb-datafiles>
299
296
300
- To learn more about starting a ``mongod`` process, see
301
- :ref:`start-mongod-processes`.
302
-
303
297
.. step:: Wait for the member to enter the ``ARBITER`` state.
304
298
305
299
Before downgrading the primary, wait for the member
@@ -314,8 +308,9 @@ Downgrade Procedure
314
308
315
309
.. step:: Step down the primary.
316
310
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:
319
314
320
315
.. code-block:: javascript
321
316
@@ -334,7 +329,7 @@ Downgrade Procedure
334
329
335
330
.. step:: Shut down the former primary member.
336
331
337
- To shutdown the former primary, connect to the
332
+ To shut down the former primary, connect to the
338
333
deployment using :binary:`mongosh` and run the
339
334
following command:
340
335
@@ -350,7 +345,97 @@ Downgrade Procedure
350
345
351
346
mongod --dbpath </path-to-mongodb-datafiles>
352
347
353
- To learn more about starting a ``mongod`` process, see
354
- :ref:`start-mongod-processes`.
355
-
356
348
.. 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