Manual Installation of HBR Agent VIB on ESXi Hosts to Allow HCX Bulk Migration of Encrypted VMs
Article ID: 404300
Updated On:
Products
Issue/Introduction
During an HCX 4.11 or VCF 9.x bulk migration workflow for an encrypted VM, one of the following validation alerts will be seen if the Host Based Replication agent vSphere Installation Bundle (HBR agent VIB) is not installed on the source ESXi host:
"HBR-agent is not installed on source ESXi host for encrypted VM migration""HBR-agent is installed but not running on source ESXi host, running state is required for encrypted VM migration"
You must manually install the HBR agent VIB on the ESXi host to allow HCX bulk migration of an encrypted VM, as outlined in the HCX 4.11 release notes.
HCX does not provide a way to install this VIB automatically to avoid a potential conflict with the installation of the same VIB on the hosts via vLCM operations.
Note that if the HBR agent VIB is manually installed on a host that is part of a vLCM-managed cluster, and the vLCM cluster image does not include the HBR Agent component, then vLCM will automatically remove the VIB during image remediation or compliance enforcement. To avoid this scenario, you can also import the HBR agent file into vLCM.
When checking the ESXi host, the hbr-agent is not listed.
- Run the command to list the installed VIBs required:
esxcli software vib list | grep -i hbr - Only the
vmware-hbrsrvvib is returned and not thevmware-hbr-agent.- Expected result from an ESXi host with the
vmware-hbr-agentVIB installed:
- Expected result from an ESXi host with the
Environment
VMware HCX 4.11
Cause
The HBR agent VIB must be manually installed on the ESXi host in order to allow HCX bulk migration of an encrypted VM
Resolution
Open a Broadcom support case and refer to this knowledge article to get assistance with manually installing the HBR agent VIB.
For more information, see Creating and managing Broadcom support cases.
Additional Information
Feedback
