VMware Import Scans Succeed but File Downloads Fail
A VMware Service connects to vCenter and scans VMs, but backup or import jobs fail with "server refused connection" when pulling files. Usually DNS or port 902 reachability to the ESXi hosts.
Symptoms
The VMware Service connects to vCenter and scans VMs without errors.
A backup or import job starts, then pauses, retries, and fails after several attempts.
The service log shows the snapshot succeed, then a run of download errors:
Error: The server refused connection
Error downloading file: [<datastore>] <VM>/<VM>.nvram
Error downloading file: [<datastore>] <VM>/<VM>.vmxf
Error downloading file: [<datastore>] <VM>/<VM>.vmx
Backup job paused due to encountering an error. Will retry again in approximately Nm (#k of 10)The failure hits every file, including the small config files (
.vmx,.vmxf,.nvram) — not only the large virtual disks.
Overview
The VMware Service uses vCenter only to enumerate VMs and locate their files. The actual transfer goes directly to the ESXi host that owns the VM's datastore, at the host FQDN that vCenter returns.
If the service can reach vCenter but not that ESXi host, vCenter looks healthy — the scan succeeds — while every download fails with "server refused connection". There are two common causes.
1. DNS. The VMware Service cannot resolve the ESXi host FQDNs that vCenter returns. The usual reason is a wrong or missing DNS server or search domain on the service VM's NIC. This is the most common cause. It also explains why VMs on one cluster back up fine while another cluster fails — the working cluster's hosts happen to resolve.
2. Network or firewall. The host name resolves, but the host is not reachable directly. The transfer needs TCP 443 (vSphere API) and TCP 902 (NFC, the disk data channel) open from the VMware Service to each ESXi host, not only to vCenter. Port 902 is the one most often missed.
Diagnosis
In vSphere, note the FQDNs of the ESXi hosts in the cluster that owns the failing VM's datastore. These are the names VergeOS connects to.
In VergeOS, navigate to Import/Export > VMware Services and double-click the service.
Select View Service > Diagnostics.
From the Diagnostics panel, try to resolve and reach each host FQDN.
If a name does not resolve, the cause is DNS.
If a name resolves but does not connect, check the firewall and port 902.
Solution
Set the VMware Service VM's NIC to a DNS server that resolves the ESXi host FQDNs, or add the correct search domain. See Configuring VMware Service VM NIC IPv4 Settings.
Make sure TCP 443 and 902 are open from the VMware Service to each ESXi host, not only to vCenter.
Run the job again. The downloads proceed past the config files and into the virtual disks.
Additional Resources
Last updated
Was this helpful?