Troubleshoot common issues
For information about known issues with slow logons and workarounds, see Knowledge Center article CTX101705.
Checking that profiles are being streamed
If you have enabled streamed user profiles and want to verify that this feature is being applied to a user’s profile, do the following:
Check the following type of entry in the Profile Management log file:
pre codeblock 2010-03-16;16:16:35.369;INFORMATION;;;;1140;ReadPolicy: Configuration value read from policy: PSEnabled=<1> <!--NeedCopy-->
The last item must be set to PSEnabled=<1> if the feature is enabled.
Check the following entry for the user in the Profile Management log file:
pre codeblock 2010-03-16;20:17:30.401;INFORMATION;<domain name>;<user name>;2;2364;ProcessLogon: User logging on with Streamed Profile support enabled. <!--NeedCopy-->
If streamed user profiles are not being applied, the item reads ProcessLogon: User logging on with Streamed Profile support disabled.
Determining which policies are in force
Use UPMSettings.ini to determine the Profile Management policies that are being applied. The UPMSettings.ini file is located at the root folder of each Citrix user profile in the user store. Examining this file might be more convenient than using the Resultant Set of Policy (RSoP) especially if you use a mixture of GPOs and .ini file settings to determine policies.
Use UPMFRSettings.ini to determine which profile folders are not processed because they are on an exclusion list. The UPMFRSettings.ini file is also located at the root folder.
Excluding corrupt profile data
If a user profile is corrupt and you are confident the problem lies with a particular file or folder, exclude it from the synchronization process. The way is to add the file or folder to the exclusion list.
Cleaning connections to registry entries
In some scenarios (not just those involving Profile Management), connections to registry profile data are preserved after users log off. This preservation can result in slow logoffs or incomplete termination of user sessions. The User Profile Hive Cleanup (UPHClean) tool from Microsoft can help resolve these scenarios.
Deleting local profiles
Microsoft Delprof.exe and Sepago Delprof2 are tools that help you delete user profiles.
Deleting locked, cached profiles
If you use VMware software to create virtual desktops, but users’ cached profiles are locked and cannot be deleted, see Profile Management and VMware for troubleshooting information.
Identifying where profiles are stored
Diagnosing profile issues can involve locating where the files in a user’s profiles are stored. The following procedure provides a quick way to identify where profiles are stored.
- In Event Viewer, click Application in the left pane.
- Under Source in the right pane, locate the Citrix Profile Management event of interest and double-click it.
- The path to the user store associated with the event is displayed as a link on the General tab.
- Follow the link to browse the user store if you want to explore the files.
To determine whether a server is processing a user’s logons and logoffs correctly, check the file called PmCompatibility.ini in the user’s profile in the user store. The file is located in the profile’s root folder. The last entry in the file is the name of the server from which the user last logged off. For example, if the server runs Profile Management 5.0, the entry would be:
[LastUpdateServerName] 5.0=<computer name> <!--NeedCopy-->
To roll back to earlier versions of Profile Management, run del /s from the command line on the file server that hosts the user store. The command deletes the PmCompatibility.ini file from each profile. For example, if the local path to the user store is D:\UpmProfiles, run:
del /s D:\UpmProfiles\pmcompatibility.ini <!--NeedCopy-->
After the command has completed, users can log on to computers running the earlier version and receive their profile from the user store.
Profile Management running on VMware creates multiple profiles
Replicated VMware folders are created in user profiles. The replicates have incremented folder names (000, 001, 002, and so on). For more information about this issue and how to resolve it, see Knowledge Center article CTX122501.
Long logon times With Novell eDirectory
When users log on to an environment involving Citrix products and Novell eDirectory (formerly Novell Directory Services), long logon times might be experienced and errors written to the event log. Sessions might become unresponsive for up to 30 seconds at the Applying your personal settings stage. For more information about this issue and how to resolve it, see Knowledge Center article CTX118595.
Excluded folders in user store
Excluded folders appear in the user store. This is expected and no corrective action is required. Folders on an exclusion list are created in the user store but their contents are not synchronized.
Missing information in log file
Activating debug mode does not automatically enable full logging. In log settings, verify that you have selected all check boxes for the events you want to log.
Tip: You might have to scroll down to enable the last check boxes on the list.
GPO settings inoperative
You change a GPO setting but it is not operative on the computer running the Citrix Profile Management Service. The issue occurs because GP does not refresh immediately but instead is based on events or intervals specified in your deployment. To refresh GP immediately, run
gpupdate /force on the computer.
For your changes to take effect, run the
gpupdate /force command from the command prompt as documented at https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/gpupdate.
Users receive new or temporary profiles
By default, users are given a temporary profile when a problem is encountered. For example, the user store is unavailable. Alternatively, you can configure Profile Management to display an error message and then log users off. This approach can help with troubleshooting.
For instructions on configuring this feature, see Force user logoffs.
In some circumstances, when they log on, users receive a new profile instead of their cached profile. For more information about this issue and a workaround for it, see Knowledge Center article CTX118226.
Users might also receive a temporary profile if a local profile is present after the copy in the user store is removed. This situation can arise if the user store is cleared but local profiles are not deleted at logoff. Profile Management treats such partial removal of profiles as a network, share, or permissions error, and provides the user with a temporary profile. For this reason, partial removal is not recommended. To work around this issue, log on to the affected computer and delete the profile manually.
If your deployment includes personal vDisks (a Citrix Virtual Desktops feature), users might receive temporary profiles if the default processing of these disks has not been correctly adjusted. For more information, see Migrate user profiles.
Profile data lost when Citrix Virtual Desktops sessions become unresponsive
In a Citrix Virtual Desktops deployment, disconnecting from a Remote Desktop Protocol (RDP) session can cause a virtual desktop to become unresponsive or to restart. The behavior impacts Profile Management because it causes profile data to be lost when the session ends. The issue is fixed in Citrix Virtual Delivery Agent Version 3.1.3242 and later.
Users cannot log on (Event ID 1000, Source Userenv)
Users are unable to log on to a Citrix environment and receive the following error message: “Windows did not load your roaming profile and is attempting to log you on with your local profile… Contact your network administrator.” This error appears in the Application event. Log on Windows as Event ID 1000, with source Userenv.
For more information about this issue and other workarounds for it, see Knowledge Center article CTX105618.
In Citrix Virtual Desktops environments, a user can select a default printer but sometimes the selection is not retained between logons. This issue has been observed when a Citrix Virtual Desktops policy is used to set printers on pooled virtual desktops based on a Citrix Provisioning Services vDisk in standard image mode. This issue does not originate with Profile Management. Though the Profile Management log file shows that the registry entry for the printer is copied at logoff (which is expected), NTUSER.dat for the user does not contain the entry (which is not expected). The issue in fact originates with the way Citrix Virtual Desktops uses the
DefaultPmFlags registry setting. For more information, see Knowledge Center article CTX119066.
Sometimes, unexpected printers are added to profiles and, after users remove them, the printers reappear at the next logon. For more information, see the Profile Management support forum.
Problems with application settings on multiple platforms
You might experience problems where application settings do not roam correctly across multiple platforms. Typically these problems result from:
- Settings that are not applicable from one system to another. For example, hardware specific settings that are not on every system.
- Applications that are installed differently on different systems. For example, an application that is installed on a C: drive on one system but on D: on another, an application that is installed in C:\Program Files on one system but in C:\Program Files (x86) on another, or an Excel add-in installed on one system but not on another.
- Applications that store setting information outside of the profile. For example, information stored in the local machine’s settings or outside the user profile.
- Language-specific configuration settings stored in the registry. Profile Management automatically translates language-specific folder names in Version 1 profiles but not in the registry.
In most instances, these issues can be minimized by better standardization of the systems that cause the issues. However, often the issues result from inherent incompatibilities (with multiple platforms) of the OS or the respective application. If the problematic settings are not critical, excluding them from the profile might resolve the issue.
Profiles owned by unknown accounts
On rare occasions, a profile can appear to belong to an unknown account. On the Advanced tab of the System Properties dialog box for a computer, Account Unknown is displayed when you click Settings in User Profiles. This issue is accompanied by an event log entry, “Profile notification of event Create for component <application ID> failed, error code is ???.” In the registry, the application ID points to the SHACCT Profile Notification Handler, a Microsoft component.
To confirm that this issue occurs in your environment, log on as a user whose data is not processed by Profile Management, and check for these symptoms.
It is not an issue with Profile Management but might be the result of Active Directory interacting badly with virtual machine snapshots. The operation of Citrix user profiles is unaffected. Users can log on and off, and their profile changes are preserved.
In this article
- Slow logons
- Checking that profiles are being streamed
- Determining which policies are in force
- Excluding corrupt profile data
- Cleaning connections to registry entries
- Deleting local profiles
- Deleting locked, cached profiles
- Identifying where profiles are stored
- Checking servers
- Roll back
- Profile Management running on VMware creates multiple profiles
- Long logon times With Novell eDirectory
- Excluded folders in user store
- Missing information in log file
- GPO settings inoperative
- Users receive new or temporary profiles
- Profile data lost when Citrix Virtual Desktops sessions become unresponsive
- Users cannot log on (Event ID 1000, Source Userenv)
- Problems with application settings on multiple platforms
- Profiles owned by unknown accounts