see on GitHub

Recovering from Esent errors

Symptoms:

  • RavenDB server side error messages like:
    • Secondary index is corrupt. The database must be defragmented
    • System.InvalidOperationException: Could not open transactional storage

Cause:

An error in Esent's file.

Resolution:

Run Esent Utility for recovering from errors. There are two approaches to recover a corrupted database:

  • Recovery - a loss-less operation that tries to recover the Esent file (esentutl /r RVN /l logs /s system)
  • Repair - a more aggressive approach that may cause data loss (esentutl /p Data)

In both cases, at the end, the defragmentation should be performed (esentutl /d Data)

Equivalent options for a file system:

  • Recovery - esentutl /r RFS /l logs /s system
  • Repair - esentutl /p Data.ravenfs
  • Defragment - esentutl /d Data.ravenfs

Further read:

Esentutl