Search
StarWind is a hyperconverged (HCI) vendor with focus on Enterprise ROBO, SMB & Edge

Veeam: re-map MoRef ID of protected VMs when replacing the vCenter Server

  • February 28, 2019
  • 9 min read
Cloud and Virtualization Architect. Paolo is a System Engineer, VCP-DCV, vExpert, VMCE, Veeam Vanguard, and author of the virtualization blog nolabnoparty.com
Cloud and Virtualization Architect. Paolo is a System Engineer, VCP-DCV, vExpert, VMCE, Veeam Vanguard, and author of the virtualization blog nolabnoparty.com

veeam-replace-vcenter-server-01

When you replace the vCenter Server configured in Veeam Backup & Replication, you need to re-map MoRef ID of protected VMs to avoid backup jobs failure.

During the migration to a new vCenter or if an inventory change occurs in the vCenter, the virtual machine MoRef ID changes with the result of a failure of the backup job associated with the error Object with reference <vmname> was not found in the hierarchy cache.

error

To replace the vCenter Server configured in Veeam Backup & Replication, you need to keep same MoRef IDs for all protected virtual machines. In vSphere 6.5 and 6.7, the Upgrade option available in Stage 1: Deploy appliance wizard takes care of migrating also the virtual machine’s MoRef IDs.

If you can’t perform a successfull migration using the VMware Migration utility or if the source vCenter Server is corrupted or failed, as a last resort the migration can be achieved using the vCenter Migration Utility available at Veeam website. Although is not officially supported by Veeam, this tool allows to re-map the MoRef ID’s keeping the backup incremental chains intact.

If you use Cloud Connect repository, the tool cannot fix jobs targeting a Cloud Connect repository but Active Full backup should be used instead.

Before migration

Before using the Migration Tool, make sure to have a valid configuration backup of Veeam Backup & Replication and no backup jobs are currently running.

  • When the migration has been completed successfully, remove the old vCenter from Veeam Backup & Replication configuration.
  • If you have any vLab configured, you need to manually recreate it after the migration has completed.

Backup of the Veeam Backup database

Before proceeding, take a backup of the configuration database to quickly restore the Veeam Backup Server if something goes wrong during the procedure. From the main menu, click on Settings icon and select Configuration Backup.

configuration backup

Click on Backup now button. The backup is being performed.

configuration backup settings

When the backup has completed successfully click OK.

succesful backup

Configure the new vCenter Server

From the Backup Infrastructure area, select Managed Servers > VMware vSphere > vCenter Servers and click Add Server from the menu.

Add Server

Enter the DNS name or IP address of the new vCenter and optionally a Description then click Next.

DNS name or IP address

Specify the Credentials needed to access the new vCenter then click Next.

Credentials

Click Connect to proceed.

connect

Click Finish to add the new vCenter Server.

Finish

The vCenter Server has been added successfully.

veeam-replace-vcenter-server-11

Re-map MoRef IDs with vCenter Migration Utility

Download from Veeam website the vCenter Migration Utility and copy the tool in the Veeam Backup Server.

vCenter Migration Utility

Open the Command Prompt, access the MigrationTool_9.5 directory and run the following command to prepare the list of VMs to migrate:

Command Prompt

Current VM references on the new vCenter are compared with the VM references in the VeeamBackup database and the result is written in a text file created in the MigrationTool_9.5 directory named <old_vCenter>_to_<new_vCenter>_migration_task.

migration tool

The file contains info related to objects found during the pre-migration task. The file can be reviewed and edited as necessary.

info related to objects

Now run the following command to associate the VMs to the new vCenter Server:

command to associate the VMs

The re-mapping of the MoRef ID‘s of the virtual machines procedure has completed successfully.

Check of existing backup jobs

Edit an existing backup job and go to Virtual Machines tab. Click Recalculate to check if virtual machines to protect are properly detected. It can happen that you need to adjust the tags if something has changed in the new vCenter.

Recalculate

Click Add and select the correct Tag or VMs from the new vCenter Server.

Click Add

Select the tag to delete and click Remove.

click Remove

Click Finish to save the new backup job configuration.

Click Finish

Run the backup job

Once the backup jobs have been fixed, select and run a backup job to check if the correct backup chain is used. Right click a backup job and select Run.

select Run

The backup job is being executed. The (Incremental) label at the top indicates the correct backup chain is used.

Incremental

The incrementals are merged in the full backup, it confirms the backup chain hasn’t been altered.

Incremental 2

Also the available backups from the specific backup job show the backup chain remained the same.

the backup chain

When all jobs have been fixed, you can safely remove the old vCenter Server from Veeam Backup Server configuration. Right click the old vCenter Server and select Remove.

Remove

With this procedure you can replace a vCenter Server in your infrastructure without compromise the configured backup chains.

Hey! Found Paolo’s article helpful? Looking to deploy a new, easy-to-manage, and cost-effective hyperconverged infrastructure?
Alex Bykovskyi
Alex Bykovskyi StarWind Virtual HCI Appliance Product Manager
Well, we can help you with this one! Building a new hyperconverged environment is a breeze with StarWind Virtual HCI Appliance (VHCA). It’s a complete hyperconverged infrastructure solution that combines hypervisor (vSphere, Hyper-V, Proxmox, or our custom version of KVM), software-defined storage (StarWind VSAN), and streamlined management tools. Interested in diving deeper into VHCA’s capabilities and features? Book your StarWind Virtual HCI Appliance demo today!