Veeam VM Migrator Utility
Veeam Backup & Replication tracks VMs in jobs using Managed Object Reference IDs (MORef-IDs), which change after migration or recreation of vCenter, causing MORef-ID misalignment.
Veeam VM Migrator utility is integrated into Veeam Backup PowerShell module and it allows you to resolve MORef-ID misalignment. As a result, your backup incremental chains will remain intact after an inventory change in vCenter.
The utility consists of the following cmdlets:
- Set-VBRVmBiosUuid — this cmdlet updates the BIOS UUIDs of existing VM entries within the Veeam Backup & Replication configuration database based on information from the old vCenter.
- Set-VBRVCenterName — this cmdlet modifies vCenter name by adding the _old suffix to its name.
- Generate-VBRViMigrationSpecificationFile — this cmdlet generates a migration task file which contains the list of mapping tasks.
- Start-VBRViVMMigration — this cmdlet starts MORef-IDs update.
For more information on the utility cmdlets, see Veeam PowerShell Reference guide.
How VM Migrator Utility Works
Veeam VM Migrator utility performs migration the following way:
- [Optional] Updates BIOS UUIDs of VMs located on the old vCenter to ensure future mapping accuracy.
- [Optional] Renames the old vCenter name by adding the _old suffix to its name.
- Scans old and new vCenters for VM references, and creates mapping tasks.
- Generates a migration task file which contains mapping tasks.
- Uses previously generated migration task file to perform VMs MORef-IDs update.