Uploaded image for project: 'MongoDB Database Tools'
  1. MongoDB Database Tools
  2. TOOLS-394

Consider rewording help text for --repair

    • Type: Icon: Task Task
    • Resolution: Done
    • Priority: Icon: Major - P3 Major - P3
    • 2.8.0-rc4
    • Affects Version/s: 2.8.0-rc0
    • Component/s: None
    • 2014 Last MCI Iteration
    • Completed

      --help section for mongodump --repair looks like this:

            --repair                        try to recover a crashed database
      

      And it may sound like the mongodump will try to "fix" the database. But in fact it is a read only operation that tries to read the contents of a database by iterating over the extents manually. For mmap v1, this goes through 2 passes - iterating to the next record and iterating to the prev record. In other words, if the database is in a valid state, each document will appear twice.

      We also need to fix our documentation since it is not correct:

      http://docs.mongodb.org/manual/reference/program/mongodump/

      --repair
      Runs a repair option in addition to dumping the database. The repair option attempts to repair a database that may be in an invalid state as a result of an improper shutdown or mongod crash.

      The --repair option uses aggressive data-recovery algorithms that may produce a large amount of duplication.

            Assignee:
            Unassigned Unassigned
            Reporter:
            randolph@mongodb.com Randolph Tan
            Votes:
            1 Vote for this issue
            Watchers:
            5 Start watching this issue

              Created:
              Updated:
              Resolved: