Citrix Workspace Cleanup Utility

The Citrix developers have – finally – released a tool that can help many admins with deploying the Citrix Client in their environment.

  • Download Citrix Workspace App, Citrix ADC and all other Citrix workspace and networking products. Receive version updates, utilities and detailed tech information.
  • The Receiver Clean-Up Utility creates a backup of all Citrix registry keys in the file ReceiverLogsRegBackup.reg before running any clean-up and deletion process. To undo the changes: Reinstall Receiver for Windows Import the RegBackup.reg file to restore settings.

How to Use the Citrix Receiver Clean Up Utility. Sometimes if you re-install or update the Citrix Receiver you might experience strange behaviour. In that case we recommend to manually uninstall the Citrix Receiver by using the Citrix Receiver Clean Up Utility that you can download on this page.

The Citrix Receiver CleanUp Utility should remove traces from all previous versions of the Receiver and also older versions called Citrix Online Plugin.

See here a full Download List of all Citrix Clients versions
There was a serious need for this tool since a lot of issues have been found when installing Citrix Receiver, when older versions or traces of it are still installed.
I have received more than 10.000 (!) hits on this article so far, so it is safe to state that the majority of Citrix admins and users were and are struggling with the installation/configuration/uninstallation of the latest Citrix clients (Receiver).

Issues encountered when traces traces from older versions are found:

The following issues have been encountered:

Land

  • An error message after launching an application caused by older registry keys.
  • 2 different icons in the system tray.
  • Both pnamain.exe and receiver.exe loaded at the same time.
  • Missing options after right clicking the icon in the system tray.
  • Sudden occurences of no application being lauched after clicking it.
  • No information/warning that older clients have been detected, and no option to uninstall it automatically.
  • Pass-through Authentication randomly or not at all working.

Unfortunately it does not uninstall all existing Citrix Clients on a pc, it merely cleans up registry keys and files. There is an option to backup the keys and files, and to run things silently.

So the administrators still need to write scripts to launch the uninstall application, which is since then last years the executable, which sounds like a virus, TrolleyExpress.exe.
Depending on the version and 32 or 64-bit the TrolleyExpress.exe is found in a different location.

A real pity because there is a great need of a tool that does the uninstallation silently, and without reboot. We hope Citrix is working on that…

Since Citrix doesn’t have a tool somebody else wrote one already some time ago: A great free tool to help uninstall ALL previous versions is UNICA from Gourami: http://www.gourami.eu/products/unica.html

With a simple command line it is possible to uninstall and install your client. “UNICA searches the uninstall information of a workstation for every product which was released by Citrix and uninstalls it. UNICA waits till everything is finished uninstalling, and then launches the installation command line for deploying the new client.

A downside of the tool is the following: “Because UNICA uninstalls every product that is released by Citrix, it also uninstalls the presentation server console“. Aparantly Citrix GoToMeeting is not uninstalled (at least the version I had) but that probably doesn’t count for other Citrix apps.

Note it does not run on servers, just in case somebody accidentally runs it on a Citrix server, your Citrix XenApp is not uninstalled from your server.
I found it very useful, and a time saver.

So the Citrix Receiver CleanUp Utility is a tool to run after the uninstallation of before the installation of the Citrix Client.

Citrix Receiver CleanUp Utility Download

Direct Download: ReceiverCleanupUtility.zip (Direct link will change when new version is released)>
Backup Download – version 2.2.0.1 : ReceiverCleanupUtility.exe
Backup Download – version 2.1.0.4 : ReceiverCleanupUtility.exe
Backup Download – version 1.0.3.10: ReceiverCleanupUtility.exe
Backup Download – version 1.0.3.8: ReceiverCleanupUtility.exe

A note that might disappoint some readers: Windows XP nor Vista are NOT supported. I tested and nothing happens when running on vista.

Citrix is continously updating and improving the tool, so do check if there is a new version.
The latest versions have received the following updates:

• Auto upload of Receiver Clean-Up utility logs to Citrix.
• Name of log files updated.
• Bug fixes
• New OS versions support (Windows 8.1/Vista/XP)

Prerequisites

Supported Operating Systems (32- and 64-bit unless noted). Windows 2012 + Windows 2012R2 is not mentioned, but it is assumed to work on there as well, since it shares the code with Window 8/8.1

  • Windows 8.1
  • Windows 7
  • Windows 2008 R2 64-bit
  • Windows Vista

So what does the Receiver Cleanup exactly?

  • The following processes will be terminated before the utility begins to remove Receiver:

pnamain.exe
ssonsvr.exe
selfservice.exe
selfserviceplugin.exe
receiver.exe
updater.exe
wfcrun32.exe
wfica32.exe
concentr.exe
radeobj.exe
ARPriv service (Citrix Receiver Install Helper Service)
Redirector.exe

  • Files and Directories

The utility deletes the following files and directories if they are available:

%programdata%MicrosoftWindowsStart MenuProgramsStartupReceiver.lnk
%programdata%MicrosoftWindowsStart MenuProgramsStartupOnline plug-in.lnk
%programdata%MicrosoftWindowsStart MenuProgramsCitrixOnline plug-in.lnk
%programdata%MicrosoftWindowsStart MenuProgramsCitrixReceiver.lnk
%appdata%ICAClient
%appdata%CitrixReceiver
%appdata%CitrixAuthManager
%appdata%CitrixSelfService
%systemdrive%usersdefaultappdatalocalcitrixreceiver
%systemdrive%usersdefaultappdatalocalcitrixSelfService
%systemdrive%usersdefaultappdatalocalcitrixAuthManager
%localappdata%CitrixReceiver
%localappdata%CitrixAuthManager
%localappdata%CitrixSelfService
%programfiles%citrixICA client
%programfiles%citrixauthmanager
%programfiles%citrixselfserviceplugin
%programfiles%citrixReceiver

  • User Profiles

The Receiver folder for all user profiles except for the currently logged in user will be deleted.

  • Registry Values

The utility deletes the following registry values and keys if they exist:

HKLMSoftwareMicrosoftWindowsCurrentversionRun Value:ConnectionCenter
HKLMSoftwareMicrosoftWindowsCurrentversionRun Value:CitrixReceiver
HKCRica
HKCRwfica
HKCRWinFrameICA
HKCRMimeDatabaseContent Typeapplication/x-ica
HKCRInstallerUpgradeCodes9b123F490B54521479D0EDD389BCACC1
HKCRCLSID that starts with {238F
HKCR that starts with citrix.icaclient
HKCUSoftwareCitrixICA Client
HKCUSoftwareCitrixPNAgent
HKCUSoftwareCitrixDazzle
HKCUSoftwareCitrixPrinterProperties
HKCUSoftwareCitrixReceiver
HKCUSoftwareCitrixXenDesktopDesktopViewer

Entries in HKLMSoftwareClassesInstallerProducts that relate to the following: SSONWrapper and PNAWrapper components

HKLMMicrosoftWindowsCurrentVersionUninstallCitrixOnlinePluginFull
HKLMMicrosoftWindowsCurrentVersionUninstallCitrixOnlinePluginPackWeb
HKLMSoftwareCitrixAuthManager
HKLMSoftwareCitrixCitrixCAB
HKLMSoftwareCitrixDazzle
HKLMSoftwareCitrixICA Client
HKLMSoftwareCitrixReceiverInside
HKLMSoftwareCitrixPNAgent
HKLMSoftwareCitrixPluginPackagesXenAppSuite
HKLMSoftwareCitrixXenDesktopDesktopViewer
HKLMSoftwareCitrixInstall{94F321B9-45B0-4125-970D-DE3D98CBCA1C}
HKLMSoftwareCitrixInstallICA Client
HKLMSoftwareCitrixInstallPNAgent
HKLMSoftwareCitrixInstallDesktopViewer
HKLMSoftwareCitrixInstallReceiverInsideForOnline
HKLMSoftwareCitrixInstallMUI
HKLMSoftwareCitrixReceiver
HKLMSoftwareCitrixInstall{70755658-255B-4EA6-BF8F-7188BDCFF7D0}
HKLMSoftwareCitrixInstallSSON
HKLMSoftwareMicrosoftWindowsCurrentVersionUninstallCitrixOnlinePluginFull
HKLMSystemCurrentControlSetServicesPnSson
HKLMSystemControlSet001ServicesPnSson
HKLMSystemControlSet002ServicesPnSson
HKLMSoftwareMicrosoftWindowsCurrentversionInstallerUserDataS-1-5-18ComponentsAAC19809250CF4140B060EBD01517B77

Citrix Removal Tool Free

Citrix

Entries in:

Citrix Cleanup Utility Windows 10

HKLMSoftwareMicrosoftWindowsCurrentVersionInstallerUserData
HKLMSoftwareClassesInstallerProducts
HKLMSoftwareMicrosoftWindowsCurrentVersionUninstall
HKCRInstallerProducts

For the following:

Online Plug-in
Citrix Receiver(DV)
Citrix Receiver(PNA)
Citrix Receiver (HDX Flash Redirection)
Citrix Receiver(SSON)
Citrix Receiver(USB)
Citrix Receiver(Aero)
Citrix Online plug-in (PNA)
Citrix Online plug-in (SSON)
Citrix Receiver Inside
Citrix online plug-in (web)
Citrix online plug-in (PNA)
Citrix online plug-in (USB)
Citrix online plug-in (HDX)
Citrix online plug-in (DV)
Self-service plug-in
Citrix Authentication Manager
Citrix Receiver Updater and Citrix offline plug-in components

Citrix Receiver Cleanup Tool Download

The following registry keys are modified by the utility to remove PnSson provider from the Provider Order value:

HKLMSystemControlSet001ControlnetworkproviderHwOrder
HKLMSystemControlSet001ControlNetworkProviderOrder
HKLMSystemControlSet002ControlnetworkproviderHwOrder
HKLMSystemControlSet002ControlnetworkproviderOrder
HKLMSystemCurrentControlSetControlnetworkproviderHwOrder
HKLMSystemCurrentControlSetControlnetworkproviderOrder

The following entries in the HKEY_USERS registry for each user on the machine will be removed:

SoftwarecitrixAuthManager

SoftwarecitrixCitrixCAB
SoftwarecitrixICA Client
SoftwarecitrixDazzle
SoftwarecitrixReceiver
SoftwareCitrixReceiverInside
SoftwareCitrixPluginPackages
SoftwarecitrixPrinterProperties
SoftwarecitrixPNAgent
SoftwarecitrixProgram Neighborhood Agent

I have problems with cached Receiver files/directories/icons. How do I clean them up or reset the receiver settings?

The newer versions of Receiver have the option to RESET RECEIVER settings. Very nicely hidden in About Citrix receiver > Reset Citrix Receiver


Basically the executuable cleanup.exe will run, and removes the settings from the current store you had configured.

Run the following commands:

C:Program Files (x86)CitrixSelfServicePluginCleanUp.exe –cleanUser
Note: ‘U’ must be capitalized in the parameter

Reset Citrix Receiver To Default Settings

Adding the following switch allows for silent execution without pop-up:
-cleanUser -silent

Resetting Receiver to factory defaults removes the following items:

Citrix Workspace Cleanup Utility Software

  • All accounts and stores
  • All apps delivered by the Self-Service Plug-in, along with their icons and registry keys
  • All file type associations created by the Self-Service Plug-in
  • Cached files and saved passwords
  • Per-user registry settings that are user preferences and, for per-machine installations, all user-specific registry settings
  • Access Gateway registry settings for Receiver

Citrix Workspace Cleanup Utility Pro

Resetting Receiver does not impact the following items:

Citrix Workspace App Uninstall Utility

  • Receiver or Plug-in installation
  • Per-machine ICA lockdown settings
  • GPOs