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:

1. [Optional] Updates BIOS UUIDs of VMs located on the old vCenter to ensure future mapping accuracy.
2. [Optional] Renames the old vCenter name by adding the _old suffix to its name.
3. Scans old and new vCenters for VM references, and creates mapping tasks.
4. Generates a migration task file which contains mapping tasks.
5. Uses previously generated migration task file to perform VMs MORef-IDs update.