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

Consider rewording help text for --repair

    XMLWordPrintable

    Details

    • Type: Task
    • Status: Closed
    • Priority: Major - P3
    • Resolution: Fixed
    • Affects Version/s: 2.8.0-rc0
    • Fix Version/s: 2.8.0-rc4
    • Component/s: None
    • Labels:
    • Documentation Changes:
      Completed

      Description

      --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.

        Attachments

          Issue Links

            Activity

              People

              Assignee:
              Unassigned
              Reporter:
              renctan Randolph Tan
              Votes:
              1 Vote for this issue
              Watchers:
              5 Start watching this issue

                Dates

                Created:
                Updated:
                Resolved: