VMware

VMware vSphere Update Manager 5.0 Release Notes

VMware vSphere Update Manager 5.0 | Aug 24 2011 | Build 432001

Last Document Update: 25 April 2013

Check frequently for additions and updates to these release notes.

What's in the Release Notes

These release notes cover the following topics:

The Update Manager 5.0 release notes provide information about VMware vSphere Update Manager, an optional module for VMware vCenter Server. For information about new vCenter Server features, requirements, and installation, see the VMware vSphere 5.0 Release Notes. For more information about VMware vSphere Update Manager, see the Installing and Administering VMware vSphere Update Manager documentation.


What's New

  • Cross-platform upgrade from ESX to ESXi: Get a jumpstart on your migration to ESXi by using VMware vSphere Update Manager 5.0 to upgrade from ESX to ESXi.
  • Optimized Cluster Patching and Upgrade: VMware vSphere Update Manager 5.0 can patch and upgrade your ESX and ESXi clusters faster than before. Based on available cluster capacity, it can remediate an optimal number of ESX/ESXi hosts simultaneously without virtual machine downtime. Additionally, for those situations where turnaround time is more important than virtual machine uptime, you have the choice to remediate all ESX hosts in a cluster simultaneously.
  • VMware Tools Upgrade: VMware vSphere Update Manager 5.0 enables reductions in virtual machine downtime when upgrading VMware Tools by reducing the number of reboots required. You can schedule an upgrade to occur at the time of next virtual machine reboot.
  • Enhanced Virtual Appliance Upgrade Experience
    • You can upgrade your virtual appliances even when your VMware vSphere Update Manager 5.0 server does not have direct access to the Internet.
    • You can upgrade workflow is now better integrated with the patching workflow that you are already familiar with from earlier releases.
    • Better visibility into virtual appliance software components that will change as a result of a pending upgrade.
  • A More Flexible UMDS
    • You can configure multiple download URLs.
    • You can restrict downloads to only those ESX product versions and types that are relevant to your environment.
  • Update Manager Utility: The Update Manager 5.0 release includes the VMware vSphere Update Manager Utility, which helps users reconfigure the Update Manager setup, change the database password and proxy authentication, re-register Update Manager with vCenter Server, and replace the SSL certificates for Update Manager.

This release contains bug fixes described in Resolved Issues and known issues described in Known Issues.

Top of Page

Hardware Requirements and Sizing Estimator

Minimum hardware requirements for Update Manager vary depending on how Update Manager is deployed.

Hardware Requirements

If the database is installed on the same machine as Update Manager, requirements for memory size and processor speed are higher. The minimum requirements to ensure acceptable performance are as follows:

  • Processor: Intel or AMD x86 processor with two or more logical cores, each with a speed of 2GHz
  • Network: 10/100 Mbps
    For best performance, use a Gigabit connection between Update Manager and ESX hosts.
  • Memory:
    • 2GB RAM if Update Manager and the vCenter Server are on different machines
    • 4GB RAM if Update Manager and the vCenter Server are on the same machine

Sizing Estimator

For more information about the disk storage requirements, see the VMware vSphere Update Manager Sizing Estimator. The sizing estimator calculates the size of the Update Manager 5.0 database and patch store. The estimate is calculated from the information that you enter about your deployment, such as the number of the hosts and virtual machines. The sizing estimator also provides recommendations for the Update Manager database and server deployment models.

Top of Page

Installation Notes

This section includes information about the installation of Update Manager and Update Manager Download Service, an optional module of vSphere Update Manager.

Update Manager

Installation of VMware vSphere Update Manager requires network connectivity with an existing vCenter Server system. Each installation of vSphere Update Manager must be associated with a single vCenter Server instance.

Before you install Update Manager, you must install vCenter Server. For database compatibility information, see Databases that Support Installation of the Update Manager Server.

The Update Manager module consists of a client component, which is a plug-in interface to a VMware vSphere Client instance, and a server component that can be installed on the same system as vCenter Server or on a different system.

The Update Manager 5.0 server can be installed only on 64-bit Windows operating systems, and the Update Manager 5.0 Client can be installed on both 32-bit and 64-bit operating systems.

Update Manager Download Service

vSphere Update Manager Download Service (UMDS) is an optional module of Update Manager that you can use to download patch definitions. Install UMDS in case your deployment system is secured and the machine on which Update Manager is installed has no access to the Internet.

UMDS 5.0 can be installed only on 64-bit Windows operating systems.

Installing UMDS 5.0 in an Environment with Update Manager 5.0 Instances Only

In the UMDS 5.0 installation wizard, you can select the patch store to be an existing download directory from a previous UMDS 4.x installation and reuse the applicable downloaded updates in UMDS 5.0. You should uninstall existing UMDS 4.x instances before reusing the patch store. After you associate an existing download directory with UMDS 5.0, you cannot use it with earlier UMDS versions. If you install UMDS with an existing download directory, make sure that you perform at least one download by using UMDS 5.0 before you export updates.

Installing UMDS 5.0 in an Environment with both Update Manager 4.x and Update Manager 5.0 Instances

You should not install UMDS 5.0 with an existing UMDS 4.x download directory if your environment contains both Update Manager 4.x and Update Manager 5.x instances. In such a case, you need an UMDS 4.x and an UMDS 5.x installation on two separate machines, so that you can export updates for the respective Update Manager versions.

To use UMDS, the download service must be of a compatible version with the Update Manager server. For more information about the compatibility between Update Manager and the UMDS, see the see the Installing and Administering VMware vSphere Update Manager documentation.

Update Manager Utility

When you install Update Manager or UMDS, vSphere Update Manager Utility is silently installed on your system as an additional component.

The Update Manager Utility allows you to change the database password and proxy authentication, re-register Update Manager with vCenter Server, and replace the SSL certificates for Update Manager. For more information about reconfiguring the Update Manager settings by using the utility, see the Reconfiguring VMware vSphere Update Manager documentation.

Top of Page

Upgrade Notes

This release allows upgrades from Update Manager version 4.x. Before you upgrade Update Manager from a previous version, you must upgrade vCenter Server and the vSphere Client to a compatible version.

Upgrade from UMDS 4.x to UMDS 5.0 is not supported, but under certain conditions you can perform a fresh installation of UMDS 5.0 and use an existing patch store from UMDS 4.x.

Top of Page

Interoperability and Software Requirements


The VMware Product Interoperability Matrix provides details about the compatibility of current and earlier versions of vSphere Update Manager with other VMware vSphere components, including ESXi, VMware vCenter Server, the vSphere Client, and the vSphere Web Client. In addition, this site also provides information about supported management and backup agents before installing ESXi or vCenter Server.



Operating Systems that Support Installation of the Update Manager server and the UMDS

To view supported host operating systems on which you can install Update Manager server and UMDS, select the Host OS option of the VMware Compatibility Guide.



Databases that Support Installation of the Update Manager server and the UMDS

To view information about the databases that are compatible with Update Manager server and UMDS, select the Solution/Database Interoperability option of the VMware Product Interoperability Matrix.



Update Manager can scan and remediate ESX/ESXi hosts, virtual machines, and virtual appliances

  • Host patching
    • ESX/ESXi 3.5
    • ESX/ESXi 4.x
    • ESXi 5.0
  • Host upgrades of ESX/ESXi 4.x to ESXi 5.0
  • Upgrades of VMware Tools and virtual machine hardware for virtual machines
  • Upgrades of virtual appliances


Supported Operating Systems for Upgrade of VMware Tools and Virtual Hardware

  • Windows XP Professional 32-bit (SP3 required)
  • Windows XP Professional 64-bit (SP2 required)
  • Windows 2000 [Professional/Server/Advanced Server/Datacenter Server] 32-bit
  • Windows 2000 [Professional/Server/Advanced Server/Datacenter Server] 64-bit
  • Windows Server 2003 [Standard/Enterprise/Datacenter] 32-bit (SP2 required)
  • Windows Server 2003 [Standard/Enterprise/Datacenter] 64-bit (SP2 required)
  • Windows Server 2003 R2 [Standard/Enterprise/Datacenter] 32-bit (SP2 required)
  • Windows Server 2003 R2 [Standard/Enterprise/Datacenter] 64-bit (SP2 required)
  • Windows Vista [Business/Enterprise] 32-bit (SP2 required)
  • Windows Vista [Business/Enterprise] 64-bit (SP2 required)
  • Windows Server 2008 [Standard/Enterprise/Datacenter] 32-bit
  • Windows Server 2008 [Standard/Enterprise/Datacenter] 64-bit
  • Windows Server 2008 [Standard/Enterprise/Datacenter] 32-bit SP2
  • Windows Server 2008 [Standard/Enterprise/Datacenter] 64-bit SP2
  • Windows 7 [Professional/Enterprise] 32-bit
  • Windows 7 [Professional/Enterprise] 64-bit
  • Windows 7 [Professional/Enterprise] 32-bit SP1
  • Windows 7 [Professional/Enterprise] 64-bit SP1
  • Windows Server 2008 [Standard/Enterprise/Datacenter] 64-bit R2
  • Windows Server 2008 [Standard/Enterprise/Datacenter] 64-bit R2 Service Pack 1
  • Red Hat Enterprise Linux 2
  • Red Hat Enterprise Linux 3
  • Red Hat Enterprise Linux 4
  • Red Hat Enterprise Linux 5
  • CentOS 4
  • CentOS 5
  • CentOS 6
  • Debian 4
  • Debian 5
  • Debian 6
  • Ubuntu 7.x
  • Ubuntu 8.x
  • Ubuntu 9.x
  • Ubuntu 10.x
  • Ubuntu 11.x
  • SUSE Linux Enterprise Server 8
  • SUSE Linux Enterprise Server 9
  • Oracle Enterprise Linux 4
  • Oracle Enterprise Linux 5
  • Oracle Enterprise Linux 6
  • Asianux 3
  • Asianux 4

Top of Page

Resolved Issues

  • Update Manager might not restore the original power state of fault tolerant virtual machines after remediation
    When you remediate a fault tolerant virtual machine that is in suspended or powered-off state, the machine might remain powered-on after the remediation is completed.
  • Updates to the Jetty Web server embedded in Update Manager
    The Jetty Web server embedded in Update Manager 5.0 is updated from Jetty version 6.1.6 to Jetty version 6.1.24, to address multiple security issues that exist in the earlier releases of Jetty.
    The Common Vulnerabilities and Exposures project has assigned the names CVE-2009-1523 and CVE-2009-1524 to these issues.
  • Cluster remediation options report is not generated if the cluster is under remediation
    If you try to generate a cluster remediation options report while the cluster is being remediated, the report will be generated and displayed only after the remediation is completed.
  • Upgrade of VMware Tools might fail with error The operation is not supported on this object
    The upgrade failure might occur in clusters containing both ESX 3.x and ESX 4.x hosts, with DRS enabled in automatic mode. After completing the upgrade of VMware Tools, Update Manager first shuts down the guest operating system and then powers it on. DRS selects the best suited host, on which to power on the remediated virtual machine. If the selected host is running ESX 3.x, the post-scan test of the VMware Tools upgrade task results in error message VMware Tools upgrade was not performed on <VM name>. VMware Tools upgrade is supported only for VMs on ESX 4.0 hosts and higher.
  • Powered-off virtual machines are not migrated to other hosts in a DRS enabled cluster
    Update Manager puts hosts into maintenance mode during remediation but it does not migrate powered-off virtual machines to other hosts in a DRS enabled cluster.
  • Host remediation might fail when VMware DPM is using the Wake-on-LAN mechanism
    If you configure Update Manager to disable VMware DPM on a cluster during remediation, and the cluster contains hosts in standby mode, Update Manager tries to power on the hosts before remediation. When VMware DPM is using the Wake-on-LAN mechanism to power on hosts in standby mode, if you try to disconnect any powered-on host in the cluster while the other hosts are powering on, the Exit Stand By Host operation might fail.
  • The content of a dynamic patch baseline might not update
    A dynamic host patch baseline from an earlier version of Update Manager might not update when new patches that meet the baseline criteria are released by VMware. Typically, the content of dynamic baselines changes automatically when new patches that meet the baseline criteria are released.
  • In large environments, the Update Manager Client plug-in might temporarily lose connection to the Update Manager server
    VMware Tools operations, such as scanning for the VMware Tools version and upgrading VMware Tools, use the same system resources as the Update Manager Client plug-in. If you run many VMware Tools operations at the same time, the Update Manager Client plug-in might disconnect from the Update Manager server. This issue does not occur with other operations such as host and virtual machine patching, host upgrade, or virtual appliance upgrade.

Top of Page

Known Issues

The known issues in this Update Manager release are grouped as follows:

Installing and Upgrading

  • After an upgrade, the Update Manager plug-in might be disabled for the duration of a download task
    If Update Manager loses connection to vCenter Server while a download task is running, the Update Manager plug-in cannot be re-enabled. This problem might occur after an upgrade to Update Manager 5.0.
    Workaround: Wait for the download task to complete, and then enable the Update Manager plug-in.
  • After you upgrade from Update Manager 1.0 Update 6 to Update Manager 5.0, an error message appears when you switch tabs in the Administration view
    When you switch between tabs in the Update Manager Administration view, a dialog box that asks you whether to save the changes might appear. If you click No, the following error message appears: Specified argument was out of the range of valid values. Parameter name: The value must be between MinimunTimeInSeconds and MaximumTimeInSeconds. You might encounter this problem after you upgrade Update Manager 1.0 Update 6 to Update Manager 5.0, if in the original Update Manager 1.0 Update 6 installation you selected Fail Task as the failure response on the ESX Host Settings page.
    Workaround: To resolve the problem, perform one of the following workarounds.
    • When the dialog box that asks you whether to save the changes appears, click Yes.
    • On the ESX/Host Cluster Settings page in the upgraded Update Manager 5.0, click Apply.
  • You might not be able to enable the Update Manager plug-in on the vSphere Client
    If the Update Manager database is located on a separate machine and the system DSN uses Windows authentication, you cannot enable the Update Manager plug-in on the vSphere Client. The error message you receive is There was an error connecting to VMware vSphere Update Manager. Database temporarily unavailable or has network problems.
    Workaround: Ensure that the Update Manager database uses SQL Server authentication.
  • A minimum of 600MB of free space for Update Manager on the boot drive is required to install Update Manager
    Although Update Manager does not need to be installed on the boot drive, some required components must be installed on the boot drive. 600MB of space for Update Manager is required at installation time to accommodate these required components, as well as temporary files used during the installation.
    Workaround: Ensure at least 600MB of free space on the boot drive before installing Update Manager.

Scanning, Staging, and Remediation

  • Upgrade remediation from ESXi 4.x to ESXi 5.0 does not succeed on IBM x3650 M2 servers
    Upgrade from ESXi 4.x to ESX 5.0 might fail on IBM x3650 M2 servers and the following error message appears: Software or system configuration of host <host_name> is incompatible. Check scan results for details.
    Workaround: Perform the upgrade to ESXi 5.0 by using a scripted upgrade or an interactive upgrade.
  • VMware Tools upgrade remediation of a powered off virtual machine might fail if automatic VMware Tools upgrade is enabled
    You can enable automatic VMware Tools upgrade on power cycle for virtual machines by using the Edit VMware Tools upgrade settings window in Update Manager or by editing the VMware Tools options in the Virtual Machine Properties dialog box in the vSphere Client. If you enabled automatic VMware Tools upgrade and you attempt to remediate a powered off virtual machine against a VMware Tools upgrade baseline, the remediation fails with the error A general system error occurred: A VMware Tools installation is already in progress.
    Workaround: To upgrade VMware Tools on a powered off virtual machine, use either an upgrade baseline or the automatic upgrade option, but not both simultaneously.
  • Remediating ESXi 5.0 hosts against bulletins that are marked as requiring reboot might not reboot the hosts
    Some updates require the host to be rebooted during the remediation process. The information whether a reboot is required is contained in the update metadata and is displayed in the Update Manager Patch Repository, under Impact. For ESXi 5.0 VIBs, the reboot requirement is not determined solely by the metadata, but instead depends on the VIB specification and whether a previous version of the VIB is installed on the host. This provides reboot optimization for some VIBs, where an initial installation does not require a host reboot and only subsequent patching of the VIB requires a reboot.
    Workaround: No workaround is required. Update Manager reboots hosts as necessary to ensure a successful remediation.
  • Host patch remediation fails when patch metadata is not available
    In the Update Manager 5.0 installation wizard, you can deselect Download updates from default sources immediately after installation. After installation, in the Configuration tab, you can choose to download only patch metadata from sources for specific ESX/ESXi versions, for example, only ESXi 5.0 patch metadata. In such a situation, if you attempt to remediate a container with ESX/ESXi hosts of different versions, and you have downloaded patch metadata for some and not all host versions, the remediation fails.
    Workaround: Download patch metadata for all host versions in your inventory.
  • By using the Remediate wizard, you can ignore some upgrade scan warnings and force a remediation even if the upgrade warnings are not related to third-party software
    On the ESXi 5.x Upgrade page of the Remediate wizard, you can select Remove installed third-party software that is incompatible with the upgrade, and continue with the remediation to remove third-party software installed on the host and to ensure a successful remediation. Selecting the option also forces Update Manager to ignore three potential issues that are not related to third-party software. The following warning messages are associated with the potential issues.
    • The root password is encrypted with DES encryption, causing it to be authenticated up to only 8 characters. For instructions on how to correct this, see VMware KB 1024500 at http://kb.vmware.com/kb/1024500.
    • VMkernel and Service Console network interfaces are sharing the same subnet <subnet_name>. This configuration is not supported after upgrade. Only one interface should connect to subnet <subnet_name>.
    • Unsupported devices <device_name> found on the host.
    Workaround: Before a remediation, perform an upgrade scan and review the messages in the Upgrade Details window of Update Manager. Take the necessary actions recommended by the messages to ensure that the remediation succeeds.
  • Misleading scan message in the Upgrade Details window when ESX/ESXi hosts use non-MD5 encryption of the root password
    When you scan an ESX/ESXi 4.x host against an ESXi 5.0 baseline, the following message might appear in the Upgrade Details window: The root password is encrypted with DES encryption, causing it to be authenticated up to only 8 characters. For instructions on how to correct this, see VMware KB 10245000 at http://kb.vmware.com/kb/1024500. The message appears not only when DES encryption is used, but also in all cases where the root password is encrypted by using a non-MD5 encryption algorithm.
  • Compliance status is Incompatible and remediation fails for ESX 4.1 Update 1 hosts when you scan or remediate the hosts against an ESXi 5.0 upgrade baseline
    When you perform an upgrade scan of ESX 4.1 Update 1 hosts against an ESXi 5.0 upgrade baseline, the compliance status might be Incompatible. The remediation of ESX 4.1 Update 1 hosts against an ESXi 5.0 upgrade baseline might fail. The scan and remediation problems are caused by third-party drivers in the ESX 4.1 Update 1 installation. After an upgrade scan of hosts, more information about third-party software is provided in the conflict details for the upgrade baseline.
    Workaround: Two different types of drivers might cause the problems.
    • Async drivers, for example oem-vmware-esx-drivers-scsi-3w-9xxx.
      The vendor will release drivers asynchronously for ESXi 5.0, and the drivers will be made available in the VMware patch depot. If you require those drivers, you must download them, use Image Builder CLI to build a custom ESXi image that contains them, and remediate against the custom image. Without the ESXi 5.0 drivers, pertinent hardware devices might stop functioning.
    • Deprecated drivers, for example oem-vmware-esx-drivers-net-vxge.
      The driver is discontinued in ESXi 5.0 because the pertinent hardware is discontinued. In the Update Manager Remediate wizard, on the ESXi 5.x Upgrade page, click Remove installed third-party software that is incompatible with the upgrade, and continue with the remediation. You should be aware of the functional implications of third-party software removal, because pertinent hardware devices might stop functioning.
  • Remediation task fails for migration of ESX 4.x hosts with expired licenses to ESXi 5.0
    When you migrate ESX 4.x hosts with expired licenses to ESXi 5.0, the task fails with the following error message: The upgraded host could not connect to vCenter Server due to licensing issues. Configure the vSphere licenses for the new version and connect the host manually.
    Workaround: The host has been migrated successfully and is in maintenance mode. Reconnect the host to vCenter Server manually. The evaluation period of hosts is reset to 60 days after a migration or upgrade.
  • Host remediation might not complete if the host contains powered on fault tolerant virtual machines
    Host remediation might not complete if there are any Primary virtual machines with disabled FT on the host, and you select Fail Task or Retry on the Host Remediation Options page of the Remediate wizard. In such a scenario, powered on Primary virtual machines with disabled FT cannot be powered off or migrated in a DRS cluster. The host cannot enter maintenance mode while there are powered on virtual machines on it, and the remediation cannot be completed.
    Workaround: When you remediate hosts containing Primary or Secondary virtual machines, you can use one of the following workarounds:
    • Select Power Off virtual machines and Retry or Suspend virtual machines and Retry on the Host Remediation Options page of the Remediate wizard.
    • Manually migrate the fault tolerant virtual machine to another host before you start a remediation.
    • If EVC is enabled on a DRS cluster, virtual machines with disabled FT can be automatically migrated when the host tries to enter maintenance mode. This is possible only if DRS is not disabled on the particular host.
  • Host remediation might fail, if vCenter Server does not properly update the power state of the host
    When a host is powering on (exiting standby mode), the host power state might not get updated in vCenter Server and host remediation cannot finish or times out. When the power state of a host is not updated properly, in the vSphere Client inventory the host might be displayed as if it is in standby mode, but actually the host is powered on.
    Workaround: To remediate the host, remove the host from the inventory and add it again so that vCenter Server refreshes the power state of the host. Then start the remediation process.
  • The Remediation Selection page might display an incorrect number of patches for the selected baselines
    When you remediate a vSphere inventory object against a patch or extension baseline preselected in Compliance view, the initial page of the remediation wizard might show an incorrect number of patches that need to be remediated. In this case, when the inventory object has multiple attached patch and extension baselines, the number of patches corresponds to the number of compliant patches from all attached baselines, and not just from the selected baselines.
    Workaround: Either change the selection of baselines or groups in the Remediation Selection page, or first click Next to go to the next page and then click Back to return to the selection page.
  • Host upgrade scan and remediation might fail if there is not enough free space on the host
    Host upgrade scan and remediation might fail with the AgentInstallFailed error message. This error might result from insufficient free space on the ESX/ESXi host.
    Workaround: To upgrade ESX/ESXi hosts, ensure you have at least 20MB free space in the /tmp directory of the host.
  • VMware Tools upgrade fails for virtual machines created on hosts of versions 2.5.x
    When you scan a virtual machine with the VMware Tools version corresponding to ESX 2.5.x against a VMware Tools Upgrade to Match Host baseline, the VMware Tools Upgrade to Match Host baseline state is Non-Compliant. Although the state is Non-Compliant, the VMware Tools upgrade fails with a VM Tools installed in the VM doesn't support automatic upgrade error message. Automatic upgrade for VMware Tools is supported only for virtual machines created on hosts running versions ESX 3.0.x, ESX 3.5 or later, and ESX 3i version 3.5 or later.
    Workaround: Upgrade VMware Tools manually by right-clicking the virtual machine in the inventory and selecting Guest > Install/Upgrade VMware Tools.
  • Host remediation might fail for some patches because of irresolvable conflict with the patches on the host
    Patch remediation of a host might fail when a patch (for example, patch A) in a baseline input conflicts with the host and the conflict cannot be resolved by the other patches in the baseline input.
    Workaround: The Patch Details window for patch A displays a recommendation to use another patch to resolve the conflict. The recommendation might also contain many patches. Including one or all of the recommended patches into the baseline might resolve the conflict. For more information, refer to the KB article associated with patch A and the recommended patches.
  • You cannot stage patches to ESX/ESXi 3.x hosts
    Staging patches to individual ESX/ESXi 3.x hosts or container objects containing ESX/ESXi 3.x and ESX/ESXi 4.0 hosts might fail. The Recent Tasks pane displays the error message: There are errors during staging operation. vSphere Update Manager supports staging patches only to hosts running ESX/ESXi 4.0 and later.

Internationalization Issues

  • You cannot login to the Update Manager Utility by using a user account that contains non-ASCII characters
    The Update Manager Utility that is included in the Update Manager 5.0 release does not support non-ASCII user names.
    Workaround: Use an account with a user name that contains only ASCII characters.
  • Upload of ESXi images does not succeed when you have logged in with a user name that contains non-ASCII characters
    If the Windows account user name that you use to authenticate to the vSphere Client contains non-ASCII characters and you try to upload an ESXi image by using Update Manager, the following error message appears: Failed to login. Error was: Authentication failed, not a valid user.
    Workaround: Use an account with a user name that contains only ASCII characters.
  • When you double-click VMware vSphere Update Manager.msi, the hint message is not localized
    When you extract to a local folder all components, required for the installation of Update Manager, either from a .zip file or an .iso image, you can run the VMware vSphere Update Manager.msi application by double-clicking it. When you run the application, the hint pop-up displays the message The installer should be started using VMware-UpdateManager.exe. The message is in English and not localized.
  • When you double-click VMware vSphere Update Manager Download Service.msi, the hint message is not localized
    When you extract to a separate folder all components, required for the installation of UMDS, either from a .zip file or an .iso image, you can run the VMware vSphere Update Manager Download Service.msi application by double-clicking it. When you run the application, the hint pop-up displays the message The installer should be started using VMware vSphere Update Manager Download Service.msi. The message is in English and not localized.
  • You cannot install Update Manager and download patches to directories with non-ASCII characters in their names
    In the installation wizard of Update Manager, you can change the installation and patch download locations of the Update Manager. Changing the installation and patch download locations to folders containing non-ASCII characters in their names might result in errors. Only ASCII characters are supported in installation paths and user names. However, non-ASCII characters are supported in passwords.
  • You cannot install Update Manager in Simplified Chinese language on Japanese operating systems
    If you select Simplified Chinese as the installation language on a Japanese operating system, an error 1158 appears and the installation fails. You can select Japanese, German, or English as the installation language on a Japanese operation system.

Using Update Manager

  • HA configuration does not succeed for hosts in lockdown mode
    If you have ESXi 4.x hosts in lockdown mode included in a vSphere HA-enabled cluster, the hosts are not configured for HA after a successfull remediation of the ESXi 4.x hosts to ESXi 5.0. If you try to configure HA manually, the following error appears: Cannot Install the vCenter agent service. Unknown installer error.
    The problem also occurs on fresh ESXi 5.0 installations.
    Workaround: Disable lockdown mode and retry configuring HA for the hosts.
  • You might be unable to view compliance information for a cloned virtual machine
    When you clone a virtual machine, enable Fault Tolerance for the machine, and power on the cloned virtual machine, you might not be able to view compliance information. When you open the Compliance view, the error Failed to retrieve data appears.
  • The virtual machine that runs Update Manager might be powered off during a host upgrade
    Outside DRS clusters, Update Manager does not upgrade the host on which the vCenter Server or Update Manager virtual machine runs. In DRS clusters, if you start a remediation task on the host running the vCenter Server or Update Manager virtual machine, DRS attempts to migrate the virtual machine to another host, so that the remediation succeeds. If you remove the host on which the Update Manager virtual machine runs from a DRS cluster and then add it to a datacenter in the vSphere Client inventory, you can remediate the host and the Update Manager virtual machine is powered off.
    Workaround: Before remediation, ensure that the host on which the Update Manager virtual machine runs is in a DRS cluster or move the Update Manager virtual machine to another host.
  • Missing patch type information in the Import Patches wizard
    On a new Update Manager installation, when you import offline patch bundles for the first time, patch type information is not displayed in the Import Patches wizard. The Type column on the Confirm Import page is empty.
    Workaround: Although the patch type information is not displayed, you can import the patches successfully by completing the wizard. This problem occurs only during the first import of offline patch bundles. Consequent import operations have the patch type information displayed correctly in the wizard.
  • Download patch definitions task might fail if Update Manager is configured to use authenticated proxy
    If the Update Manager server is configured to use a proxy server that requires authentication, the Download patch definitions task might fail to download patches.
    Workaround: Enable anonymous user access on the proxy server.
  • ESX 5.0 does not support staging of a tools bulletin
    When you run a stage task with an ESX 5.0 tools bulletin, the task completes successfully, but the tools bulletin is not staged.
    Workaround: You can remediate the Tools bulletin directly to install it. Host maintenance mode or reboot, and consequently host downtime, is not required during the remediation of the tools bulletin.
  • Update Manager cannot download updates from a valid download source
    A non-existent HTTPS URL might be incorrectly displayed as accessible in the Add Download Source window. For example, if you type https://mydepot.com instead of http://mydepot.com and click Validate URL, the validation might succeed even if the actual download source is an HTTP address. As a result, Update Manager cannot download updates from the specified HTTPS URL address.
    Workaround: Delete the URL and add it correctly.
  • Update Manager fails to download patches when previously downloaded patches are manually deleted from the repository
    When you download patches, files are stored in the repository on the hard disk. If you delete the downloaded files manually, subsequent patch download might fail.
    Workaround: Avoid deleting patch files from the repository.
  • Invalid email addresses in the email notification settings prevent Update Manager from sending email messages
    In the patch and notification download schedules, you can configure Update Manager to send emails when new patches or notifications are downloaded. If you enter invalid email addresses, Update Manager might not send emails. If you enter an invalid email address with the same domain name as the SMTP Server sender account in vCenter Server mail sender setting, Update Manager does not deliver emails to any of the email addresses (including the valid ones). If the domain name of the invalid email addresses is different from the SMTP Server sender account in vCenter Server mail sender setting, email notifications can be successfully delivered to the valid email addresses entered in the Update Manager email notification settings.
    Workaround: Remove the invalid email addresses from the email notification settings.
  • In Windows Vista, all Help buttons in the Update Manager Client open the default Update Manager help page
    If you are using Internet Explorer 7 browsers installed on Windows Vista machines, the vSphere Update Manager context-sensitive help does not display the required help pages. Instead, the help displays the default vSphere Update Manager help page.
    Workaround: Apply Service Pack 2 to Windows Vista. For more details, see the following Microsoft knowledge base article http://support.microsoft.com/kb/942172.
  • Notification emails might be blocked by antivirus software
    You might not receive any email notifications from Update Manager if you have certain antivirus software installed on your vCenter Server system. Update Manager can be configured to send email notifications, such as notifications for newly downloaded patches and other scheduled tasks. If you have installed antivirus software (for example, McAfee) that monitors and blocks email traffic, you might not be able to receive the notifications from Update Manager.
    Workaround: Disable the antivirus software rule that blocks the email traffic.
  • ESX 4.0 hosts might lose network connectivity after remediation, if the VMkernel is configured to use DHCP
    When Update Manager patches ESX hosts, the patches might require host reboot. After rebooting, vCenter Server might be unable to add the ESX host to the vSphere inventory if the VMkernel of the host is configured to use DHCP.
    Workaround: Configure the VMkernel of the host to use a static IP address or install patch ESX400-200906402-BG, which fixes the ESX 4.0 issues. You can find patch ESX400-200906402-BG in the ESX400-200906001.zip bundle.
  • Switching between Compliance view and Administration view might navigate you to the wrong location
    When you select a datacenter object in the VMs and Templates inventory view of the vSphere Client and use the Admin view and Compliance view quick links to navigate to the Update Manager Administration view and the Update Manager Compliance view, you might go to the wrong vSphere Client view. For example, select Home > Inventory > VMs and Templates in the navigation bar. Select a datacenter object in the inventory and click the Update Manager tab to open the Update Manager Compliance view. When you click Admin view and then go back by clicking the Compliance view link, you navigate to the Host and Clusters inventory view instead of the VMs and Templates view.
    Workaround: Manually navigate from the Hosts and Clusters inventory view to the VMs and Templates view by selecting Home > Inventory > VMs and Templates in the navigation bar.
  • Update Manager does not take snapshots of virtual machines on which FT is turned on before remediation
    You cannot take snapshots of virtual machines on which FT is enabled. If you remediate a virtual machine on which FT is turned on and in the Remediate wizard choose to take a snapshot before remediation, Update Manager ignores this setting and does not take a snapshot of the virtual machine.
    Workaround: Disable FT, configure Update Manager to take a snapshot of the virtual machine, and remediate the machine. If you want to turn on FT after the remediation, delete the snapshot and then enable FT.
  • Virtual machine hardware upgrade or VMware Tools upgrade might fail with error fault.com. - vmware.vc - Integrity.V - MToolsRemediationFault.summary
    The upgrade failure might occur on virtual machines migrated with vMotion from ESX 3.0.x hosts to ESX 4.0.x hosts. In this situation, the guest ID property of the virtual machine is unset, but a new ID is not assigned. Update Manager attempts to read the guest ID during VMware Tools upgrade, and the task fails. The same issue might occur on virtual machines that are reverted to a snapshot, or resumed from suspended state on ESX 4.0.x hosts.
    Workaround: First manually upgrade VMware Tools, and then upgrade the virtual hardware of the virtual machine.
  • When multiple users attempt to create a baseline with the same name simultaneously, Update Manager displays an ambiguous error message
    When multiple users attempt to create a baseline with the same name simultaneously, Update Manager displays the message The specified key, name, or identifier already exists. The message does not inform you explicitly that another user is attempting to create a baseline with the same name.
  • When you stage a baseline that contains multiple bulletins, some bulletins might be shown as missing
    After the successful staging of a baseline that contains multiple bulletins, some bulletins might be shown as Staged and others as Missing. For more information, see After you stage a baseline, a bulletin might be shown as Missing instead of Staged (KB 1018530).
  • Update Manager fails to install and upgrade the Cisco Nexus 1000V VEM, if the ESX host is running on an IPv6 networking stack
    When an ESX host is added to a Cisco Nexus 1000V DVS, Update Manager installs the Cisco Nexus 1000V VEM on the host. Upgrading the Cisco Nexus 1000V VSM to the latest version invokes Update Manager to upgrade the VEM on the host attached to the DVS. Both the installation and the upgrade operations might fail if the host is running on an IPv6 networking stack.
    Workaround: Install or upgrade the VEM on the host manually, by using the offline bundle.
  • During VMware Tools upgrade you might see a misleading error message in Recent Tasks pane
    When you perform a VMware Tools upgrade of a virtual machine, you might see a misleading error message Cannot complete operation because VMware Tools is not running in this VM even though the remediation is successful.
  • Scheduling a remediation task generates a set of tasks
    When you schedule a remediation task, several active tasks appear in the Recent Tasks pane. One of these tasks is Remediate Entity. This task appears when you create a new remediation task and is not an actual remediation task in which the objects are remediated. The Remediate Entity task creates sub-tasks for the scheduled remediation based on your input in the Remediate wizard.
  • Administration view and Compliance view quick-switch links might not work properly if your environment is in linked mode
    If your vCenter Server system is part of a connected group in vCenter Linked Mode and you have an Update Manager instance registered with each vCenter Server system, the Admin view and Compliance view navigation links might not work properly. For example, consider a scenario in which Update Manager instance 1 is registered with vCenter Server system 1 and Update Manager instance 2 is registered with vCenter Server system 2. When you select an object managed by vCenter Server system 1, click the Update Manager tab, and then click Admin view in the upper-right corner, you see the Administrator's view of Update Manager instance 1. When you click Compliance view, select an object from the inventory managed by vCenter Server 2, and click Admin view in the upper-right corner, you see the Administration view of Update Manager instance 1 again.
    Workaround: Click Compliance view and then click Admin view again to see the Administration view of the second Update Manager instance.
  • When you perform a VMware Tools upgrade you might see a misleading error message
    When you perform a VMware Tools upgrade of a virtual machine with insufficient free space, the remediation fails because of the lack of space with a wrong error message The VMware Tools operation was canceled.
  • Conflicting patches are counted in the remediation wizard
    After you scan a selected object against a patch baseline, you might see a number of conflicting patches in the Patch Baselines window. When you try to remediate the selected object, the conflicting patches are counted in the Remediation wizard as patches that are going to be installed on the object, but only some or none of the conflicting patches are installed during the remediation process.
  • Update Manager Service might fill the \Temp directory with many temporary system files
    You might see many files with names like ufa{*}.tmp and ufa{*}.tmp.LOG{*} in the Windows \Temp directory (the default location is C:\WINDOWS\Temp).
    • ufa{*}.tmp files – These files are created when the Update Manager service becomes unavailable in the middle of an offline virtual machine scan. To delete the ufa{*}.tmp files (for example, to delete a ufa729F.tmp file):
      1. Select Start > Run.
      2. In the Run window enter regedit.
      3. In Registry Editor, navigate to the My Computer\HKEY_LOCAL_MACHINE folder and select the ufa729F.tmp file.
      4. Select File > Unload Hive.
      5. Open a Command Prompt window.
      6. Navigate to C:\ and run the following command:
        del C:\Windows\Temp\ufa729F.tmp
    • ufa{*}.tmp.LOG{*} files – These files are Windows transaction log files for registry operations. They can be generated as a result of Windows logging registry transactions, and are removed after use. ufa{*}.tmp.LOG{*} files are like any other Windows temporary files and can be deleted as a part of a Windows Disk Cleanup task.
      To delete the ufa{*}.tmp.LOG{*} files (for example, to delete a ufaFF50.tmp.LOG2 file):
      1. Open a Command Prompt window.
      2. Navigate to C:\ and run the following command:
        del C:\Windows\Temp\ufaFF50.tmp.LOG2

Top of Page