This article describes the troubleshooting steps in case of a Virtual Appliance installation failure
This article applies to:
- Acronis Backup for VMware (Acronis vmProtect)
The installation of Acronis Virtual Appliance fails with the following error in the log file (the log file is located in the %temp% directory):
Failed to deploy the virtual appliance on the following ESX(i) hosts: [HostIP]
Agent initialization failed.
1) One of the parameters was invalid
2) Failed to resolve host
3) There was an error in communication
The errors mentioned above are returned to Acronis Backup for VMware (Acronis vmProtect) installer from the vSphere environment, where the Virtual Appliance deployment is attempted. Please see the Solutions section for each of these issues causes and resolutions.
- One of the parameters was invalid. This error may appear if the Acronis Backup for VMware (Acronis vmProtect) installer called for an unsupported function for particular ESXi host (which you specified as the target for the deployment).
- Typically this error appears when you try to deploy Acronis vmProtect 7 onto ESXi 5.1 host. This is unsupported. Support for 5.1 vSphere is added in Acronis vmProtect 8 only. See details in Acronis vmProtect 7: Supported Environments.
- Failed to resolve host. This error means that the installer could not resolve some host names to their IP addresses. Typically this happens due to DNS issues under the following conditions:
- You run the installation from the machine where vCenter is installed and specify the same vCenter for connection. If it is Windows 2008 or higher, then the specified hostname is resolved to IPv6 (enabled by default) address which is unsupported by Acronis Backup for VMware (Acronis vmProtect) installer which results in connection failure. The solution is to specify the vCenter address in the installer using its IPv4 address or make sure that the hostname of the vCenter is resolved to IPv4 address from this machine (this can be done by modyfing the \windows\system32\drivers\etc\hosts file for example).
- You run the installation, specify the vCenter address for connection and select some of the ESX(i) hosts registered under this vCenter. The ESX(i) hosts were registered under the vCenter using their DNS names instead of IPs. To resolve the issue ensure that pinging the ESX(i) hosts DNS names is working properly on the machine where you run the installation from (i.e. the DNS name is resolved to IPv4 address).
- There was an error in communication. This is a general VIX error indicating low-level communication problems between the agent (Acronis Agent) executing the VIX operation and the ESX(i) host (for the error description see VMware KB: Error Codes). It is most likely caused by the network settings applied to the machine where you are running the installation from which has problems connecting to the ESX(i) host on TCP port 902 and/or 443.
- Check the firewall settings of the ESX(i) host to ensure that the necessary ports are opened.
See also Acronis Backup for VMware 9.