build 980262fe | content blog-content@c8490fa · 338 posts | profiles 20 · corpus 208 | 0 skipped |
How-To · 2025-12-12

VLR Appliance 9.0.4 – HBR-Agent can't be installed

You installed VLR Appliance 9.0.4 and it will not install the Host Based Replication Agent for ESX. If you run a vSAN stretched cluster, there is a workaround.

2025-12-12Date
Daniel StadelmannAuthor
1Min read
263words
no translation reviewed
Topics capabilities · idf weight Cloud cloud 2.20 Virtualization virtualization 1.59
Vendors vendors · idf weight VMware vmware 0.91

Have you just installed VLR Appliance 9.0.4 and are you stuck on “The Host Based Replication Agent for ESX can’t be installed on ‘domain-cxx’. The vLCM image has deltas that need to be applied”?

Then I have good news. If you run a vSAN stretched cluster, there is a workaround.

VMware confirmed to me this morning that the fix arrives with VLR 9.1.

The cause

It sits in vLCM. After the auto-install of the HBR agents on every host in the cluster, the appliance waits for a compliance message. It never comes, because the Witness Host, which is part of the logical construct, does not report compliant. There is no way to override that manually.

VMware’s official statement: “The issue is because vLCM is considering witness host as part of the cluster.
VLR is checking if hbr-agent is installed on the witness host or not. There is some delta reported by the vLCM cluster which is why we are not pushing the hbr-agent.”

The fix

With 9.1 the HBR agent becomes part of the ESX image, which makes the VLR appliance’s auto-install unnecessary. On top of that the handling of the Witness Appliance is being reworked in code, so the error should not come back.

The workaround

To stop the constant compliance checking for now, disable the auto-install on the VLR appliance.

Connect to the appliance with Putty, then

vi /opt/vmware/etc/hms/hms-configuration.xml

search for the following value with /

true

set it to “false” and restart the service

service hms restart

Trouble or questions? Get in touch.

You might also like