VMware View Manager 4.0.2 Release Notes

View Manager Version 4.0.2 | 15 September 2010 | Build: 294291 (View Manager), 210930 (View Composer)

Last Updated: 15 September 2010

These release notes cover the following topics:

What's New in View Manager 4.0.2

VMware View 4.0.2 is a maintenance release that resolves some known issues in the previous releases. For details, see the Resolved Issues section.

View Manager 4.0.2 also includes support for vSphere 4.0 Update 2.

Top of Page

Before You Begin

Before you begin installing and configuring VMware View components, review the General Installation Guidelines section.

Important: VMware View 4.0.2 requires VMware vSphere 4.0 Update 1, Update 2, or Update 3. VMware View 4.0.2 supports the versions of vSphere and VMware Infrastructure listed in the System Requirements section of the VMware View Manager Administration Guide, vSphere 4.0 Update 3, and VirtualCenter 2.5 Update 6 and ESX 3.5 Update 5.

General Installation Guidelines

The following guidelines apply to all installation types (new installations and upgrades).

  • Install vSphere 4 Update 1, Update 2, or Update 3, or VMware Infrastructure 3 version 3.5 Update 3 or above Install vSphere 4 Update 1, Update 2, or Update 3, or VMware Infrastructure 3 version 3.5 Update 3 or above if you want to use View Composer.
    Note: If you want to use the Offline Desktop experimental feature, VMware Infrastructure 3.5 Update 3 or above is required. Offline Desktop is not supported with vSphere 4.

    When upgrading, strictly follow the recommendations in the upgrade guide for the vSphere or VMware Infrastructure version you are using.
  • View Client with Offline Desktop is an experimental feature. Install View Client with Offline Desktop if you want to use Offline Desktop.
  • View Client with Offline Desktop cannot be installed on the same machine as VMware Workstation, VMware ACE, VMware Player, or VMware Server.
  • View Client, View Client with Offline Desktop, and View Agent cannot be installed on the same machine.
  • Synchronize time – Use the VMware Tools time synchronization function to ensure that virtual machines are synchronized to ESX. ESX must synchronize to an external NTP source, for example, the same time source as Active Directory. For additional information, see Timekeeping in VMware Virtual Machines information guide.
  • Validate your Internet Explorer settings – View Client uses Microsoft Internet Explorer Internet settings, including proxy settings, when connecting to View Connection Server. Ensure that your Internet Explorer settings are accurate and that you can access the View Connection Server URL through Internet Explorer.
  • Before creating an automatically provisioned desktop pool, do the following:
    • Validate the vCenter guest customization specification if you intend to use one – Make sure that the guest customization specifications in vCenter are accurate. You should use vCenter to deploy and customize a virtual machine from your template using that customization specification and fully test the resulting virtual machine (in other words, DHCP, authentication) before using that customization specification in View Administrator.
    • Validate network ports on ESX – Make sure you have a sufficient number of ports on the virtual switch which is used for the guest virtual machines. The default value for ESX is 24, which might not be sufficient when creating a large pool of desktop virtual machines.
  • View does not support using link-local (169.254.x.x) addresses for virtual desktops – Configure virtual desktops to use DHCP or static IP addresses.
  • View supports smart cards and smart card readers that use a PKCS#11 or Microsoft CryptoAPI provider.

Top of Page

Known Issues

The known issues are grouped as follows:



  • When using View Client to log in as the current user, intermittent authentication failures and XML parsing errors in the View Connection Server log were seen when View Client sent a very long value for the Kerberos data field.
  • If you are upgrading from View Composer 1.0, when a prompt asks whether you want the wizard to upgrade the database, you must respond that you do want the wizard to upgrade the database. If you select manual upgrade, it will fail. If you are upgrading from View Composer 1.1, no database schema upgrade is required.
  • During vSphere upgrade, the administrator might choose to upgrade the virtual machine hardware to version 7 in the parent virtual machine. This can trigger a Windows Vista or Windows 7 reactivation prompt when View desktops are recomposed.

View Administrator

  • When editing a desktop pool that is not in vSphere mode, vSphere mode is not enabled by changing the Hosts and Clusters selection to a standalone ESX 4.0 host.
  • If you press the F5 key to refresh the page while configuring a desktop pool, a Java error might be displayed.
    Workaround: Do not press F5 to refresh the page. If the error appears, you must close all active Web browser instances and then restart them.
  • An authentication error is displayed if a non-ASCII value for the external URL is entered when configuring a View Server in View Administrator.
    Workaround: Use only ASCII characters in the View Server External URL.
  • Removing a View Manager ADAM Instance Causes an Error (KB 1007591)

View Client

  • View Client supports connections to View desktops using PCoIP. The following are known limitations when using PCoIP:
    • View clients that use PCoIP can connect to View security servers, but PCoIP sessions with the desktop ignore the security server. PCoIP uses UDP for streaming audio and video. Security servers support only TCP.
    • Smart cards are not supported.
    • Audio input works with USB devices only.
    • View Portal does not support PCoIP connections.
  • On Windows 7 View desktops that use the Virtual Printing feature, if you go to the Control Panel, you see only the default printer listed even though other printers are available. When you print a file, the other printers are available in the Print dialog box.
    Workaround: To see the other printers in the Control Panel, right-click the default printer and point to Properties.
  • For some newer USB printers, if the color setting for the printer on the local machine is different from the color setting in the Virtual Printer settings for the View desktop, the local client settings take precedence. For example, if the client computer setting is to print in color but the Virtual Printer setting is to print grayscale, the document is printed in color.
  • If you connect to a Windows 7 desktop using PCoIP, autofit does not work.
  • When View Client attempts to connect to a Windows 7 desktop using PCoIP, a blank black screen will appear instead of the Windows Security dialog box if the Windows 7 desktop fails to perform single sign-on, for example, if the desktop does not join the domain.
    Workaround: Make sure that you enter a valid user name, password, and domain name in the View Client connection dialog box. When using single sign-on, you do not have to re-enter authentication information to log in to the desktop.
    Once connected, if the Windows Security dialog box is activated in the desktop, a blank screen is displayed. To dismiss the dialog box, press Esc. You can also attempt to type in the correct authentication information, but you cannot see what you are entering.
  • If you connect to a Vista desktop using RDP, but then switch to PCoIP, a blank black screen will appear and then the session will end. This problem only occurs if single sign-on fails.
    Workaround: The administrator must correctly set up single sign-on. Make sure that single sign-on was enabled during the View Agent installation. Verify that the remote desktop is joined to the same Active Directory domain as the credentials used to log in to the View Connection Server instance.
  • The user will see a blank black screen and then the session will end if three conditions occur simultaneously: the remote desktop is running Windows XP SP3, the remote desktop is not joined to an Active Directory domain, and the user reconnects to the same desktop using PCoIP after disconnecting and logging off from the RDP connection.
  • When connected to a desktop using PCoIP and playing a video without using MMR, audio might lag behind video.
  • MMR does not work if a machine is moved from a workgroup to a domain after the View Agent is installed.
    Workaround: You must reregister the required MMR DLLs.
    On a Windows Vista machine, you can use a batch file that contains the following commands:
    "%SystemRoot%\system32\regsvr32" "%CommonProgramFiles%\VMware\Wyse TCX MMR Server\WMRVFilter.dll"
    "%SystemRoot%\system32\regsvr32" "%CommonProgramFiles%\VMware\Wyse TCX MMR Server\WMRVVideoMFT.dll"
    "%SystemRoot%\system32\regsvr32" "%CommonProgramFiles%\VMware\Wyse TCX MMR Server\WMRVMediaSource.dll"

    On a Windows XP machine, you can use a batch file that contains the following commands:
    "%SystemRoot%\system32\regsvr32" "%CommonProgramFiles%\VMware\Wyse TCX MMR Server\WMRVFilter.dll"
    "%SystemRoot%\system32\regsvr32" "%CommonProgramFiles%\VMware\Wyse TCX MMR Server\WMRVAudioDMO.dll"
    "%SystemRoot%\system32\regsvr32" "%CommonProgramFiles%\VMware\Wyse TCX MMR Server\WMRVVideoDMO.dll"
  • When playing a video using MMR in a Vista desktop, if Windows Media Player is switched to full screen mode you cannot exit full screen mode until the video finishes playing.
  • When connected to a desktop using PCoIP, if you connect a projector or external monitor to a laptop computer, multi-media redirection (MMR) does not play properly. Sometimes it displays only a black box.
  • When connected to a desktop using PCoIP, multiple monitor display does not take effect, or functions poorly, when the leftmost or topmost display is not the primary monitor. For instance, the desktop might be centered across two physical monitors. Also, video might play on the second monitor instead of inside Windows Media Player on the primary monitor.
    Workaround: Always designate the left or top monitor as the primary monitor.
  • When a View Client user is logged in to a guest virtual machine, the vSphere Client (or VI Client) Console view displays a blank screen. Do not type or mouse-click within the Console, because doing so disrupts the user. Do not leave the virtual machine Console view active, because a Console view during an active PCoIP session can affect user experience and has the potential to consume additional network bandwidth.
    Workaround: Set vSphere role-based privileges to restrict access to the Console and reduce the chance of this occurring.
  • If a Windows XP guest is put into Stand by mode, the View Client desktop does not close immediately, and might not close.
    Workaround: Avoid using Stand by mode.
  • When using PCoIP, disable Auto-detect video settings in the video card settings when you create the virtual machine to use as the template or Parent VM for provisioning a desktop pool using the vSphere Client. Otherwise, View cannot set the correct video parameters, and multiple monitor mode fails during provisioning.
  • On Windows Vista systems running View Client, the guest desktop user can access a USB device that is in use on the client system if no locking mechanism is in place. Notepad does not lock a file, whereas Word does.
  • If you try to connect to an NLA-enabled Vista machine from an NLA-enabled Windows XP client, the connection fails with the error message An authentication error has occurred (Code: 0x80090303). Remote Computer: <IP.Address>. The same error occurs if you try to connect directly with RDP to the NLA-enabled Vista machine.
    Workaround: You can connect from Windows Vista clients.
  • If you are running View Client on Windows Vista build 6.0.6000, you might encounter the following problems:
    • It is not possible to add a printer in the Control Panel.
    • If you try to connect to a desktop using RDP, View Client hangs. The system log will include the error An internal communication error occurred. Redirected printing will no longer function for a single user session. Check the status of the Terminal Services Device Redirector in the System folder of Device Manager.
    Workaround: Upgrade your client system to Windows Vista SP1 or higher.
  • If View Client is started from the command line using a command such as wswc.exe -serverURL <IP.Address> -domainName <domain_name>, the user is prompted for a user name and password. If the user waits about 15 seconds and then clicks Cancel, the wswc.exe process remains running until another View Client is launched interactively or from the command line.
    Workaround: Manually stop the wswc.exe process.
  • View Client fails to connect to the View security server if a standard server FQDN with localized characters is specified during security server installation.
    Workaround: Specify the IP address of the standard server during security server installation.
  • View Client for Windows supports connections to desktops using the HP RGS protocol. View Portal does not support RGS connections. Linux thin clients do not support RGS connections.
    • Only connections to HP Blade PCs, HP Workstations, and HP Blade Workstations are supported.
    • Connections to virtual machines are not supported.
    • Vista desktops are not supported.
    • Only direct connections are supported. Tunnel connections are not supported.
    • Smart cards are not supported.
    • Multiple monitors are not supported.
  • When you are connected to a desktop using the HP RGS protocol, if you right-click a file, folder, or network connection, you might see a red screen and repeated Network connection warning errors. This problem occurs if you right-click an item to select that item and the following settings are turned on:
    • Show Common Tasks in Folders
    • Fade or Slide Menus into View
    Workaround: Workarounds are described in Microsoft KB article 819946 (http://support.microsoft.com/kb/819946). Do one of the following:
    • Turn off the Fade or Slide Menus into View visual effect
    • Use Windows classic folders
    Alternatively, select the item before you right-click it. To select an item, either click the item or rest the mouse pointer on the item.
  • VMware View Client requires HTTP 1.1 to be enabled in Internet Explorer (KB 1011655)
  • When a user connects to a desktop through multiple View Clients desktop sessions are disconnected (KB 1007581)
  • View Portal on Mac OS does not support connection to Windows Vista desktops (KB 1007584)

Smart Card

Offline Desktop (Experimental)

  • When you install View Agent with the Offline Desktop component selected, the installer includes VMCI files (such as vsocklib.dll) even if VMware Tools has already installed them. This could result in a version mismatch or an older version being installed.
    Workaround: If you previously installed VMware Tools on the virtual machine, deselect Offline Desktop Components when installing View Agent.
  • If you attempt to perform an offline operation that requires re-authentication when the View Connection Server is configured to display a pre-login message, open windows might close though the View Client process is still running in the background.
    Workaround: End the View Client process (wswc.exe) in Task Manager and then restart View Client. If the network connection is lost and then comes back when running a local desktop, restart View Client before initiating an offline operation.
    This problem does not occur if you do not configure the View Connection Server to display a pre-login message.

View Composer

  • Unable to remove source and replica virtual machines associated with View Composer desktop pools (KB 1008704)
  • On rare occasions, you might see an error such as: Virtual Machine Message msg.disk.duplicateUUID : Virtual disks "<diskname_1>.vmdk" and "<diskname>.vmdk" have the same UUID...This message appears in vCenter when the virtual machine is powering on. You can see the full message in the console.
    This error indicates that disks with the same UUID were created during a refresh or recompose operation. However, the message only appears after a refresh or a recompose to the same snapshot. The root cause of this disk duplication is that the UUID is out of sync between vCenter and View. This causes the duplicate virtual disk to be created and leaves the virtual machine booting to the original, incorrect disk.
    Workaround: VMware recommends that you delete the virtual machine and provision a new one.
  • If a user data disk runs out of disk space when a persistent linked clone desktop pool is created, recomposed, or refreshed, an error message is displayed: View composer agent initialization state error(20) failed to redirect profiles directory (waited 35 secs).
    Workaround: Make the user data disk larger to accommodate the default and All Users profiles in the Parent VM. The minimum size of 128MB might not be sufficient.
  • Do not recompose a linked clone from Windows XP to Windows Vista. If the virtual machine contains a large amount of user profile data, the user data disk might not be large enough to hold both Vista-style \users\* and XP-style Documents and Settings\username user profiles.
  • vSphere optimizes virtual machine cloning by using the SCSI data mover extended-copy feature. However, a side effect of this optimization is that linked clone pool provisioning can be slowed down by concurrent full cloning tasks.
    Workaround: Do not concurrently provision a linked clone pool and a large full clone pool if the two pools are on the same SCSI array, sharing the same data mover. Similarly, do not configure a linked clone pool to share a SCSI array with a full clone pool that uses the delete-desktop-after-logoff policy.
  • When you create an automated pool of 100 or more desktops, View Composer does not warn you to limit the prefix name to 12 characters. In an automated pool, desktop names can be no longer than 15 characters, including the prefix name and the autogenerated number. For example, if you create an automated pool with a 13-character prefix and set the maximum pool size higher than 100 desktops, View Connection Server cannot provision more than 99 desktops.
    Workaround: When you create an automated pool of 100-999 desktops, limit the prefix to 12 characters. When you create a pool of 1,000 or more desktops, limit the prefix to 11 characters.
  • Linked clones that use BusLogic controllers might become unusable when recomposed to a base image that uses an LSI Logic controller. Linked clones affected by this issue are unable to boot their operating systems, and the administration interface shows errors such as: View Composer agent initialization state error (-1): Illegal state (waited 360 seconds). There is no workaround. Changing SCSI type during a recompose is not a supported operation.
  • If the connection to the database is lost during linked clone operations (including linked clone creation, resynchronization, and destruction), View Composer might crash. View Composer will attempt to restart automatically, causing another crash which is logged as a Service cannot be started exception in the Windows event log.
    Workaround: Restart the database server if it is not running. Then restart the View Composer service from the Windows Services control panel.
  • If you use VirtualCenter 2.5 Update 3, re-registering a linked clone in VirtualCenter changes the BIOS UUID of the linked clone (KB 1013505)
  • Rebalance fails for existing virtual machines if linked clones are moved another local storage (KB 1007699)
  • Non-ASCII user names and passwords for VirtualCenter are not recognized by View Composer. (KB 1007702)
  • Static DNS server setting is lost when a recompose is performed from a Windows XP virtual machine to a Windows Vista virtual machine. (KB 1007707)
  • Cloned virtual machines might show Error state after a transient failure (KB 1007820)


Top of Page

Resolved Issues

The resolved issues are grouped as follows:

Install and Upgrade

  • If you attempted to install View Agent when the Windows Firewall service was not running, the View Agent installation program returned an error and rolled back the installation.
  • If you attempted to install View Client when the Windows Firewall service was not running, the View Client installation program returned an error and the installation failed.

View Administrator

  • In View Administrator, the Desktop Sources tab in the Global Desktops and Pools page included links to the Edit Image, Rebalance, and Cancel Task operations. If you tried to use these links, the operations would fail, because they can be performed only on linked clones from within a particular desktop pool view.
  • The performance of View Administrator became degraded if several hundred individual desktop pools were created where each pool contained a single virtual machine.
  • The value of the Number of days to keep production logs group policy setting determines how many days of log files are retained and therefore how many days of events can be displayed in View Administrator. The default value for this setting is 7.

    In previous releases, it was possible to set the Show last ## days of events option in View Administrator to a value up to 31, regardless of the value of the Number of days to keep production logs group policy setting.

    With 4.0.2, the setting for Number of days to keep production logs determines the maximum value for Show last ## days of events. However, if Number of days to keep production logs is set to a value greater than 100, only a value up to 100 can be selected. The default value for Show last ## days of events and Number of days to keep production logs is still 7.

View Client, Thin Clients, and PCoIP Zero Clients

  • When connected to a View desktop with a 4.0.1 View Agent installed, the mouse cursor sometimes disappeared during a WebEx or Microsoft Office Live Meeting.
  • The backspace key sometimes stopped working when connecting to desktops using PCoIP from View Client on DevonIT TC5 thin clients.
  • The Log in as current user feature did not work if the primary DNS suffix portion of the client computer's FQDN was different from the name of the Active Directory domain that the client computer belonged to.
  • When using PCoIP Zero clients, clients experienced unexpected disconnects.
  • When using PCoIP Zero clients, data transfer failed for NTFS-formatted USB drives.

Smart Card

  • The smart card single sign-on feature and the smart card removal policy were not supported with Giesecke & Devrient smart cards.
  • Smart card authentication with Gemalto Cyberflex Access 64K V2C smart cards was not supported by View Client on Vista client systems.

View Composer

  • When a linked clone desktop pool was created, some clones could remain in a customizing state until the customization timed out. These clones failed to be provisioned.
  • When linked clone desktops were created or recomposed, the clones could enter the following error state: View Composer agent initialization state error (6): Unknown failure (waited 0 seconds).
  • When View Composer created, recomposed, or refreshed linked-clone desktops with user data disks, the operation could fail. The following error was displayed: View Composer agent initialization state error (2): Failed to redirect profiles directory (waited XX seconds).
  • When attempting to perform recompose, rebalance, or refresh operations on linked clone desktop pools, the operation failed with a java.lang.IllegalStateException if a virtual machine was not powered off when the Parent VM snapshot was taken.

    For a virtual machine that has been upgraded from hardware version 4 to hardware version 7, you must still take the Parent VM snapshot in a powered-off state.
  • When a linked clone desktop that belonged to a persistent pool and did not have a separate user data disk was rebalanced twice, the second rebalance operation could fail with the following error: Invalid parameter disk[0].diskId. The operation used the disk name to find the UDD, which worked during the first rebalance. However, rebalance changes the disk name, and the second rebalance incorrectly identified the OS disk as a UDD and attempted to relocate the disk with the virtual machine. The invalid device key error occurred because the OS disk was detached for the rebalance.


  • Connections to virtual desktops using PCoIP failed after installing ESX 4.0 Update 2, which updates VMware Tools.
  • In View 4.0.1, View Client help was always displayed in English. Now, View Client displays the help in the correct language for German, Simplified Chinese, Japanese, and French locales.

    Additionally, the View Administrator help link for Simplified Chinese locales went to an incorrect download link. It now points to the View Manager Administration Guide in Simplified Chinese.
  • The Always on power policy did not work for persistent pool desktops. If the user selected Shutdown from the Start menu, the desktop did not automatically restart.
  • A deadlock issue prevented View Connection Server from performing power operations on suspended virtual machines.
  • When a manual desktop pool was created with two or more virtual machines, and the power policy was set to Power Off VM, the first virtual machine in the pool was powered on, but the subsequent virtual machines were not powered on. After the first user connected to a desktop, subsequent users could not connect and an error indicated that no desktops were available.
  • View Client sometimes failed to connect to the Connection Server with the error Connection to server could not be established SSL initiation failed when using a proxy server and Extended Validation (EV) SSL certificates.
  • When using View Client to log in as the current user, intermittent authentication failures and XML parsing errors in the View Connection Server log were seen when View Client sent a very long value for the Kerberos data field.
  • The View Connection Server service failed with an authentication error when attempting to log in to desktops using domain accounts with path lengths greater than 260 characters.
  • The presence of a network switch between a View Connection Server instance and a security server caused the View Connection Server host to hold sockets open that the security server had closed on its side. The View Connection Server host eventually ran out of sockets, which prevented users from loading the login page.
  • A handle leak occurred when certain registry keys (such as Forced DNS Name) existed, but the value of those keys did not.
  • View Connection Server stopped allowing incoming connections and displayed an Out of memory Java heap space error while performing sequential add operations for manual or individual pool virtual machines in a large deployment.
  • If the connection between View Client and the virtual desktop is dropped, for example due to poor network reliability, the user is forced to start a new connection and re-authenticate to reconnect to the desktop.

    With View 4.0.2, the new Enable RDP Auto-Reconnect group policy setting has been added to take advantage of the automatic reconnect feature of RDP. This setting only needs to be enabled if poor connectivity causes re-authentication requests on reconnect. This setting is disabled by default.

    You must upgrade both View Client and View Agent to be able to use this new group policy setting. This setting works for direct connections, but not for tunneled connections.

Top of Page