VMware View Manager 3.1.1 Release Notes

View Manager Version 3.1.1 | 10 July 2009 | Build 175957 (View Manager), 161885 (View Composer)

Last Document Update: 10 July 2009

These release notes cover the following topics:

What's New in View Manager 3.1.1

View Manager 3.1.1 is a maintenance release that resolves some known issues in the previous releases. Refer the Resolved Issues section for more details.

Top of Page

Before You Begin

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

Important: View 3.1.1 Does Not Support vSphere. View 3.1.1 supports only the VMware Infrastructure versions listed in the System Requirements section of the VMware View Manager Administration Guide.

General Installation Guidelines

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

  • Install VMware Infrastructure 3 Version 3.5 Update 3 or Update 4 Install VMware Infrastructure 3 version 3.5 Update 3 or Update 4 if you want to use View Composer or Offline Desktop features. When upgrading, strictly follow the recommendations in the VMware VirtualCenter Upgrade Guide.
  • View Client with Offline Desktop is an experimental feature. Install the VMware View Client with Offline Desktop if you are going 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 http://www.vmware.com/pdf/vmware_timekeeping.pdf.
  • 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 VirtualCenter guest customization specification if you intend to use one – Make sure that the guest customization specification in VirtualCenter is accurate. You should use VirtualCenter 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.
  • Install required Microsoft Windows patches – For Windows XP desktop virtual machines, make sure you have RDP patches referenced by Microsoft Knowledge Base (KB) articles 323497 (http://support.microsoft.com/kb/323497) and 884020 (http://support.microsoft.com/kb/884020).  Failure to do this might result in a Windows Sockets failed error message on the client. 
  • Upgrade View Client machines to use Microsoft Remote Desktop Connection (RDC) 6.x – This recommendation applies to machines running Windows XP and Windows XPe. Windows 2000 does not support RDC 6.x. Windows Vista comes with RDC 6.x installed. RDC 6.x can be downloaded at the following Microsoft download site: Microsoft downloads
  • 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.
  • VMware View provides Common Access Card (CAC) support for Actividentity and Gemalto smart cards. View does not currently offer SSO support which enables single sign-on from a client device to a virtual desktop without requiring a user to re-enter a pin.

Known Issues

The known issues are grouped as follows:


  • When creating and preparing the guest system, you must install View Agent after all other third-party applications are installed. After you install View Agent, you must uninstall it before installing additional third-party applications in the guest. If you install other third-party applications after installing View Agent, and then uninstall View Agent, certain registry entries for the other third-party applications might be lost. Applications known to be affected by the installation order include Microsoft AppV, vmSight ConnectorID, and Citrix Presenter.
    Workaround: If you need to install another third-party application after installing View Agent, uninstall View Agent, install the other third-party applications, and then install View Agent.
  • If the system locale (set in Control Panel > Regional and Language options > Advanced > Language for non-Unicode programs) does not match the language of the version of Windows that you are using, installation of the View Connection Server hangs.
    Workaround: Make sure that the system locale matches the language of the version of Windows that you are using.
  • Installing the View Agent on Windows XP disables the Welcome Screen and Fast User Switching (KB 1007602)
  • No warning message is generated that desktops are checked out when you uninstall the View Client with Offline Desktop (KB 1007607)


View Administrator

  • If you press the F5 key to refresh the page while configuring a desktop pool, a Java exception might occur.
    Workaround: Do not press F5. If the exception occurs, you must close all running Web browser instances and then restart them.
  • When using View Administrator with Internet Explorer 6, the OK and Cancel buttons on the Global Settings page (Configuration > Global Settings > Edit) might not be visible when the screen resolution is set to 800x600.
    Workaround: Change the screen resolution to 1024x768.
  • On rare occasion, View Administrator might display IllegalStateException errors.
    Workaround: Restart the VMware View Connection Server service.
    If this error occurs, a file named facelet_error<nnnnn>.html, containing detailed information about the exception, is created in the log directory C:\Documents and Settings\All Users\Application Data\VMware\VDM\logs. VMware Technical Support might ask you to send these files, in addition to vdm-support script output, for troubleshooting.
    Note: The facelet_error<nnnnn>.html log files are small, but they are not deleted automatically. You can delete them manually to reclaim disk space.
  • 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 (Adam Instance VMwareVDMDS) causes an error if no other directory service servers can be contacted in an environment with more than one View Connection Server. (KB 1007591)

View Client

  • MMR might not work in View Clients connecting to a Windows virtual desktop that has been restarted in VirtualCenter.
    Workaround: Unregister and re-register WMRVFilter.dll in the virtual machine as follows:
    1. Change to the directory <drive>:\Program Files\Common Files\VMware\Wyse TCX MMR Server
    2. regsvr32 /u WMRVFilter.dll
    3. regsvr32 WMRVFilter.dll
    4. Restart the media player.
  • 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 HP Blade PCs, HP Workstations, and HP Blade Workstations are supported. Virtual machines are not supported.
    • Vista desktops are not supported.
    • Only direct connections are supported. Tunnel connections are not supported.
    • Smart cards (CAC) 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.
  • 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.
  • VMware View Client requires HTTP 1.1 to be enabled in Internet Explorer (KB 1011655)
  • Setting the "Automatic logoff after disconnect" policy for an individual desktop or desktop pool results in unexpected behavior when a user is already connected to that desktop through another client (KB 1007581)
  • View Portal on Mac OS does not support connection to Windows Vista desktops (KB 1007584)

Common Access Card

Offline Desktop (Experimental)

View Composer


Resolved Issues

The resolved issues are grouped as follows:

View Administrator

  • When using View Web Portal to launch a virtual desktop with a user, the User field in the View Administrator Console does not display the name of the desktop user although the desktop is assigned to the user persistently.
    This issue is resolved in this release.
  • The list of desktop pools in the left-hand pane of the Web Administrator window's Inventory tab is sometimes not populated. This issue prevents the administrators from managing the desktops.
    This issue is resolved in this release.

View Client

View Clients might unexpectedly disconnect from the desktops when tunneled (KB 1012388)


When you perform some functions on a virtual desktop that is running View agent and certain third-party GINAs that do not completely support WLX version 1.4, the guest operating system fails and displays a blue screen. This issue is resolved in this release.