- Veeam Support Knowledge Base
- How to Move Veeam Backup & Replication Backup Files
How to Move Veeam Backup & Replication Backup Files
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
Starting with Veeam Backup & Replication 12, a new "Move Backup" feature is now built-in. The methods documented in this article are still viable, but we encourage users to instead utilize the built-in functionality for the best experience.
Purpose
This article documents two methods for changing the repository where backup files are stored.
For documentation on changing the backup location of Veeam Agent jobs not directly controlled by Veeam Backup & Replication, but targeting a Veeam Backup & Replication server's repository, refer to vee.am/kb2321
Solution
There are two primary situations and respective methods that this KB article documents. Below is a summary of each.
Method A: Same Job, New Backup location
The backup files are being moved to a new repository, but the existing Backup Job will continue to be used. This method will use the automapping function built-in to the software.
Method B: New Job, New Backup location
You are seeding a job or mapping a job to a backup chain in a new location. This method does not require that the job doing the mapping be the same as the job that initially created the restore points, as it requires that you manually use the map backup function.
Method A: Same Job, New Backup location
- Disable the backup job(s) planned to be moved; this will prevent additional restore points from being created during the repository transition. Disabling the job/jobs will also stop any SQL Transaction Log backups, as those running during the transition will cause the final step to fail.
- Create a new repository for the new location where backup files will be located.
- Manually move the backup files to the new repository path. You must include the metadata file (.vbm), full backup files (.vbk), and any needed incremental files (.vib or .vrb).
Note:
- It is recommended to move all backup files, but you may omit incremental files if needed. However, if you decide not to move/copy all backup files to the new storage, you will need to use the “Forget Missing Restore Points” function to clear any references to backup files that were not moved/copied after the final step.
- There will be folders created inside the directory/path for job names. If your repository path is set as E:\Backups, Job A will go to E:\Backups\Job A.
- Rescan the new repository.
- If the backup files are not encrypted, skip this step.
If the backup files are encrypted, the encrypted backup will appear under the Backups > Disk (encrypted) node in the inventory pane. In the working area, select the imported backup and click Specify Password on the ribbon or right-click the backup and select Specify password. More Information This is also relevant for encrypted Veeam Agent backups.
- Observe that after the Rescan has been completed, there will be duplicate entries for the backup files. One is associated with the old Repository under Backups > Disk, and the other is associated with the new repository under Backups > Disk (Imported).
- Edit the Backup or Backup Copy Job, and go to the Storage or Target tab, and from the drop-down menu, select the new repository.
- Press Next through the rest of the pages of the wizard to finalize the setting. If no error occurs, and the job now lists the new repository in its Repository column, the mapping has been completed.
Note: If you encounter the following error: “Move all backup files to the new backup repository first”, some restore points the software was expecting to find were not found in the new repository. Cancel out of the job configuration and check both the old repository location and the new location to verify that all restore points have been moved. Then return to step 3 again.
- Verify migration by checking under Backups > Disk to see that the Job's backup files listed there are now associated with the new repository.
- Enable the job that was disabled in Step 1.
If the steps in "Method A" continue to lead to the "Move all backups files to the new backup repository first" error, and you have made sure all the backup files from the initial repository are in the new repository. You may need to use "Method B" below to forcefully map the job.
If "Method B" also does not allow you to map correctly, please contact Veeam Support.
Method B: New Job, New Backup location
To map the existing backup files to a new or different job, follow these steps:
- Under Backups > Disk, right click the job you are changing repository for, and select Remove from Configuration.
- If you are mapping the backup set from one job to another, but the backup location will stay the same, skip this step.
If you are moving the backup files to a new location create a new repository for the new location where backup files are located.
- Rescan the repository where the backup files are located.
- If the backup files are not encrypted, skip this step.
If the backup files are encrypted, the encrypted backup will appear under the Backups > Disk (encrypted) node in the inventory pane. In the working area, select the imported backup and click Specify Password on the ribbon or right-click the backup and select Specify password. More Information This is also relevant for encrypted Veeam Agent backups.
- Edit the Backup\Backup Copy Job. Go to the Storage\Target tab, and from the drop-down menu, select the repository where the backup files you wish to map are located.
- Click Map Backup and select the existing backup chain
If you are attempting to seed failover cluster Veeam Agent for Microsoft Windows job’s restore points, please follow the actions below (it has a bit different workflow due to the product design):
- Clone the source cluster job
- Remove the source job (it will also remove from configuration its points, not from the disk but from the Veeam config only)
- Move the source backup folder to a new backup folder;
- Rescan the new repository to import the moved files
- Change the cloned backup job to the new repository and map the imported points there
More Information
If you have attempted to manually import the backup, before performing the steps outlined in this article, you must first "Remove from configuration" any backups that were manually imported. These will be identifiable in the Backups > Disk (Imported) section. They will be listed with the suffix _imported and will have no repository listed in the Repository column.
To report a typo on this page, highlight the typo with your mouse and press CTRL + Enter.
Spelling error in text
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
Thank you!
Your feedback has been received and will be reviewed.