KB ID: | 3067 |
Product: | Veeam Backup for Microsoft Office 365 |
Version: | 4.0 |
Published: | 2019-12-16 |
Last Modified: | 2020-10-08 |
Note: Before proceeding with the steps described below, make sure the target Object Storage does not have any existing data associated with the entities that will be migrated.
Existing backup data can be transferred from the local backup repository to the object storage repository using the Move-VBOEntityData PowerShell cmdlet.
Mind the following:
In Veeam Backup for Microsoft Office 365 4.0, the following data migration scenarios between repositories are supported:
Existing restore points will be available after the migration but they no longer will be attached to the original job. To access the necessary restore point, right-click on the corresponding organization name.
The migration procedure will not automatically reconfigure the corresponding backup jobs. To proceed with backing up to an object storage repository, you must reconfigure the jobs manually and point them to the new target.
It’s recommended to run migration operations outside of backup windows to avoid overhead on a proxy and affecting backup jobs performance.
The following instructions provide an explanation of Veeam PowerShell cmdlets that allow you to migrate data.
NOTE: Before using a script from this KB, make sure that you have installed Veeam Backup for Microsoft Office 365 version 4a/4c and a Cumulative Fix Pack.
To download Microsoft Office 365 version 4a, refer to KB3035.
To download Microsoft Office 365 version 4c, refer to KB3145.
To obtain a Cumulative Fix Pack contact our technical support by opening a support ticket.
This example shows how to perform basic operations with Veeam PowerShell cmdlets and to move backup data from the local backup repository to the object storage repository.
$source = Get-VBORepository -Name "Source Repository Name" $target = Get-VBORepository -Name "Object Storage Repository Name" $data = Get-VBOEntityData -Type User -Repository $source -Name "John Doe" Move-VBOEntityData -From $source -To $target -User $data
This description covers details on the cmdlets and parameters that are used to get the necessary objects and migrate backup data that you want to move (a single user’s mailbox, archive mailbox, OneDrive and SharePoint site) between the repositories with the Move-VBOEntityData cmdlet.
For example, to migrate the user's OneDrive and Archive mailbox data run the following command:
Move-VBOEntityData -From $source -To $target -User $data -OneDrive -ArchiveMailbox
By default, the session iniciated by running the Move-VBOEntityData cmdlet is a single-thread operation and you will not be able to start another migration job before the current one is finished. To migrate larger amounts of data, it's recommended to run migration jobs in parallel by using the -RunAsync parameter. For example:
Move-VBOEntityData -From $source -To $target -User $data -RunAsync
The status of data management jobs is presented in Veeam Backup for Microsoft Office 365 console under the corresponding node on the job sessions history:
The script below is designed to demonstrate how to automate backup data migration to an object storage repository.
Please note that the script is provided to demonstrate automation possibilities and is not supported by Veeam Technical Support. Use it at your own risk.
The script consists of steps that perform the following operations:
Step 1. Organization Selection - this step defines the organization which data you want to migrate.
Step 2. Backup Proxy Selection - this step defines the backup proxy server that hosts existing backup data.
Step 3. Target Repository Selection - this step defines a target object storage repository.
Step 4. Limiting Migrations Sessions - this step configures the maximum numbers of simultaneous migration sessions to a half of all threads configured for the selected backup proxy server (for example, if there are 64 threads configured on a backup proxy server, it would limit migration sessions to 32 migration sessions).
Step 5. Disabling all Jobs for Selected Organization - this step disables all backup jobs created for the specified organization.
Step 6. Creating a list of source repositories - Creates a list of backup repositories used by the backup jobs from the step 5 that will be used as a source repositories (if a repository is not in use by at least one backup job, the data residing there would not be migrated).
Step 7. Getting and Migrating all Users - this step creates a list of all Users, Sites, and Groups located in the repositories from step 6 and then migrates their data.
Step 8. Reconfiguring Job to Use New Repository - this step 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 on step 5.
For the ease of use, each step is provided with a corresponding comment in the script.
KB ID: | 3067 |
Product: | Veeam Backup for Microsoft Office 365 |
Version: | 4.0 |
Published: | 2019-12-16 |
Last Modified: | 2020-10-08 |