|
1 | | -#open-vm-tools 10.0.0 Release Notes |
2 | | - |
3 | | -Updated on 1 SEP 2015 |
4 | | -##What's in the Release Notes |
5 | | -The release notes cover the following topics: |
6 | | - |
7 | | -- What's New |
8 | | -- Internationalization |
9 | | -- Compatibility |
10 | | -- Installation and Upgrades for This Release |
11 | | -- Known Issues |
12 | | - |
13 | | -##What's New |
14 | | -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: |
15 | | - |
16 | | -- **Common versioning**: Infrastructure changes to enable reporting of the true version of open-vm-tools. This feature is dependent on host support. |
17 | | -- **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. |
18 | | -- **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. |
19 | | -- **ESXi Serviceability**: Default _vmtoolsd_ logging is directed to a file instead of syslog. _vmware-toolbox-cmd_ is enhanced for setting _vmtoolsd_ logging levels. |
20 | | -- **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. |
21 | | - |
22 | | -## Internationalization |
23 | | -open-vm-tools 10.0.0 supports the following languages: |
24 | | - |
25 | | -- English |
26 | | -- French |
27 | | -- German |
28 | | -- Spanish |
29 | | -- Italian |
30 | | -- Japanese |
31 | | -- Korean |
32 | | -- Simplified Chinese |
33 | | -- Traditional Chinese |
34 | | - |
35 | | -## Compatibility |
36 | | -open-vm-tools 10.0.0 is compatible with all supported versions of VMware vSphere, VMware Workstation 12.0 and VMware Fusion 8.0. |
37 | | -## Installation and Upgrades for This Release |
38 | | -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 |
39 | | -## Known Issues |
40 | | -The known issues are as follows: |
41 | | - |
42 | | -- **The status of IPv6 address is displayed as "unknown"** |
43 | | - |
44 | | - The status of IPv6 address from vim-cmd is displayed as "unknown" even when the address is valid. |
45 | | - |
46 | | - Workaround: None |
47 | | -- **TextCopyPaste between host and guest systems fail** |
48 | | - |
49 | | - Copy and Paste of text between host and guest systems fail if the text size 50KB or higher. |
50 | | - |
51 | | - Workaround: Copy and Paste smaller amounts of text. |
52 | | -- **Definition of the field _ipAddress_ in guestinfo is ambiguous** |
53 | | - |
54 | | - The field _ipAddress_ is defined as "Primary IP address assigned to the guest operating system, if known". |
55 | | - |
56 | | - Workaround: The field _ipAddress_ in this context for Linux is defined as the first IP address fetched by open-vm-tools. |
| 1 | +# open-vm-tools 12.3.0 Release Notes |
| 2 | + |
| 3 | +Updated on: 31 August 2023 |
| 4 | + |
| 5 | +open-vm-tools | 31 AUGUST 2023 | Build 22234872 |
| 6 | + |
| 7 | +Check back for additions and updates to these release notes. |
| 8 | + |
| 9 | +## What's in the Release Notes |
| 10 | + |
| 11 | +The release notes cover the following topics: |
| 12 | + |
| 13 | +- [open-vm-tools 12.3.0 Release Notes](#open-vm-tools-1230-release-notes) |
| 14 | + - [What's in the Release Notes](#whats-in-the-release-notes) |
| 15 | + - [What's New](#whats-new) |
| 16 | + - [End of Feature Support Notice](#end-of-feature-support-notice) |
| 17 | + - [Internationalization](#internationalization) |
| 18 | + - [Guest Operating System Customization Support](#guest-operating-system-customization-support) |
| 19 | + - [Interoperability Matrix](#interoperability-matrix) |
| 20 | + - [ Resolved Issues](#-resolved-issues) |
| 21 | + - [Known Issues](#known-issues) |
| 22 | + |
| 23 | +## <a id="whatsnew" name="whatsnew"></a>What's New |
| 24 | + |
| 25 | +This release resolves CVE-2023-20900. For more information on this vulnerability and its impact on VMware products, see https://www.vmware.com/security/advisories/VMSA-2023-0019.html. |
| 26 | + |
| 27 | +* Please see the [Resolved Issues](#resolvedissues) and [Known Issues](#knownissues) sections below. |
| 28 | + |
| 29 | +* A complete list of the granular changes in the open-vm-tools 12.3.0 release is available at: |
| 30 | + |
| 31 | + [open-vm-tools ChangeLog](https://github.com/vmware/open-vm-tools/blob/stable-12.3.0/open-vm-tools/ChangeLog) |
| 32 | + |
| 33 | +## <a id="endsupport" name="endsupport"></a>End of Feature Support Notice |
| 34 | + |
| 35 | +* Deprecated: Using "xml-security-c" and "xerces-c" to build the VMware Guest Authentication Service (VGAuth) |
| 36 | + |
| 37 | + 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, now is the time to plan for the change. The open-vm-tools 12.3.x series will be the last version that can use "xml-security-c" and "xerces-c". |
| 38 | + |
| 39 | +## <a id="i18n" name="i18n"></a>Internationalization |
| 40 | + |
| 41 | +open-vm-tools 12.3.0 is available in the following languages: |
| 42 | + |
| 43 | +* English |
| 44 | +* French |
| 45 | +* German |
| 46 | +* Spanish |
| 47 | +* Italian |
| 48 | +* Japanese |
| 49 | +* Korean |
| 50 | +* Simplified Chinese |
| 51 | +* Traditional Chinese |
| 52 | + |
| 53 | +## <a id="guestop" name="guestop"></a>Guest Operating System Customization Support |
| 54 | + |
| 55 | +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. |
| 56 | + |
| 57 | +## <a id="interop" name="interop"></a>Interoperability Matrix |
| 58 | + |
| 59 | +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. |
| 60 | + |
| 61 | +## <a id="resolvedissues" name ="resolvedissues"></a> Resolved Issues |
| 62 | + |
| 63 | +* **This release resolves CVE-2023-20900.** |
| 64 | + |
| 65 | + For more information on this vulnerability and its impact on VMware products, see https://www.vmware.com/security/advisories/VMSA-2023-0019.html. |
| 66 | + |
| 67 | +* **Linux quiesced snapshot: "SyncDriver: failed to freeze '_filesystem_'"** |
| 68 | + |
| 69 | + The open-vm-tools 12.2.0 release had an update to the Linux quiesced snapshot operation that would avoid starting a quiesced snapshot if a filesystem had already been frozen by another process. See the [Resolved Issues](https://github.com/vmware/open-vm-tools/blob/stable-12.2.0/ReleaseNotes.md#-resolved-issues) section in the open-vm-tools 12.2.0 Release Notes. That fix may have been backported into earlier versions of open-vm-tools by Linux vendors. |
| 70 | + |
| 71 | + It is possible that filesystems are being frozen in custom pre-freeze scripts to control the order in which those specific filesystems are to be frozen. The vmtoolsd process **must be informed** of all such filesystems with the help of "excludedFileSystems" setting of tools.conf. |
| 72 | + |
| 73 | + ``` |
| 74 | + [vmbackup] |
| 75 | +
|
| 76 | + excludedFileSystems=/opt/data,/opt/app/project-*,... |
| 77 | + ``` |
| 78 | +
|
| 79 | + A temporary workaround is available (starting from open-vm-tools 12.3.0) for system administrators to quickly allow a quiescing operation to succeed until the "excludedFileSystems" list can be configured. Note, if another process thaws the file system while a quiescing snapshot operation is ongoing, the snapshot may be compromised. Once the "excludedFileSystems" list is configured this setting MUST be unset (or set to false). |
| 80 | +
|
| 81 | + ``` |
| 82 | + [vmbackup] |
| 83 | +
|
| 84 | + ignoreFrozenFileSystems = true |
| 85 | + ``` |
| 86 | +
|
| 87 | + This workaround is provided in the source file changes in |
| 88 | +
|
| 89 | + https://github.com/vmware/open-vm-tools/commit/60c3a80ddc2b400366ed05169e16a6bed6501da2 |
| 90 | +
|
| 91 | + and at Linux vendors' discretion, may be backported to earlier versions of open-vm-tools. |
| 92 | +
|
| 93 | +* **A number of Coverity reported issues have been addressed.** |
| 94 | +
|
| 95 | +* **Component Manager / salt-minion: New InstallStatus "UNMANAGED".** |
| 96 | +
|
| 97 | + Salt-minion added support for "ExternalInstall" (106) to indicate an older version of salt-minion is installed on the vm and cannot be managed by the svtminion.* scripts. The Component Manager will track that as "UNMANAGED" and take no action. |
| 98 | +
|
| 99 | +* **The following pull requests and issues have been addressed** |
| 100 | +
|
| 101 | + * Add antrea and calico interface pattern to GUESTINFO_DEFAULT_IFACE_EXCLUDES |
| 102 | +
|
| 103 | + [Issue #638](https://github.com/vmware/open-vm-tools/issues/638) |
| 104 | + [Pull request #639](https://github.com/vmware/open-vm-tools/pull/639) |
| 105 | +
|
| 106 | + * Invalid argument with "\\" in Linux username (Active Directory user) |
| 107 | +
|
| 108 | + [Issue #641](https://github.com/vmware/open-vm-tools/issues/641) |
| 109 | +
|
| 110 | + * Improve POSIX guest identification |
| 111 | +
|
| 112 | + [Issue #647](https://github.com/vmware/open-vm-tools/issues/647) |
| 113 | + [Issue #648](https://github.com/vmware/open-vm-tools/issues/648) |
| 114 | +
|
| 115 | + * Remove appUtil library which depends on deprecated "gdk-pixbuf-xlib" |
| 116 | +
|
| 117 | + [Issue #658](https://github.com/vmware/open-vm-tools/issues/658) |
| 118 | +
|
| 119 | + * Fix build problems with grpc |
| 120 | +
|
| 121 | + [Pull request #664](https://github.com/vmware/open-vm-tools/pull/664) |
| 122 | + [Issue #676](https://github.com/vmware/open-vm-tools/issues/676) |
| 123 | +
|
| 124 | +## <a id="knownissues" name="knownissues"></a>Known Issues |
| 125 | +
|
| 126 | +
|
| 127 | +* **Shared Folders mount is unavailable on Linux VM.** |
| 128 | +
|
| 129 | + 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. |
| 130 | +
|
| 131 | + Note: This issue is applicable to open-vm-tools running on VMware Workstation and VMware Fusion. |
| 132 | +
|
| 133 | + Workaround: |
| 134 | +
|
| 135 | + 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: |
| 136 | +
|
| 137 | + <tt>vmhgfs-fuse /mnt/hgfs fuse defaults,allow_other 0 0</tt> |
0 commit comments