Profile Management architecture
This article describes the folder structure of the user store and of the cross-platform settings store. The user store is the central location for Citrix user profiles. The cross-platform settings store is a separate location.
Important information about Profile Management stores
The structures of the user store and cross-platform settings store are described here for information purposes and to assist with localizing and troubleshooting. Follow these important recommendations, which are designed to minimize problems with profile data and maintain security:
- Do not change the structure of either store.
- Do not write files and folders directly to any part of a store. The user store is different in this respect from any redirected folders.
- Keep the user store separate from any redirected folders. You can keep them on disjoint shares of the same file server or DFS namespace, for example \\server1\profiles\%username% and \\server1\folders\%username%. This technique also makes it much easier to support Version 1 and Version 2 profiles together, and to support a single set of redirected folders shared by both profile versions.
- Users do not need to see the user store, so do not map a drive letter to it.
- Do not impose quotas on the user store. If you restrict profile size, consider excluding items rather than using a quota.
Folder structure of the user store
The user store defaults to the WINDOWS folder in the user’s home directory. This simplifies pilot installations, but for production systems, configure the user store to be a network share or (for best scalability) a DFS namespace. Supported configurations for enterprise-ready user stores are described in High availability and disaster recovery with Profile Management.
Recommendations on creating secure user stores are available in the article called Create a file share for roaming user profiles on the Microsoft TechNet website. These minimum recommendations ensure a high level of security for basic operation. Also, when configuring access to the user store, include the Administrators group, which is required to modify or remove a Citrix user profile.
Note: On Windows 7 and Windows 2008 R2 client devices, do not select the Encrypt data access check box while creating the share on Windows 2012 R2 File Server.
The folder structure of the user store at the root level is shown in this table.
| Folder | Notes |
|---|---|
| \ | The root of a profile in the user store. |
| \UPM_Profile | This folder contains files and folders from the profile. |
| \UPM_Drive_C | This folder contains any included items from outside the profile (in this case from drive C). This folder is present during upgrades from Profile Management 4.x or earlier. Managing items outside the profile is not supported in Profile Management 5.0. |
| \Pending | This folder contains the lock file, any pending files, and the stamp file if the streaming feature is in use. |
Some examples are shown in this table.
| Example Folder Name | Notes |
|---|---|
| \UPM_Profile\Data | The synchronized content of the Data folder in the user profile. |
| \UPM_Profile\AppData_upm_var | The synchronized content of the de-localized Application Data folder in the user profile. This folder is present during upgrades from Profile Management 4.x or earlier. Managing Version 1 profiles (of which Application Data is an example folder) is not supported in Profile Management 5.0. |
Pending area
The user store includes the pending area. This area is a holding area used by the streamed user profiles and active write back features. All files are synchronized from the pending area to the user store after a user logs off from their last session. New sessions download files from both the user store and the pending area, so the user always experiences an up-to-date profile.
If a server becomes unresponsive, a timeout can be set that releases files in the pending area back to the user store (if configured as part of the streamed user profiles feature).
Folder structure of the user store with multiple platforms
When using the cross-platform settings feature, multiple platforms are involved. You must define platform-specific folders to separate the profiles for each platform. Typically, you do this using Profile Management variables in the Path to user store policy (for example, using %USERNAME%\!CTX_OSNAME!!CTX_OSBITNESS! in the path).
The cross-platform settings store holds the settings for supported applications after the cross-platform settings feature is configured. You specify the name and location of the store during configuration (using the Path to cross-platform settings store policy). The store holds the subset of the user’s settings that roam between operating systems.
For example, you might want to roam settings between Windows XP and Windows 7. The platform-specific folders contain the user settings that are unique to Windows XP and Windows 7. The cross-platform settings store contains the subset of the settings that roam between these operating systems. At logon, this subset is copied into, and remains part of, the platform-specific folders. At logoff, any changes to the subset are extracted and placed back into the cross-platform settings store.
Each platform-specific folder contains standard subfolders (for example, UPM_Profile). For more information, see Folder structure of the user store. In addition, the UPM_CPS_Metadata subfolder is present. This system-created folder contains temporary settings that are shared across operating systems.
The user store and AD forests
Citrix user profiles cannot be managed across forests. They can be managed across domains in the same forest allowing multiple users with the same logon name to access the same resources in the forest. This involves uniquely identifying profiles with the %USERDOMAIN% and %USERNAME% variables in the path to the user store.
However, in this case you must use variables to disambiguate identical logon names when setting the path to the user store. To do this, append the domain name variable to the path. You must also set permissions on the user store and enable Profile Management’s Processed Groups setting using Active Directory’s Universal Groups.
You can use a manually defined system variable such as %ProfVer% to set the operating system version. Or you can use a Profile Management variable to set the operating system name, bitness, or the profile version. For examples of user store paths in AD forests, see Specify the path to the user store.
Localizing the user store
The following table provides an overview of how Profile Management localizes and de-localizes folders when profile data is moved to and from the user store. Only folder names are localized and de-localized. For example, Start menu entries and registry settings are not translated into the correct language by Profile Management.
This information is relevant only when upgrading from Profile Management 4.x or earlier, when Version 1 profiles might be present. Managing Version 1 profiles is not supported in Profile Management 5.0.
| Version 1 English Folder | User Store Folder | Full Path Relative to the User Profile |
|---|---|---|
| Accessibility
Accessories Administrative Tools Application Data Cookies Desktop Entertainment Favorites History Links Local Settings My Documents My Music My Pictures My Videos NetHood PrintHood Programs Recent Start Menu Templates Temporary Internet Files SendTo Startup System Tools |
Accessibility_upm_var
Accessories_upm_var AdminTools_upm_var AppData_upm_var Cookies_upm_var Desktop_upm_var Entertainment_upm_var Favorites_upm_var History_upm_var Links_upm_var LocalSettings_upm_var MyDocuments_upm_var MyMusic_upm_var MyPictures_upm_var MyVideos_upm_var NetHood_upm_var PrintHood_upm_var Programs_upm_var Recent_upm_vars StartMenu_upm_var Templates_upm_var TemporaryInternetFiles_upm_var SendTo_upm_var Startup_upm_var SystemTools_upm_var |
\Start Menu\Programs\Accessories
\Start Menu\Programs \Start Menu\Programs \Local Settings \Start Menu\Programs\Accessories \Local Settings \Favorites \My Documents \My Documents \My Documents \Start Menu \Local Settings \Start Menu\Programs \Start Menu\Programs\Accessories |