Updated on: 20 MAR 2019

VMware Tools | 27 JULY 2017 | Build 6082533

Check for additions and updates to these release notes.

What's in the Release Notes

The release notes cover the following topics:

What's New
Earlier Releases of VMware Tools
Before You Begin
Internationalization
Compatibility Notes
Installation and Upgrades for This Release
Resolved Issues
Known Issues
Known Issues from Earlier Releases

What's New

VMware Tools is a suite of utilities that enhances the performance of the virtual machine's guest operating system and improves management of the virtual machine.

VMware Tools support for guest operating systems in 10.1.10
- windows.iso supports Windows Vista and later.
- linux.iso supports Linux guest operating systems Red Hat Enterprise Linux (RHEL) 5 and later, SUSE Linux Enterprise Server (SLES) 11 and later, Ubuntu 10.04 and later. It also supports other distributions with glibc versions 2.5 and later.
- darwin.iso supports Mac OS X versions 10.11 and later.
- freebsd.iso supports FreeBSD versions.
- solaris.iso supports Solaris versions.
Resolved Issues: This release of VMware Tools 10.1.10 addresses issues that have been documented in the Resolved Issues section.

Earlier Releases of VMware Tools

For earlier releases of VMware Tools 10.0.0, see the VMware Tools Documentation page.

Before You Begin

VMware Tools ISO images for a few end of life guest operating systems are frozen. Some ISO images are not shipped with ESXi in the tools-light VIB. For more details, see the VMware Tools Documentation page. All VMware Tools ISO images are available for download from http://my.vmware.com.

VMware Tools for Windows are available for download in 32-bit and 64-bit installer executable (.exe) files. These files are provided for easier access and installation of VMware Tools in Windows guest operating systems.

VMware support for VMware Tools for FreeBSD will be frozen at version 10.1.x. VMware recommends using open-vm-tools, redistributed by operating system vendors.The support is ceased with the availability of open-vm-tools from FreeBSD for releases 10.x, 11.x and for the FreeBSD development branch 12.0 currently.

VMware Tools 10.1.x is available and can be installed on supported FreeBSD 10.x OS releases.
VMware Tools 10.1.5 is the last supported version of VMware Tools for FreeBSD that can be installed on FreeBSD 11.x.

Important note about upgrading to ESXi 5.5 Update 3b or later

For the resolution on incompatibility and general guidelines while upgrading ESXi hosts to ESXi 5.5 Update 3b or ESXi 6.0 Update 1 or later, using older versions of Horizon View Agent, refer to the knowledge base articles:

Internationalization

VMware Tools 10.1.10 is available in the following languages:

English
French
German
Spanish
Italian
Japanese
Korean
Simplified Chinese
Traditional Chinese

Compatibility

VMware Tools 10.1.10 is compatible with supported versions of VMware vSphere ESXi 5.5 and later, VMware Workstation 12.0 and VMware Fusion 8.0. See VMware Compatibility Guide for more information.

VMware Tools 10.1.10 enables support for DirectX 10.0 and OpenGL 3.3 on Windows guests when used with VMware Workstation 12.0, VMware Fusion 8.0, and releases of VMware vSphere where the virtual device supports the required feature. The VMware guest operating system OpenGL driver for Windows and Linux supports the OpenGL 3.3 core profile only. The OpenGL3.3 compatibility profile is not supported. OpenGL guest driver only supports version 3.0 for compatibility profiles.

The VMware Tools installer option to clobber Linux kernel modules that are shipped with the operating system is deprecated. In the upcoming versions of VMware Tools for Linux, the clobber option will be removed from the installer.

Guest Operating System Customization Support

The Guest OS Customization Support Matrix provides details about the guest operating systems supported for customization.

Installation and Upgrades for this release

VMware Tools can be downloaded from the Product Download page.

VMware Tools Operating System Specific Packages can be downloaded from http://packages.vmware.com/tools/releases/index.html. For more information on installing OSPs, see the VMware Tools Installation Guide for Operating System Specific Packages.

The steps to install VMware Tools vary depending on your VMware product and the guest operating system you have installed. For general steps to install VMware Tools in most VMware products, see General VMware Tools installation instructions (1014294).To set up the productLocker to point to the shared datastore, see KB 2004018.

For specific instructions to install, upgrade, and configure VMware Tools, see VMware Tools Documentation page.

Upgrade Information

Upgrade support for future releases of VMware Tools

Upgrade support is available for older versions of VMware Tools shipped with ESXi that have reached end of support to newer versions of VMware Tools shipped concurrently to the immediate ESXi version released at the time of end of support of the older ESXi releases.

Support for ESXi 5.0 and ESXi 5.1 VMware Tools

Extended support - Extended support is available for VMware Tools versions shipped with ESXi 5.0 and ESXi 5.1
Upgrade - Upgrade of VMware Tools to version 10.0.12 for the legacy guest operating systems is not supported on ESXi 5.0 and ESXi 5.1. Virtual machines running VMware Tools 10.0.12 is supported on ESXi 5.0 and 5.1.

Upgrade Impact

The upgrade support implies that users need to follow a two-step upgrade process to upgrade VMware Tools prior to 9.4.x to versions later than 10.1.0 on non-legacy guest operating systems.

VMware Tools prior to 9.4.x must be first upgraded to VMware Tools version 10.1.0. As a second step, VMware Tools can be upgraded to a newer version later than 10.1.0.
VMware Tools 9.4.x and newer can be directly upgraded to the latest available version of VMware Tools.

For mapping of VMware Tools versions that were bundled with ESXi, see http://packages.vmware.com/tools/versions.

For a simple upgrade, upgrade to VMware Tools bundled with the supported version of ESXi.

VMware Tools is backward and forward compatible with ESXi. Newer versions of VMware Tools are compatible with older ESXi versions supported and conversely. Upgrade of VMware Tools to version 10.0.12 is the last supported upgrade for the legacy guest operating systems on VMware ESXi 5.5, Patch Release ESXi550-201608001, VMware ESXi 6.0, Patch Release ESXi600-201608001 and later.

Windows guest drivers installed by VMware Tools

VMware Tools 10.1.10 support the following driver versions on a Windows Guest Operating System.

Hardware drivers

Drivers	Version
`vmci`	9.8.6.0
`vsock`	9.8.8.0
`pvscsi`	1.3.8.0
`wddm`	8.15.1.51
`xpdm`	12.1.8.0
`vmxnet3`	1.7.3.2 - NDIS 6.0
`vmxnet2`	2.2.0.0
`vmmouse`	12.5.7.0
`vmusbmouse`	12.5.7.0
`vmaudio`	5.10.0.3506

Software drivers

Drivers	Version
`vmrawdsk.sys`	1.1.0.1
`vmmemctl.sys`	7.4.1.1
`vmhgfs.sys`	11.0.14.2 - For operating systems Windows Vista and later
`vsepflt.sys`	10.1.10.0
`vnetflt.sys`	10.1.10.0 - For Kernel-Mode Code Signing
`vnetWFP.sys`	10.1.10.0

Resolved Issues

VMware Tools uninstaller is unable to stop VMware Tools service
While uninstalling VMware Tools in a Linux guest operating system, VMware Tools uninstaller is unable to stop vmtoolsd service. This issue occurs in Linux distributions such as Ubuntu 15.04 and later, RHEL7 and later, and SLES12 and later.
This issue is resolved in this release.

Installing VMware Tools on a 64-bit Windows virtual machine might result in an error
After you install VMware Tools on a 64-bit Windows virtual machine, when the virtual machine boots up, the system might display the following error:
VMware Tools unrecoverable error: (vthread-4)
Exception 0xc0000005 (access violation) has occurred.
This issue is resolved in this release.

Mouse movements in RDP sessions to Windows virtual machines are affected by MKS console mouse movements
If an administrator uses the vSphere Client to open a console to a Windows virtual machine on which multiple users are logged in through terminal sessions, their mouse movements might become synchronized with the mouse movements of the administrator.
Note: Due to these changes, VMware Tools icon in the system tray will not be displayed in an RDP session. To check the version of VMware Tools, run the command in the command prompt:
"C:\Program Files\VMware\VMware Tools\VMwareToolboxCmd.exe" -v

This issue is resolved in this release.

VMware Tools upgrade on power cycle fails on Windows operating system
VMware Tools upgrade on power cycle fails to complete on Windows operating system. This issue is caused by a corrupted manifest file.
This issue is resolved in this release.

VMware Tools upgrade fails if /tmp is mounted as noexec
An upgrade of VMware Tools fails on a Linux system where /tmp is mounted with the option noexec. This issue occurs because the upgrade binary cannot be executed from /tmp directory.
This issue is resolved in this release.

Quiesced snapshot fails on a Japanese Windows Server 2008 R2 in vSphere
After upgrading VMware Tools on Japanese Windows Server 2008 R2 to VMware Tools 10.1.0 or later, VMware Tools service on NT service process fails while taking a quiesced snapshot.
This issue is resolved in this release.

Quiesced snapshots of Windows Server 2012 and Windows Server 2012 R2 virtual machines with VMware Tools 10.1.0 fails with an error
Quiesced snapshots of Windows Server 2012 and Windows Server 2012 R2 virtual machines with VMware Tools 10.1.0 fails with an error. This issue occurs when VMware Tools service fails to respond, which automatically results in the change of status in the virtual machines.
This issue is resolved in this release.

VMware Tools re-installation in repair mode triggers a warning
VMware Tools re-installation in repair mode triggers a warning message similar to the following:
"setup failed to install physical disk driver automatically...."
This issue is resolved in this release.

Connecting to View fails with a black screen intermittently
An issue that resulted in black screen to appear while connecting to View with Horizon View Agent hosted on ESXi 6.5 is fixed in this release.
This issue is resolved in this release.

Upgrading VMware Tools to 10.1.0 in a Windows guest operating system results in system event log
After upgrading VMware Tools to 10.1.0 results in system event log with 10010 error event by DCOM on the Windows Guest operating system.
This issue is resolved in this release.

WMI performance adapter service fails on windows guest operating systems
WMI performance adapter service (wmiapsrv.exe) fails on virtual machines running Windows 10 and Windows Server 2016.
This issue is resolved in this release.

Known Issues

Unable to remove ventflt and vnetWFP drivers while upgrading VMware Tools from 10.1.x to 10.1.10
ventflt and vnetWFP drivers do not stop when they are selected to remove during VMware Tools upgrade. This issue occurs while upgrading VMware Tools from 10.1.x to 10.1.10 only.

Workaround:

Reboot the windows guest operating system.
Run the VMware Tools installer to remove ventflt and vnetWFP drivers after upgrading VMware Tools.

Known Issues from Earlier Releases

To view a list of known issues applicable from earlier releases, click here.

VMware Tools 10.1.0 is not compatible with VMware Site Recovery Manager 6.1.1 or earlier
Upgrading VMware Tools to 10.1.0 on a virtual machine managed by VMware Site Recovery Manager 6.1.1 or earlier breaks the VMware Site Recovery Manager workflows. VMware Site Recovery Manager 6.1.2 and 6.5 versions are compatible with VMware Tools 10.1.0.

Workaround: Upgrade VMware Site Recovery Manager to version 6.1.2 or 6.5 before installing or upgrading VMware Tools to version 10.1.0. If a virtual machine is being managed by VMware Site Recovery Manager 6.1.1 or earlier, avoid installing or upgrading VMware Tools to version 10.1.0. This compatibility requirement is also applicable to open-vm-tools 10.1.0 packaged by various Linux distributions. For more information on compatibility, see VMware Product Interoperability Matrix.

Attempts to install VMware Tools on a FreeBSD 6.x or 7.x guest operating system might fail with an error
Attempts to install VMware Tools on a FreeBSD 6.x or 7.x guest operating system might fail with an error similar to the following:
Guest operating system daemon: failed Attempting to run vmtoolsd after installation will result in the following error "Segmentation fault: 11 (core dumped)"

Workaround: Before installing VMware Tools 10.1.0 on a FreeBSD 6.x or 7.x VM, perform the following
1. Create the file, if it is not created
  
  /etc/libmap.conf
2. Add the following to /etc/libmap.conf file
  
  [/usr/local/lib/vmware-tools/] libpthread.so.2 libthr.so.2 libpthread.so libthr.so
If VMware Tools 10.1.0 is already installed, perform the following

Update /etc/libmap.conf with the following

[/usr/local/lib/vmware-tools/] libpthread.so.2 libthr.so.2 libpthread.so libthr.so
Complete the configuration by running /usr/local/bin/vmware-config-tools.pl

Note: This workaround is not applicable to virtual machines running FreeBSD versions later than 7.x.

Common Agent Framework in open-vm-tools fails to build in Ubuntu 14.04
Common Agent Framework in open-vm-tools fails to build in Ubuntu 14.04 with rabbitmq-c version lower than 0.8.0

Workaround: Upgrade rabbitmq-c to version 0.8.0 or later for TLSv1.2 support in Common Agent Framework.

vmusr plug-ins do not load on Solaris 10 Update 11
While VMware Tools 10.1 is running on Solaris 10 U11 guest operating systems, the following vmusr plug-ins are not loaded:
- libdesktopEvents.so
- libdndcp.so
- libresolutionSet.so
This issue might also occur in Solaris version 11.2.

Workaround: Upgrade to Solaris 11.3.

With VMware Tools 10.0.x, duplicate drivers might be loaded in the Linux kernel
This issue occurs when drivers are installed in /lib/modules/<kernel version>/ directly. This might lead to incorrect detection of drivers by VMware Tools which causes installation of unwanted drivers.

Workaround: To work around this issue, install the modules in the sub-directory of /lib/modules/<kernel version>/ / before installing or re-installing VMware Tools.

For example,
cd /lib/modules/$(uname -r)/ mkdir foobar mv foo.ko bar.ko foobar/ depmod -a

Collapse List of Earlier Known Issues