Rebuild the Agent Cache After Corruption
search cancel

Rebuild the Agent Cache After Corruption


Article ID: 286773


Updated On:


Carbon Black App Control (formerly Cb Protection)


  • The Agent's cache.db file is more than 1GB in size
  • Files that have been Approved in the past, are now being blocked
  • Errors.bt9 file shows frequent and persistent messages similar to the below:​
    • ​Error[database disk image is malformed]
    • Error[HandleCorruptDB: Warning: Agent database appears to be corrupt
    • Error[ValidateConfigListFile Error[Magic mismatch[xxxx] Expected[yyyy]]]
    • Error[CacheDatabase: Database did not pass integrity check]
  • Cache_invalid.bt9 files located in the Agent Data directory.
  • Events with subtype "Agent database error" may show in the Console.


  • App Control Agent: All Supported Versions
  • macOS: All Supported Versions
  • Linux: All Supported Versions
  • Windows: All Supported Versions


The most common cause of Agent cache corruption is improper/hard shutdowns. Other reasons could include:
  • Third party products injecting into the Agent/interfering with operations.
  • Unsupported OS/Agent combination.
  • Modifications to the OS or other critical files while the Agent is not running/disabled.



  1. Verify the impacted machine is running a supported and compatible Agent version.
  2. Verify antivirus exclusions for the agent are added for any 3rd party security tools
  3. Stop The Agent Via Local Command Line / Terminal
  4. Delete all files with cache in the name from the relevant directory:
    • Linux: /srv/bit9/data/
      rm –f /srv/bit9/data/cache.*
    • macOS: /Library/Application Support/com.bit9.Agent/
    • Windows: C:\ProgramData\Bit9\Parity Agent\
  5. Start The Agent Via Local Command Line / Terminal
  6. Allow the Agent to fully Initialize again.


  1. Login to the Console and navigate to Assets > Computers > relevant Computer.
  2. From the Computer Details page > right-side menu > Other Actions > Delete Database > Go.
  3. From the Other Actions menu > Restart Service > Go.

Additional Information

  • Initialization will occur after completing these steps, and will issue a new Local Approval to all files.
  • If the machine is sensitive to degraded performance, or possible blocks, it is recommended to complete these steps outside peak usage.