MongoDB recovery planning

WiredTiger corruption requires a complete dbPath snapshot before MongoDB repair or restart attempts.

MongoDB's WiredTiger engine uses checkpoints and a journal to recover from ordinary interruptions. Disk-level corruption, missing files, damaged metadata, or inconsistent copies can prevent automatic recovery and make repair lossy.

Understand the symptom

A checkpoint, journal, and table files form one storage-engine state.

WHY

What is happening

WiredTiger checkpoints provide consistent on-disk recovery points, while journal records cover more recent operations. Copying selected collection files or deleting lock, journal, or metadata files can break that relationship. MongoDB documents repair for cases where disk corruption prevents startup, but repair can discard unrecoverable content and must be tested on protected copies.

What you may see

Symptoms that change the recovery path.

01

mongod exits during startup

WiredTiger cannot open metadata, replay recovery, or read required table files.

02

WiredTiger panic or checksum errors

Storage pages or metadata fail validation and the engine protects itself from further work.

03

Files are missing from dbPath

A partial copy, cleanup, filesystem fault, or failed storage may have removed a required component.

04

Unexpected shutdown recovery repeats

The engine cannot reach a usable checkpoint with the available journal and data files.

Protect the source

Actions that can make the situation worse.

01

--repair can discard data

Repair aims for a usable database and may remove records or tables it cannot reconstruct.

02

Deleting journal loses recent operations

Journal files may contain changes newer than the last durable checkpoint.

03

Partial file copies are inconsistent

Collection, index, metadata, journal, and encryption files must represent the same storage state.

Do this now

Safe steps before evaluation.

01

Stop MongoDB and dependent applications

Prevent automatic restarts, writes, replica actions, and backup agents from changing dbPath.

02

Snapshot the complete dbPath

Preserve every WiredTiger file, collection, index, journal, diagnostic, lock, and configuration file.

03

Collect version and topology context

Record MongoDB and FCV versions, standalone or replica role, storage engine, encryption, and recent maintenance.

04

Protect the source disk

Acquire failing volumes before repair, resync, filesystem checks, or repeated startup attempts.

NEPFOSYS process

How a data-first evaluation proceeds.

01

Storage-engine inventory

NEPFOSYS correlates metadata, checkpoints, journal, tables, indexes, logs, version, and physical storage.

02

Recovery on protected copies

Startup, repair, salvage, or replica-assisted paths are tested without changing the source.

03

Collection-level validation

Recovered databases, collections, documents, indexes, and date ranges are checked against priorities.

A clear next step

Preserve the original device before another repair or recovery attempt.

Start a case with the exact symptoms, incident timeline, prior attempts, encryption details, and the files that matter most. NEPFOSYS will route the case to the appropriate DFW intake or nationwide mail-in path.

Start with a case review

Questions, answered

What customers ask before starting.

Will WiredTiger always recover after an unexpected shutdown?

It normally recovers from the last valid checkpoint plus journal, but disk corruption or missing files can prevent automatic recovery.

Is mongod --repair non-destructive?

No. It changes the database and can discard content that cannot be repaired. Use a protected copy and validate the result.

Which files should be preserved?

Keep the entire dbPath, journal, WiredTiger metadata and history store, collection and index files, configuration, logs, keys, and storage snapshot.

DFW local · Nationwide mail-in

Protect the device. Start with the facts.

Start my recovery case