Importing Backup Files

If the Veeam Backup & Replication server has failed and you have restored it in a new location, you can copy the backup files to a new repository and re-map the Veeam Plug-in backup files.

Limitations and Prerequisites

Consider the following limitations:

  • If backup files are not imported according to instructions given in this section, Veeam Plug-in backup and restore operations may fail.
  • The repository from which you plan to import backups must be added to the Veeam Backup & Replication infrastructure. Otherwise you will not be able to access backup files.
  • [For backups of scale-out clusters and servers with the customServerName option] To avoid mapping failure, the cluster name must be the same as the name used before importing backups.
  • [For imports to the scale-out backup repository] Before importing your backup, consider that the names of all backup files (.VAB, .VASM, .VACM) and paths to these files contain only the following allowed characters:
  • a-zA-Z0-9 
  • _-.+=@^

If your backup was initially created on a standalone backup server, the default name of the backup metadata file (.VACM) contains forbidden characters. Before importing, you must delete forbidden characters from the file name or replace them with the allowed characters.

How to Import Veeam Plug-in Backup Files

To import Veeam Plug-in backup files, do the following:

  1. Copy the backup file folder to a backup repository or add a new backup repository with this folder as a subfolder.


Make sure that you import backup files and all related metadata files.

Keep in mind that each Veeam Plug-in backup file (.VAB) has its own metadata file (.VASM). Also, you must import the backup job metadata file (.VACM) that is stored in the same folder.

  1. Log in to the Veeam Backup & Replication console.
  1. Open the Backup Infrastructure view.
  1. In the inventory pane of the Backup Infrastructure view, select the Backup Repositories node.
  1. In the working area, select the required backup repository and click Rescan on the ribbon. Alternatively, you can right-click the backup repository and select Rescan.

During the rescan operation, Veeam Backup & Replication gathers information about backups that are currently available in the backup repository and updates the list of backups in the configuration database. After the rescan operation, backups that were not in this configuration database will be shown on the Home view in the Backups > Disk (Imported) node.

Rescan Backup Repository

  1. On the IBM Db2 server, set the new repository as a target in the Veeam Plug-in settings:

DB2ConfigTool --set-repositories

Available backup repositories:
2. serv07_repo
Enter repository number: 1

  1. Start the Veeam Plug-in configuration wizard with the following parameter:


Before you re-map your backup to the repository, make sure that there is not an existing backup job on your machine with Veeam Plug-in that is targeted at the same repository. If there is such a job, delete this job from the Veeam Backup & Replication console.

DB2ConfigTool --map-backup


Page updated 4/2/2024

Page content applies to build