update release notes for 10.2.0

diff --git a/ReleaseNotes.md b/ReleaseNotes.md
index 6f4ce1c5768f48a4f76468522b551aa0a4efc534..42b3b077909a33c1e4e0f272e5af1db7de52d08d 100644 (file)
--- a/ReleaseNotes.md
+++ b/ReleaseNotes.md
@@ -1,6 +1,6 @@
-#open-vm-tools 10.0.0 Release Notes 
+# open-vm-tools 10.2.0 Release Notes
 
-Updated on 1 SEP 2015
+Updated on 14 Dec 2017
 ##What's in the Release Notes
 The release notes cover the following topics: 
 
@@ -10,17 +10,12 @@ The release notes cover the following topics:
 - 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:
+## What's New
 
-- **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.
+- **FreeBSD support**: freebsd.iso is not available for VMware Tools 10.2.0 and later as it has been discontinued in favor of open-vm-tools. For more information, see Compatibility Notes section of this release notes.
 
 ## Internationalization 
-open-vm-tools 10.0.0 supports the following languages:
+open-vm-tools 10.2.0 supports the following languages:
 
 - English 
 - French 
@@ -33,24 +28,41 @@ open-vm-tools 10.0.0 supports the following languages:
 - 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.
+- open-vm-tools 10.2.0 is compatible with all supported versions of VMware vSphere ESXi 5.5 and later, VMware Workstation 14.0 and VMware Fusion 10.0. See VMware Compatibility Guide for more information.
+- Starting with VMware Tools version 10.2.0, Perl script based VMware Tools installation for FreeBSD has been discontinued. Going forward, FreeBSD systems are supported only through the open-vm-tools packages directly available from FreeBSD package repositories. FreeBSD packages for open-vm-tools 10.1.0 and later are available from FreeBSD package repositories.
+
 ## 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"**
+## Resolved Issues 
+
+* **Summary page of the VM does not list the IP address of the VMs in the right order**
+
+    The configuration option to exclude network interfaces from GuestInfo and set primary and low priority network interfaces is added to the tools.conf configuration file.
+This issue is resolved in this release.
+
+* **Guest authentication fails with a SystemError fault when the requested password is expired**
+
+    Attempting to authenticate with an expired password, for example when attempting Guest Operations, fails with a SystemError fault.
+This issue is resolved in this release. Authentication with an expired password now fails with an InvalidGuestLogin fault in order to provide a more precise error code for such a case.
+
+* **The free space reported in vim.vm.GuestInfo.DiskInfo for a Linux guest does not match with df command in the guest**
+
+    Prior to VMware Tools version 10.2.0, the free space reported in vim.vm.GuestInfo.DiskInfo for a Linux guest included file system specific reserved blocks. This led to guest file system usage in vSphere clients reporting more free space than what was reported by df command in the guest. This issue has been resolved in this release by not including the file system specific reserved blocks in the free space reported in vim.vm.GuestInfo.DiskInfo for Linux guests by default. The default behavior can be reversed with a configuration in ```/etc/vmware-tools/tools.conf``` file in the Linux guest operating systems:
+```
+    [guestinfo] 
+    diskinfo-include-reserved=true
+```
+
+* **VMware user process might not restart after upgrades of open-vm-tools**
+
+    When the VMware user process receives a SIGUSR2, it restarts itself by executing vmware-user and terminates itself. This is used on upgrades to ensure that the latest version of vmtoolsd is running. vmware-user was not available in open-vm-tools..
+This issue is fixed in this release.
 
-       The status of IPv6 address from vim-cmd is displayed as "unknown" even when the address is valid.
+## Known Issues
 
-       Workaround: None 
-- **TextCopyPaste between host and guest systems fail**
+* **Shared folder shows empty on Ubuntu 17.04 with open-vm-tools**.
+    On rebooting Ubuntu 17.04 with open-vm-tools installed, the shared folders /mnt directory is empty. This issue is observed even after installing Ubuntu 17.04 using easy install, enabling shared folders in VM settings and selecting Always Enabled.
+Workaround: Disable Shared Folders in the interface and enable after the VM is powered on with VMware Tools running.
 
-       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.