Pawel Serwan Blog

Citrix, Microsoft and other stuff

Citrix Profile Management – User Store revealed


One of the biggest problem in Application or Desktop Virtualization is end user experience and consistency of user profile and customizations. Luckily there is a bunch of tools available on the market that help solve that problem. One of them is Citrix Profile Management intended as a profile solution for XenApp servers, virtual desktops created with XenDesktop, and physical desktops. You install Profile management on each computer whose profiles you want to manage. Active Directory Group Policy Objects allow you to control how Citrix user profiles behave. All sounds like a fairy tail – Citrix admin configures policy settings and it everything works like a charm. But obviously it isn’t. Recently I needed to troubleshoot user Citrix profile related problem, or at least user stated that 🙂 I’ve started from checking Active Directory Group Policy settings for Citrix Profile Management. Everything looked good, user was member of a proper security group. I switched then to the user store defined in Group Policy to check if I can find anything there. Usually you held use store on network share on file server. It might be part of user homedir or might be completely separate folder. After getting to user store you find the below structure of files and folders.


I was searching Citrix eDocs trying to find explanation of that structure and especially those configuration files but I was unsuccessful. So what does they really do? Let’s start from .INI files. Below you can find information stored in my Citrix profile:



You can find here two interesting information helpful in troubleshooting:

[VersionUpdateTimeStamps] – first part of that string tells you which version of Citrix UPM was used and the second part tells you when logged off last time from Citrix session using profile  management. In my case I used UPM version 5.1 and I logged of 18th August at 19:20.

[LastUpdateServerName] – one more time, first part tells you which version of Citrix UPM was used and the second part tells you to which Citrix XenApp/XenDesktop server you were  connected.


upmsettings I haven’t paste whole file here. Basically it contains configuration of UPM. It is synced every time you log to Citrix session and it  reflects settings in Active Directory Group Policy for Citrix Profile Management – or at least it should 🙂


userprofileorigin This file contains few useful information:

OPTemplate – it tells you from what kind of profile your Citrix profile was created. In that particular case I was launching Citrix session in the environment where Citrix Profile Management was configured. So my profile was created from Default user profile on server PSXA01. But if I would have already some existing/local profile on XenApp/XenDesktop server that string would be like: C:\Users\PawelSerwan. It would be the same if you would change version of Citrix Profile Management.

UTCTime – shows when Citrix user profile was created

Conflict Flags  – shows if there were some conflicts between profiles – I was not able to find info what exact conflicts count here.

Machine Name – tells you to which server user was connected when Citrix profile was created.

Machine Domain – shows domain name which server is member of.

Now let’s check what directories contain.


PendingThis directory contains 2 subfolders:

1. UPM_Profile – contains configuration, settings and data changed in current Citrix session/sessions. Those changes will be later incorporated into user Citrix profile.

2. Stamp – it contains one file with name of the server to which user Citrix profile was copied locally.

Stamp subfolder











UPM_Profile folder contains all data, settings and configuration that were defined in Active Directory Group Policy for Citrix Profile Management. This folder simply contains Citrix profile.

Hope that this short explanation of directories and files sitting inside UPM user store will be useful for you and will ease your troubleshooting of Profile Management problems.


9 thoughts on “Citrix Profile Management – User Store revealed

  1. appsense environment manager is better for enterprise, can do way more things but it’s costly


  2. hi Tomek,

    I do not have experience with AppSense but heard a lot good things about. Do you know if there is a way to get trial installation?


  3. Pawel,

    Great intro to Citrix UPM. For those of us who can’t utilize the more advanced (and costly alternatives) this is great. We’re utilizing UPM in our environment and have run across various issues where user changes aren’t being saved (small customizations such as IE/Firefox favorites) and sometimes settings that should remain persistent such as Outlook profile setup, ShoreTel communicator configuration, etc.

    I haven’t been able to trace it down so what I’ve resorted to doing is letting Citrix recreate the profile by renaming their current profile folder. It’s not a pretty or ideal fix but for whatever reason it works. I’ve tried reviewing the logs/settings files and do notice a discrepancy with regards to the last modified date. I’ve tried googling the issue but nothing points to a definitive solution.

    Thanks again for going through the UPM store information. It’s a great introductory breakdown that should provide useful for anyone having issues with UPM.

    Any plans on going over enabling logging and all the various things that can be logged? I found out a few months ago that by default that most, if not, all logging is disabled. I may dive into this myself as we’re still having various issues with our PVS target devices not rebooting properly. Its too bad I can’t join your Polish Citrix User Group!

    Hope all is well.

    Kind Regards,


  4. hi Adrian,

    Thanks for very nice comment 🙂 UPM is nice technology but it causes a lot of problems as well. One nice thing that you can try to do is to delete local profile on log off. Of course if you can do that. We had that working in one environment and it was working pretty nice. The only obstacle might be the case when you have a lot of data under %userprofile%\AppData\Local. In that case you can try to roam that information. I do not know what are the exact problems you have and with which apps but I would try to move those settings and configuration under %userprofile%\AppData\Roaming. This should do the trick.

    Regarding UPM logging I may try to write something in the next week. By default there is some logging enabled – I will post about it.

    One more time thanks for following my blog and good comments.



  5. Pingback: Weekend reading - Savage Nomads

  6. Pingback: Citrix Newsletter – March ’15 | RUMINATION

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s