Knowledge Base
The VMware Knowledge Base provides support solutions, error messages and troubleshooting guides

|
Ensuring the correct VMware Tools ISO image is loaded
Symptoms
-
VMware Tools installation errors before completion.
-
VMware Tools installation fails to complete.
-
Unable to complete VMwareTools installation.
-
VMware Tools installation is not responding.
-
You receive the following error:
General system error occured: Invalid fault.
Resolution
Ensuring the VMware Tools ISO image has been loaded in Windows guest operating systems
In a Windows guest operating system the VMware Tools installation may fail to start after you choose Install VMware Tools if the Autostart option is disabled.
To manually start the VMware Tools Installer:
-
Connect to the ESX Server host your virtual machine resides on or connect to your VirtualCenter server with the VMware Infrastructure Client (VI Client).
-
Right-click the virtual machine you want to install VMware Tools on, in your inventory. Choose to cancel or end the VMware Tools installation.
-
Right-click the virtual machine you want to install VMware Tools on, in your inventory. Choose to install VMware Tools.
-
Click OK or Install when prompted.
-
If the installer does not start:
-
Click Start > Run from the inside guest operating system.
-
Type D:\setup.exe, where D: is the first CD-ROM drive configured for your virtual machine.
-
Click OK to start installing VMware Tools.
-
-
If the setup fails to start as the ISO was not mounted to the CD-ROM drive:
-
Right-click the virtual machine you want to install VMware Tools on, in your inventory. Choose Edit Settings.
-
Select CD/DVD Drive.
-
Ensure the Connected check box is selected.
-
Choose Datastore ISO file > Browse > vmimages > tools-isoimages > windows.iso
-
Complete step 5 again.
-
-
If you still experience problems getting the installation to start, see Confirm ISO image is not corrupt (1004820).
Ensuring the VMware Tools ISO image has been loaded in Linux guest operating systems
In a Linux guest operating system, the VMware Tools installation may fail to start after you choose Install VMware Tools if the Autorun or Automount option are not available.
To manually start the VMware Tools Installer:
-
Connect to the ESX host your virtual machine resides on or connect to your VirtualCenter server with the VI Client.
-
Right-click the virtual machine you want to install VMware Tools on, in your inventory. Choose to cancel or end the VMware Tools installation.
-
Right-click the virtual machine you want to install VMware Tools on, in your inventory. Choose to install VMware Tools.
-
Log in to the virtual machine as root.
-
Mount the ISO as a CD-ROM:
mount /dev/cdrom /mnt/cdrom
Note: You can also use the instructions given in step 6 of the Windows section to mount the Linux.iso file. -
Run this command to see a tarball and a Red Hat Package Manager (RPM) file under the CD-ROM directory:
ls /mnt/cdrom -
Run this command to install using the RPM:
rpm -i /mnt/cdrom/VMwareTools-<esx version>.i386.tar.rpm -
Run this command to install using the tarball:
cd /tmp
tar -zxvf /mnt/cdrom/VMwareTools-<esx version>.i386.tar.gz -
Run this command to unmount the CD-ROM
umount /mnt/cdrom -
If you unpacked the tarball, run the VMware Tools installer.
Change the directory to vmware-tools-distrib and run ./vmware-install.pl .
It is normal for the console screen to go blank for a short time during the installation when the display size changes. -
After the installation completes restart your X session for any mouse or graphics changes to take effect. Press Ctrl + Alt + Del.
-
Run this command to start the tools running in the background during an X server session:
/usr/bin/vmware-toolbox & -
Run this command to delete the extracted directory created in step 8, after you have finished installing VMware Tools:
rm -rf /tmp/vmware-tools-distrib
Tags
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.
Actions
- KB Article:
- Updated:
- Categories:
- Product Family:
- Products:
- Product Versions:

