Enable BitLocker on secondary drive causes Receiver installation to be corrupted

Enable BitLocker on secondary drive causes Receiver installation to be corrupted

book

Article ID: CTX219898

calendar_today

Updated On:

Description

This article is intended for Citrix administrators and technical teams only.
 
Non-admin users must contact their company's Help Desk/IT support team and can refer to CTX297149 for more information.

 

On a machine with Microsoft BItlocker data encryption on a secondary drive, while receiver is installed on primary system drive, attempting to start receiver causes Windows to attempt repair and error 2330 to be thrown.

User-added image

Resolution

1. As a prevention, enable BitLocker on the data drive before installing Receiver. Else,
before install Receiver, please ensure the data drive who will be locked sometime later has less free space than the drive where Receiver will be installed
2. For client machine who already suffered such issue, please uninstall Receiver and reinstall it to fix the issue. Because the secondary encrypted drive is already locked and invisible to Windows Installer, TARGETDIR will be set as C: drive when reinstall Receiver.

Problem Cause

The root cause is,
1.When installing Receiver,  because the encrypted drive drive has more free space than C: drive, so TARGETDIR property is set as the encrypted drive drive.
Note: TARGETDIR property is a global variable used by Windows Installer during an installation. https://msdn.microsoft.com/en-us/library/windows/desktop/aa372064(v=vs.85).aspx
2. After Receiver installation completed, BitLocker is enabled on the encrypted drive drive.
3. When launching desktop, Windows Installer will check if key path of each Receiver components is available. If this check passed, Receiver process is launched to open desktop. However, keypath of one Receiver component just equals to value of TARGETDIR equal to the encrypted drive drive.
4. As the encrypted drive was locked and became invisible to Windows Installer, Windows installer thought keypath of the Receiver component is unavailable and then try to repair Receiver installation. That's why a Windows installation dialog appears.
5. AS the encrypted drive was locked and inaccessible, the repair finally fails with MSI error 2330.
 

Issue/Introduction

The article describes a Receiver installation issue impacted by Microsoft BitLocker

Additional Information

If the TARGETDIR property is undefined, the ROOTDRIVE property is used to resolve the path. If it is not an administrative installation, or if the installer can find no network drives, the installer sets ROOTDRIVE to the local drive that can be written to having the most free space.
TARGETDIR: https://msdn.microsoft.com/en-us/library/windows/desktop/aa372064(v=vs.85).aspx
ROOTHIVE: https://msdn.microsoft.com/en-us/library/windows/desktop/aa371372(v=vs.85).aspx