Knowledge Base

The VMware Knowledge Base provides support solutions, error messages and troubleshooting guides
 
Search the VMware Knowledge Base (KB)   View by Article ID
 

Troubleshooting a failed VMware Tools installation in a Guest Operating System

Symptoms

  • VMware Tools installation errors before completion.
  • VMware Tools installation fails to complete.
  • Unable to complete VMware Tools for Windows and/or Linux installations.
  • VMware Tools hangs when installing or-reinstalling.
  • You may receive one or more of these errors:
    • An error occurred during the move data process: -623 File name is.
    • The system administrator has set policies to prevent this installation
    • The Windows installer service could not be accessed. This can occur if you are running windows in safe mode, or if windows installer is not correctly installed. Contact your support personnel for assistance
    • Error 1316 A network error occurred while attempting to read the file.
    • Error 1706. Setup cannot find the required files
    • Error 1714 The older version of VMware Tools cannot be removed.
      Error 1722: There is a problem with Windows Installer Package. A program run as part of the setup did not finish as expected. Contact your support personnel or package vendor.
    • The system administrator has set policies to prevent this installation
    • Failed dependencies: glibc-common

Purpose

This article guides you through troubleshooting the installation of VMware Tools on guest operating systems.  

Resolution

Please validate that each troubleshooting step below is true for your environment. Each step will provide instructions or a link to a document, in order to eliminate possible causes and take corrective action as necessary. The steps are ordered in the most appropriate sequence to isolate the issue and identify the proper resolution. Do not skip a step.

  1. Verify that the guest operating system you are trying to install VMware Tools in is fully certified. See Supported Guest Operating Systems (341) for an outline of which guest operating systems are certified for each version of ESX/ESXi. If your guest operating system is not listed, the following steps may help to install VMware Tools, but be aware that installation is not always possible in an uncertified guest operating system.

  2. Verify that the correct guest operating system is selected. For more information, see Ensuring the correct Guest Operating System is selected (1003912).

  3. Verify that the correct ISO image is being loaded. For more information, see Ensuring the correct VMware Tools ISO image is loaded (1003910).

  4. Verify that the VMware Tools ISO image has not been corrupted. For more information, see Determining if your VMware Tools ISO image is corrupt on an ESX/ESXi host (1004820).

  5. If installing on a Windows operating system, ensure that you are not experiencing any issues with your Windows registry. For more information on troubleshooting registry issues with VMware Tools, see Unable to upgrade existing VMware Tools (1001354).

  6. If installing on a 64-bit Linux guest operating system, ensure that there are no dependencies missing. For more information, see VMware Tools installation fails to start the guest operating system daemon on 64-bit Linux Guest Operating Systems with the 32-bit glibc-common package installed (1023185).

Note: If your problem still exists after trying the steps in this article:

Additional Information

For related troubleshooting information, see General VMware Tools installation instructions (1014294).

Note: If VMware tools Install hangs, verify if running a custom install of VMware tools rather than a typical or complete install addresses the issue. Also disable the thin print component.

In addition, see these articles for further assistance troubleshooting specific issues with VMware Tools:

Tags

install-vmware-tools install-vmware-tools-fails upgrade-vmware-tools guest-os-vmware-tools-fails

See Also

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.

Feedback

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)
Actions
  • Bookmark Document
  • Email Document
  • Print Document
  • Subscribe to Document
  • Bookmark and Share