For Linux virtual machines, you manually install or upgrade VMware Tools by using the command line.

Before you begin

  • Power on the virtual machine.

  • Verify that the guest operating system is running.

  • Because the VMware Tools installer is written in Perl, verify that Perl is installed in the guest operating system.

  • To determine whether you have the latest version of VMware Tools, look on the Summary tab for the virtual machine.

  • For vSphere virtual machines, determine whether you have the latest version of VMware Tools. In the vSphere Client inventory, select the virtual machine and click the Summary tab.

About this task

This procedure describes how to use the VMware Tools tar installer to install or upgrade VMware Tools. For virtual machines in a vSphere environment, you can alternatively use VMware Tools operating system specific packages (OSPs) and open-vm-tools to install and upgrade VMware Tools. With OSPs open-vm-tools, you can use the native update mechanisms of your operating system to download, install, and manage VMware Tools. For more information, see Operating System Specific Packages for Linux Guest Operating Systems.

Procedure

  1. Mount the VMware Tools virtual disc on the guest operating system.

    VMware Product

    Action

    vSphere Client

    Inventory > Virtual Machine > Guest > Install/Upgrade VMware

    vSphere Web Client

    Right-click the virtual machine and select Guest OS > Install/Upgrade VMware Tools.

    Fusion

    Virtual Machine > Install (or Upgrade) VMware Tools

    Workstation Pro

    VM > Install (or Upgrade) VMware Tools

    Workstation Player

    Player > Manage > Install (or Upgrade) VMware Tools

  2. Mount the VMware Tools virtual disc on the guest operating system.

    VMware Product

    Action

    vSphere Client

    Inventory > Virtual Machine > Guest > Install/Upgrade VMware Tools

    vSphere Web Client

    Right-click the virtual machine and select All vCenter Actions > Guest OS > Install/Upgrade VMware Tools.

    1. To locate a virtual machine, select a datacenter, folder, cluster, resource pool, host, or vApp.

    2. Click the Related Objects tab and click Virtual Machines.

  3. If you are performing an upgrade or reinstallation, in the Install/Upgrade VMware Tools dialog box, select Interactive Tools Installation or Interactive Tools Upgrade and click OK.

    The process starts by mounting the VMware Tools virtual disc on the guest operating system.

  4. In the virtual machine, log in to the guest operating system as root and open a terminal window.
  5. Run the mount command with no arguments to determine whether your Linux distribution automatically mounted the VMware Tools virtual CD-ROM image.

    If the CD-ROM device is mounted, the CD-ROM device and its mount point are listed as something like this:

    /dev/cdrom on /mnt/cdrom type iso9660 (ro,nosuid,nodev)
  6. If the VMware Tools virtual CD-ROM image is not mounted, mount the CD-ROM drive.
    1. If a mount point directory does not already exist, create it.
      mkdir /mnt/cdrom

      Some Linux distributions use different mount point names. For example, on some distributions the mount point is /media/VMware Tools rather than /mnt/cdrom. Modify the command to reflect the conventions that your distribution uses.

    2. Mount the CD-ROM drive.
      mount /dev/cdrom /mnt/cdrom

      Some Linux distributions use different device names or organize the /dev directory differently. If your CD-ROM drive is not /dev/cdrom or if the mount point for a CD-ROM is not /mnt/cdrom, modify the command to reflect the conventions that your distribution uses.

  7. Change to a working directory, for example, /tmp.

    cd /tmp

  8. Delete any previous vmware-tools-distrib directory before you install VMware Tools.

    The location of this directory depends on where you placed it during the previous installation. Often this directory is placed in /tmp/vmware-tools-distrib.

  9. List the contents of the mount point directory and note the filename of the VMware Tools tar installer.
    ls mount-point
  10. Uncompress the installer.
    tar zxpf /mnt/cdrom/VMwareTools-x.x.x-yyyy.tar.gz

    The value x.x.x is the product version number, and yyyy is the build number of the product release.

    If you attempt to install a tar installation over an RPM installation, or the reverse, the installer detects the previous installation and must convert the installer database format before continuing.

  11. If necessary, unmount the CD-ROM image.
    umount /dev/cdrom 

    If your Linux distribution automatically mounted the CD-ROM, you do not need to unmount the image.

  12. Run the installer and configure VMware Tools.
    cd vmware-tools-distrib
    ./vmware-install.pl

    Usually, the vmware-config-tools.pl configuration file runs after the installer file finishes running.

  13. Follow the prompts to accept the default values, if appropriate for your configuration.
  14. Follow the instructions at the end of the script.

    Depending on the features you use, these instructions can include restarting the X session, restarting networking, logging in again, and starting the VMware User process. You can alternatively reboot the guest operating system to accomplish all these tasks.

Results

The VMware Tools label on the Summary tab changes to OK.

If you are using vCenter Server, the VMware Tools label on the Summary tab changes to OK.

What to do next

If you upgraded VMware Tools as part of a larger, system-wide upgrade, next determine whether to upgrade the virtual machines in your environment. To review and compare the hardware available for different compatibility levels, see Hardware Features Available with Virtual Machine Compatibility Settings.

If you upgraded VMware Tools as part of a vSphere upgrade, next determine whether to upgrade the virtual machines in your environment. To review and compare the hardware available for different compatibility levels, see the vSphere Virtual Machine Administration documentation.