2 bugs with Azure Arc Resource Bridge upgrade on VMware

Daniel Wilkins 20 Reputation points
2026-07-30T13:26:03.1733333+00:00

Hello,

I came across 2 bugs while upgrading our on-premise Azure Arc Resource Bridge this week, hosted in our VMware environment.

The first was when upgrading from v1.6.0 to v1.7.0, and it throwing an error regarding our datastore. Looking into it, the ARB was originally installed on a vVol datastore, then later moved to a newer VMFS 6 datastore. The vVol datastore was deleted this year. I edited the .yaml file to replace the old datastore name with the new one, and the upgrade got further, but then still appeared to reference the old datastore name later in the upgrade process and I was unable to proceed. I ended up creating a new ARB.

With the new ARB up and running, on v1.5.0, I upgraded to 1.6.0, then 1.7.0, but was then not able to upgrade any further due to what appears a DNS issue in the 1.8.0 upgrade process. I was seeing errors relating to the FQDN on our vCenter server and not being able to resolve it. It seems it was using a different DNS server (10.96.0.10) to what was in the .yaml file. Re-running the upgrade, but entering the IP address of vCenter, worked.

Azure Arc
Azure Arc

A Microsoft cloud service that enables deployment of Azure services across hybrid and multicloud environments.

0 comments No comments

Answer accepted by question author

Jerald Felix 17,640 Reputation points Volunteer Moderator
2026-07-30T17:19:09.1166667+00:00

Hello Daniel Wilkins,

Greetings! Thanks for raising this question in the Q&A forum.

Both of the issues you ran into match documented behavior for Arc resource bridge on VMware, and the workarounds you landed on are the correct ones.

Issue 1 — datastore reference after moving off the original vVol datastore

This is a known limitation rather than a bug in the upgrade logic itself. Arc resource bridge tracks the appliance VM's original deployment path (datastore, resource pool, folder) internally, and Microsoft's own troubleshooting documentation confirms that editing the config YAML file or manually relocating the VM in vCenter does not update these internal references, which is exactly what you hit: the upgrade got further after your YAML edit but then failed again referencing the old, deleted vVol datastore. The appliance VM effectively can't be moved from its original location path; if any component in that path changes, the appliance loses its Azure connection, and the only supported path forward at that point is what you did, deploying a new resource bridge rather than trying to force the existing one to recognize the new path. For future moves, plan to redeploy the appliance rather than relocate it or hand-edit the YAML.

Issue 2 — DNS resolution failure for the vCenter FQDN during the 1.8.0 upgrade

This also matches two documented causes. First, Microsoft's troubleshooting guide notes that the appliance VM must be able to reach a DNS server that resolves internal names such as the vCenter endpoint, and that this must work independently of whatever's configured in your YAML at deploy time, since the upgrade process stages a new appliance VM and control plane that need working DNS resolution during that staging window. Second, if your vCenter FQDN uses a .local suffix, there's a separate documented issue: the appliance VM runs Azure Linux OS, which does not resolve .local domains by default (that suffix is reserved for multicast DNS on most Linux distributions), and the documented workaround is exactly what you did, supplying the IP address instead of the FQDN. The 10.96.0.10 address you saw is very likely the internal Kubernetes cluster DNS service IP that the resource bridge's own control plane uses, rather than a value read directly from your YAML, which explains why editing the YAML's DNS entry didn't change what you saw in the error.

Where to report this so it gets tracked as a bug

Since you've already worked around both issues, if you'd still like Microsoft to look at these as potential product gaps (particularly the datastore reference not updating from a YAML edit), the best path is either:

  • Open a Support case against Azure Arc so it gets logged against the resource bridge product group with your appliance's diagnostic logs attached, or
  • File an issue against the Azure/ArcResourceBridge GitHub repository, which Microsoft uses to track resource bridge release notes and known issues.

If this answer helps you kindly accept the answer which will help others who have similar questions.

Best Regards,

Jerald Felix.

Was this answer helpful?

1 person found this answer helpful.
0 comments No comments

0 additional answers

Sort by: Most helpful

Your answer

Answers can be marked as 'Accepted' by the question author and 'Recommended' by moderators, which helps users know the answer solved the author's problem.