[DOCS-7777] removeShard docs should note that only one shard can be in draining state Created: 29/Apr/16  Updated: 11/Jan/17  Resolved: 03/Jun/16

Status: Closed
Project: Documentation
Component/s: None
Affects Version/s: None
Fix Version/s: 01112017-cleanup

Type: Improvement Priority: Minor - P4
Reporter: Ramon Fernandez Marina Assignee: Ravind Kumar (Inactive)
Resolution: Done Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Participants:
Days since reply: 7 years, 32 weeks, 6 days ago

 Description   

The removeShard documentation (and possibly other related pages) should note that only one shard in a cluster can be in "draining" state at a given time.

This is what happens if one tries to remove more than one shard in a cluster:

mongos> db.runCommand({removeShard: "shard01"})
{
        "msg" : "draining started successfully",
        "state" : "started",
        "shard" : "shard01",
        "note" : "you need to drop or movePrimary these databases",
        "dbsToMove" : [
                "test"
        ],
        "ok" : 1
}
mongos> db.runCommand({removeShard: "shard02"})
{
        "ok" : 0,
        "errmsg" : "Can't have more than one draining shard at a time",
        "code" : 117
}



 Comments   
Comment by Githook User [ 30/Jun/16 ]

Author:

{u'username': u'devkev', u'name': u'Kevin Pulo', u'email': u'kev@pulo.com.au'}

Message: Mention that removeShard draining uses the balancer

Follow-up from DOCS-7777. That the balancer is the mechanism by which shards are drained is mentioned briefly in the Example. This change makes the balancer's involvement much more explicit.

Signed-off-by: kay <kay.kim@10gen.com>
Branch: master
https://github.com/mongodb/docs/commit/423936d8809aac8e130bf65c6af5225f3af2caf2

Comment by Githook User [ 13/Jun/16 ]

Author:

{u'username': u'rkumar-mongo', u'name': u'ravind', u'email': u'ravind.kumar@10gen.com'}

Message: DOCS-7777: removeShard does not support simultaneous draining operations

Signed-off-by: kay <kay.kim@10gen.com>
Branch: master
https://github.com/mongodb/docs/commit/7efebd5ae56118df35cbf44fed90214ce06425b7

Generated at Thu Feb 08 07:54:59 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.