Tools – Citrix Receiver CleanUp Utility

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

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 
Download Old Citrix Clients
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: 

  • 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 Gouramihttp://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

http://support.citrix.com/article/CTX137494

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 8
  • Windows 7
  • Windows 2008
  • Windows 2008 R2 64-bit
  • Windows 2003
  • Windows Vista
  • Windows XP

 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%\Microsoft\Windows\Start Menu\Programs\Startup\Receiver.lnk
%programdata%\Microsoft\Windows\Start Menu\Programs\Startup\Online plug-in.lnk
%programdata%\Microsoft\Windows\Start Menu\Programs\Citrix\Online plug-in.lnk
%programdata%\Microsoft\Windows\Start Menu\Programs\Citrix\Receiver.lnk
%appdata%\ICAClient
%appdata%\Citrix\Receiver
%appdata%\Citrix\AuthManager
%appdata%\Citrix\SelfService
%systemdrive%\users\default\appdata\local\citrix\receiver
%systemdrive%\users\default\appdata\local\citrix\SelfService
%systemdrive%\users\default\appdata\local\citrix\AuthManager
%localappdata%\Citrix\Receiver
%localappdata%\Citrix\AuthManager
%localappdata%\Citrix\SelfService
%programfiles%\citrix\ICA client
%programfiles%\citrix\authmanager
%programfiles%\citrix\selfserviceplugin
%programfiles%\citrix\Receiver 

  • 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:

 HKLM\Software\Microsoft\Windows\Currentversion\Run\  Value:ConnectionCenter
HKLM\Software\Microsoft\Windows\Currentversion\Run\  Value:CitrixReceiver
HKCR\ica
HKCR\wfica
HKCR\WinFrameICA
HKCR\Mime\Database\Content Type\application/x-ica
HKCR\Installer\UpgradeCodes\9b123F490B54521479D0EDD389BCACC1
HKCR\CLSID that starts with {238F
HKCR that starts with citrix.icaclient
HKCU\Software\Citrix\ICA Client
HKCU\Software\Citrix\PNAgent
HKCU\Software\Citrix\Dazzle
HKCU\Software\Citrix\PrinterProperties
HKCU\Software\Citrix\Receiver
HKCU\Software\Citrix\XenDesktop\DesktopViewer

 Entries in HKLM\Software\Classes\Installer\Products\ that relate to the following: SSONWrapper and PNAWrapper components

HKLM\Microsoft\Windows\CurrentVersion\Uninstall\CitrixOnlinePluginFull
HKLM\Microsoft\Windows\CurrentVersion\Uninstall\CitrixOnlinePluginPackWeb
HKLM\Software\Citrix\AuthManager
HKLM\Software\Citrix\CitrixCAB
HKLM\Software\Citrix\Dazzle
HKLM\Software\Citrix\ICA Client
HKLM\Software\Citrix\ReceiverInside
HKLM\Software\Citrix\PNAgent
HKLM\Software\Citrix\PluginPackages\XenAppSuite
HKLM\Software\Citrix\XenDesktop\DesktopViewer
HKLM\Software\Citrix\Install\{94F321B9-45B0-4125-970D-DE3D98CBCA1C}
HKLM\Software\Citrix\Install\ICA Client
HKLM\Software\Citrix\Install\PNAgent
HKLM\Software\Citrix\Install\DesktopViewer
HKLM\Software\Citrix\Install\ReceiverInsideForOnline
HKLM\Software\Citrix\Install\MUI
HKLM\Software\Citrix\Receiver
HKLM\Software\Citrix\Install\{70755658-255B-4EA6-BF8F-7188BDCFF7D0}
HKLM\Software\Citrix\Install\SSON
HKLM\Software\Microsoft\Windows\CurrentVersion\Uninstall\CitrixOnlinePluginFull
HKLM\System\CurrentControlSet\Services\PnSson
HKLM\System\ControlSet001\Services\PnSson
HKLM\System\ControlSet002\Services\PnSson
HKLM\Software\Microsoft\Windows\Currentversion\Installer\UserData\S-1-5-18\Components\AAC19809250CF4140B060EBD01517B77

 Entries in:

HKLM\Software\Microsoft\Windows\CurrentVersion\Installer\UserData
HKLM\Software\Classes\Installer\Products
HKLM\Software\Microsoft\Windows\CurrentVersion\Uninstall
HKCR\Installer\Products

 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  

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

HKLM\System\ControlSet001\Control\networkprovider\HwOrder
HKLM\System\ControlSet001\Control\NetworkProvider\Order
HKLM\System\ControlSet002\Control\networkprovider\HwOrder
HKLM\System\ControlSet002\Control\networkprovider\Order
HKLM\System\CurrentControlSet\Control\networkprovider\HwOrder
HKLM\System\CurrentControlSet\Control\networkprovider\Order  

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

\Software\citrix\AuthManager

\Software\citrix\CitrixCAB
\Software\citrix\ICA Client
\Software\citrix\Dazzle
\Software\citrix\Receiver
\Software\Citrix\ReceiverInside
\Software\Citrix\PluginPackages
\Software\citrix\PrinterProperties
\Software\citrix\PNAgent
\Software\citrix\Program 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

Reset Receiver in about
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)\Citrix\SelfServicePlugin\CleanUp.exe –cleanUser
Note: ‘U’ must be capitalized in the parameter

Reset Citrix Receiver To Default Settings

Reset Receiver to Default Settings

Citrix Receiver Reset

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

Resetting Receiver to factory defaults removes the following items:

  • 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

Resetting Receiver does not impact the following items:

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