Skip to content

Commit 8d860aa

Browse files
(DOCSP-26781): Add missing sections to 6.0 downgrade sharded cluster procedure (#2212)
* (DOCSP-26781): Add missing sections to 6.0 downgrade sharded cluster procedure * wording * indentation * fix typos * wording
1 parent 17ec7d3 commit 8d860aa

File tree

1 file changed

+98
-13
lines changed

1 file changed

+98
-13
lines changed

source/release-notes/6.0-downgrade-sharded-cluster.txt

Lines changed: 98 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -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

Comments
 (0)