This article provides an overview of the Citrix Profile Management: Profile Containers feature including architectural changes and providing general troubleshooting guidelines. It is highly recommended that you familiarize yourself with Profile Container section of the Citrix Virtual Apps and Desktops Product Documentation  which covers feature descriptions, requirements, limitations and configuration before using this troubleshooting article.

Instructions

• Ensure the Profile container – List of folders to be contained in profile disk policy has been enabled.
• Validate the ProfileContainer.vhdx file has been created in the user’s profile on the user store.
• Confirm the volume path for the mounted VDHX is recorded at HKLM\Software\Citrix\UserProfileManager\<SID>\ProfileContainerVolumePath after disk mount. 

• Use the Windows Disk Management utility to confirm that the Citrix_UPM_Disk has been mounted to the VDA.
  • Note: Multiple VHDX files mounted to a single VDA can impact IOPS. Use Performance Monitor to review performance activity.

• Ensure the ProfileContainer.vhdx file is not in use by another session. In the Windows Event log, you will see the error code: 80070020 from the Source: Citrix Profile Management.

• Use Process Monitor to validate the user’s permission to access the VHDX file path by confirming the execution of ICACLS.exe (using CDF Trace and Procmon).

• Use Process Monitor to validate the junction point was created. Filter by the process name UserProfileManager.exe. Find the path to the junction point and you will see a SUCCESS result with the detail Control: FSCTL_SET_REPARSE_POINT.

• Use Process Monitor to validate the VHDX file mounts and dismounts successfully. Filter by the process name UPMSearchHelper.exe which is dedicated to handle VHDX files for Citrix Profile Management.
  • Note: When a user first logs, UpmSearchHelper.exe will determine if the ProfileContainer.vhdx file already exists. If not, it will create the file as seen in the screenshot below.

• To track the activity of this feature on the VDA, trace the UPM_Service provider using CDFControl.
• Junction point activity is recorded in CDF traces.