VMware

VMware vCenter Server 5.0 Update 3 Release Notes

vCenter Server 5.0 Update 3 | 17 OCT 2013 | Build 1300600

vSphere Client 5.0 Update 3 | 17 OCT 2013 | Build 1300600

vCenter Server 5.0 Update 3 Installation Package | 17 OCT 2013 | Build 1343691

vCenter Server Appliance 5.0 Update 3 | 17 OCT 2013 | Build 1302764

Last updated: 13 MAR 2014

What's in the Release Notes

These release notes cover the following topics:

What's New

This release of VMware vCenter Server 5.0 Update 3 offers the following improvements:

  • Database support added for Microsoft® SQL Server® 2012 Service Pack 1

  • Resolved Issues - This release delivers a number of bug fixes that have been documented in the Resolved Issues section.

Internationalization

VMware vSphere 5.0 is available in the following languages:

  • English
  • French
  • German
  • Japanese
  • Korean
  • Simplified Chinese

vSphere Client Locale Forcing Mode

With vSphere 5.0, you can configure the VMware vSphere Client™ to provide the interface text in English even when the machine on which it is running is not English. You can set this configuration for the duration of a single session by running a command-line switch. This configuration applies to the interface text and does not affect other locale-related settings such as date and time or numeric formatting.

The following vSphere Client command causes the individual session to appear in English:
vpxClient -locale en_US

Features Added in This Release

This release includes all features and fixes from 5.0 Update 2.

Compatibility and Installation

ESXi, vCenter Server, and vSphere Client Version Compatibility

Apart from the database support introduced in the What's New section, vCenter 5.0 Update 3 provides the same level of compatibility as the existing vCenter 5.0 Update 2 release. See the VMware Product Interoperability Matrix for full details on vCenter 5.0 Update 3 compatibility.

The VMware Product Interoperability Matrix provides details about the compatibility of current and earlier versions of VMware vSphere components, including ESXi, VMware vCenter Server, the vSphere Client, and optional VMware products. In addition, this site provides information about supported management and backup agents that you can run before installing ESXi or vCenter Server.

The vSphere Web Client and the vSphere Client are packaged with the vCenter Server and modules ZIP file. You can install one or both clients from the VMware vCenter Installer wizard.

Inventory Service Database

The Inventory Service database does not have a scheduled backup. You should back up the Inventory Service database as part of your regular vCenter Server database administration. To move the Inventory Service database to a different host machine, back up the database on the source machine and restore the database on the destination machine as described in the vSphere Installation and Setup documentation.

Guest Operating System Customization Support

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

vSphere Client Connections to Linked Mode Environments

vCenter Server 5.0 can exist in Linked Mode only with other instances of vCenter Server 5.0. Linked Mode groups that contain both vCenter Server 5.0 and earlier versions of vCenter Server (such as vCenter Server 4.0 and vCenter Server 4.1) are not supported. In this release, you can manage Linked Mode groups that contain both vCenter Server 5.0 and vCenter Server 5.0 Update 2 instances.

vSphere 5.0 and VMware View Compatibility

To learn about vSphere configurations supported with VMware View, see the VMware Product Interoperability Matrix.

Installation Notes for This Release

The Windows vSphere Client 5.0 Update 3 installer will report an Internal Error 2229 error when performing an upgrade of an existing installation on non-English systems. Uninstall the existing vSphere Client 5.0 before installing vSphere Client 5.0 Update 3.

Read the vSphere Installation and Setup documentation for step-by-step guidance on installing and configuring ESXi and vCenter Server.

After successful installation, you must perform some licensing, networking, and security configuration. For information about these configuration tasks, see the following guides in the vSphere documentation.

vCenter Server 5.0 supports installation on Windows 64-bit platforms only. You can upgrade from vCenter Server 4.1 to vCenter Server 5.0 on the same system if it is 64 bit. If you have VMware vCenter Server 2.5 or vCenter Server 4.0 on 32-bit systems installed, see the vSphere Upgrade documentation for instructions on installing vCenter Server on a 64-bit operating system and preserving your vCenter Server database.

vCenter Server 5.0 includes Management Information Base (MIB) files related to vCenter Server. You can download MIB files related to ESXi from the VMware Web site at http://www.vmware.com/download/vsphere/drivers_tools.html.

Upgrades for This Release

For instructions about how to upgrade vCenter Server and ESXi hosts, see the vSphere Upgrade documentation.

vSphere 5.0 supports the following upgrade scenarios:

  • You can perform in-place upgrades on 64-bit systems from vCenter Server 4.x to vCenter Server 5.0.
    You cannot upgrade an instance of vCenter Server 4.0.x that is running on Windows XP Professional x64 Edition.
  • You can upgrade vCenter Server 2.5 Update 6 or later and vCenter Server 4.0.x to vCenter Server 5.0 by installing vCenter Server 5.0 on a new 64-bit operating system and migrating the existing database.
    This upgrade method makes an upgrade from a 32-bit system to a 64-bit system possible.
  • vCenter Server 5.0 can manage ESXi 5.0 hosts in the same cluster with ESX/ESXi 4.x and ESX/ESXi 3.5 hosts. It can also manage ESX/ESXi 3.5 hosts in the same cluster with ESX/ESXi 4.x hosts. vCenter Server 5.0 cannot manage ESX 2.x or 3.0.x hosts.

Test Releases of vSphere 5.0

Upgrades from the vCenter Server 5.0 Beta and the vCenter Server 5.0, 5.0 Update 1, 5.0 Update 2, and 5.0 Update 3 RC Release Candidate releases to vCenter Server 5.0 Update 3 are not supported. Uninstall Beta or Release Candidate versions of vCenter Server 5.0, 5.0 Update1, 5.0 Update 2, 5.0 Update 3 RC releases and perform fresh installations of vCenter Server 5.0 Update 3. If you were testing Beta or Release Candidate versions of vCenter Server 5.0, 5.0 Update 1, 5.0 Update 2, 5.0 Update 3 VMware recommends that you recreate data you want to preserve from those setups on vCenter Server 5.0, 5.0 Update 1, 5.0 Update 2, 5.0 Update 3.

VMware vSphere SDKs

VMware vSphere provides a set of SDKs for vSphere server and guest operating system environments.

  • vSphere Management SDK. A collection of software development kits for the vSphere management programming environment. The vSphere Management SDK contains the following vSphere SDKs:

    • vSphere Web Services SDK. Includes support for new features available in ESXi 5.0 and vCenter Server 5.0 server systems. You can also use this SDK with earlier versions of ESX/ESXi and vCenter Server. For more information, see the VMware vSphere Web Services SDK documentation.

    • vSphere vCenter Storage Monitoring Service (SMS) SDK. SMS 2.0 is supported on vCenter Server 5.0. For more information, see vCenter SMS SDK documentation.

    • vSphere ESX Agent Manager (EAM) SDK. EAM 1.0 is supported on ESXi 5.0. For more information, see vSphere ESX Agent Manager.

  • vSphere Guest SDK. The VMware vSphere Guest SDK 4.0 is supported on ESXi 5.0. For more information, see the VMware vSphere Guest SDK documentation.

  • VMware vSphere SDK for Perl. The SDK for Perl 5.0 is supported on vSphere 5.0. For more information, see the vSphere SDK for Perl documentation.

Open Source Components for VMware vSphere

The copyright statements and licenses applicable to the open source software components distributed with vSphere 5.0 are available at http://www.vmware.com/download/vsphere/open_source.html, on the Open Source tab. You can also download the source files for any GPL, LGPL, or other similar licenses that require that the source code or modifications to source code are made available for the most recent generally available release of vSphere.

Product Support Notices

VMware vSphere 5.0 is the last release for the following management features and platforms. VMware continues to provide technical support for these features and platforms through the end of their support lifecycles.

  • VMware Toolbox: vSphere 5.0 is the last release to include support for the VMware Tools graphical user interface, VMware Toolbox. VMware will continue to update and support the Toolbox command-line interface (CLI) to perform all VMware Tools functions.

  • VMI Paravirtualization: vSphere 4.1 was the last release to support the VMI guest operating system paravirtualization interface. For information about migrating virtual machines that are enabled for VMI so that they can run on later vSphere releases, see Knowledge Base article 1013842.

  • VMCI Sockets: vSphere 5.0 is the last major release to support use of Virtual Machine Communication Interface (VMCI) sockets to communicate between virtual machines. Use of VMCI sockets to communicate between ESXi and virtual machines continues to be supported.

  • Prebuilt Modules for Unsupported Linux Guests: vSphere 5.0 is the last release to ship prebuilt modules (PBMs) for unsupported Linux guest operating systems. To use an unsupported Linux guest, you must compile Linux kernel modules from source code during VMware Tools installation.

  • Tape Drives: VMware does not support tape drives that are connected to ESX/ESXi hosts. For additional information, see Knowledge Base article 1016407.

  • vSphere 5.0 and its subsequent update and patch releases are the last vSphere versions to support VMware ESX/ESXi 3.5 and VMware Virtual Center 2.5: Future versions of vSphere, which includes VMware ESXi, VMware vCenter Server, VMware vSphere Client, and VMware vCenter extensions and plug-ins, such as vCenter Update Manager, will not operate with VMware ESX/ESXi 3.5 or VMware Virtual Center 2.5. VMware ESX/ESXi 3.5 and VMware VirtualCenter 2.5 will continue to be supported until their originally published end-of-support dates.

Resolved Issues

This release resolves issues in the following subject areas.

Licensing

  • Attempts to export license report of a vCenter Server displays an error: Cannot export licensing usage data
    When you attempt to export a licensing report from the Licensing Reporting Manager (LRM) of a vCenter Server that has earlier versions of ESXi 5.0 hosts connected to it, an error message similar to the following is displayed:

    Cannot export licensing usage data.

    This issue is resolved in this release.

Security

  • Update to OpenSSL version openssl-0.9.8y addresses multiple security issues
    The OpenSSL library is updated to version openssl-0.9.8y to address multiple security issues.

    The Common Vulnerabilities and Exposures project (cve.mitre.org) has assigned the names CVE-2013-0169, CVE-2012-2686, and CVE-2013-0166 to these issues.

    This issue is resolved in this release.
  • VMware ESXi Session Fixation Vulnerability
    VMware ESXi contains a vulnerability in the handling of session IDs. To exploit this vulnerability, an attacker must know a valid session ID of an authenticated user. Exploitation of the issue may lead to Elevation of Privilege. To reduce the likelihood of exploitation, vSphere components should be deployed on an isolated management network.

    VMware would like to thank Alexey Tyurin of DSecRG for reporting this issue to us.

    The Common Vulnerabilities and Exposures project (cve.mitre.org) has assigned the names CVE-2013-5971 to this issue.

    This issue is resolved in this release.

Storage

  • vCenter Server restart removes the configured SDRS scheduled tasks
    When you restart a vCenter Server system, the scheduled tasks configured for Storage DRS (SDRS) disappear.

    This issue is resolved in this release.

Upgrade and Installation

  • Upgrading to vCenter Server 5.0 results in the database type to change incorrectly in the vcdb.properties
    When upgrading to vCenter Server 5.0, the installer automatically changes the database type in vcdb.properties based on the host name string match, causing Java based applications to stop working. This issue occurs if the database server's host name contains substrings such as db2 or oracle.

    This issue is resolved in this release.
  • The default CPU slot size displayed in vSphere 5.0 non-English locales is incorrect
    During fresh installation or upgrade to vSphere 5.0, the default CPU slot size is shown incorrectly as 256 MHz instead of 32 MHz for non-English locales in the vpxd.cfg file. This issue occurs due to difference in the vpxd.cfg files for English and non-English locales.

    This issue is resolved in this release.
  • Minor upgrade of vCenter Server changes the logon setting of the VMware VirtualCenter Management Webservices to local system
    During minor upgrade of vCenter Server, the logon setting of the VMware VirtualCenter Management Webservices changes to local system account. The VirtualCenter Management Webservices (Tomcat) service starts successfully, however, does not function properly and you might encounter issues where Performance Graphs, Storage Views "Maps", or other functions might fail.

    This issue is resolved in this release.

vCenter Server and vSphere Client

  • Unable to sort virtual machines in Datastore and Datastore Cluster View
    When you connect to vCenter Server 5.0 by using the vSphere Client, attempts to sort the virtual machines in the Provisioned Space and User Space do not work in the Datastore and Datastore Cluster View.

    This issue is resolved with this release.
  • Monster Character Large Objects (CLOBs) dumped into the log file if the SQL operation takes too long
    When an Structured Query Language (SQL) statement runs for too long, the current virtual database (VDB) code prints out a warning message that contains the parameter of the statement. If the parameter is of type CLOB and is large in size, it increases the log files.

    This issue is resolved with this release.
  • vCenter Server might stop responding during host synchronization operations
    During host synchronization operations, for example, after you add a host to vCenter Server, the vCenter Server collects and processes all the events sent from hostd. When the number of events being collected is more than the configured (1000 by default) number of events, the vCenter Server might crash with an error message similar to the following:

    Too many events (max: 1000): xxxx

    This issue is resolved in this release.
  • Using the vSphere Client Datastore browser to move a virtual machine from one datastore to another might result in the virtual machine file deletion if the virtual machine folder name begins with a . (period)
    In vCenter Server, an attempt to move a virtual machine whose folder name begins with a . (period) character from one datastore to another datatore results in the virtual machine folder being moved. However, the virtual machine disks, .vmx and all other files are deleted. With this release, a warning dialog box is displayed to make the user aware of the effects of such an operation.

    This issue is resolved in this release.
  • vCenter Server Appliance does not display performance charts older than one week
    The vCenter Server Appliance does not display overview and advanced performance charts older than one week.

    This issue is resolved in this release.
  • Recent Tasks pane in vSphere displays excessive vim.host.DiskManager.Lease.allocateBlocks tasks
    On a thin provisioned virtual machine, when you perform a Backup and Restore operation, the Recent Tasks pane displays excessive vim.host.DiskManager.Lease.allocateBlocks tasks.

    This issue is resolved in this release.
  • Datastore performance chart data missing if the datastore cluster contains more than 10 datastores
    The data for some datastore performance charts such as Normalized Latency per Datastore and Aggregate IOps per Datastore show No Data Available message if the datastore cluster contains more than 10 datastores.

    This issue is resolved in this release.
  • Newly configured NetFlow settings in vSphere Distributed Switch not saved after vCenter Server reboot
    When you configure the port settings for NetFlow in the vSphere Distributed Switch for vCenter Server 5.0, the settings are not saved in the database and are lost after the vCenter Server restarts.

    This issue is resolved in this release.
  • vCenter Server alarm repeat action does not get cancelled if an alarm becomes red and then returns to green in less than a second
    vCenter Server repeats the trigger action of the alarm with repeat frequency even after the alarm status returns to normal (green) from red within less than a second until you reset the alarm.

    This issue is resolved in this release.
  • Different values for virtual machine reserved memory in Managed Object Browser (MOB)
    After you edit the virtual machine settings and assign a valid value to the memory reservation property on the Resource Allocation tab, the correct value is saved in different data structures and displayed in MOB at multiple locations. However, the changes to one of the tables do not persist in the database, specifically, the memoryReservation value in the virtual machine's summary.config file. The value is reset to 0 when the vCenter Server is restarted. This results in different values for virtual machine reserved memory in MOB.

    This issue is resolved in this release.
  • vSphere Distributed Switch (VDS) network port statistics are corrupted
    The vSphere Distributed Switch (VDS) network port statistics get corrupted if a port number of the virtual machine's network adapter is changed manually or if the virtual machine is cloned and port monitoring is enabled.

    This issue is resolved in this release.
  • vCenter Server takes a long time to upload files
    Attempts to upload files through vCenter Server by using HTTP connections takes a long time due to an anomaly in the vCenter Server, which is unable to handle multiple chunks in the HTTP request header. If the vCenter Server is under heavy load, uploading large files through it might still take longer than uploading files through ESXi hosts due to the limited bandwidth that vCenter can provide at that time. Uploading large files through vCenter Server is not advisable because vCenter Server handles heavy network traffic load.

    This issue is resolved in this release.
  • Discrepancy in hardware status between vCenter and ESXi Managed Object Browsers (MOB) even after invoking the RefreshHealthStatusSystem API
    The Refresh or ResetSystemHealthInfo API, which is used to give one shot health sensor values does not update the latest health sensor values in vCenter Server.

    This issue is resolved in this release.
  • The PerformanceManager.QueryStats API call returns value of 0 instead of -1 when you request for five-minute roll up statistics data during the period when roll up data is not available for query
    PerformanceManager.QueryStats Application Programming Interface (API) call returns value of 0 instead of -1 when requesting five-minute roll up statistics data during the period when the data is not available for query. The data is not available because it has not been rolled up.

    This issue is resolved in this release.
  • Virtual machine connected to vSphere Distributed Switch (VDS) might lose network connectivity after peforming a vMotion
    Multiple processes compete against each other during vCenter Server host-sync and virtual machine cold relocate or vMotion operations. The VDS ports created on the destination hosts during cold relocate or vMotion might be removed by vCenter Server host-sync causing the virtual machine to lose network connectivity.

    This issue is resolved in this release.
  • Unable to edit the settings of a virtual machine that is a member of a data store cluster
    In vCenter Server, you cannot edit the settings of a virtual machine that is a member of a datastore cluster by using an user account that does not have the configure a datastore cluster permission in vCenter Server but has full permissions at the virtual machine level. The following error message is displayed:

    Permission to perform this operation was denied.
    You do not hold privilege "Datastore cluster > Configure a datastore cluster on Datastore cluster Cluster Name"

    This issue is resolved in VMware vSphere Client.
  • Registering or unregistering a vCenter Server instance with the Web Client requires plaintext password
    When installing the vsphere Web Client on a Windows-based vCenter Server, you need to register or unregister the local vCenter instance into the web-client by using the local administrator password in admin-cmd.bat. The password used by admin-cmd.bat is in plaintext.

    This issue is resolved in this release.
  • While using the datastore browser, all virtual machine folders on a VMFS or NFS volume are deleted if you attempt to delete a folder of a powered on virtual machine
    While using the datastore browser, if you attempt to delete a virtual machine folder when the virtual machine is powered on, a message similar to the following is displayed:

    Cannot delete file. [VMFS] <virtual_Machine_Name>

    If you power off the virtual machine without closing the datastore browser or changing the folder selection, and attempt to delete the same virtual machine folder again, all the virtual machine folders on the VMFS or NFS volume are deleted.

    This issue is resolved in this release.
  • vCenter Server vpxd service stops responding during startup
    During vCenter Server starup, the vpxd service might stop responding when performing the LDAP file-based backup.

    This issue is resolved in this release.

vMotion and Storage vMotion

  • Storage vMotion of a virtual machine disk fails if a disk with identical name is present on the target datastore while the provisioning.relocate.enableRename is set to true in vCenter Server
    When performing a storage vMotion of a virtual machine disk if there is a disk with an identical name on the target datastore while the provisioning.relocate.enableRename is set to true in the vCenter Server, the operation fails with the following error message:

    Cannot complete the operation because the file or folder VM_NAME.vmdk already exists

    This issue might occur when you create a virtual machine with two disks with identical names in different datastores while the provisioning.relocate.enableRename is set to true in the vCenter Server and then attempt to peform a storage vMotion on it or when you perform a partial storage vMotion back and forth between two datastores.

    This issue is resolved in this release.
  • When a virtual machine is migrated and you directly connect the vSphere Client to an ESXi host, the network adapter displays an error message: Invalid backing
    After you perform a cold migration or a vMotion operation, if the vSphere Client is directly connected to the destination ESXi host and you edit the settings of the migrated virtual machine, the network adpater displays the following error message:

    Invalid backing.

    This issue is resolved in this release.

Virtual Machine Management

  • Attempts to perform vMotion on multiple virtual machines fails with the error: Operation cannot be performed while vApp operation is in progress
    Attempts to perform vMotion simulataneously on multiple virtual machines from vApp fails with the following error message in the Recent Tasks pane:

    Operation cannot be performed while vApp operation is in progress

    This issue is resolved in this release.
  • The CPU ready time for idle virtual machines in a resource pool is high
    When you have a resource pool spread across multiple hosts and if the virtual machines on some of the hosts are active and on some other hosts are idle, you might encounter high CPU ready time, when the idle virtual machines begin to get active, as a result of low CPU resource limit on the host. The CPU ready time is considered high if the %Ready field value in the esxtop tool is higher than the normal value of 5%.

    This issue is resolved in this release.

VMware HA and Fault Tolerance

  • High Availability (HA) failover might lead to virtual machines losing network connectivity when virtual machines are configured to use multiple vSphere Distributed Switches (VDS)
    If a virtual machine is configured to use multiple VDS switches with the same port key, an HA failover in the host leads to the virtual machines losing network connectivity.

    This issue is resolved in this release.
  • Guest shutdown through VMware View operations might cause a powered off virtual machine to be re-protected by FDM
    During guest shutdown of a Linux-based virtual machine through VMware View, the vCenter Server also simultaneously attempts to power off the virtual machine. This results in a conflict and the virtual machine gets re-protected by the Fault Domain Manager (FDM). When you power on the virtual machine, an error message similar to the following is displayed:

    This virtual machine might have been moved or copied.

    This issue is resolved in this release.

Known Issues

Read through all of the Known Issues to find items that apply to you. The issues are grouped as follows.

Known issues not previously documented are marked with the * symbol.

Installation

  • Launch of autorun.exe on a Windows 2012 machine with MS SQL Server installed displays script errors *
    On a Windows 2012 machine that has Microsoft SQL Server installed, launching autorun.exe from the product installation media causes script errors to be displayed.
    Workaround: This issue occurs only on the first attempt to launch autorun.exe. To resolve the issue, ensure the installer has stopped completely and launch the autorun.exe again.

  • No error message when you install vSphere Authentication Proxy, vSphere ESXi Dump Collector, and vSphere Syslog Collector support tools for vCenter Server on earlier versions of vCenter Server
    vCenter Server tools (VMware ESXi Dump Collector, VMware Syslog collector, vSphere Auto Deploy, and vSphere Authentication Proxy) are included with the vSphere 5.0 installation media. If you attempt to install one or more of these tools on a system on which an earlier version of vCenter Server is installed, the installation fails without displaying an error message.
    Workaround: None

  • vSphere Authentication Proxy, vSphere ESXi Dump Collector, and vSphere Syslog Collector support tools for vCenter Server do not support IPv6
    The host machines for Authentication Proxy, ESXi Dump Collector, and Syslog Collector must each have a valid IPv4 address. You can install these support tools on machines in IPv4-only or IPv4/IPv6 mixed-mode network environments. You cannot install the tools on machines in IPv6-only environments. The Authentication Proxy, ESXi Dump Collector, and Syslog Collector services bind to an IPv4 address for communication with vCenter Server, and do not support IPv6. The vCenter Server can be on a host machine in an IPv4-only, IPv4/IPv6 mixed-mode, or IPv6-only network environment, but the machine that connects to the vCenter Server through the vSphere Client must have an IPv4 address for the Authentication Proxy, ESXi Dump Collector, and Syslog Collector services to work.
    Workaround: None.

  • vCenter Inventory Service does not support binding on IPv6 interfaces by default
    When you install vCenter Server, vCenter Inventory Service supports only IPv4 by default.

    Workaround: To enable IPv6 support for vCenter Inventory Service, take the following steps.

    1. Stop the vCenter Inventory Service.
      1. From the Administrative Tools control panel, select Services.
      2. Right-click vCenter Inventory Service and select Stop.
    2. In a text editor, open the following file:
      Inventory_Service_installation_directory/lib/server/config/dataservice.properties
    3. Change the value for dataservice.nio.enabled to false.
    4. Restart the vCenter Inventory Service.
  • Cannot install vSphere Client in folder whose name contains special characters
    When you install the vSphere Client into a folder or directory whose name contains any of the characters semicolon (;), left square bracket ([), right square bracket (]), equals sign (=), plus sign (+), comma (,), or pound sign (#), the following error message appears:
    The installation path contains a ';' character. Please select an installation directory with this character.
    Even if the folder name does not contain a semicolon (;), you cannot install the vSphere Client into the specified folder. In addition, if you install the vSphere Client into a customized folder with a name that contains a pound character (#), the client cannot connect to vCenter Server.
    Workaround: Do not install the vSphere Client into a customized folder with a folder name that contains any of the characters semicolon (;), left square bracket ([), right square bracket (]), equals sign (=), Plus sign (+), comma (,), or pound sign (#).

  • Joining a Linked Mode group after installation is unsuccessful if User Account Control is enabled on Windows 2008
    When User Account Control (UAC) is enabled on Windows 2008 x64-bit operating systems and you try to join a machine to a Linked Mode group on a system that is already running vCenter Server, the link apparently succeeds without any errors, but in reality it is unsuccessful. Only one vCenter Server appears in the inventory list.

    Workaround: Turn off User Account Control (UAC) before joining a Linked Mode group after installation, then turn it back on.

    1. Turn off UAC.
      1. From the Start menu, select Control Panel > User Accounts.
      2. Select Turn User Account control on or off.
      3. Deselect User Account Control (UAC) to help protect your computer and click OK.
      4. Reboot the machine when prompted.
    2. Start the Linked mode configuration.
      1. Select Start > All Programs > VMware > vCenter Server Linked Mode Configuration.
      2. Click Next.
      3. Select Modify Linked-Mode configuration and click Next.
      4. Select Join this vCenter Server instance to an existing Linked-Mode group or another instance, and click Next.
      5. Enter the server name and LDAP port information and click Next.
      6. Click Continue to complete the installation.
      7. Click Finish to end the linking process.
    3. Log in to one of the vCenter Server systems and verify that the servers are linked.
    4. After the vCenter Server systems are linked, turn on UAC.
      1. From the Start menu, select Control Panel > User Accounts.
      2. Select Turn User Account control on or off.
      3. Select User Account Control (UAC) to help protect your computer and click OK.
      4. Reboot the machine when prompted.
  • After installing the vSphere Web Client, when the user clicks Finish in the installation wizard, a browser opens and displays a blank page
    After you install the vSphere Client, a browser opens and displays a blank page when you click Finish in the installation wizard. The page remains blank and the browser does not connect to the vSphere Administration application.
    Workaround: Close the browser and launch the vSphere Administration Application page from the Start menu.

Upgrade

  • Upgrading Windows vSphere Client on non-English systems might fail
    The Windows vSphere Client 5.0 Update 3 installer will report an Internal Error 2229 error when performing an upgrade of an existing installation on non-English systems.
    Workaround: Uninstall the existing vSphere Client 5.0 before installing vSphere Client 5.0 Update 3.

  • vCenter Server upgrade fails with the error The system administrator has set policies to prevent this installation
    This problem can occur when the computer has insufficient contiguous memory for Windows Server 2003 or Windows XP to verify that the .msi package or the .msp package is correctly signed.

    Workaround:

    1. From the Windows Start menu, select Run, type control admintools, and click OK.
    2. Double-click Local Security Policy.
    3. Select Software Restriction Policies.
    4. If no software restrictions are listed, right-click Software Restriction Policies, and select Create New Policy.
    5. Under Object Type, double-click Enforcement.
    6. Select All users except local administrators, and click OK.
    7. Restart the computer, and retry the vCenter Server upgrade.
  • Data migration fails if the path to the vCenter Server installation media contains non-ASCII characters
    When this problem occurs, an error message similar to: 'ascii' codec can't decode byte 0xd0 in position 30: ordinal not in range(128) appears, and the installer quits unexpectedly during the data migration process.
    Workaround: Make sure the path to the vCenter Server installation media does not contain any non-ASCII characters.

Licensing

  • Automatic assignment of a vSphere license key to certain ESX/ESXi hosts in a host container might be unsuccessful and the hosts might remain in evaluation mode
    vCenter Server 5.0 supports the automatic assignment of license keys to ESX/ESXi hosts. You can associate a license key with a host container in vCenter Server, such as a datacenter or a cluster. vCenter Server assigns the license key to all unlicensed hosts that you add to this host container. You can associate only one license key to a host container. If the license that you associate with a host container is a different version than the hosts that you add to this host container, the license is not assigned to the hosts. For example, if you associate a vSphere 5.x license to a cluster and you add ESX/ESXi 4.x to the cluster, the license is not assigned to the ESX/ESXi 4.x hosts and they remain in evaluation mode.
    Workaround: Make sure that all hosts that you add to a host container are of the same version as the license that you associate with the same container. If a host from the same container requires a license of a different version, associate the license directly with the host. For example, you associate a vSphere 5.x license with a cluster. You add ESXi 5.x hosts to the cluster and they are assigned the vSphere 5.x license. You add ESX/ESXi 4.x hosts to the same cluster and associate a vSphere 4.x license with the hosts. You reconnect the ESX/ESXi 4.x hosts to vCenter Server and they are assigned the vSphere 4.x license.

Security

  • Datastore web interface sessions are not immediately terminated when you close the browser window
    When you close a web browser after accessing the datastore web interface, the session is not immediately terminated on the server side. VMware would like to thank Jason Jones of Inner Security for reporting this issue.
    Workaround: You must click Logout in the datastore web interface to terminate the session before you close the browser window.

Networking

  • Adding a network resource pool to a vSphere Distributed Switch fails with the error Cannot complete a vSphere Distributed Switch operation for one or more host members
    This error message indicates that one or more of the hosts on the distributed switch is already associated with the maximum number of network resource pools. The maximum number of network resource pools allowed on a host is 56.
    Workaround: None.

  • Fault Tolerance is not compatible with vSphere DirectPath I/O with vSphere vMotion
    When Fault Tolerance is enabled on a virtual machine, DirectPath I/O with vMotion is inactive for all virtual adapters on the virtual machine.
    Workaround: Disable Fault Tolerance and reboot the virtual machine before enabling DirectPath I/O with vMotion.

  • vCenter Server Virtual Appliance does not support IPv6
    Although the vCenter Server Virtual Appliance Web console has an option to configure IPv6, vCenter Server Virtual Appliance does not support IPv6 configuration.
    Workaround: Do not set or change IPv6 configuration on the vCenter Server Virtual Appliance Web console.

Storage

  • I/O latency threshold appears to be 15ms after you disable I/O metrics for a datastore cluster
    After you disable I/O metrics for a datastore cluster, the Summary page for the datastore cluster continues to display an I/O latency threshold value of 15ms (the default).
    Workaround: None. To view the correct value, select Datastore Cluster>Storage

  • Link to enter SDRS maintenance mode appears on Summary page of standalone datastore
    Only datastores that are a part of a datastore cluster can successfully enter Storage DRS maintenance mode. However, a link to enter Storage DRS maintenance mode appears on the Summary page for a datastore that is not in a datastore cluster. When you click Enter SDRS maintenance mode for a standalone datastore, the datastore attempts to enter maintenance mode and the task appears to be pending indefinitely.
    Workaround: Cancel the Enter SDRS Maintenance Mode task in the Recent Tasks pane of the vSphere Client.

  • An all paths down (APD) condition during Storage vMotion can result in communication failure between vCenter Server and ESXi host
    If an APD condition occurs when you migrate virtual machines using Storage vMotion, vCenter Server disconnects the host involved in Storage vMotion from the vCenter Server inventory. This condition persists until the background Storage vMotion operation completes. This action could take a few minutes or hours depending on the Storage vMotion operation time. During this time, no other operation can be performed for that particular host from vCenter Server.
    Workaround: None. After the Storage vMotion operation completes, vCenter Server reconnects the host back to the inventory. None of the running virtual machines on non-APD datastores are affected by this failure.

  • Symbolic links added to a datastore might cause the Datastore Browser to incorrectly display datastore contents
    When you add symbolic links at the top level of a datastore, either externally in an NFS server or by logging in to the host, you might not be able to see the correct datastore information, such as its files and folders, when you browse the datastore. Symbolic links referencing incorrect files and folders might cause this problem.
    Workaround: Remove the symbolic links. Do not use symbolic links in datastores.

  • Attempts to add an extent to an ATS-capable VMFS datastore fail
    You can only span an ATS-capable datastore over an ATS-capable device. If you select the device that does not support ATS to extend the ATS-capable datastore, the operation fails. The vSphere Client displays the An error occurred during host configuration message. In the log file, you might also find the following error message:
    Operation failed, unable to add extent to filesystem.
    Workaround: Before adding an extent to an ATS datastore, verify whether the extent device supports ATS by running the following command:
    esxcli storage core device vaai status get -d=device_ID
    The output must display the following information:
    ATS Status: supported

  • Storage DRS might not behave as expected when balancing I/O load
    When you use IOMeter software to generate I/O load to test Storage DRS, the IOMeter populates the files with only zeros by default. This data does not contain random patterns of ones and zeros, which are present in real data and which are required by Storage DRS to determine the I/O characteristics and performance of the datastore.
    Workaround: When you test Storage DRS load balancing, use real data to populate at least 20 percent of the storage space on the datastore. If you use IOMeter software to generate I/O load, choose a version that allows you to write random patterns of ones and zeros to your files.

  • Names of new virtual machine disks do not appear in Storage DRS initial placement recommendations
    When creating, cloning, or deploying from template a virtual machine on a Storage DRS-enabled datastore cluster, the placement recommendations or faults dialog box does not list the names of the new virtual machine hard disks. The dialog box displays
    Place new virtual machine hard disk on <datastore name>.
    Workaround: None. When virtual machines are being created, hard disk names are not assigned until the disks are placed. If the virtual machine hard disks are of different size and are placed on different datastores, you can use the Space Utilization before and after statistics to estimate which disk is placed on which datastore.

  • Storage DRS appears to be disabled when you use the Scheduled Task wizard to create or clone a virtual machine
    When you create a scheduled task to clone or create a virtual machine, and select a datastore cluster as the destination storage for the virtual machine files, the Disable Storage DRS check box is always selected. You cannot deselect the Disable Storage DRS check box for the virtual machine in the Scheduled Task wizard.
    Workaround: None. The Disable Storage DRS check box is always selected in the Scheduled Task wizard. However, after the Scheduled Task runs and the virtual machine is created, the automation level of the virtual machine is the same as the default automation level of the datastore cluster.

  • vSphere Client displays an error when you attempt to unmount an NFS datastore with Storage I/O Control enabled
    If you enable Storage I/O Control for an NFS datastore, you cannot unmount that datastore. The following error message appears:
    The resource is in use.
    Workaround: Before you attempt to unmount the datastore, disable Storage I/O Control.

  • After migration, the mode of an IDE RDM disk in physical compatibility does not change to Independent Persistent
    The mode of the IDE RDM disk in physical compatibility does not change to Independent Persistent after you migrate the virtual machine with the disk from the ESX/ESXi 4.x host to ESXi 5.0.
    Workaround: After migration, use the vSphere Client to change the disk's mode to Independent Persistent.

  • Attempts to add a virtual compatibility RDM with a child disk to an existing virtual machine fail
    If you try to add a virtual compatibility RDM that has a child disk to an existing virtual machine, the operation fails. The vSphere Client displays the following error message:
    Reconfigure failed: vim.fault.DeviceUnsupportedForVmPlatform.
    Workaround: Remove a child disk to be able to add a virtual compatibility RDM.

  • With software FCoE enabled, attempts to display Storage Maps fail with an error message
    This problem affects only those ESXi hosts that have been added to vCenter Server without any previous software FCoE configuration. After you enable software FCoE adapters on these hosts, attempts to display Storage Maps in the vSphere Client fail. The following error message appears:
    An internal error has occurred: Failed to serialize response.
    Workaround: Configure software FCoE on the ESXi host first, and then add the host to vCenter Server.

  • Attempts to unregister multiple storage vendor providers at the same time might fail with an error
    If you try to simultaneously unregister multiple vendor providers from vCenter Server, your attempts might fail. The following error message appears even though the failed vendor providers are present in vCenter Server:
    ManagedObjectNotFound.
    The sms.log file might display the following exception:
    ProviderUnregistrationFault.
    Workaround: Manually unregister one vendor provider at a time.

Server Configuration

  • Applying a host profile with a service startup policy of off does not disable the service
    A host profile is created using as a reference host an ESXi host configured with some services disabled and is applied to a host with those services enabled. The host profile application process does not disable the services on the target ESXi host. This situation is commonly encountered by users who have enabled the ESXShell or SSH services on the target ESXi hosts through the Security Profile in the vSphere Client or Troubleshooting Options in the DCUI.

    Workaround: The reboot process disables the services. You can also manually stop the services in the vSphere Client by configuring the host. Perform this procedure for each service.

    1. Select the host in the inventory.
    2. Click the Configuration tab.
    3. Click Security Profile in the Software section.
    4. Click Properties and select the service.
    5. Click Options.
    6. Click Stop and click OK.

  • Host profile answer file status is not updated when switching the attached profile of the host
    When attaching a host profile to a host that was previously attached to another host profile, the answer file status is not updated. If the answer file status is Completed,after attaching another host profile to the host, the answer file status in the host profile view still appears as Completed. The actual status, however, might be changed to Incomplete.

    Workaround: Manually update the answer file status after attaching a host profile.

    1. In vSphere Client, select the newly attached profile in the Host Profiles inventory view.
    2. Click the Hosts and Clusters tab.
    3. Right-click the host from the Entity Name list and select Check Answer File.

    The host profile answer file status is updated.

  • Manually applying a host profile containing a large configuration might timeout
    Applying a host profile that contains a large configuration, for example, a very large number of vSwitches and port groups, might timeout if the target host is either not configured or only partially configured. In such cases, the user sees the Cannot apply the host configuration error message in the vSphere Client, although the underlying process on ESXi that is applying the configuration might continue to run.

    In addition, syslog.log or other log files might have error messages such as the following message:
    Error interacting with configuration file /etc/vmware/esx.conf: Timeout while waiting for lock, /etc/vmware/esx.conf.LOCK, to be released. Another process has kept this file locked for more than 20 seconds. The process currently holding the lock is hostd-worker(5055). This is likely a temporary condition. Please try your operation again.

    This error is caused by contention on the system while multiple operations attempt to gather system configuration information while the host profiles apply operation sets configuration. Because of these errors and other timeout-related errors, even after the host profiles apply operation completes on the system, the configuration captured in the host profile might not be fully applied. Checking the host for compliance shows which parts of the configuration failed to apply, and perform an Apply operation to fix those remaining non-compliance issues.

    Workaround: Perform one of the following:

    • ESXi hosts not provisioned with Auto Deploy

      1. Increase the timeout value for the apply operation by adding the following entry in the /etc/vmware/hostd/cmdMo.xml file:

        <managedObject id="2">
        <type> vim.profile.host.profileEngine.HostProfileManager </type>
        <moId> ha-hostprofileengine-hostprofilemanager </moId>
        --> <timeOutInSeconds> xxxx </timeOutInSeconds> <--****
        <version> vim.version.dev </version>
        <cmd> /usr/bin/sh </cmd>
        <arg id="1"> -l </arg>
        <arg id="2"> -c </arg>
        <arg id="3"> /usr/lib/vmware/hostd/hmo/hostProfileEngine.py --cgi </arg>
        </managedObject>


        Where xxxx is the timeout value in seconds. By default, the apply operation times out in 10 minutes. This entry lets you set a longer timeout. For example, a value of 3600 increases the timeout to 1 hour. The value you enter might vary depending on the specific host profile configuration. After you set a high enough value, the apply operation timeout error no longer appears and the task is visible in the vSphere Client until it is complete.
      2. Restart hostd.
    • Hosts provisioned with Auto Deploy

      1. Reboot the ESXi host provisioned with Auto Deploy.
      2. For ESXi hosts provisioned with Auto Deploy, ensure that the answer file is complete by performing the Update Answer File operation on the ESXi host and then rebooting.

        The configuration in the host profile and answer file is applied on the system during initialization. Large configurations might take longer to boot, but it can be significantly faster than manually applying the host profile through the vSphere client.
  • Host Profiles compliance check fails for reference host with newly created profile
    A compliance check for a newly configured host profile for example, configured with iSCSI, might fail if the answer file is not updated before checking compliance.
    Workaround: Update the answer file for the profile before performing a compliance check.

vCenter Server and vSphere Client

  • The vSphere Client 5.0 does not display the default group that the default local user belongs to*
    The vSphere Client 5.0 does not display the default group to which the default local users such as dcui, vpxuser, and nfsnobody belong to. An error message similar to the following is displayed:

    Call "HostLocalAccountManager.AssignUserToGroup" for object "ha-localacctmgr" on ESXi failed.
    Workaround: None.
  • Unable to search virtual machines under Virtual Appliance in the VMs and Templates view*
    When you search for virtual machines under Virtual Appliance (vApp) in the VMs and Templates view, the results are displayed. However, when you click on the search results, the virtual machines inside vApp are not displayed.
    Workaround: You can perform the search from Hosts and Clusters view.
  • vCenter performance chart for the past day displays data only for the current day with time zone set to local*
    The vCenter performance chart for the past day displays data only for the current day and not for a 24-hour period in an environment where vCenter Virtual Appliance is deployed and the time zone is changed to the local time zone.
    Workaround: None.
  • Scheduled Tasks might display incorrect next run time if the vSphere Client system time is not set according to the UTC time zone *
    If task is scheduled by using a vSphere client whose system time is not set according to the UTC, vCenter System might incorrectly schedule the task ahead or later than the actual desired time. The issue is caused by vCenter Server storing and processing scheduled task times in UTC.

    For example, consider the scenario when a task is scheduled in the JST time zone with frequency and start time similar to the following:
    Frequency: Monthly
    Starting Time:1:00(JST)
    The last Wednesday of the month

    Now, at 1:00 (JST), the last Wednesday of the month according to UTC time zone might be the first Wednesday of the next month according to the JST time zone. This might cause the scheduled task to run on the first Wednesday of the next month. This issue occurs when the starting time is between 0:00 and 8:59(JST).
    Workaround: None.
  • Exporting events for a long period of time results in the vSphere Client to display an error message: System.OutOfMemoryException *
    When exporting events for a long period of time, for example for several months, the vSphere Client displays an error message System.OutOfMemoryException and fails the export events task. In environments with very high number of events this error can occur at smaller intervals.
    Workaround: To resolve this issue collect the events for a long period of time in short installments (short periods of time and combine them) by specifying the to and from time.
  • vCenter Server 5.0 is unable to function correctly when installed with Oracle 11.2.0.3 Patch 10 or later
    vCenter Server 5.0 and 5.1 does not function correctly when installed with Oracle 11.2.0.3 Patch 10 or later. With this, creating a new virtual machine on vCenter Server 5.0 fails with the following error message:
    An internal error occurred in the vSphere Client.
    Details: Object reference not set to an instance of an object.


    For more information: see KB 2039874
    Workaround: None.

  • Guest operating system name displayed in Virtual Machines tab and Summary tab might be different
    In vCenter Server, the guest operating system name selected during virtual machine creation might be different from the actual guest operating system running or installed on the virtual machine. For such virtual machines, always the Configured OS name would be shown in the Virtual Machines tab. Whereas, if you select the virtual machine name in the inventory and click on Summary tab, the guest operating system name shown might be either Runtime OS name or Configured OS name depending on whether VMware Tools is enabled or disabled, virtual machine powered on or off, etc.
    Workaround: None

  • The Summary tab might display incorrect values for Provisioned space for Hosts with VAAI NAS
    When a virtual disk with Thick Provision Lazy zeroed format is created on an ESXi host with VAAI NAS, in the Datastores and Datastore Cluster view, the Provisioned space displayed on the Summary tab  might be double of the provisioned storage set for the virtual disk.
    For example the if the provisioned storage is 75GB, the Provisioned space displayed might be around 150 GB.
    Workaround: None

  • Email contains incorrect measurement unit information when custom alarms based on VM Total Size on Disk(GB) are triggered
    If a custom alarm that is based on VM Total Size on Disk(GB) is set to trigger by size (GB), the email generated when the alarm is triggered contains metric information that is not defined by size (GB).
    For example, an email similar to the following is received where the metrics referenced is percentage (%) and not size (GB).
    Target: <Target_Name>
    Previous Status: Gray
    New Status: Yellow

    Alarm Definition:
    ([Yellow metric Is above 20971%; Red metric Is above 52428%])
    Current values for metric/state:
    Metric Space actually used = 31457%

    Description:
    Alarm <Alarm_Name> on <Target_Name> changed from Gray to Yellow.
    Workaround: None
  • Welcome screen of VMware vCenter Server Appliance console does not display the Configure Network option
    Configure Network option is no longer available through welcome screen of VMware vCenter Server Appliance console. Starting with this release, you will not be able to configure network settings from the welcome screen of VMware vCenter Server Appliance.
    Workaround:Log into VMware vCenter Server Appliance Web UI using a web browser to configure the network settings.
  • Database size estimator displays 0.00B for embedded vPostgres database
    When you use the vSphere Web Client, the vCenter database size estimator is not updated when using the vPostgres database. The Estimated database space or Estimated space required fields display 0.00B no matter what is set.
    The size estimator continues to work for remote databases.
    Workaround: None

  • After upgrading the vCenter Server, the performance tab reports the message : Report application initialization is not completed successfully
    If the VMware Virtual Center Management Webservices is running under a Windows Active Directory account, instead of a local system account, the upgrade process may set the VMware VirtualCenter Management Webservices to run under local system.
    The vCenter Server service continues to run under the domain account and the VirtualCenter Management Webservices service runs as local system, which impacts the correct operation of the VirtualCenter Management Webservices (Tomcat) service.
    Workaround:

    1. Close all vSphere Client sessions connected to vCenter Server.
    2. Click Start > Run, type services.msc, and click OK. The Services window opens.
    3. Right-click the VMware VirtualCenter Management Webservices service and click Properties.
    4. Click the Log On tab.
    5. Change the account to use "This account:" and use the same domain account which the VMware VirtualCenter Server service is using.
    6. Click OK.
    7. Right-click the VMware VirtualCenter Management Webservices service and click Restart.
    8. After the service starts, connect to the vCenter Server.
    Note: You may have to follow this process for these services also

    • vCenter Inventory Service
    • VMware vSphere Profile-Driven Storage Service
  • vCenter Server Appliance vpxd service appears in running state even though service is not successfully initialized
    On the VMware vCenter Server Appliance , the vpxd service appears in a running state when checked through the Web Console or through the command line, but users are unable to log in to the vCenter Server Appliance using the vSphere Client.sw
    Workaround: None

  • vCenter Service status tab displays errors after you change the HTTP and HTTPS port settings on vCenter Server Appliance
    In vCenter Server Appliance , after changing the HTTP and HTTPS port settings, the vCenter Service status tab in vSphere Client shows errors for services such as Storage Monitoring Service, Profile-driven Storage and vCenter Server. Storage Views tab for an ESX host may show no data.
    Workaround: None

  • The embedded database provided with the vCenter Server Appliance supports an inventory with a maximum of 5 hosts and 50 virtual machines
    The embedded database is not configured to manage an inventory that contains more than 5 hosts and 50 virtual machines. If you use the embedded database with the vCenter Server Appliance, exceeding these limits can cause numerous problems, such as causing vCenter Server to stop responding.

  • An error occurs when backing up inventory services data in the vCenter Server Appliance
    When you run the /usr/lib/vmware-vpx/inventoryservice/scripts/backup.sh script to back up inventory services data in the vCenter Server Appliance, it might fail with the error message, Java HotSpot(TM) 64-bit Server VM warning: Attempt to allocate stack guard pages failed. This error occurs when the vCenter Server Appliance is low on memory and JVM cannot allocate enough memory to start the process.
    Workaround: Increase system RAM for the vCenter Server Appliance.

  • Restarting vpxd in the vCenter Server Appliance fails with a database error
    On a vCenter Server Appliance with an embedded database, restarting vpxd might fail. An error message similar to the following appears in the vpxd.log file:
    Alert:false@ /build/mts/release/bora-336896/bora/vpx/vpxd/util/vpxdVdb.cpp:403

    This error occurs if the system clock on the vCenter Server Appliance is reset to a time earlier than the time at which the database was created. As a result the database objects created by the vCenter Server Appliance having time stamps that appear to be in the future. This causes queries for database objects to fail.

    You might encounter this error during Active Directory configuration if the clock on the Active Directory domain controller is set to an earlier time than the clock on the vCenter Server Appliance, because during the configuration, the vCenter Server Appliance clock is synchronized to the clock on the Active Directory domain controller.
    Workaround: After configuring the embedded database, do not set the system clock on the vCenter Server Appliance to an earlier time. When configuring Active Directory, ensure that the clock on the Active Directory domain controller is not set to a time earlier than the clock on the vCenter Server Appliance.

  • The VMware vCenter Server Appliance web console has options for configuring IPv6 even though IPv6 is not supported
    Although the VMware vCenter Server Appliance does not support IPv6, the Network tab of the VMware vCenter Server Appliance Web console has a configuration option for IPv6 and assigns an IPv6 address to the appliance if a DHCPv6 server is on the network.
    Workaround: Type an invalid static IPv6 address for the VMware vCenter Server Appliance to prevent the appliance from obtaining an IPv6 address through DHCP.

  • Performance counters are shown to be at Stat-level 2 while they are actually moved to Stat-level3
    In vCenter Server, some performance counters are actually moved to Stat-level 3, but appear to be available at Stat-level 2 in the vSphere Client.The vSphere Client is not updated correctly to reflect the changes to CPU and disk related information, which have been moved to stat-level 3.
    Workaround: Move to Stat-level 3 to use those counters.

  • Logging into vCenter (using SQL database) with certain third party applications can cause severe vCenter database performance issues
    When applications like nWorks query the vCenter SQL database, the resultant SQL query can be very large which causes the database to run out of tempdb space and cause vCenter service to crash.
    Workaround: If the database performance issue is caused by a SQL query with a huge IN CLAUSE coming from vCenter Server, then the following config parameter can be used which alters the query produced from EventManagervia the vpxd.cfg configuration file.

  • Advanced performance chart views does not display data for virtual machines if data counters not applicable to virtual machines are selected
    When customizing advanced performance chart views, if you use the per-virtual-machine stacked graph chart type for virtual machines and select data counters that are not applicable for virtual machine, the resulting chart does not display any performance data for the virtual machine. The Performance Chart Legend pane also does not show any data for the virtual machine.
    Workaround: When customizing advanced performance chart views, do not select data counter that are not applicable for virtual machines. TO know the list of counters applicable for virtual machines, select a virtual machine in the vCenter Server inventory, click the Performance tab and navigate to Advanced -> Chart Options.

  • The vSphere Web Client Alarms sidebar does not indicate the correct number of alarms present in the system
    When more than 100 alarms are present in the system, the vSphere Web Client Alarms sidebar falsely indicates only 100 alarms.
    Workaround: None.

  • Overview performance charts do not appear for datastore clusters or datastores in large environments
    In some large environments, overview performance charts might not appear for datastore clusters or datastores because vSphere Management WebServices, Tomcat, is out of memory.
    Workaround: Increase the amount of memory available to Tomcat.

  • When using the vSphere Web Client, you are repeatedly prompted to increase local storage available for Adobe Flash
    The vSphere Web Client uses local storage on the system that issued to access the client to store log files. The storage limits for the log files are determined by Adobe Flash Player settings. As the log files grow, a dialog box appears prompting you to increase the limit. You are prompted again periodically until the storage limit reaches Unlimited.
    Workaround: Set the storage limits for the Adobe Flash Player:

  • Cannot select multiple columns for sorting in the vSphere Web Client
    In tables in the vSphere Web Client, you can select the primary column for sorting by clicking on the column header. Clicking on a second column header changes that column to the primary sorting column rather than selecting it as the secondary sorting column.

    Workaround: To sort by multiple columns in vSphere Web Client tables, perform the following procedure:

    1. Select the primary column for sorting by clicking on the column header.
    2. Select the secondary and subsequent columns for sorting by Ctrl-clicking on the column headers.

  • Internet Explorer 7 cannot load vSphere Web Client pages
    If Internet Explorer 7 security settings do not include about:internet and https://localhost as trusted sites, the Web browser cannot open vSphere Web Client pages.

    Workaround: Add about:internet and https://localhost as trusted sites:

    1. In Internet Explorer 7, select Tools > Internet Options.
    2. Click the Security tab.
    3. Select Trusted Sites.
    4. Click Sites.
    5. In the Add this Web site to the zone text box, type about:internet and click Add.
    6. In the Add this Web site to the zone text box, type https://localhost and click Add.
    7. Click OK.
    8. Close and restart Internet Explorer.
  • Opening the vSphere Administration Application from a shortcut produces the error: Windows cannot find 'https://localhost:9443/admin-app'
    When Firefox is the default Web browser and is not running, launching the vSphere Administration Application from a shortcut might produce the error:
    Windows cannot find 'https://localhost:9443/admin-app'. Make sure you typed the name correctly, and then try again.

  • Workaround: This is a known issue with Firefox on some Windows systems. See http://kb.mozillazine.org/Windows_error_opening_Internet_shortcut_or_local_HTML_file_-_Firefox.

  • The vSphere Web Client does not load the vCenter Server inventory if the vCenter Server host name cannot be resolved
    If the vSphere Web Client cannot resolve the vCenter Server system's host name and the vCenter Server is registered with the vSphere Client using an IP address, the vSphere Web Client cannot load the inventory tree.
    Workaround: Ensure that the vCenter Server's host name can be resolved in one of the following ways:

    • Add the vCenter Server system to your name server.
    • Add the vCenter Server system to the C:\Windows\System32\drivers\etc\hosts file on the system that runs the vSphere Web Client
  • Flash plug-in crashes when logging in or out of vSphere Web Client on Linux
    When you log in or out of the vSphere Web Client on a Linux system, the Flash plug-in might crash.
    Workaround: Reload the page to restart the Flash plug-in.

  • Cannot access vSphere Web Client administration tool using a local IPv6 address
    If you attempt to access the vSphere Web Client administration tool using a local IPv6 address, the Web browser displays the error message
    vSphere Web Client administration tool cannot be accessed from a remote host.

  • Workaround: Use localhost instead of the IPv6 address to access the administration tool. For example, use https://localhost:9443/admin-app instead of an address like https://[fc00:10:20:123:355c:1744:1b82:6716]:9443/admin-app.

  • Internet Explorer 7 cannot access vSphere Client Web pages when the client is installed on a system that uses pure IPv6
    If the vSphere Web Client is installed on an operating system that uses pure IPv6, you cannot use Internet Explorer 7 to access the vSphere Web Client.
    Workaround: Use Firefox or Internet Explorer 8 to access the vSphere Web Client.

  • Internet Explorer might fail to download the Client Integration Plug-In
    When you use Internet Explorer to download the Client Integration Plug-In, you might see the error message,Internet Explorer cannot download the vmware-vmcr-win32-x86.exe from localhost. This happens when certain security settings in Internet Explorer prevent download of the Client Integration Plug-In.
    Workaround: Use an alternative method of downloading the Client Integration Plug-In.

    • Use Firefox to connect to the vSphere Web Client and download the Client Integration Plug-In.
    • Use Internet Explorer to connect to the Client Integration Plug-In file directly using the non-secure port http://ipaddress:portnumber/vsphere-client/vmrc/vmware-vmrc-win32-x86.exe. For example, http://localhost:9090/vsphere-client/vmrc/vmware-vmrc-win32-x86.exe.
  • The vSphere Web Client does not load or refresh data
    Sometimes the vSphere Web Client cannot load or refresh data. The loading spinner at the top right corner of the application continues to spin, and the requested information is not displayed.
    Workaround: Perform one or more of the following procedures:

    • Click the browser's Refresh button.
    • Select a different object from the inventory tree and click the browser's Refresh button.
    • Check the health status of vCenter Server and its services. Restart any services that have stopped.
  • The vSphere Web Client login page is not accessible from the vCenter Server Welcome page
    If you use a localhost URL to access the vCenter Server Welcome page, clicking the Log in to vSphere Web Client produces an error.
    Workaround: Use the IP address or host name of the vCenter Server system to access the Welcome page.

  • The Select Users and Groups dialog box in the vSphere Client shows truncated user and group names
    When you add a permission to an inventory object in the vSphere Client, the Select Users and Groups dialog box might display truncated names for users and groups. For example, Administrator might display as tor. Users and groups can be selected only by typing the correct complete name.
    This occurs when the Workstation service in Windows is stopped.

  • Workaround: Restart the Workstation service on the vCenter Server machine.

    Select Start > Programs > Administrative Tools > Services.

    Right-click Workstation and select Start.

  • The exported list of virtual machines might be incomplete
    When you select a datacenter, cluster, host, or other object in the vSphere Client inventory and export a list of its virtual machines, the list might not include all the virtual machines. This occurs because information in the list is not always populated for objects that are not visible.
    Workaround: Before exporting, scroll through the list to make sure that all virtual machines are displayed.

  • Spurious error messages appear in the vSphere Web Client log files
    Some spurious error messages appear in the vSphere Web Client log files because of the versions of Tomcat and dm Server used. These include a number of INFO messages as well as the message, SEVERE: No global context defined for server. You can ignore these messages.
    Workaround: None.

  • vSphere Web Client online Help incorrectly lists Firefox 3.5 as a supported browser
    The vSphere Web Client online Help incorrectly lists Firefox 3.5 as a supported Web browser for the vSphere Web Client and client integration plug-in.
    Workaround: For information about supported Web browsers, see the vSphere Installation and Setup documentation.

  • The vSphere Client shows an error message when attempting to view virtual machine Storage Profiles
    When you connect the vSphere Client to vCenter Server and attempt to view a virtual machine's storage profile, you might see the error message, vCenter Server is unable to connect to Profile-driven storage service at http:///sps/sdk.
    A port conflict occurs when the Storage Profile Service and another service are configured to use port 31000. The vSphere Web Client and vCenter Orchestrator can cause this conflict.

    Workaround: Restart vSphere Web Client service and the vCenter Orchestrator configuration service. The services will pick the next available free port when they are restarted. If only one of the services is present or running on the machine, you need only restart that service.

  • Information in the Virtual Machines tab might not refresh
    Sometimes information in the Virtual Machines tab in the vSphere Client might not immediately refresh. For example, if you clone or register a large number of virtual machines, some virtual machines might not appear in the Virtual Machines tab, although they appear in the inventory tree. If you power on or power off a large number of virtual machines, the new power states might not be reflected on the Virtual Machines tab, although they are correctly displayed in the inventory tree.
    Workaround: Press F5 to refresh the information in the tab.

  • vSphere Web Client does not load in Internet Explorer 9 on Windows Server 2008
    When you attempt to load the vSphere Web Client in Internet Explorer 9 on a Windows Server 2008 system, you see a blue background in the Web browser window and no further activity.
    Workaround: On Windows Server 2008 systems, use Internet Explorer 7 or 8 or Mozilla Firefox 3.6 or later to access the vSphere Web Client.

  • vSphere Web Client state does not persist between sessions
    The state of the vSphere Web Client normally persists between sessions, so that when you log in with the vSphere Web Client again, the same objects and tabs are selected that were selected when you logged out of the previous session. However, if your Web browser preferences are set so that the browser does not remember history, or if the Flash player Website Storage settings do not allocate any storage for visited sites, the Flash player does not store data from the vSphere Web Client and the state does not persist from session to session.

    Workaround: Perform the following procedure:

  • The vSphere Web Client intermittently produces Error #2406: The loaded file did not have a valid signature
    When using Mozilla Firefox 3.6.x on SUSE Linux Enterprise Server 11 or Red Hat Enterprise Linux 5, the follow error message might occur intermittently:
    Error #2406: The loaded file did not have a valid signature.
    Workaround:Restart the Web browser and reconnect to the vSphere Web Client.

  • vCenter Server Crashes When Exporting System Logs
    When you export system logs from vCenter Server, vCenter Server uses the folder specified by the WindowsTEMP environment variable. By default, this variable is set of C:\Windows\Temp.
    If vCenter Server is configured to store a large amount of log data, or if you select a large number of hosts from which to download logs, the drive specified in theTEMP variable can run out of space. If this drive is the same drive on which vCenter Server is installed, the VMware VirtualCenter Server service might crash.
    Workaround: Ensure that the drive specified by the Windows TEMP environment variable has enough free space for exported logs. Consider specifying a drive other than C: in the TEMP variable to prevent disruption to system services.

Virtual Machine Management

  • Virtual machines within a vApp are powered off when the vApp's shutdown option is set to Guest Shutdown
    When you perform the shutdown operation on a vApp, all the virtual machines within the vApp are powered off, ignoring the configured shutdown action set for the vApp.
    Workaround: Use the Power Off option in the vApp to shutdown virtual machines within the vApp.
  • CPU hot add error on hardware version 7 virtual machines
    Virtual CPU hot add is supported with the multicore virtual CPU feature for hardware 8 virtual machines.
    For hardware version 7 virtual machines with cores per socket greater than 1, when you enable CPU hot add in the Virtual Machine Properties dialog box and try to hot add virtual CPUs, the operation fails and a CPU hot plug not supported for this virtual machine error message appears.
    Workaround: To use the CPU hot-add feature with hardware version 7 virtual machines, power off the virtual machine and set the number of cores per socket to 1.
    For best results, use hardware version 8 virtual machines.

  • USB devices passed through from an ESXi host to a virtual machine might disconnect during migration with vMotion
    When a USB device is passed through to a virtual machine from an ESXi host and the device is configured to remain connected during migration with vMotion, the device might disconnect during the vMotion operation. The devices can also disconnect if DRS triggers a migration. When the devices disconnect, they revert to the host and are no longer connected to the virtual machine. This problem occurs more often when you migrate virtual machines that have multiple USB devices connected, but occasionally happens when one or a small number of devices are connected.
    Workaround: Migrate the virtual machine back to the ESXi host to which the USB devices are physically attached and reconnect the devices to the virtual machine.

  • A virtual machine with an inaccessible SCSI passthrough device fails to power on
    If a SCSI passthrough device attached to a virtual machine has a device backing that is inaccessible from the virtual machine's host, the virtual machine fails to power on with the error, An unexpected error was received from the ESX host while powering on VM.
    Workaround: Perform one of the following procedures:

    • If the virtual machine's host has a physical SCSI device, change the device backing of the SCSI passthrough device to the host's physical SCSI device, and power on the virtual machine.
    • If the host does not have a physical SCSI device, remove the SCSI passthrough device from the virtual machine and power it on.
  • Virtual machine clone or relocation operations from ESXi 5.0 to ESX/ESXi 4.1 fail if replication is enabled
    If you use the hbr enablereplication command to enable replication on a virtual machine that resides on an ESXi 5.0 host and clone the virtual machine to an ESX/ESXi 4.1 or earlier host, validation fails with an operation is not supported error message. Cloning of ESXi 5.0 virtual machines on ESX/ESXi 4.1 hosts is not supported.
    Workaround: Select one of the following workarounds:

    • Clone the virtual machine onto an ESXi 5.0 host
    • Clone or relocate a new virtual machine on an ESX/ESXi 4.1 host.
  • vCenter Server 5.0 and ESX/ESXi host incompatibility cause migration operations for virtual machines with delta disks to fail
    If vCenter Server 5.0 manages a host earlier than ESX/ESXi 4.0 Update 3, you cannot migrate virtual machines with snapshots or delta disks to that host. Attempting such migrations results in the following system error message:
    Migration of VMs with snapshots or delta disks is not supported due to version incompatibility between vCenter Server and ESX. To continue this operation, please upgrade your ESX host(s) to ESX 4.0 Update 3 or later.
    The same restriction applies and a similar error message appears for ESX/ESXi 4.1. ESX/ESXi 4.1 does not support migration of virtual machines with delta disks if vCenter Server 5.0 manages the host.
    Workaround: Upgrade the ESX/ESXi host to ESX/ESXi 4.0 Update 3 or later or upgrade to ESX 4.1 Update 1 or later.

  • Non-ASCII DNS suffixes are not set correctly after customizing Windows XP and Windows 2003
    If you enter a non-ASCII DNS suffix in the Network Properties DNS tab when you use the Customization Specification Wizard to customize Windows XP or Windows 2003, the customization is reported as successful but the non-ASCII DNS suffix is not set correctly.
    Workaround: Set the DNS suffix manually in Windows XP and Windows 2003.

  • The snapshot disk path in the .vmsd snapshot database file and the parent path in the delta disk descriptor file are not updated after migration
    When snapshot.redoNotWithParent is set to TRUE and you change the
    snapshotDirectory setting from, for example, Database A to Database B, you might see an error message that says,
    Detected an invalid snapshot configuration. This problem occurs when both of the following conditions exist:

    • You revert to a previous snapshot in the snapshot tree and create new snapshots from that snapshot point. The result is a nonlinear snapshot tree hierarchy.
    • The disk links in a disk chain span multiple datastores and include both the source and destination datastores. This situation occurs if you change the snapshotDirectory settings to point to different datastores more than once and take snapshots of the virtual machine between the snapshotDirectory changes. For example, you take snapshots of a virtual machine with snapshotDirectory set to Datastore A, revert to a previous snapshot, then change the snapshotDirectory settings to Datastore B and take additional snapshots. Now you migrate the virtual disk from Datastore B to Datastore A.

    The best practice is to retain the default setting, which stores the parent and child snapshots together in the snapshot directory. Avoid changing the snapshotDirectory settings or taking snapshots between datastore changes. If you set snapshot.redoNotWithParent to TRUE, perform a full storage migration to a datastore that is currently not used by the virtual machine.

    Workaround: Manually update the disk path references to the correct datastore path in the snapshot database file and disk descriptor file.

Migration

  • Cold migration of a virtual machine that has IDE virtual disk from an ESXi 5.0 host to ESX/ESXi 4.x host fails with the error The operation is not supported on the object
    When you use vCenter Server 5.0 to cold migrate a virtual machine that has one or more IDE virtual disks from an ESXi 5.0 host to a host running ESX/ESXi 4.x, the migration fails with the error The operation is not supported on the object.

    Workaround: Perform the following steps.

    1. On the ESXi 5.0 host, select the virtual machine.
    2. If the virtual machine resides on a host-only datastore on the ESXi 5.0 host, move the virtual machine .vmx and .vmdk files to a shared LUN that is accessible to the ESXi 5.0 host and the ESX/ESXi 4.x host.
    3. Cold migrate the virtual machine to the ESX/ESXi 4.x host by using the Change host option in the Migrate Virtual Machine wizard.

  • During Daylight Saving Time (DST) transitions, the time axis on performance charts is not updated to reflect the DST time change.
    For example, local clocks in areas that observe DST were set forward 1 hour on Sunday, March 27, 2011 at 3am. The tick markers on the time axis of performance charts should have been labeled ..., 2:00, 2:20, 2:40, 4:00, 4:20, ..., omitting ticks for the hour starting at 3am. The labels actually displayed are ..., 2:00, 2:20, 2:40, 3:00, 3:20, 3:40, 4:00, 4:20, ....
    Workaround: None

  • Virtual machine disks retain their original format after a Storage vMotion operation in which the user specifies a disk format change
    When you attempt to convert the disk format to Thick Provision Eager Zeroed during a Storage vMotion operation of a powered-on virtual machine on an host running ESX/ESXi 4.1 or earlier, the conversion does not happen. The Storage vMotion operation succeeds, but the disks continue to retain their original disk format because of an inherent limitation of ESX/ESXi 4.1 and earlier. If the same operation is performed on a virtual machine on an ESXi 5.0 host, the conversion happens correctly.
    Workaround: None.

  • The vCenter Server support bundle tool cannot find log data that is stored in a custom location
    The vCenter Server support bundle tool cannot locate log files that are stored in custom, non-default, locations. The vCenter Server support bundle tool is different from the vSphere Client log gathering tool.

    Workaround: Connect a vSphere Client to a vCenter Server and use the Export System Logs function to retrieve log data. In the vSphere Client, select Administration > Export System Logs.

    When you cannot connect a vSphere Client to a vCenter Server, you must manually copy the files into the log bundle.

VMware HA and Fault Tolerance

  • In vCenter Server 5.0 a number of advanced configuration options for vSphere HA are no longer supported
    The following options are no longer supported.

    das.consoleUser
    das.consoleNode
    das.consolePerm
    das.primaryCount
    das.checkVmStateDelay
    das.trace
    das.traceLevel
    das.traceOutput
    das.preferredPrimaries
    das.disableUWSwapRequirement
    das.sensorPollingFreq
    das.bypassNetCompatCheck
    das.defaultfailoverhost
    das.failureDetectionTime
    das.failureDetectionInterval

    If you attempt to set one of the unsupported options, vCenter Server 5.0 reports that the option is not valid. Also, if you upgrade to vCenter Server 5.0 from a previous version with any of these options defined, they are deleted and are no longer in effect.
    Workaround: None.

Internationalization

  • Search does not find localized characters in Japanese, Chinese, Korean, German, French, and Spanish.
    Search for localized characters does not retrieve hits for Japanese, Chinese, Korean, and characters in German, French, and Spanish.
    Workaround: When searching for topics, use English interface.

  • Users with user names containing non-ASCII characters cannot log in to vCenter Server using the vSphere Web Client
    The vSphere Web Client does not accept user names containing non-ASCII characters. Users with user names containing non-ASCII characters cannot use the vSphere Web Client to connect to vCenter Server.
    Workaround: Use the vSphere Client to connect to vCenter Server.

  • Issues related to localized search and search scope in the vSphere Web Client Help
    Known issues with localized search in the vSphere Web Client Help include:
    Searches using localized characters for non-English languages do not retrieve results. If you create search scope names using non-ASCII characters, these characters do not display correctly.
    Workaround: Edit the tomcat-server.xml file to specify URI encoding as UTF-8:

    Open the file vSphere_Web_Client_Installation_Directory\springsource-dm-server-2.0.4\config\tomcat-server.xml using a text editor.

    Edit the following section of the file to add the parameter URIEncoding="UTF-8" at the end of the line connectionTimeout="20000":

    <Connector port="9090" protocol="HTTP/1.1"
    connectionTimeout="20000"
    redirectPort="9443" emptySessionPath="true"/>


    9090 is the default value for the Connector port. If you changed this value during installation, another port number appears. Do not change the port number.

    After the change, the section should read as follows:

    <Connector port="9090" protocol="HTTP/1.1"
    connectionTimeout="20000" URIEncoding="UTF-8"
    redirectPort="9443" emptySessionPath="true"/>

    Edit the following section of the file to add the line URIEncoding="UTF-8" at the end of the line keystoreFile="config/keystore":

    <Connector port="9443" protocol="HTTP/1.1" SSLEnabled="true"
    maxThreads="500" scheme="https" secure="true"
    clientAuth="false" sslProtocol="TLS"
    keystoreFile="config/keystore"
    keystorePass="changeit" emptySessionPath="true"/>


    9443 is the default value for the Connector port. If you changed this value during installation, another port number appears. Do not change the port number.

    After the change, the section should read as follows:

    <Connector port="9443" protocol="HTTP/1.1" SSLEnabled="true"
    maxThreads="500" scheme="https" secure="true"
    clientAuth="false" sslProtocol="TLS"
    keystoreFile="config/keystore" URIEncoding="UTF-8"
    keystorePass="changeit" emptySessionPath="true"/>

    Save the file.

CIM and API

  • Invoking a specific API from View Composer results in client side de-serialization error *
    Attempts to monitor tasks of the private API calls in the vCenter Server by using the public Clients-VMware Web Services SDK while using the View Composer might cause the following exception:

    org.xml.sax.SAXException: No deserializer for {urn:vim25}ArrayOfCbrcDigestRecomputeResult

    Note: Clients who have access to task oriented APIs can only get the task completed status object by using the waitForUpdatesEx() method. Public clients cannot have access to any of the internal API result objects visible by TaskHistoryCollectors.

    Workaround: To resolve this issue, see KB 2056580.