The VMware Knowledge Base provides support solutions, error messages and troubleshooting guides
Installing VMware Tools in a Linux virtual machine using a Compiler (1018414)
Note: For an overview of installing VMware Tools, see Overview of VMware Tools (340).
Note: If your Linux distribution is not RPM-based, has a custom kernel, or is unsupported, use the steps below to compile VMware Tools, otherwise, see Installing VMware Tools in a Linux virtual machine using RPM (1018392).
To install VMware Tools in a Linux guest operating system using Compiler:
- Ensure that your Linux virtual machine is powered on.
- If you are running a GUI interface, open a command shell.
Note: Log in as a root user, or use the sudo command to complete each of these steps.
- Click VM in the virtual machine menu, then click Guest > Install/Upgrade VMware Tools.
- Click OK.
Note: In some cases, verify that the CDROM device is Connected from within the Edit Settings option of the virtual machine.
- To create a mount point, run:
- To mount the CDROM, run:
mount /dev/cdrom /mnt/cdrom
- To copy the Compiler gzip tar file to a temporary local directory, run:
cp /mnt/cdrom/VMwareTools-version.tar.gz /tmp/
Where version is the VMware Tools package version.
- To determine the version of VMware tools, run:
You see output similar to:
- To change to the tmp directory and extract the contents of the tar file into a new directory called vmware-tools-distrib, run:
tar -zxvf VMwareTools-version.tar.gz
- To change directory to vmware-tools-distrib and run the vmware-install.pl PERL script to install VMware Tools, run:
- Complete the screen prompts to install the VMware Tools. Options in square brackets are default choices and can be selected by pressing Enter.
- To compile VMware Tools successfully, you need gcc Compiler and Linux Kernel sources provided by your Linux distribution. Consult your Linux distribution documentation for details on methods to install these packages.
- It is normal for the console screen to go blank for a short time during the installation when the display size changes.
- Some warnings or errors are normal, like when a files does not exist.
- Depending on the Linux distribution, your network service might restart after installation. VMware recommends that you invoke this command from the console and not remotely.
- If you are running a GUI interface, restart your X Window session for any mouse or graphics changes to take effect.
- To start VMware Tools running in the background during an X Window session, run:
- Depending on your environment, you may need to unmount the CD-ROM. To unmount the CD-ROM, run:
- Depending on your environment, you may need to manually end the VMware Tools installation. To end the VMware Tools install, click VM in the virtual machine menu, then click Guest > End VMware Tools Install.
- To remove VMware Tools installation packages, run:
rm -rf /tmp/vmware-tools-distrib
If you experience a symbolic link creation error during installation, see Unable to create the symbolic link when installing VMware Tools in Linux (2010580).
If you are running an unsupported distribution or using an unsupported kernel version and are not able to compile modules or install VMware Tools, VMware recommends that you explore the VMware community support forums. There are regular discussions on the forums about the latest development kernels and workarounds for building VMware Tools modules.
VMware tools can be uninstalled using the /usr/bin/vmware-uninstall-tools.pl script. For related information, see Installing VMware Tools in vSphere (2004754).
Note: VMware Tools no longer includes drivers for x Server 1.8 or higher. Ensure that these SVGA and mouse drivers are installed before installing VMware Tools:
For translated versions of this article, see:
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.