[DOCS-4246] Create page to explain recovery from invalid replset config due to 2.8 upgrade Created: 27/Oct/14  Updated: 09/Jan/15  Resolved: 09/Jan/15

Status: Closed
Project: Documentation
Component/s: manual
Affects Version/s: None
Fix Version/s: v1.3.16, mongodb-3.0

Type: Bug Priority: Major - P3
Reporter: Spencer Brody (Inactive) Assignee: Allison Reinheimer Moore
Resolution: Done Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Depends
is depended on by SERVER-15767 Refuse to start up with invalid repls... Closed
Related
related to DOCS-4192 Document replica set behavior changes... Closed
Participants:
Days since reply: 9 years, 5 weeks, 5 days ago

 Description   

Starting in 2.8 mongod will fail to startup if it has an invalid replica set configuration stored in local.system.replset. We need a docs page describing what to do in this case. Before we can push the change to the server, however, we would like to at least have a URL that we can include in the log message when the server fails to start up so we can direct users to more information on how to recover than we can put into the log message.

The steps the user should take most likely depends on what the reason the config is invalid is. There were a few changes in 2.8 as to what makes a config valid/invalid, for example it is illegal starting in 2.8 to specify a "votes" field with values other than 0 or 1. So if the user has a config that was valid in 2.6 but is no longer valid in 2.8, then they should downgrade to 2.6, reconfigure to a future-proof config, then re-upgrade.

If their config is invalid in another way, then they must have done something funky to even get this config stored - their best bet is probably to restart without --replSet and on a different port and drop local.system.replset. Though I'm not sure whether we want to actually document that part as this case should be very rare, and we have to be careful about recommending people mess with system collections directly.



 Comments   
Comment by Githook User [ 09/Jan/15 ]

Author:

{u'username': u'schmalliso', u'name': u'Allison Moore', u'email': u'allison.moore@10gen.com'}

Message: DOCS-4246: recover invalid replset config

spelling

Signed-off-by: Allison Moore <allison.moore@10gen.com>
Branch: master
https://github.com/mongodb/docs/commit/34fb2ea8e5382a958b7c75b2c4ebda7a7365b461

Comment by Spencer Brody (Inactive) [ 28/Oct/14 ]

samk has told me that http://www.mongodb.org/dochub/core/recover-replica-set-from-invalid-config is now reserved for this.

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