From 619e61f96c0a82c0b3054122c81a62a29301bf1b Mon Sep 17 00:00:00 2001 From: John Wolfe Date: Fri, 22 Mar 2024 14:00:45 -0700 Subject: [PATCH] Update the ReleaseNotes.md for the 12.4.0 open-vm-tools release. --- ReleaseNotes.md | 143 +++++++++++++++++++++++++++++------------------- 1 file changed, 87 insertions(+), 56 deletions(-) diff --git a/ReleaseNotes.md b/ReleaseNotes.md index 6f4ce1c57..1997f073a 100644 --- a/ReleaseNotes.md +++ b/ReleaseNotes.md @@ -1,56 +1,87 @@ -#open-vm-tools 10.0.0 Release Notes - -Updated on 1 SEP 2015 -##What's in the Release Notes -The release notes cover the following topics: - -- What's New -- Internationalization -- Compatibility -- Installation and Upgrades for This Release -- Known Issues - -##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. Read about the new and enhanced features in this release below: - -- **Common versioning**: Infrastructure changes to enable reporting of the true version of open-vm-tools. This feature is dependent on host support. -- **Quiesced snapshots enhancements for Linux guests running IO workload**: Robustness related enhancements in quiesced snapshot operation. The _vmtoolsd_ service supports caching of log messages when guest IO has been quiesced. Enhancements in the _vmbackup_ plugin use a separate thread to quiesce the guest OS to avoid timeout issues due to heavy I/O in the guest. -- **Shared Folders**: For Linux distributions with kernel version 4.0.0 and higher, there is a new FUSE based Shared Folders client which is used as a replacement for the kernel mode client. -- **ESXi Serviceability**: Default _vmtoolsd_ logging is directed to a file instead of syslog. _vmware-toolbox-cmd_ is enhanced for setting _vmtoolsd_ logging levels. -- **GuestInfo Enhancements**: Plugin enhancements to report more than 64 IP addresses from the guest. These enhancements will be available only after upgrading the host because the guest IP addresses limit also exists on the host side. - -## Internationalization -open-vm-tools 10.0.0 supports the following languages: - -- English -- French -- German -- Spanish -- Italian -- Japanese -- Korean -- Simplified Chinese -- Traditional Chinese - -## Compatibility -open-vm-tools 10.0.0 is compatible with all supported versions of VMware vSphere, VMware Workstation 12.0 and VMware Fusion 8.0. -## Installation and Upgrades for This Release -The steps to install open-vm-tools vary depending on your VMware product and the guest operating system you have installed. For general steps to install open-vm-tools in most VMware products, see https://github.com/vmware/open-vm-tools/blob/master/README.md -## Known Issues -The known issues are as follows: - -- **The status of IPv6 address is displayed as "unknown"** - - The status of IPv6 address from vim-cmd is displayed as "unknown" even when the address is valid. - - Workaround: None -- **TextCopyPaste between host and guest systems fail** - - Copy and Paste of text between host and guest systems fail if the text size 50KB or higher. - - Workaround: Copy and Paste smaller amounts of text. -- **Definition of the field _ipAddress_ in guestinfo is ambiguous** - - The field _ipAddress_ is defined as "Primary IP address assigned to the guest operating system, if known". - - Workaround: The field _ipAddress_ in this context for Linux is defined as the first IP address fetched by open-vm-tools. +# open-vm-tools 12.4.0 Release Notes + +Updated on: 21 March 2024 + +open-vm-tools | 21 MARCH 2024 | Build 23259341 + +Check back for additions and updates to these release notes. + +## What's in the Release Notes + +The release notes cover the following topics: + +* [What's New](#whatsnew) +* [End of Feature Support Notice](#endsupport) +* [Internationalization](#i18n) +* [Guest Operating System Customization Support](#guestop) +* [Interoperability Matrix](#interop) +* [Resolved Issues](#resolvedissues) +* [Known Issues](#knownissues) + +## What's New + + +* Please see the [Resolved Issues](#resolvedissues) and [Known Issues](#knownissues) sections below. + +* A complete list of the granular changes in the open-vm-tools 12.4.0 release is available at: + + [open-vm-tools ChangeLog](https://github.com/vmware/open-vm-tools/blob/stable-12.4.0/open-vm-tools/ChangeLog) + +## End of Feature Support Notice + +* Discontinued: Using "xml-security-c" and "xerces-c" to build the VMware Guest Authentication Service (VGAuth) + + Starting with open-vm-tools 12.4.0, and going forward, the VGAuth service build will require the "xmlsec1" and "libxml2" development and runtime packages. If still using the "xml-security-c" and "xerces-c" open source projects to build open-vm-tools, you must make the change now. The open-vm-tools 12.3.x series will be the last version that can use "xml-security-c" and "xerces-c". + +## Internationalization + +open-vm-tools 12.4.0 is available in the following languages: + +* English +* French +* German +* Spanish +* Italian +* Japanese +* Korean +* Simplified Chinese +* Traditional Chinese + +## Guest Operating System Customization Support + +The [Guest OS Customization Support Matrix](http://partnerweb.vmware.com/programs/guestOS/guest-os-customization-matrix.pdf) provides details about the guest operating systems supported for customization. + +## Interoperability Matrix + +The [VMware Product Interoperability Matrix](http://partnerweb.vmware.com/comp_guide2/sim/interop_matrix.php) provides details about the compatibility of current and earlier versions of VMware Products.  + +## Resolved Issues + +* **The following github.com/vmware/open-vm-tools pull request has been addressed** + + * Power Ops: Attempt to execute file path only + + [Pull request #689](https://github.com/vmware/open-vm-tools/pull/689) + +* **A number of issues flagged by Coverity have been addressed.** + +* **Add aliasing code to identify Miracle Linux by its former name of "asianux".** + + The Asianux Linux distribution rebranded itself as Miracle Linux. Since vSphere infrastructure recognizes "asianux" but not Miracle Linux, aliasing code was added to open-vm-tools to continue to identify Miracle Linux systems as "asianux". + +## Known Issues + + +* **Shared Folders mount is unavailable on Linux VM.** + + If the **Shared Folders** feature is enabled on a Linux VM while it is powered off, the shared folders mount is not available on restart. + + Note: This issue is applicable to open-vm-tools running on VMware Workstation and VMware Fusion. + + Workaround: + + If the VM is powered on, disable and enable the **Shared Folders** feature from the interface. For resolving the issue permanently, edit **/etc/fstab** and add an entry to mount the Shared Folders automatically on boot. For example, add the line: + + vmhgfs-fuse /mnt/hgfs fuse defaults,allow_other 0 0 + + For more information on how to configure VMware Tools Shared Folders, see [KB 60262](https://kb.vmware.com/s/article/60262)