Introduction To Veeam Backup Extractor

Veeam Backup Extractor is a Veeam utility to extract VMs from full backup (VBK) file. Administrators can extract VMs from backup file without installing Veeam Backup & Replication.

There is no dependency between the utility and Veeam Backup & Replication, so the utility works as independent utility. Administrators can copy the utility from backup server to another server and run that easily.

Note: I didn’t test extract VMs from a backup file which it’s placed on a shared folder.

There is two interface for extracting VMs from backup files:

1. Graphical User Interface
2. Command-Line

The extract utility is located in the installation folder of Veeam Backup & Replication, by default: %PROGRAMFILES%\Veeam\Backup and Replication\Backup. The folder contains three files for the extract utility:

• Veeam.Backup.Extractor.exe — utility working via the graphic user interface (can be used on Microsoft Windows machines only) – 1st File
  
• extract.exe — utility working via the command-line interface, a version for Microsoft Windows – 2nd File
  
• extract — utility working via the command-line interface, a version for Linux – 3rd File
  

Graphical User Interface

GUI is available by run Veeam.Backup.Extractor.exe from this path:

%PROGRAMFILES%\Veeam\Backup and Replication\Backup

Extracting VMs is so simple from backup files by using Veeam.Backup.Extractor.exe, just click on browse button (1), select backup file (2), then select VM from the VMs list and then click Extract to extracting virtual machines from the backup file.

Command-Line Utility

There is two command-line utility for Windows and Linux that administrators be able to extract VMs from backup file by run the commands.

There is an interactive mode for extracting VMs and administrators be able to find and select backup files or VMs from a list. Also the command-line utility can accept arguments.

Using Interactive Mode

To start the extract utility in the interactive mode, run the extract.exe file from the product installation folder(in case of a Linux machine, run the extract file).

You will have to sequentially enter the following arguments:

1. Path to the full backup file from which the VM must be restored. After you enter the path, the restore utility will display a list of all VMs included in the backup and their description.
2. Name of the VM you want to restore. If there is more than one VM with the specified name in the backup, you will be asked to specify the host on which the backed up VM resides. If you want to restore all VMs from the backup, press [ENTER].
3. If the backup was encrypted, password that was used to encrypt the backup file.
4. Output directory to which VMs must be restored. If you want to restore VM(s) to the current directory, press [ENTER].
5. Operation confirmation. Press [Y] on the keyboard to restore a VM to the directory you selected. If you want to abort the operation, press [ENTER].

Using Script Mode

Administrator can use command-line mode and passing arguments to run command faster. This is actually script mode. Here is some example for script mode:

Displaying Help Information for Utility Usage:

extract.exe -help

Displaying List of VMs in Backup:

extract.exe -dir [-vm vmname] [-host hostname] -password backupkey pathtovbk

Parameters

Getting Encryption Status of Backup File:

extract.exe –getEncryptionStatus pathtovbk

Parameters

Restoring VMs from Backup:

extract.exe -restore [-vm vmname] [-host hostname] -password backupkey pathtovbk [outputdir]

Parameters