[DOCS-10590] Issues with repairDatabase documentation Created: 28/Jul/17 Updated: 30/Oct/23 Resolved: 03/Aug/17 |
|
| Status: | Closed |
| Project: | Documentation |
| Component/s: | manual |
| Affects Version/s: | None |
| Fix Version/s: | Server_Docs_20231030 |
| Type: | Bug | Priority: | Critical - P2 |
| Reporter: | Kevin Adistambha | Assignee: | Kay Kim (Inactive) |
| Resolution: | Fixed | Votes: | 0 |
| Labels: | None | ||
| Remaining Estimate: | Not Specified | ||
| Time Spent: | Not Specified | ||
| Original Estimate: | Not Specified | ||
| Issue Links: |
|
||||||||||||||||
| Participants: | |||||||||||||||||
| Days since reply: | 6 years, 24 weeks ago | ||||||||||||||||
| Description |
|
There are several issues with the repairDatabase documentation page in https://docs.mongodb.com/manual/reference/command/repairDatabase/ repairDatabase is an administrative command that needs to be run with due care, especially in a replica set configuration. However, the tone and content of the documentation page gives the impression that this is a "safe" command to run. As a result, the suggestion to run repairDatabase for the smallest of issues is often see in community advice. In MMAPv1, repairDatabase rebuilds the data files based on the data that can be successfully read. Running this command in a replica set could potentially create inconsistencies in the set. Since all nodes in a replica set are assumed to contain identical data, this will lead to difficult to diagnose crashes and other surprising behaviour. Confirmation will be needed as to what exactly repairDatabase does for WiredTiger. A sample of incorrect and misleading statements in the page are:
The result of running repairDatabase may be irreversible. Hence, this command should come with:
|
| Comments |
| Comment by Githook User [ 31/Aug/17 ] |
|
Author: {'username': 'kay-kim', 'name': 'kay', 'email': 'kay.kim@10gen.com'}Message: |
| Comment by Githook User [ 31/Aug/17 ] |
|
Author: {'username': 'kay-kim', 'name': 'kay', 'email': 'kay.kim@10gen.com'}Message: |
| Comment by Githook User [ 31/Aug/17 ] |
|
Author: {'username': 'kay-kim', 'name': 'kay', 'email': 'kay.kim@10gen.com'}Message: |
| Comment by Githook User [ 31/Aug/17 ] |
|
Author: {'username': 'kay-kim', 'name': 'kay', 'email': 'kay.kim@10gen.com'}Message: |
| Comment by Githook User [ 31/Aug/17 ] |
|
Author: {'username': 'kay-kim', 'name': 'kay', 'email': 'kay.kim@10gen.com'}Message: |
| Comment by Githook User [ 31/Aug/17 ] |
|
Author: {'username': 'kay-kim', 'name': 'kay', 'email': 'kay.kim@10gen.com'}Message: |
| Comment by Githook User [ 31/Aug/17 ] |
|
Author: {'username': 'kay-kim', 'name': 'kay', 'email': 'kay.kim@10gen.com'}Message: |
| Comment by Githook User [ 31/Aug/17 ] |
|
Author: {'username': 'kay-kim', 'name': 'kay', 'email': 'kay.kim@10gen.com'}Message: |
| Comment by Kay Kim (Inactive) [ 28/Jul/17 ] |
|
heh – You've gotten me trained kevin.adistambha – I'm like "Oh, I'll see if Kevin opens a CR himself" |