Product Documentation

To migrate user profiles

May 08, 2015
This topic contains instructions on turning Citrix user profiles into Windows roaming profiles. It also describes how to remove Citrix user profiles from personal vDisks (a Citrix XenDesktop feature) so Profile management can process them.

For more information on migration strategies, see Upgrading Profile Management and Migrating Profiles.

To migrate to roaming profiles

You can migrate Citrix user profiles to Windows roaming profiles at any time. This involves moving profile data to a network location where the roaming profiles will be stored. After migration, Profile management takes no part in processing user logons or application settings.
  1. Ensure all users are logged off.
  2. Remove the Profile Management Service from all of the computers that are managed by the software.
  3. In the user store, move the contents of \UPM_Profile to your roaming profile location. You do not have to move the contents of the cross-platform settings store.
  4. In addition, for Version 1 profiles only, remove the _upm_var suffix from all subfolders of \UPM_Profile.
    Note: You may find that scripting simplifies this step.

To migrate from personal vDisks

If you use the Personal vDisk feature in XenDesktop, by default user profiles are stored on the Personal vDisk's P: drive not the virtual desktop's C: drive. If instead you want Citrix Profile management (not the Personal vDisk) to process the profiles, you adjust this default when installing the Virtual Desktop Agent by modifying the Registry on the master image used for a new catalog. In this scenario, because the catalog is new, no users have logged on, so no profiles are stored on the P: drive.

Important: An alternative scenario occurs if you enable Profile management on machines in existing catalogs with Personal vDisks. Because the catalog is already in use, logons will already have taken place and profiles will be present on the P: drive (and will remain there after you modify the Registry). You must therefore adjust the default differently.

Issues that indicate the presence of profiles on P: drives while Profile management is enabled include users having to reset their wallpaper, having to reconfigure their applications, or receiving temporary profiles.

Follow these instructions to adjust the default in this alternative scenario.

  1. Schedule a maintenance downtime for the virtual machines whose profiles you want to migrate.
  2. Create a startup script (or edit your existing script) and include a command to run Delprof.exe, a profile deletion tool for Windows XP from Microsoft, or Delprof2.exe. a similar tool for later operating systems from Sepago. Follow the run command by a shutdown command:
    \\<share name>\delprof.exe /q /i 
    shutdown /s /t 0

    You can download Delprof.exe from the Microsoft Web site. For information on this tool, see http://support.microsoft.com/kb/315411.

  3. On the master image, change the following Registry setting from 1 to 0:
    Caution: Editing the registry incorrectly can cause serious problems that may require you to reinstall your operating system. Citrix cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Be sure to back up the registry before you edit it.

    HKLM\Software\Citrix\personal vDisk\Config\EnableUserProfileRedirection

  4. Update the master image's inventory.
  5. During the scheduled downtime, distribute the master image to the virtual machines, and ensure they restart. At that point, the script runs, deletes the profiles from the P: drives, and shuts down the machines.
  6. When all of the machines are shutdown, delete the startup script (or the line you added to your existing script).
  7. Start all of the machines or let users log on. From this point, profiles are stored on the virtual desktops' C: drives.
Note: To migrate profiles in the reverse direction so they are managed by the personal vDisk (not Profile management), follow these instructions but change the Registry setting of EnableUserProfileRedirection from 0 to 1. This loads the profiles on to the personal vDisk's P: drive.