VMware Player online course

Install VMware Tools in a Linux Guest Using VMware Player

Learn how to install VMware Tools manually in a Linux guest with VMware Player, including open-vm-tools, the VMware Tools ISO, prerequisites, verification, and troubleshooting.

VMware Tools is guest software that provides drivers and integration services between a virtual machine and VMware Player. This lesson explains how to install it in a running Linux guest when Easy Install did not install the tools automatically.

The guest operating system is the Linux system running inside the virtual machine. The host operating system is the physical computer system running VMware Player. Windows guests use a different installation procedure; see Install VMware Tools in Windows for that case.

What VMware Tools provides

VMware Tools supplies guest-side drivers, services, and integration components. Depending on the Linux distribution, desktop environment, VMware Player version, and display server, it can provide:

  • Better display handling and dynamic resolution changes.
  • Smoother mouse movement and pointer integration.
  • Guest and host time synchronization.
  • Shared clipboard and drag-and-drop support where available.
  • Cleaner shutdown, restart, suspend, and other guest operations.
  • Support for other VMware guest integration features, such as shared folders when the required components are installed.

Some features are unavailable in particular desktop sessions or require additional configuration. Installing the tools does not guarantee that every integration feature works with every Linux display server.

When a manual installation is needed

Easy Install is a VMware-assisted operating system installation process that can automate parts of a supported guest installation. For some Linux installations, it can also install VMware Tools during setup.

Use a manual procedure when Easy Install was not used, when it failed to install the tools, or when you need to repair an existing installation. Power on the VM and log in to Linux before beginning. You need root privileges directly or through sudo.

Choose an installation source

Linux guests commonly have two possible VMware Tools sources. Use one supported implementation rather than installing both implementations on top of each other.

Installation method: Distribution package method with open-vm-tools

Best use case: Current Linux distributions that provide VMware guest tools through their repositories.

Installation source: The Linux distribution package manager.

Key dependencies: The standard tools package and, for graphical desktops where applicable, a desktop integration package.

Maintenance approach: Update the packages with the normal system update process. This is often the distribution-supported choice.

Installation method: VMware Player ISO and legacy Perl installer

Best use case: Following VMware Player's Install VMware Tools workflow, or using a distribution where the packaged option is unavailable.

Installation source: The VMware Tools ISO attached to the VM's virtual CD/DVD drive.

Key dependencies: Perl, root privileges, and possibly compiler tools, make, and matching kernel headers.

Maintenance approach: Revisit the VMware Player installer when appropriate and rebuild or update modules after kernel changes.

Method 1: Install open-vm-tools from the distribution

First search your repository for VMware guest tools. On Debian- or Ubuntu-family systems, for example:

apt-cache search open-vm-tools

Install the standard package:

sudo apt-get update
sudo apt-get install open-vm-tools

For a graphical desktop, the desktop integration package may also be required:

sudo apt-get install open-vm-tools-desktop

Package names and commands vary. Use the equivalent package manager for your distribution, such as dnf, yum, zypper, or pacman. Restart the guest, or restart the affected desktop session, when the package documentation requests it.

Afterward, check the service when the distribution uses a systemd service:

systemctl status open-vm-tools

If this method works, do not also install the legacy ISO tools unless your distribution or VMware documentation specifically requires it.

Method 2: Install from the VMware Tools ISO

1. Prepare the virtual CD/DVD device

  1. Power on the Linux VM and log in.
  2. In VMware Player, select Player > Manage > Virtual Machine Settings.
  3. Select the first virtual CD/DVD device.
  4. Configure it so VMware Player can attach the VMware Tools virtual CD image. In older VMware Player interfaces, this may mean selecting the physical-drive Auto Detect setting.
  5. Make sure the device is connected. The guest cannot read the installer media if the virtual CD/DVD drive is disconnected.

If the VM has no suitable optical device, add one through the virtual machine hardware settings. The Add a CD-ROM Drive guide covers that hardware task.

2. Start the VMware Player installation action

With the guest running, choose Player > Manage > Install VMware Tools. Depending on the VMware Player release, Player may ask to download the tools image. Accept the download prompt if the image is not already available and allow Player to attach it to the virtual CD/DVD device.

The attached image is called the VMware Tools ISO: a virtual optical-disc image containing the legacy VMware Tools installer. The guest desktop may mount it automatically and display it as a disc. If it does not, locate the device and mount it manually using your distribution's normal removable-media procedure.

3. Check the Linux prerequisites

Open a terminal. Verify that Perl, the scripting language runtime used by the legacy installer, is available:

perl -v

If the command is missing on an Ubuntu-family guest, install it with:

sudo apt-get install perl

The installer may also need compiler and kernel development files to build host modules. Typical requirements include a compiler, make, and kernel headers matching the currently running kernel. A package manager may report the exact missing package names.

Requirement: Perl

Why it is needed: Runs the legacy vmware-install.pl script.

How to verify: perl -v

Ubuntu-family example: sudo apt-get install perl

Notes: Install it in the guest, not on the host.

Requirement: Build tools

Why it is needed: Compiles VMware kernel modules when modules are required.

How to verify: Check whether the compiler and make commands are available, or read the installer's error.

Ubuntu-family example: Install the distribution's build-essential package.

Notes: Package names vary by distribution.

Requirement: Kernel headers or development package

Why it is needed: Provides files for compiling modules against the running kernel.

How to verify: Compare the running kernel from uname -r with the installed header package version.

Ubuntu-family example: Install the headers package matching uname -r.

Notes: A kernel update can leave the headers mismatched or absent.

Requirement: Administrative access

Why it is needed: Installs system files, services, and drivers.

How to verify: Confirm that sudo works or that you can log in as root.

Ubuntu-family example: Prefix administrative commands with sudo.

Notes: Do not grant administrative privileges to untrusted files.

Requirement: Connected virtual CD/DVD device

Why it is needed: Gives Linux access to the VMware Tools ISO.

How to verify: Check VMware Player hardware settings and the output of mount.

Ubuntu-family example: Use Player's CD/DVD settings and the desktop's mounted-media view.

Notes: Mount locations differ between distributions.

4. Find the mounted installer media

A mount point is a directory where Linux makes removable media accessible. Mount locations vary; examples include directories under /media, /run/media, or /mnt. Do not assume a fixed path.

Display current mounts:

mount

Look for a CD-ROM or ISO entry and note its directory. Then list that directory, replacing the placeholder with the path reported on your system:

ls -l <mount-point>

Find the versioned VMware Tools compressed archive. Its name commonly begins with VMwareTools and ends in .tar.gz, but always use the exact filename shown by ls.

5. Extract the archive outside the CD mount

Optical media is normally read-only, so create a temporary working directory on the guest filesystem:

mkdir -p /tmp/vmware-tools
cd /tmp/vmware-tools

Copy the archive from the mounted media, replacing both placeholders with the actual mount point and archive filename:

cp <mount-point>/<VMWARE_TOOLS_ARCHIVE> .

Extract it with tar, which is a file archive utility:

tar zxpf <VMWARE_TOOLS_ARCHIVE>

The archive normally creates a directory containing the installer script. Change into that extracted directory, then run the script with administrative privileges:

cd vmware-tools-distrib
sudo perl vmware-install.pl

Use the exact extracted directory name if it differs. Run the installer from the extracted working directory rather than directly from the mounted CD.

6. Answer the installer questions

The Perl installer asks configuration questions about paths, modules, and services. For a standard desktop VM, the displayed defaults are generally appropriate. Press Enter to accept a default unless you have a specific reason to change it.

Read warnings carefully. If the installer asks to compile modules and reports missing compiler tools or kernel files, stop and install the required prerequisites before trying again.

7. Reboot and verify

Reboot after the installation so drivers, modules, and services can load fully:

sudo reboot

After Linux starts, test practical integration features. Resize the VM window and check whether the guest display follows the new size. Move the pointer between host and guest, and test clipboard or drag-and-drop if those features are supported and enabled.

For an ISO installation, the exact service or status command varies by release. Check the installed VMware-related services and modules using your distribution's service tools and the installer's final output. For a package installation, the following is commonly useful:

systemctl status open-vm-tools

If integration is absent, a successful script exit alone is not enough: verify that the service is running and that the required kernel modules loaded.

Ubuntu example: Linux guest without Easy Install

  1. Boot the Ubuntu VM and log in.
  2. Open a terminal and run perl -v.
  3. If Perl is missing, run sudo apt-get install perl.
  4. Choose Player > Manage > Virtual Machine Settings, select the CD/DVD device, and confirm that it is connected.
  5. Choose Player > Manage > Install VMware Tools and accept the download prompt if shown.
  6. Run mount to identify the mounted media, then use ls -l <mount-point> to find the archive.
  7. Create /tmp/vmware-tools, copy the archive there, and extract it with tar zxpf <VMWARE_TOOLS_ARCHIVE>.
  8. Enter the extracted directory and run sudo perl vmware-install.pl.
  9. Accept normal defaults, resolve any requested build dependencies, and run sudo reboot.

Common installation issues

Symptom: Install VMware Tools is unavailable

Likely cause: The VM is powered off, lacks a usable CD/DVD device, or the device is disconnected.

Diagnostic check: Confirm the VM is running and inspect Player's virtual machine hardware settings.

Resolution: Power on the guest, add or select a CD/DVD device, connect it, and retry the menu action.

Symptom: The tools CD is not visible in Linux

Likely cause: The virtual drive is disconnected, the ISO did not attach, or the desktop did not auto-mount it.

Diagnostic check: Review CD/DVD settings and run mount.

Resolution: Connect the device, retry Install VMware Tools, and mount the device manually when required by the distribution.

Symptom: perl is not found

Likely cause: Perl is not installed in the guest.

Diagnostic check: Run perl -v.

Resolution: Install Perl through the guest package manager and repeat the version check.

Symptom: The installer cannot build modules

Likely cause: Build tools are absent, kernel headers are missing or mismatched, or the guest kernel was upgraded.

Diagnostic check: Compare uname -r with the installed kernel headers and read the installer's error.

Resolution: Install build dependencies and matching kernel development files, boot the intended kernel if necessary, and rerun the installer.

Symptom: Display, clipboard, or pointer integration still fails

Likely cause: Services or modules did not load, conflicting implementations are installed, or the desktop session has compatibility limitations.

Diagnostic check: Check the tools service, loaded modules, installed packages, and desktop-session support.

Resolution: Keep one supported tools implementation, remove conflicts, update VMware Player or guest packages, and consider the distribution-supported open-vm-tools package.

Kernel, Secure Boot, and compatibility considerations

Linux kernel updates can require VMware Tools modules to be rebuilt. If the running kernel changes, install matching kernel headers and rerun the installer or update the distribution-provided tools package.

Secure Boot can prevent unsigned third-party kernel modules from loading. A legacy ISO installer can also fail when it does not understand a newer kernel or desktop stack. Missing headers, unsupported module interfaces, and compiler-version differences can produce similar symptoms.

When the distribution supports open-vm-tools, it is usually easier to maintain because package updates follow the distribution's kernel and service changes. Do not install the ISO-based tools and open-vm-tools together unless the documentation explicitly says that the combination is supported.

Upgrades and final checks

  • For open-vm-tools, use the normal Linux package update process.
  • For the ISO-based installation, use VMware Player's Install VMware Tools workflow when a compatible tools image is available.
  • After a kernel update, verify that tools services run and that required modules load.
  • Confirm display resizing and pointer integration after every repair or upgrade.
  • Keep the temporary extraction directory only as long as needed, then remove it if desired.

For related VMware Player concepts, review VMware Tools Overview, Easy Install Feature in VMware Player, Shared Folders Overview, and Copy and Paste Feature.

Exam-relevant notes

  • VMware Tools runs inside the guest operating system; it is not installed only on the host.
  • open-vm-tools is the open-source, distribution-packaged alternative commonly used by current Linux systems.
  • The legacy VMware Tools ISO installer requires Perl and may require compiler tools and matching kernel headers.
  • A mount point is the directory through which Linux accesses the attached tools media.
  • Extract the tar archive to a writable directory before running vmware-install.pl.
  • Reboot after installation so services and kernel modules can load.