Davoud Teimouri

Virtualization & Datacenter

[Review]: Veeam BR Extractor

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

Veeam BR Extract Utility - GUI

Veeam BR Extract Utility - Command-Line

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.

Veeam BR Extract Utility

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

ParameterDescriptionRequired/Optional
vmName of the VM that you want to restore. Use this parameter to filter VMs in the backup.Optional
hostName of the host on which the initial VM resides. This parameter should be specified if the vm parameter is used. Use this parameter to filter VMs that have the same name but reside on different hosts.Optional
passwordPassword for the encrypted backup file.Required for encrypted backup files
pathtovbkPath to the backup file from which the VM should be restored.Required

Getting Encryption Status of Backup File:

extract.exe –getEncryptionStatus pathtovbk

Parameters

ParameterDescriptionRequired/Optional
pathtovbkPath to the backup file from which the VM must be restored.Required

Restoring VMs from Backup:

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

Parameters

ParameterDescriptionRequired/Optional
vmName of a VM that you want to restore. Use this parameter to filter VMs in the backup. If you want to restore all VMs from the backup file, do not specify this parameter.Optional
hostName of the host on which the initial VM resides. This parameter should be specified if the vm parameter is used.
Use this parameter to filter VMs that have the same name but reside on different hosts.
Optional
pathtovbkPath to the backup file from which the VM should be restored.Required
passwordPassword for the encrypted backup file.Required for encrypted backup files
outputdirPath to the directory to which the VM files should be restored. If this parameter is not specified, the VM will be restored to the current directory.Optional
Davoud Teimouri is as a professional blogger, vExpert 2015-2016-2017, VCA, MCITP. This blog is started with simple posts and now, it has large following readers.

4,643 total views, 10 views today

[Review]: Veeam BR Extractor
5 (100%) 2 Votes

Leave a Reply

Teimouri.net © 2012 Frontier Theme
%d bloggers like this:
Read more:
vExpert 2016 Second Half Applications are Now Open

You can apply for vExpert 2016 on the below link: https://form.jotform.com/61374764816969 Current vExpert 2016 do not need apply. Wait for...

Close