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

Troubleshooting a failed VMware Tools installation in a Guest Operating System (1003908)

  • 18 Ratings


  • 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

  • In the vminst.log file located at %TEMP%, you see an error similar to:

    tools-build-493255: 03/29/12 09:49:04 Attempting to launch "printui.exe /ia /f "C:\Program Files\Common Files\VMware\Drivers\Virtual Printer\TPOGPS\OEMPRINT.INF" /r "TPVM:" /m "TP Output Gateway PS" /Y /K /h3"


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


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 the VMware Compatibility Guide 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 Installing VMware Tools manually from the ISO image (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


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

See Also

Update History

03/30/2012 - Added additional symptom 05/07/2012 - Updated title of referenced article 1012693

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.


  • 18 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.
  • 18 Ratings