Citrix Supportability Pack – UPM Configuration Check

Citrix Supportability Pack tool highlight: User Profile Manager UPM Configuration Check


The Citrix Supportability Pack was made available late last year (2015) and is meant to be a single location for all the tools you might ever need to troubleshoot an issue in your Citrix farm – and by farm, I mean any of the components of the installation:

  • XenDesktop
  • Legacy XenApp
  • Printing
  • Graphics
  • Web Interface
  • …the list goes on

Think of this as a repository containing all of the tools that all of the Citrix support engineers use on a daily basis – available to the public. For free. It’s a single zip file download and contains all of the tools as well as a readme and links to the individual support pages. Taken from the Supportability Pack download page:

Installing Supportability Pack

1. Unzip the Supportability Pack into local folder of your choice.

2. Open the README.HTML file with any web browser and begin exploring the tools catalog.  

3. You will need to one-time unzip/install of individual tools as needed prior to use. Each tool can be found in individual zip file located in the TOOLS subfolder.

How to Use the Supportability Pack

The pack can be extracted to local drive, portable drive, USB stick, etc. Once the is extracted please open the README.html in any browser to begin exploring the catalog. You can review the entire set of tools or see a filtered list based on feature or component. All the listed tools are placed into the TOOLS subfolder and need to be unzipped individually as needed.  The README.html also contain URL links to the Support documentation (CTX article) for each tool where you can learn more about them.

This post will highlight one of the easiest to use and most useful tools available when working with the Citrix Profile Management product:

Citrix Profile Management Configuration Checking Tool

Or UPMConfigCheck for short – it’s available here:

Fortunately, this tool is available as a portable PowerShell script – the only real prerequisite is PowerShell 2.0. UPMConfigCheck will query through all of the configuration points of UPM – both HDX policy as well as INI file and gather other pertinent data on configuration such as:

  • Installed Citrix software inventory
  • Group Policy Settings
  • Folder redirection settings
  • Environmental issues such as profile location, disk space, file and folder counts
  • App-V detection with recommended settings
  • ShareFile detection with recommended settings

Consider this tool to be a one-stop-shop for a UPM baseline configuration check.

How does it work?

Run it. Let it finish running. Gather the data. Fix problems. That’s really all there is to it.


This is on a XenDesktop 7.7 Server OS VDA running 2012 R2 – this is a static machine (no MCS or PVS).

UPMCheck1 UPMCheck2


UPMCheck3 UPMCheck4

Additionally, the -WriteCsvFiles parameter will output 3 CSV files containing environment data, applied policies and configuration settings for UPM.


That’s it!

So when you need to check your UPM configuration or want to double check exactly which policies are applied, give the UPM Configuration Check tool a shot – it’s easy to use and provides a wealth of great information.

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.