Skip to content

Commit

Permalink
Update the ReleaseNotes.md for the 12.4.0 open-vm-tools release.
Browse files Browse the repository at this point in the history
  • Loading branch information
johnwvmw committed Mar 22, 2024
1 parent 6710ee5 commit 619e61f
Showing 1 changed file with 87 additions and 56 deletions.
143 changes: 87 additions & 56 deletions ReleaseNotes.md
Original file line number Diff line number Diff line change
@@ -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)

## <a id="whatsnew" name="whatsnew"></a>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)

## <a id="endsupport" name="endsupport"></a>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".

## <a id="i18n" name="i18n"></a>Internationalization

open-vm-tools 12.4.0 is available in the following languages:

* English
* French
* German
* Spanish
* Italian
* Japanese
* Korean
* Simplified Chinese
* Traditional Chinese

## <a id="guestop" name="guestop"></a>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.

## <a id="interop" name="interop"></a>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. 

## <a id="resolvedissues" name ="resolvedissues"></a> 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".

## <a id="knownissues" name="knownissues"></a>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:

<tt>vmhgfs-fuse /mnt/hgfs fuse defaults,allow_other 0 0</tt>

For more information on how to configure VMware Tools Shared Folders, see [KB 60262](https://kb.vmware.com/s/article/60262)

0 comments on commit 619e61f

Please sign in to comment.