Search the VMware Knowledge Base (KB)
View by Article ID

Troubleshooting Agent Unreachable status in VMware Horizon View (2083535)

  • 12 Ratings


  • Your virtual machine is unresponsive. 
  • The operating system freezes or fails.
  • The virtual machine shuts down or boots up, the agent service is not running.
  • Incorrect network configuration or connection issues between View Connection Server and the View Agent.


The Agent Unreachable status occurs when the View Connection Server is unable to establish communication with the View Agent on a VMware View virtual machine. This issue may also occur if the View Composer Database is full. 

Troubleshoot an Agent Unreachable status

To troubleshoot the cause of an Agent Unreachable status:

  1. If multiple Connection Servers are present, ensure that ADAM replication is occurring. For more information, see Confirm ADAM replication in the next paragraph.
  2. Ensure that the virtual machine is powered on and the operating system is responsive.
  3. Ensure that there is a valid IP address and network connectivity between the virtual machine and connection server. If the IP address starts with 169.254.x.x, this means an Automatic Private IP Address has been assigned. For more information, see the Microsoft TechNet article Troubleshooting DHCP Clients.

    Note: The preceding link was correct as of November 7, 2014. If you find the link is broken, provide feedback and a VMware employee will update the link.

  4. Confirm the virtual network adapter is correct in vCenter Server. For more information, see the Virtual machine Custom Configuration Parameters section in the VMware Horizon View Administration Guide.

    Note: When a virtual machine installed with view agent has more than one NIC, you must configure the subnet that view agent uses by modifying registry settings as:

    HKLM\Software\VMware, Inc.\VMware VDM\Node Manager\subnet = n.n.n.n/m (REG_SZ)

  5. To confirm the network label configured is correct and Connect at Power On is configured edit the virtual machine settings in vCenter Server. If there are multiple NICs configured, ensure that the correct NIC is selected.
  6. Migrate the View virtual machine to another host and check for connectivity.
  7. Provision an additional virtual machine to verify if the issue persists.
  8. Ensure the firewall configuration. For more information, see:

Confirm Adam replication

To confirm ADAM replication:

  1. Log in to the View Administrator console on each Connection Server.
  2. Verify the status is consistent on all Connection Servers.
  3. To display the replication neighbors and the last time they replicated, run this command on all Connection Brokers in the same ADAM instance:

    C:\WINDOWS\adam\repadmin.exe /showrepl localhost:389 DC=vdi,DC=vmware,DC=int

    Note: In Windows 2008 R2, run this command in C:\WINDOWS\system32.

    To force the replication, run this command on all Connection Brokers in the same ADAM instance:

    C:\WINDOWS\adam\repadmin.exe /replicate    dc=vdi,dc=vmware,dc=int

    Note: Local and remote hostnames should be replaced with the FQDN of the actual machines where an attempt to force replication is made.

For additional information, see:

For translated versions of this article, see:

    日本語: VMware Horizon View でのエージェントにアクセスできないステータスをトラブルシューティングする (2090869)
    简体中文: 对 VMware Horizon View 中的“无法访问代理”状态进行故障排除 (2090959)


view agent Agent Unreachable

Request a Product Feature

To request a new product feature or to provide feedback on a VMware product, please visit the Request a Product Feature page.


  • 12 Ratings

Did this article help you?
This article resolved my issue.
This article did not resolve my issue.
This article helped but additional information was required to resolve my issue.

What can we do to improve this information? (4000 or fewer characters)

Please enter the Captcha code before clicking Submit.
  • 12 Ratings