[DOCS-1205] Procedure on "Change Hostnames in a Replica Set" has an error Created: 07/Mar/13  Updated: 13/Sep/13  Resolved: 11/Sep/13

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

Type: Bug Priority: Major - P3
Reporter: Thomas Rueckstiess Assignee: Bob Grabar
Resolution: Done Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Related
Participants:
Days since reply: 10 years, 23 weeks ago

 Description   

At http://docs.mongodb.org/manual/tutorial/change-hostnames-in-a-replica-set/#changing-hostnames-while-maintaining-the-replica-set-s-availability, there is an error in step 5. It doesn't make sense to start up the original primary (it's not needed anymore).

I replaced the steps 3-5 with the following for a customer:

...
3. When the step down succeeds, shut down the old primary.
4. Start the node that will replace the old primary in the new location
5. To make the final configuration change, connect to the current primary in the mongo shell and reconfigure the host value to replace the old node with the new one. If the old primary was at position 0, you would run:

cfg = rs.conf()
cfg.members[0].host = "mongodb0.example.net:27017"
rs.reconfig(cfg)

...

Note how step 4 became the new step 5 and the replacement node should be started before the config change to not get errors about it being unreachable.

I think step 1d. should also be changed as the secondary is not always at position 1 in the array. I would make this clearer. Something like "If the old node was at position 1, you would run: ...".



 Comments   
Comment by auto [ 11/Sep/13 ]

Author:

{u'username': u'tychoish', u'name': u'Sam Kleinman', u'email': u'samk@10gen.com'}

Message: DOCS-1205: edits
Branch: master
https://github.com/mongodb/docs/commit/61eafd7b604b2925740bffc2c8fe83b87b66e2b7

Comment by auto [ 11/Sep/13 ]

Author:

{u'username': u'bgrabar', u'name': u'Bob Grabar', u'email': u'bob.grabar@10gen.com'}

Message: DOCS-1205 change hostname in a replica set

Signed-off-by: Sam Kleinman <samk@10gen.com>
Branch: master
https://github.com/mongodb/docs/commit/c3928fe9ebb89d2f67368ab295b9ebdd28b3ab04

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