Profile Management 2106

Upgrade Profile Management

This article provides guidance on upgrading your Profile Management deployment by using Active Directory.

Important: It is important that you follow the order of the steps in this upgrade process. Upgrade the software on all computers only after adding the new .adm or .admx file to Group Policy. If you upgrade beforehand, log files might be stored in two locations. One contains log files for the old version and the other contains the files for the new version. This consideration particularly affects Citrix Virtual Desktops deployments.

It is also important to upgrade during a scheduled maintenance period. Or upgrade at a time when Active Directory replication allows the changes to propagate through your deployment. Typically, upgrade can take up to 24 hours.

The upgrade process involves:

  1. Creating a Group Policy Object (GPO) and adding the new .adm or .admx file to the new GPO

    - or -

    Upgrading an existing .adm or .admx file as described later in this article.

  2. Upgrading the .msi file on all computers as described later in this article.

  3. Applying the GPO.

To upgrade an existing .adm file

If any earlier version of the Profile Management .adm file exists in Group Policy, you can upgrade it by using the following procedure. All policy settings in the earlier version are preserved when you upgrade.

  1. On the domain controller, do one of the following:
    • Import the existing .adm file. The file resides in the GPO_Templates folder in the download package.
    • Copy the .admx file from the GPO_Templates folder in the download package to the C:\Windows\PolicyDefinitions folder and copy the .adml file to the C:\Windows\PolicyDefinitions\<localized folder>. For example, on English operating systems, <localized folder> is en-US.
  2. On the computer you use to configure Profile Management, open the Group Policy Object Editor.
  3. In the Group Policy Object Editor, right-click Administrative Templates and select Add/Remove Templates.
  4. Select the existing version of the Profile Management .adm file (for example, ctxprofile5.4.1), click Remove and then Close. The Administrative Templates\Citrix folder is deleted.
  5. Right-click Administrative Templates and select Add/Remove Templates again.
  6. Click Add, browse to the location of the new version of the .adm or .admx file (for example, ctxprofile5.5.0), select it, and click Close. The new file is imported but the old settings are retained.

To upgrade the .msi file

We recommend that you install the same version of Profile Management on all user devices and that you add the .adm or .admx file of that same version to each Group Policy Object on all domain controllers. Doing so prevents corruption of profile data, which might result when different user store structures (from different versions) exist.

We recommend that you upgrade all computers to the latest version of Profile Management before enabling any new setting. To check whether a setting is new in the version you are using, see Profile Management policies.

  1. Ensure that all users are logged off from the computers you want to upgrade.
  2. Install the new version of Profile Management over the existing version by running the .msi file on each computer. For more information, see Install and set up.

To upgrade the .ini file

You edit the .ini file in an earlier version of Profile Management and upgrade to a newer version. The software can detect that the file was edited and, by default, does not overwrite it. To preserve your .ini file settings, and use the new settings in the newer version, you must do one of the following:

  • Manually add the new settings from the .ini file of the newer version to your existing, edited .ini file.
  • Save a copy of the existing, edited version’s .ini file. Use the OVERWRITEINIFILES=yes command-line option to force an overwrite of the file during the upgrade. Add your saved settings to the upgraded .ini file. For example:

    msiexec /i <path to the MSI file\> /quiet [INSTALLDIR=<installation directory>] [OVERWRITEINIFILES=yes] [INSTALLPOLICYINIFILES=no]


To configure Profile Management policy through HDX, you must:

  • upgrade your Delivery Controllers. The reason is that HDX reads the Profile Management policy settings from the UserProfileManager_PowerShellSnapIn.msi file present in the XenApp and XenDesktop layout image-full\x64\Citrix Desktop Delivery Controller.
  • upgrade your VDAs to get the latest version of Profile Management.

More Resources

Upgrade Profile Management