Uploaded image for project: 'Documentation'
  1. Documentation
  2. DOCS-9301

Update to repairDatabase documentation

    XMLWordPrintableJSON

Details

    • Icon: Improvement Improvement
    • Resolution: Done
    • Icon: Major - P3 Major - P3
    • Server_Docs_20231030
    • None
    • Server
    • None

    Description

      The docs about --repairDatabase https://docs.mongodb.com/manual/reference/command/repairDatabase/ has a section called "Using repairDatabase to reclaim disk space". I find there are some issues with this (very short, explanation-free) section:

      You should not use repairDatabase for data recovery unless you have no other option.

      The section is about reclaiming disk space, but the first paragraph is about data recovery. This feels out of place.

      However, if you trust that there is no corruption and you have enough free space, then repairDatabase is the appropriate and the only way to reclaim disk space.

      1. This paragraph has led to cases where users wanting to reclaim space simply doing --repairDatabase without understanding what it actually does (i.e. rebuilding the collection minus some corrupted documents). I'm not sure if the wording "the appropriate and the only way to reclaim disk space" is appropriate for this section.

      2. Is this suggestion still valid for WiredTiger?

      Attachments

        Activity

          People

            kay.kim@mongodb.com Kay Kim (Inactive)
            kevin.adistambha@mongodb.com Kevin Adistambha
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved:
              7 years, 13 weeks, 6 days ago