Product Documentation

Troubleshoot

Mar 28, 2017

As a first step in troubleshooting any issue that you or your users experience, follow these basic steps:

  1. If you are using XenDesktop 7, start troubleshooting in Desktop Director. This console displays properties of profiles that can help you diagnose and correct problems.
  2. Use UPMConfigCheck. This is a PowerShell script that examines a live Profile Management deployment and determines whether it is optimally configured. For more information on this tool, see CTX132805.
  3. If a Profile Management .ini file is in use, check its configuration on the affected computer.
  4. Check the settings in Group Policy (GP) against the recommended configurations that are described in Decide on a configuration. To deactivate any Profile Management policy that you enter as lists (for example, exclusion lists and inclusion lists), set the policy to Disabled. Do not set the policy to Not Configured. 
  5. Check the HKLM\Software\Policies registry entry on the affected computer to see if there are any stale policies due to GP tattooing issues, and delete them. Tattooing occurs when policies are deleted from GP but remain in the registry.
  6. Check the file UPMSettings.ini, which contains all of the Profile Management settings that have been applied for each user. This file is located in the root folder of each Citrix user profile in the user store.

If these steps do not correct the issue, consult the remaining topics in this section of eDocs.