Skip to content

Commit e4bf5f8

Browse files
npentreljeff-allen-mongo
authored andcommitted
DOCS-14542: Update resharding related states
1 parent 778d07a commit e4bf5f8

File tree

3 files changed

+129
-139
lines changed

3 files changed

+129
-139
lines changed

source/reference/command/currentOp.txt

Lines changed: 28 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1272,7 +1272,8 @@ Output Fields
12721272
- Description
12731273

12741274
* - ``unused``
1275-
- The resharding operation is about to start.
1275+
- The resharding operation is about to start or recovering from
1276+
a primary failover.
12761277

12771278
* - ``preparing-to-donate``
12781279
- The donor shard is preparing to donate data to the recipient
@@ -1285,23 +1286,21 @@ Output Fields
12851286
- The donor shard is donating :term:`oplog` entries to the
12861287
recipient shards.
12871288

1288-
* - ``preparing-to-mirror``
1289-
- The donor shard is preventing new incoming write operations to
1290-
the collection that is being resharded.
1289+
* - ``preparing-to-block-writes``
1290+
- The donor shard is about to prevent new incoming write
1291+
operations to the collection that is being resharded.
12911292

1292-
* - ``mirroring``
1293+
* - ``error``
1294+
- An error occurred during the resharding operation.
1295+
1296+
* - ``blocking-writes``
12931297
- The donor shard is preventing new incoming write operations
12941298
and the donor shard has notified all recipient shards that new
12951299
incoming writes are prevented.
12961300

1297-
* - ``dropping``
1298-
- The donor shard is dropping the old sharded collection.
1299-
13001301
* - ``done``
1301-
- The resharding operation is complete.
1302-
1303-
* - ``error``
1304-
- An error occurred during the resharding operation.
1302+
- The donor shard has dropped the old sharded collection and the
1303+
resharding operation is complete.
13051304

13061305
.. versionadded:: 5.0
13071306

@@ -1322,7 +1321,8 @@ Output Fields
13221321
- Description
13231322

13241323
* - ``unused``
1325-
- The resharding operation is about to start.
1324+
- The resharding operation is about to start or recovering from
1325+
a primary failover.
13261326

13271327
* - ``awaiting-fetch-timestamp``
13281328
- The recipient shard is waiting for the donor shards to be
@@ -1337,24 +1337,18 @@ Output Fields
13371337
* - ``applying``
13381338
- The recipient shard is applying :term:`oplog` entries to
13391339
modify its copy of the data based on the new incoming writes
1340-
from donor shards. The recipient shard data is not yet
1341-
consistent with the donor shard data.
1340+
from donor shards.
13421341

1343-
* - ``steady-state``
1344-
- The recipient shard data is consistent with the donor shard
1345-
data.
1342+
* - ``error``
1343+
- An error occurred during the resharding operation.
13461344

13471345
* - ``strict-consistency``
1348-
- The recipient shard has all data changes.
1349-
1350-
* - ``renaming``
1351-
- The recipient shard renames the new sharded collection.
1346+
- The recipient shard has all data changes stored in a temporary
1347+
collection.
13521348

13531349
* - ``done``
13541350
- The resharding operation is complete.
13551351

1356-
* - ``error``
1357-
- An error occurred during the resharding operation.
13581352

13591353
.. versionadded:: 5.0
13601354

@@ -1376,7 +1370,8 @@ Output Fields
13761370
- Description
13771371

13781372
* - ``unused``
1379-
- The resharding operation is about to start.
1373+
- The resharding operation is about to start or recovering from
1374+
a primary failover.
13801375

13811376
* - ``initializing``
13821377
- The resharding coordinator has inserted the coordinator
@@ -1394,7 +1389,7 @@ Output Fields
13941389
- has inserted entries into ``config.tags`` for any zones
13951390
associated with the new shard key.
13961391

1397-
The coordinator informs participants shards to begin the
1392+
The coordinator informs participant shards to begin the
13981393
resharding operation. The coordinator then waits until all
13991394
donor shards have picked a ``minFetchTimestamp`` and are ready
14001395
to donate.
@@ -1410,24 +1405,23 @@ Output Fields
14101405
shards. The coordinator waits for all recipients to finish
14111406
applying :term:`oplog` entries.
14121407

1413-
* - ``mirroring``
1408+
* - ``blocking-writes``
14141409
- The resharding coordinator informs donor shards to prevent new
14151410
incoming write operations to the collection being resharded.
14161411
The coordinator then waits for all recipients to have all data
14171412
changes.
14181413

1419-
* - ``decision-persisted``
1414+
* - ``aborting``
1415+
- An unrecoverable error occurred during the resharding
1416+
operation or the :dbcommand:`abortReshardCollection` command
1417+
(or the :method:`sh.abortReshardCollection()` method) was run.
1418+
1419+
* - ``committing``
14201420
- The resharding coordinator removes the ``config.collections``
14211421
entry for the temporary resharding collection. The coordinator
14221422
then adds the ``recipientFields`` to the source collection's
14231423
entry.
14241424

1425-
* - ``done``
1426-
- The resharding operation is complete.
1427-
1428-
* - ``error``
1429-
- An error occurred during the resharding operation.
1430-
14311425
.. versionadded:: 5.0
14321426

14331427
.. data:: currentOp.opStatus

source/reference/command/serverStatus.txt

Lines changed: 73 additions & 70 deletions
Original file line numberDiff line numberDiff line change
@@ -3253,42 +3253,41 @@ shardingStatistics
32533253

32543254
* - 0
32553255
- ``unused``
3256-
- Shard is not a donor in the current resharding operation.
3256+
- The shard is not a donor in the current resharding operation.
32573257

32583258
* - 1
32593259
- ``preparing-to-donate``
3260-
- Donor shard preparing to donate data to recipient shard.
3260+
- The donor shard is preparing to donate data to the recipient
3261+
shards.
32613262

32623263
* - 2
32633264
- ``donating-initial-data``
3264-
- Donor shard donating data to recipient shard.
3265+
- The donor shard is donating data to the recipient shards.
32653266

32663267
* - 3
32673268
- ``donating-oplog-entries``
3268-
- Donor shard donating :term:`oplog` entries to recipient shard.
3269+
- The donor shard is donating :term:`oplog` entries to the
3270+
recipient shards.
32693271

32703272
* - 4
3271-
- ``preparing-to-mirror``
3272-
- Donor shard preventing new incoming write operations to the
3273-
collection being resharded.
3273+
- ``preparing-to-block-writes``
3274+
- The donor shard is about to prevent new incoming write
3275+
operations to the collection that is being resharded.
32743276

32753277
* - 5
3276-
- ``mirroring``
3277-
- Donor shard preventing new incoming write operations, and
3278-
donor shard has notified all recipient shards that new
3279-
incoming writes are prevented.
3278+
- ``error``
3279+
- An error occurred during the resharding operation.
32803280

32813281
* - 6
3282-
- ``dropping``
3283-
- Donor shard dropping old sharded collection.
3282+
- ``blocking-writes``
3283+
- The donor shard is preventing new incoming write operations
3284+
and the donor shard has notified all recipient shards that new
3285+
incoming writes are prevented.
32843286

32853287
* - 7
32863288
- ``done``
3287-
- Resharding operation is complete.
3288-
3289-
* - 8
3290-
- ``error``
3291-
- Error occurred during resharding operation.
3289+
- The donor shard has dropped the old sharded collection and the
3290+
resharding operation is complete.
32923291

32933292
*Only present when run on a shard or config server. Returns 0 on a
32943293
config server.*
@@ -3313,42 +3312,37 @@ shardingStatistics
33133312
- Shard is not a recipient in the current resharding operation.
33143313

33153314
* - 1
3316-
- ``creating-collection``
3317-
- Recipient shard creating new sharded collection.
3315+
- ``awaiting-fetch-timestamp``
3316+
- The recipient shard is waiting for the donor shards to be
3317+
prepared to donate their data
33183318

33193319
* - 2
3320-
- ``cloning``
3321-
- Recipient shard receiving data from donor shards.
3320+
- ``creating-collection``
3321+
- The recipient shard is creating the new sharded collection.
33223322

33233323
* - 3
3324-
- ``applying``
3325-
- Recipient shard modifying its copy of the data based on the
3326-
new incoming writes from donor shards. Recipient shards
3327-
apply changes from :term:`oplog` entries generated by
3328-
donor shards. Recipient shard data is not yet consistent with
3329-
donor shard data, but will be when the steady state is
3330-
reached.
3324+
- ``cloning``
3325+
- The recipient shard is receiving data from the donor shards.
33313326

33323327
* - 4
3333-
- ``steady-state``
3334-
- Steady state is reached. Recipient shard data is consistent
3335-
with donor shard data.
3328+
- ``applying``
3329+
- The recipient shard is applying :term:`oplog` entries to
3330+
modify its copy of the data based on the new incoming writes
3331+
from donor shards.
33363332

33373333
* - 5
3338-
- ``strict-consistency``
3339-
- Recipient shard has all data changes.
3334+
- ``error``
3335+
- An error occurred during the resharding operation.
33403336

33413337
* - 6
3342-
- ``renaming``
3343-
- Recipient shard renaming new sharded collection.
3338+
- ``strict-consistency``
3339+
- The recipient shard has all data changes stored in a temporary
3340+
collection.
33443341

33453342
* - 7
33463343
- ``done``
3347-
- Resharding operation is complete.
3344+
- The resharding operation is complete.
33483345

3349-
* - 8
3350-
- ``error``
3351-
- Error occurred during resharding operation.
33523346

33533347
*Only present when run on a shard or config server. Returns 0 on a
33543348
config server.*
@@ -3372,55 +3366,64 @@ shardingStatistics
33723366

33733367
* - 0
33743368
- ``unused``
3375-
- Shard is not the coordinator in the current resharding
3369+
- The shard is not the coordinator in the current resharding
33763370
operation.
33773371

33783372
* - 1
33793373
- ``initializing``
3380-
- Resharding coordinator informs shards to begin resharding
3381-
operation.
3374+
- The resharding coordinator has inserted the coordinator
3375+
document into ``config.reshardingOperations`` and has added
3376+
the ``reshardingFields`` to the ``config.collections`` entry
3377+
for the original collection.
33823378

33833379
* - 2
33843380
- ``preparing-to-donate``
3385-
- Resharding coordinator informs donor shards to prepare to
3386-
donate data to recipient shards.
3381+
- The resharding coordinator
3382+
3383+
- has created a ``config.collections`` entry for the temporary
3384+
resharding collection.
3385+
- has inserted entries into ``config.chunks`` for ranges based
3386+
on the new shard key.
3387+
- has inserted entries into ``config.tags`` for any zones
3388+
associated with the new shard key.
3389+
3390+
The coordinator informs participant shards to begin the
3391+
resharding operation. The coordinator then waits until all
3392+
donor shards have picked a ``minFetchTimestamp`` and are ready
3393+
to donate.
33873394

33883395
* - 3
33893396
- ``cloning``
3390-
- Resharding coordinator informs donor shards to donate data to
3391-
recipient shards.
3397+
- The resharding coordinator informs donor shards to donate data
3398+
to recipient shards. The coordinator waits for all recipients
3399+
to finish cloning the data from the donor.
33923400

33933401
* - 4
33943402
- ``applying``
3395-
- Resharding coordinator informs recipient shards to modify the
3396-
copy of data based on new incoming writes from donor shards.
3403+
- The resharding coordinator informs recipient shards to modify
3404+
their copies of data based on new incoming writes from donor
3405+
shards. The coordinator waits for all recipients to finish
3406+
applying :term:`oplog` entries.
33973407

33983408
* - 5
3399-
- ``mirroring``
3400-
- Resharding coordinator informs donor shards to prevent new
3409+
- ``blocking-writes``
3410+
- The resharding coordinator informs donor shards to prevent new
34013411
incoming write operations to the collection being resharded.
3412+
The coordinator then waits for all recipients to have all data
3413+
changes.
34023414

34033415
* - 6
3404-
- ``committed``
3405-
- Resharding coordinator has updated the metadata
3406-
for the collection being resharded, but the resharding
3407-
coordinator has not yet informed the donor or recipient shards
3408-
of the update. The metadata is stored in the
3409-
:data:`~config.collections`, :data:`~config.chunks`, and
3410-
:data:`~config.tags` collections.
3416+
- ``aborting``
3417+
- An unrecoverable error occurred during the resharding
3418+
operation or the :dbcommand:`abortReshardCollection` command
3419+
(or the :method:`sh.abortReshardCollection()` method) was run.
34113420

3412-
* - 7
3413-
- ``renaming``
3414-
- Resharding coordinator informs recipient shards to rename new
3415-
sharded collection.
3416-
3417-
* - 8
3418-
- ``done``
3419-
- Resharding operation is complete.
3420-
3421-
* - 9
3422-
- ``error``
3423-
- Error occurred during resharding operation.
3421+
* - 6
3422+
- ``committing``
3423+
- The resharding coordinator removes the ``config.collections``
3424+
entry for the temporary resharding collection. The coordinator
3425+
then adds the ``recipientFields`` to the source collection's
3426+
entry.
34243427

34253428
*Only present when run on a shard or config server.*
34263429

0 commit comments

Comments
 (0)