Workspace Environment Management

Migrate FSLogix profiles to Citrix Profile Management

This article shows you how to migrate user profiles from FSLogix Profile Containers to Citrix Profile Management by using the Profile Migration Tool in the Citrix WEM Tool Hub.

About the Profile Migration Tool

The Profile Migration Tool simplifies moving user profiles from different sources into the Citrix Profile Management format. It automates profile conversion and copying so that user settings are preserved.

The tool is included in the Citrix WEM Tool Hub, a set of utilities that help you configure and manage Citrix environments. For more information, see Profile Migration Tool.

Prepare for migration

Before you start:

  1. Download Citrix WEM Tool Hub to your machine
  2. Prepare the Citrix Profile Management user store

Download Citrix WEM Tool Hub

Download the WEM Tool Hub from the Citrix Cloud WEM service console.

  1. Sign in to Citrix Cloud.
  2. Open the Workspace Environment Management service.
  3. From the upper-right drop-down list, select Utilities.
  4. Under WEM Tool Hub, select Download.

    Download WEM Tool Hub

Prepare the Citrix Profile Management user store

Set up the destination profile store (Citrix Profile Management user store) and confirm that it’s accessible. You can perform this task in one of two ways:

  • Create a user store manually.

    For instructions, see Create a user store.

  • Use the User Store Creation Tool.

    This tool, also available in Citrix WEM Tool Hub, automatically creates the folder structure and sets permissions.

    User Store Creation Tool

    For more information, see User Store Creation Tool.

Migrate profiles

Follow these steps to migrate profiles:

  1. Open the Profile Migration Tool.

    Start Citrix WEM Tool Hub and select Profile Migration Tool.

    Profile Migration Tool

  2. Select the migration type.

    From the I want to migrate user profiles from… list, select FSLogix profile container.

    Source Target location

  3. Enter the FSLogix VHD location.

    In the Source section, select Browse and choose the UNC path of the network share that contains the FSLogix VHD or VHDX files.

  4. Enter the Citrix user store location.

    In the Target section, select Browse and choose the UNC path for the Citrix Profile Management user store.

  5. Verify access.

    1. Select Check access to confirm that your account has Read access to the source and Full control access to the target.
    2. If your current account lacks the necessary permissions, select Use a different account and enter credentials with the required permissions.

      Access check

  6. Specify users and groups.

    In the User profiles to migrate section, select + Select and use the Windows object picker to add users or groups.

    User selection

  7. Select the OS version.

    From the OS version list, select the Windows version of the source profiles (for example, Windows 10 or Windows Server 2022).

  8. Start the migration.

    Click Start migration. Use the progress bar and logs to monitor status.

Configure after migration

After migration completes:

  1. Install Citrix Profile Management on your machines. See Install and set up.

  2. Set up the container-based profile solution by configuring specific Profile Management policies:

    1. Enable Profile Management.
    2. Specify the user store path.
    3. Enable profile containers for the entire user profile.

      For advanced container settings, see Citrix Profile Management profile container.

  3. Disable FSLogix Profile Container on your machines. Otherwise, the Citrix container-based solution can’t work properly. Detailed steps are as follows:

    1. In Registry Editor, go to HKEY_LOCAL_MACHINE\SOFTWARE\FSLogix\Profiles.
    2. Set Enabled to 0.

Known issues

TEMP environment variable redirection

Issue: FSLogix redirects TEMP variables to a local path. This setting is saved in the profile and isn’t automatically reverted during migration.

Solution: After migration, reset the TEMP variables to the default location (for example, %USERPROFILE%\AppData\Local\Temp) by using Group Policy, WEM, or a script.

Migrate FSLogix profiles to Citrix Profile Management