Knowledge Base

The VMware Knowledge Base provides support solutions, error messages and troubleshooting guides
 
Search the VMware Knowledge Base (KB)   View by Article ID
 

Confirming that the userinit string is configured properly (1028975)

Symptoms

  • The userinit string is not passing credentials between the VMware View Client and the virtual desktop.
  • The desktop appears as available in the View Administrator console even though the user has a disconnected session to this desktop.
  • Single Sign-On (SSO) is not operating properly.
  • You have just installed a new piece of software.
  • You have implemented a new Group Policy Object (GPO).
  • You have manually edited the userinit string in the registry in one of your virtual desktops.

Purpose

This article provides a reference to the normal behavior of a userinit string in the Windows registry of a virtual desktop, and steps to fix a corrupted userinit string.

Resolution

The userinit string is responsible for listing applications that are launched upon successful authentication to a Windows guest operating system. Sometimes the installation of new applications, application of new GPOs, and manual user edits leave the userinit string in a mode which can adversely affect the successful operation of logins, Single Sign-On, and other parts of the environment.

In a VMware View virtual desktop, normally the userinit string is similar to:

C:\Windows\System32\userinit.exe, "C:\Program Files\VMware\VMware View\Agent\bin\wssm.exe",

Note: The trailing comma is necessary. It ensures that any settings added by another piece of software or GPO are delimited as necessary. Most errors related to this occur because the installation routines are not configured to place the comma at the end of the string; the key is corrupted because it is not read properly unless it is delimited correctly.

To check the current userinit string:

  1. Log into your virtual desktop, the template your virtual desktop pool is based on, or the virtual machine base image that you are using for your virtual desktops.
  2. Click Start > Run, type regedit and press Enter. The Registry Editor window opens.

    Note: Before making any registry modifications, ensure that you have a current and valid backup of the registry and the virtual machine. For more information on backing up and restoring the registry, see the Microsoft article 136393.

  3. Navigate to:

    HKEY_LOCAL_MACHINE > Software > Microsoft > Windows NT > Current Version > Winlogon

    The userinit entry is located here.

  4. Edit the userinit string if necessary. Ensure there is a comma between each program executable path. If there is not, edit the string so that there is a comma between each entry, remembering to add the trailing comma at the end of the string.
  5. Restart the virtual desktop to commit the changes.
  6. If you are editing a virtual machine base image, power down the base image, take a snapshot, and recompose using the new snapshot as your base image. For more information, see Understanding virtual machine snapshots in VMware ESXi and ESX (1015180).

See Also

Update History

01/11/2011 Edited the userinit string 09/24/2012 Added Symptom that Desktop can appear as available 10/15/2013 - Added View 4.6 and 5.x to product versions

Request a Product Feature

To request a new product feature or to provide feedback on a VMware product, please visit the Request a Product Feature page.

Feedback

  • 6 Ratings

Did this article help you?
This article resolved my issue.
This article did not resolve my issue.
This article helped but additional information was required to resolve my issue.
What can we do to improve this information? (4000 or fewer characters)
  • 6 Ratings
Actions
KB: