VMware View Manager 4.0.1 Release Notes

View Manager Version 4.0.1 | 18 February 2010 | Build: 233023 (View Manager), 210930 (View Composer)

Last Updated: 18 February 2010

These release notes cover the following topics:

What's New in View Manager 4.0.1

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

This release includes the following new features.

Localization of VMware View

The View Client and online help for View Client are now available in Japanese, French, German, and simplified Chinese. The View Manager Administration Guide, View Manager Release Notes, Getting Started with VMware View document, View Upgrade Guide, and View Architecture Planning Guide are also available in these languages.

VirtualCenter 2.5 Update 6 and ESX 3.5 Update 5 Support

View Manager 4.0.1 includes support for VirtualCenter 2.5 Update 6 and ESX 3.5 Update 5.

Enhancements to the PCoIP Display Protocol

PCoIP now supports the following features:

  • Virtual Printing, which allows end users to use local or network printers from a View desktop without requiring that additional print drivers be installed in the View desktop.
  • Single sign-on support for third party providers such as Sentillion and Imprivata.
  • View Client supports international keyboards when using PCoIP.

For PCoIP-related bug fixes, see the View Client Resolved Issues section.

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.1 requires VMware vSphere 4 Update 1. VMware View 4.0.1 supports the versions of vSphere and VMware Infrastructure listed in the System Requirements section of the VMware View Manager Administration Guide 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 or VMware Infrastructure 3 version 3.5 Update 3 or above Install vSphere 4 Update 1 (with vCenter Server Update 1) 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:



  • 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:

View Administrator

  • Occasionally, when using View Portal to connect to a security server and access a View desktop, if the browser was Internet Explorer 7, the status of the View desktop was shown as Not Connected.
  • During linked clone creation, the Desktop Sources tab in View Administrator gave an incorrect error status after provisioning and customization.

View Client

  • Occasionally, when attempting to play a video in a View desktop, an error message was displayed: The application has failed to start because vdp_rdpvcbridge.dl was not found. The video played after clicking OK.
  • If you used the Virtual Printing feature and attempted to print a page from a Firefox 3.x browser in a View desktop, garbage characters were printed.
  • User authentication with the Giesecke & Devrient smart card called Smartcafe Expert 3 always failed.
  • If you set a View Client policy for RDP settings so that users could not change the Windows display theme, the setting was ignored, and end users could change the theme in a View desktop.
  • If you used the PCoIP display protocol, occasionally when you clicked to display a menu and then moved the mouse to another menu, one of the menus did not display correctly. Sometimes a keyboard delay also occurred.
  • If you used View Client at the same time as other applications that attempted to always keep their window on top, the View Client froze. This situation occurred rarely, and usually with software that attempted to start local applications from within the View desktop.
  • When View Client users connected to a Windows 7 desktop using PCoIP, the desktop console in the vSphere Client initially blanked out for privacy. However after several minutes, sometimes a small window screen of the desktop appeared in the View Client, like Restore Down.
  • When connecting to a Windows 7 desktop using PCoIP, it sometimes took a long time for the connection to complete.
  • When connected to Windows Vista desktops using PCoIP, if the guest system went into Sleep mode, the virtual machine put the guest into Stand by mode, causing the connection to hang and new connection attempts to fail.
  • With View 4.0.1, a new group policy setting has been added that pertains to using a Proxy Auto Config (PAC) file with View Client. Usually, if Internet Explorer is configured to use a PAC file, View Client ignores this information. The new GPO tells View Client to use the PAC file to determine proxy settings. However, if you enable this group policy setting, View Client might sometimes exit unexpectedly, particularly on multicore machines. If the group policy is not set, View Client can still work with a proxy server if Internet Explorer is also configured with a fixed proxy server.
  • With View 4.0.1, you can now have a true multiple-monitor session when using a Windows 7 View Client to access a Windows 7 View desktop over Microsoft RDP. In a true multiple-monitor session, the Windows taskbar is displayed only on the primary monitor, and if you maximize an application window, the window expands to the full screen of only the monitor that contains it.

View Composer

  • When creating a persistent linked-clone desktop pool, if you stored the user profile with the OS disk and did not use vSphere mode, the desktops that were created did not store the profile with the OS disk but instead were created with a user data disk.
  • With View 4.0.1, when you run the support script on a View desktop, the View Agent support script now collects additional View Composer information and logs, including information about registry settings, profile redirection, SysPrep logs, and more.


  • When connecting to a desktop using PCoIP, the keyboard locale in the desktop kept its original setting when the keyboard locale in the client operating system was Japanese.
  • On a View desktop, the GINA (Graphical Identification and Authentication) did not always load, and you couldn't always to boot into Windows, if you uninstalled a third-party application that previously was part of a GINA chain. To avoid this issue, you had to uninstall View Agent before you uninstalled the third-party application.
  • In View 4.0.1, the size of the RSA key in View Agent has been reduced from 1024 bits to 512 bits. This reduces the time required for message validation. You can configure the global size default of the RSA key. If you want to change it from 512 back to 1024, set pae-MSGSecOptions to "keySize=1024" in the same "OU=common" object as in pae-MsgSecPublicKey.

Top of Page