Profile Management

Migrate user store

August 6, 2024

Contributed by:

C C B

Profile Management provides a solution to migrate your user store without losing any data. This feature can be useful in cases where you want to migrate your user store to a more scalable file server.

To migrate your user store, use the Migrate user store policy along with the Path to user store policy. The Migrate user store policy lets you specify the path to the folder where the user settings (registry changes and synchronized files) were previously saved (the user store path that you previously used).

The path can be an absolute UNC path or a path relative to the home directory. In both cases, you can use the following types of variables:

System environment variables (enclosed in percent signs)
Attributes of the Active Directory user object (enclosed in hash signs)

Examples:

The folder Windows\%ProfileVer% stores the user settings in a subfolder called Windows\W2K3 of the user store (if %ProfileVer% is a system environment variable that resolves to W2K3).
\\server\share\#SAMAccountName# stores the user settings to the UNC path \\server\share\<JohnSmith> (if #SAMAccountName# resolves to JohnSmith for the current user).

In the path, you can’t use user environment variables except %username% and %userdomain%.

If this setting is disabled, the user settings are saved in the current user store.

If this setting is not configured here, the corresponding setting from the .ini file is used.

If this setting is not configured here or in the .ini file, the user settings are saved in the current user store.

After the changes to the policy settings take effect, the user settings stored in the previous user store are migrated to the current user store specified in the Path to user store policy.

To configure the migration of the user store in Group Policy, complete the following steps:

Open the Group Policy Management Editor.
Under Policies > Administrative Templates: Policy definitions (ADMX files) > Citrix Components > Profile Management, double-click the Migrate user store policy.
Select Enabled.
In the Options pane, type the user store path that you previously used.
Click OK.

For your changes to take effect, run the gpupdate /force command from the command prompt. Log off from all sessions and then log on again. For details, see https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/gpupdate.

You can also choose to configure the Profile Management policies in Citrix Studio. To do so, complete the following steps:

In the left pane of Citrix Studio, click Policies.
In the Create Policy window, type the policy in the search box. For example, type “Migrate user store.”
Click Select to open the Migrate user store policy.
Select Enabled and then type the user store path that you previously used.
Click OK.

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Was this helpful

Migrate user store

August 6, 2024

Contributed by:

C C B

August 6, 2024

Contributed by:

C C B

Migrate user store

In this article