- Veeam Support Knowledge Base
- How to migrate backup data between repositories for Veeam Backup for Microsoft 365
How to migrate backup data between repositories for Veeam Backup for Microsoft 365
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
Purpose
This article provides information regarding migrating backup data between local repositories and from a local repository to an object storage repository when using Veeam Backup for Microsoft 365.
Note: Data can only be migrated using PowerShell cmdlets.
Solution
Limitations and Considerations of the Move-VBOEntityData cmdlet:
- As data is moved, Veeam Backup for Microsoft 365 removes items from the source repository and replaces them with the whitespace in the source repository database. For this reason:
- The object storage repository where you want to move backup data must not contain any data associated with the items you want to move.
- If the move process was interrupted, do not start the related backups jobs until you have resumed and completed the data move process.
- Move-VBOEntityData supports the following data migration scenarios:
- Migration from one local backup repository to another local repository
- Migration from a local backup repository to an object storage repository
- The following migration scenarios are not supported:
- Migration from an object storage repository to another object storage repository.
- Migration from an object storage repository to a local repository.
- Restore points that are migrated will no longer be attached to the original job. The restore points are still available for restore and can be accessed by right-clicking on the corresponding organization name.
- The Move-VBOEntityData cmdlet will not reconfigure backup jobs to change the repository they use. The jobs must be reconfigured manually or by using additional PowerShell cmdlets (as is done in the script example found in this article).
- It is recommended to run migration operations outside of backup windows to avoid overhead on a proxy and affecting backup jobs performance.
- If Teams data migration results in a mix of restore points created by EWS and protected APIs stored in the same repository, then such repository can only be used to create new backups using protected APIs
Usage examples for the Move-VBOEntityData cmdlet
Examples are available in the PowerShell Reference guide here: Move-VBOEntityData - Examples
Monitoring the Move-VBOEntityData migration progress
Status of migration tasks is displayed in the Veeam Backup for Microsoft 365 Console in the History tab under the Job > Data Management node.
Migration Script Example
Expand for information about the Migration Script example
The script performs the following operations:
- Select Organization. Defines the organization associated with the data to be migrated.
- Select Backup Proxy. Defines the backup proxy server that hosts existing backup data.
- Select Target Repository. Defines the target object storage repository.
- Limit Migrations Sessions. This step configures the maximum number of simultaneous migration sessions to half of all threads configured for the selected backup proxy server. For example, if there are 64 threads configured on the backup proxy server, it will limit the number of migration sessions to 32 concurrent migration sessions.
- Disable All Jobs for Selected Organization. Disables all backup jobs created for the specified organization.
- Create a List of Source Repositories. Creates a list of backup repositories used by the backup jobs from Step 5 that will be used as source repositories. (If a repository is not in use by at least one backup job, the data residing there will not be migrated.)
- Get and Migrate All Users. Creates a list of all Users, Sites, Teams, and Groups located in the repositories from Step 6 and then migrates their data.
- Reconfigure Jobs to Use New Repository. Reconfigures all the jobs from Step 5 to use the object storage repository that is defined as a target repository and enables all jobs disabled at Step 5.
Before using the script below, it is essential that you:
- Read the Solution section of this article to understand the limitations of the script's cmdlets.
- Read the Move-VBOEntityData cmdlet User Guide page to understand additional considerations.
To run the script, download the file below, place it on the Veeam Backup for Microsoft 365 server. Then, run the "kb3067.ps1" file and follow the script prompts.
This script was written for use with Veeam Backup for Microsoft 365 5B or later.
For ease of use, comments are provided for each step in the script.
MD5: 1A46953ED06CA7291D6107878A55091B
SHA-1: 29E6E85BC353318485FFABF35B67AED33C358A5E
This script is provided as a courtesy and is not supported by Veeam Technical Support. Use at your own risk.
Veeam Technical Support will not assist in the usage or troubleshooting of this tool.
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.