VMware vCenter Server 5.0 Update 1b Release Notes
vCenter Server 5.0 Update 1b | 16 August 2012 | Build 804277
vSphere Client 5.0 Update 1b | 16 August 2012 | Build 804277
vCenter Server 5.0 Update 1b Installation Package | 16 August 2012 | Build 804276
vCenter Server Appliance 5.0 Update 1b | 16 August 2012 | Build 804279
Last updated: 13 March 2014
Check for additions and updates to these release notes.
What's in the Release Notes
These release notes cover the following topics:
VMware vCenter Server 5.0 Update 1b is a patch release and offers the following improvements:
- vCenter Server 5.0 Update 1b introduces support for the following vCenter Databases
- Oracle 11g Enterprise Edition, Standard Edition, Standard ONE Edition Release 2 [126.96.36.199] - 64 bit
- Oracle 11g Enterprise Edition, Standard Edition, Standard ONE Edition Release 2 [188.8.131.52] - 32 bit
- vCenter Server Appliance Database Support: The DB2 express embedded database provided with the vCenter Server Appliance has been replaced with VMware vPostgres database. This decreases the appliance footprint and reduces the time to deploy vCenter Server further.
- Resolved Issues: In addition, this release delivers a number of bug fixes that have been documented in the Resolved Issues section.
vCenter Server 5.0 Update 1a has been removed from the VMware download site due to issues encountered when upgrading with an Oracle database for Windows. vCenter Server Update 1a is replaced by vCenter Server 5.0 Update 1b, which is functionally identical to vCenter Server 5.0 Update 1a and includes the fix for the issue encountered when upgrading with an Oracle database for Windows. Please refer to KB 2032277 and the Resolved issues section of the release notes for more information.
VMware vSphere 5.0 is available in the following languages:
- 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 1
Compatibility and Installation
ESXi, vCenter Server, and vSphere Client Version Compatibility
Apart from the database support introduced in the Whats New section, vCenter 5.0 Update 1b provides the same level of compatibility as the existing vCenter 5.0 Update 1 release. Please see the VMware Product Interoperability Matrix for full details on vCenter 5.0 Update 1b 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.
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 1 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
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.
Please review http://kb.vmware.com/kb/2017801 for known issues with updating your VMware vCenter Server Appliance to 5.0.0 Update 1b before proceeding with the update-process.
Test Releases of vSphere 5.0
Upgrades from the vCenter Server 5.0 Beta and the vCenter Server 5.0, 5.0 Update1 Release Candidate releases to vCenter Server 5.0 Update1b are not supported. Uninstall Beta or Release Candidate versions of vCenter Server 5.0, 5.0 Update1 releases, and perform fresh installations of vCenter Server 5.0 Update1b. If you were testing Beta or Release Candidate versions of vCenter Server 5.0, 5.0 Update1, VMware recommends that you recreate data you want to preserve from those setups on vCenter Server 5.0, 5.0 Update1.
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.
This release resolves issues in the following subject areas.
Upgrade and Installation
Upgrading vCenter Server 4.0.x and 4.1.x to vCenter Server 5.0 Update 1a fails on an Oracle database for Windows with the error: PLS-00905 STATS_ROLLUP2_PROC is invalid
Upgrading vCenter Server 4.0.x and 4.1.x to vCenter Server 5.0 Update 1a might fail on an Oracle database. If you install through the media VMware-VIMSetup-all-5.0.0-757163, the VCDatabaseUpgrade.log reports an error similar to:
PLS-00905: object STATS_ROLLUP2_PROC is invalid
ORA-06550: line 1, column 99:
PL/SQL: Statement ignored
ORA-06512: at "SYS.DBMS_JOB", line 82
ORA-06512: at "SYS.DBMS_JOB", line 140
ORA-06512: at line 39
Note: This issue does not exist when upgrading from vCenter Server 5.0 or vCenter Server 5.0 Update 1 to vCenter Server 5.0 Update 1a
This issue is resolved in this release.
Changing the inventory size setting for vCenter Server Appliance through the Web Console causes the vServiceManager and EAM services to stop running
In the vCenter Server Appliance, changing the inventory size through the Web Console to any setting other than small, results in the vServiceManager and EAM services to stop running.
This issue is resolved in this release.
After ESXi host reboot HA configuration fails or host does not reconnect to vCenter
If the vCenter Agent (vpxa) and HA agent get installed in ESXi ramdisk instead of vmkramdisk, these bundles do not get persisted in the bootbank image. Therefore, after the host reboot, they do not get automatically redeployed.
This problem occurs in the following situations:
This issue is resolved in this release.
- If the build number of the ESXi 4.0 host falls between 219381 and 392992.
- If ESXi build number does not fall within the range mentioned above, this problem occurs on the ESXi host, the latest vpxa/fdm installation log entries in /var/log/vpxa-installer.log or /var/log/fdm-installer.log reports, Now try installing on ramdisk and installation completed saying "All done! Status: 0".
vCenter Server and vSphere Client
VMware HA and Fault Tolerance
HA fails to restart a virtual machine with the error: Failed to open file /vmfs/volumes/UUID/.dvsData/ID/100 Status (bad0003)= Not found
In vCenter Server, a virtual machine remains powered off after an HA event.
The vSphere Client shows the following error:
Failed to open file /vmfs/volumes/UUID/.dvsData/ID/100 Status (bad0003)= Not found.
Got fault while failing over vm. /vmfs/volumes/UUID/VM/VM.vmx: [N3Vim5Fault19PlatformConfigFaultE:0xecba148] (state = reconfiguring)
Note: You can manually start the virtual machine.
For more information, see KB 2013639.
This issue is resolved in this release.
vSphere 5.0 Server WSDL files obtained directly from a server are not complete
It is possible to retrieve the vSphere API WSDL files from an ESXi or vCenter Server instance. These WSDL files are not complete. You cannot use the server-based WSDL, because SOAP toolkits cannot process it correctly because the server does not have a complete set of the schema files. The vSphere Web Services SDK contains a complete WSDL file configuration (WSDL and schema files), located in the following directory of the vSphere Management SDK distribution:
This issue is resolved in this release.
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.
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.
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.
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.
- Stop the vCenter Inventory Service.
- From the Administrative Tools control panel, select Services.
- Right-click vCenter Inventory Service and select Stop.
- In a text editor, open the following file:
- Change the value for dataservice.nio.enabled to false.
- 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.
- Turn off UAC.
- From the Start menu, select Control Panel > User Accounts.
- Select Turn User Account control on or off.
- Deselect User Account Control (UAC) to help protect your computer and click OK.
- Reboot the machine when prompted.
- Start the Linked mode configuration.
- Select Start > All Programs > VMware > vCenter Server Linked Mode Configuration.
- Click Next.
- Select Modify Linked-Mode configuration and click Next.
- Select Join this vCenter Server instance to an existing Linked-Mode group or another instance, and click Next.
- Enter the server name and LDAP port information and click Next.
- Click Continue to complete the installation.
- Click Finish to end the linking process.
- Log in to one of the vCenter Server systems and verify that the servers are linked.
- After the vCenter Server systems are linked, turn on UAC.
- From the Start menu, select Control Panel > User Accounts.
- Select Turn User Account control on or off.
- Select User Account Control (UAC) to help protect your computer and click OK.
- 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.
Upgrading to vCenter Server 5.0 the vcdb.properties may be incorrectly changed
After an upgrade to vCenter Server 5.0, the database type in vcdb.properties can be changed incorrectly affects vCenter functionality.This can occur if the DB Servers hostname contains the substrings "db2" or "oracle".
Workaround:The database Server hosting the vCenter Database should not contain the string "db2" or "oracle".As an alternative change the vcdb.properties afterwards to the correct format.
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.
- From the Windows Start menu, select Run, type control admintools, and click OK.
- Double-click Local Security Policy.
- Select Software Restriction Policies.
- If no software restrictions are listed, right-click Software Restriction Policies, and select Create New Policy.
- Under Object Type, double-click Enforcement.
- Select All users except local administrators, and click OK.
- 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.
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.
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.
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.
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.
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:
The sms.log file might display the following exception:
Workaround: Manually unregister one vendor provider at a time.
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
- Select the host in the inventory.
- Click the Configuration tab.
- Click Security Profile in the Software section.
- Click Properties and select the service.
- Click Options.
- 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.
- In vSphere Client, select the newly attached profile in the Host Profiles inventory view.
- Click the Hosts and Clusters tab.
- Right-click the host from the Entity Name list and select Check Answer File.
The host profile answer file status is updated.
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
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
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:
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
vCenter Server 5.0 virtual machines might display a red warning icon in the inventory
In vCenter Server 5.0, some VMs might display a red warning icon in the inventory, however the alarms tab for the VM does not indicate any alarm was triggered. This can appear for powered on and powered off VMs.
Workaround: Possible workarounds. Note that these are all temporary solutions.
Restart the management agents on the affected ESX/ESXi host
Restart the vCenter Server Server service
Remove the ESX/ESXi host from inventory, and register the host back with vCenteror
Remove and re-register affected VMs.
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.
To workaround this issue, change the autoUpgradeAgents option to true.
After upgrading vCenter Server, vCenter attempts to upgrade the vpxa agent on ESX/ESXi hosts a second time*
If you upgrade vCenter Server, users might see the task Upgrade vCenter Agents on cluster hosts appearing for all clusters in the vCenter. This task is never completed and the hosts do not automatically join vCenter.You can select hosts and add them manually. However, the next time you restart the vCenter Server service the same behavior occurs.
This issue occurs if the autoUpgradeAgents option in vCenter Server advanced settings is set to false and vCenter Server incorrectly tries to upgrade the vpxa agent a second time on the ESX/ESXi hosts.
To change the autoUpgradeAgents option to true.
The Upgrade vCenter Agents on cluster hosts task should now complete.
- Click Administration > vCenter Server Setting > Advanced Settings
- Look for the AgentUpgrade.autoUpgradeAgents option and change its value from false to true
- Restart the VMware VirtualCenter Server service
- Manually reconnect all ESX hosts
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 Virtual Center 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.
Note: You may have to follow this process for these services also
- Close all vSphere Client sessions connected to vCenter Server.
- Click Start > Run, type services.msc, and click OK. The Services window opens.
- Right-click the VMware VirtualCenter Management Webservices service and click Properties.
- Click the Log On tab.
- Change the account to use "This account:" and use the same domain account which the VMware VirtualCenter Server service is using.
- Click OK.
- Right-click the VMware VirtualCenter Management Webservices service and click Restart.
- After the service starts, connect to the vCenter Server.
- vCenter Inventory Service
- VMware vSphere Profile-Driven Storage Service
vSphere Client may stop responding when searching for virtual machines*
In the vCenter Server 5.0 Update 1 Client, after choosing to hide Virtual Machines from view that is, after you uncheck the Show VMs in Inventory under the View pulldown menu, the client may stop responding when you perform the following steps:
Workaround: Make sure that "Show VMs in Inventory" is selected on the vSphere client before runnning a search
- You perform a search using the search box at the top right and then click on a link in the search box results
- After selecting a host in the Hosts and Clusters view, you select the Virtual Machines tab and double-click on any Virtual Machine in the list
- You select the Virtual Machines tab in the VMs and Templates view and double-click on any virtual machine in the list
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
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.
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:
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.
Search in the vSphere Client or vSphere Web Client shows outdated results or times out
When you search the inventory in the vSphere Client or vSphere Web Client, the search might show outdated information, or, in the case of the vSphere Web Client, might time out.
An error message similar to following, indicating an unexpected runtime error, appears in the Inventory Service log file, ds.log:
[2011-06-27 18:04:25,367 pool-14-thread-5 ERROR
com.vmware.vim.query.server.provider.impl.ProviderManagerServiceImpl] Unexpected runtime exception:
Workaround: Restart the Inventory Service.
For a vCenter Server system running on Windows, perform the following steps:
- Start the Windows Service Manager:
- Select Start > Run.
- Type services.msc.
- Right-click vCenter Inventory Service and select Restart.
For the vCenter Server Appliance, perform the following steps:
Storage vMotion operations in a Linked mode environment may fail with error "The object has already been deleted or has not been completely created"
- Log in to the VMware vCenter Server Appliance Web console.
- On the vCenter Server tab, select Status.
- Click Stop vCenter.
- Click Start vCenter.
Attempting a Storage vMotion operation on a VM managed by a vCenter Server instance other than the vCenter that the user is logged into may produce an error similar to the following:"The object has already been deleted or has not been completely created." or " Call "PropertyCollector.RetrieveContents" or object "propertyCollector" on vCenter Server XXXXXXXX failed.
Workaround: The error message does not occur if Storage vMotion operations are performed when the user logs into the vCenter instance that manages the VM.
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.
Migrating virtual machine to another HA cluster changes the virtual machine state from protected to unprotected
Migrating a virtual machine from one HA cluster to another changes the virtual machine's protection state from protected to unprotected.HA status reports the virtual machine as Unprotected on the summary tab after it is migrated.Reconfiguring HA on the ESXi does not resolve the issue.
Workaround: If the state of the migrated virtual machines has changed to unprotected, then disable and re-enable HA on the destination cluster.Alternatively, if you have not yet migrated the virtual machines to the destination HA cluster, you may disable HA on the source cluster before migrating the virtual machine to the destination HA cluster. Afterwards re-enable HA on the destination cluster.
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.
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 isused 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
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:
- Select the primary column for sorting by clicking on the column header.
- 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:
- In Internet Explorer 7, select Tools > Internet Options.
- Click the Security tab.
- Select Trusted Sites.
- Click Sites.
- In the Add this Web site to the zone text box, type about:internet and click Add.
- In the Add this Web site to the zone text box, type https://localhost and click Add.
- Click OK.
- 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
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.
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.
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
Workaround: Restart the Workstation service on the vCenter Server machine.
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.
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.
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 VM Storage Profiles
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.
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,
VC 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.
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
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.
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.
- On the ESXi 5.0 host, select the virtual machine.
- If the VM 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.
- 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, ....
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.
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.
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.
vSphere HA fails to restart a virtual machine that was being migrated using vMotion when a host failure occurred.
While a virtual machine is being migrated from one host to another, the original host might fail, become unresponsive, or lose access to the datastore containing the configuration file of the virtual machine. If such a failure occurs and the vMotion subsequently also fails, vSphere HA might not restart the virtual machine and might unprotect it.
Workaround: If the virtual machine fails and vSphere HA does not power it back on, power the virtual machine back on manually. vSphere HA then protects the virtual machine.
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
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
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:
<Connector port="9090" protocol="HTTP/1.1"
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"
Edit the following section of the file to add the line URIEncoding="UTF-8" at the end of the line
<Connector port="9443" protocol="HTTP/1.1" SSLEnabled="true"
maxThreads="500" scheme="https" secure="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"
Save the file.