How to Generate a Backup Storage Dump

KB ID: 2277
Product: Veeam Backup & Replication
Veeam Agent for Microsoft Windows
Veeam Agent for Linux
Version: All
Published: 2017-04-17
Last Modified: 2026-10-13
mailbox
Get weekly article updates
By subscribing, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.

Cheers for trusting us with the spot in your mailbox!

Now you’re less likely to miss what’s been brewing in our knowledge base with this weekly digest

error icon

Oops! Something went wrong.

Please, try again later.

Purpose

This article documents how to create a "storage dump" from a Veeam backup file.

The storage dump is a human-readable output of the backup file's metadata containing:

  • Backup file parameters
  • FIB (files-in-backup) hierarchy
  • FIB blocks map
  • Offset / size / compression type of data blocks
  • Deduplication dictionary

Solution

Generating the storage dump from a backup file involves interacting with the VeeamAgent executable via a command line. The executable is located in different locations based on the Veeam product:

  • Veeam Backup & Replication
    • v12
      C:\Program Files (x86)\Veeam\Backup Transport\x64\VeeamAgent.exe
      
    • v13
      C:\Program Files\Veeam\Backup Transport\x64\VeeamAgent.exe
      
  • Veeam Agent for Microsoft Windows
    C:\Program Files\Veeam\Endpoint Backup\x64\VeeamAgent.exe
    
  • Veeam Agent for Linux
    /usr/sbin/veeamagent
    

Expand the section below that aligns with the Encryption state of the backup:

Procedure for non-Encrypted backup files:
  1. Open a command line and start the VeeamAgent by specifying the executable's full path as documented above.
Command Prompt window with VeeamAgent.exe started by its full path, displaying the PID and dispatch port
  1. Type in dumpStg, and press Enter.
Command Prompt window with the dumpStg command entered at the VeeamAgent prompt
  1. On the next line, provide the full path to the backup file, and press Enter.
Command Prompt window with the full path to the backup file (.vbk) entered on the line after dumpStg
  1. On the next line, provide the full path (including output file name) to where the storage dump should be written, and press Enter.
Command Prompt window with the full path and file name for the storage dump output entered on the next line

The storage dump will be written to the output location. This process may take longer with larger backup files.

If VeeamAgent processed the command successfully, the agent will display a prompt (>) indicating it is ready for the next command.

If, after pressing Enter in step 4, the process terminates and you are sent back to a normal command line, the input or output file location was invalid.

Procedure for Encrypted backup files:
  1. Open a command line and start the VeeamAgent by specifying the executable's full path as documented above.
Command Prompt window with VeeamAgent.exe started by its full path, displaying the PID and dispatch port
  1. Type in dumpStgWithPassword, and press Enter.
Command Prompt window with the dumpStgWithPassword command entered at the VeeamAgent prompt
  1. On the next line, provide the full path to the backup file, and press Enter.
Command Prompt window with the full path to the encrypted backup file (.vbk) entered on the line after dumpStgWithPassword
  1. On the next line, provide the full path (including output file name) to where the storage dump should be written, and press Enter.
Command Prompt window with the full path and file name for the storage dump output entered on the next line
  1. On the next line, provide the password used to encrypt the backup file, and press Enter.
Command Prompt window with the Password prompt displayed after the backup file and output file paths were entered

The storage dump will be written to the output location. This process may take longer with larger backup files.

If VeeamAgent processed the command successfully, the agent will display a prompt (>) indicating it is ready for the next command.

If, after pressing Enter in step 5, the process terminates and you are sent back to a normal command line, the input file path, output file path, or password was invalid.

If this KB article did not resolve your issue or you need further assistance with Veeam software, please create a Veeam Support Case.

To submit feedback regarding this article, please click this link: Send Article Feedback
To report a typo on this page, highlight the typo with your mouse and press CTRL + Enter.

Spelling error in text

Thank you!

Thank you!

Your feedback has been received and will be reviewed.

Oops! Something went wrong.

Please, try again later.

You have selected too large block!

Please try select less.

KB Feedback/Suggestion

This form is only for KB Feedback/Suggestions, if you need help with the software open a support case

By submitting, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.
Verify your email to continue your product download
We've sent a verification code to:
  • Incorrect verification code. Please try again.
An email with a verification code was just sent to
Didn't receive the code? Click to resend in sec
Didn't receive the code? Click to resend
Thank you!

Thank you!

Your feedback has been received and will be reviewed.

error icon

Oops! Something went wrong.

Please, try again later.