Applicable Products
- Receiver for Windows
Important Notes
This article is intended for IT administrators. If you are an end-user, please contact your support desk to run the Receiver Cleanup Utility. |
Receiver cleanup utility is not required while upgrading to the Receiver for Windows 4.4 or newer. Receiver for Windows 4.4 or newer can upgrade from anyolder version of Receiver without the need of using the cleanup utility. |
Description
The Receiver Clean-Up utility is designed to assist with the following scenarios:
- When errors occur during upgrade from an earlier version of Receiver or Online Plug-in
- When unexpected behavior or performance is experienced after upgrade from an earlier Receiver or Online Plug-in
- If Receiver upgrade is not possible due to feature incompatibility and/or a clean uninstall is required
- The Receiver Clean-Up Utility removes components, files, and registry values of Online Plug-in 11.x, 12.x, and Receiver for Windows 3.x, 4.x (Online Plugin-in 13.x, 14.x). This includes the Offline Plug-in component if installed and HDX RealTime Media Engine if installed.
Right‐click and choose “Run as Administrator” on the Citrix Receiver installation file. Take the defaults, DO NOT select “Enable Single Sign‐on” Click Finish at the end. If you use the native Citrix Receiver to access your applications go to Step 11. Citrix Receiver CleanUp Utility ReceiverCleanupUtility.zip — Zip archive, 247 KB (253505 bytes) Navigation. Citrix Workspace app is a new client from Citrix that works similar to Citrix Receiver and is fully backward-compatible with your organization’s Citrix infrastructure. Citrix Workspace app provides the full capabilities of Citrix Receiver, as well as new capabilities based on your organization’s Citrix deployment. This vid explains how to uninstall Citrix Receiver manually. Plz use this app uninstaller PRO@ if you are having.
Table of Contents
Description | How to Uninstall | Known Issues |
How to Use | Prerequisites | Contact information |
How to Undo | Supported Operating Systems | Additional Information |
How to Use the Citrix Clean-Up Utility
The Receiver Clean-Up Utility is a standalone executable file and does not require installation.
Although the Receiver Clean-Up Utility will backup Receiver registry keys before deleting them, it is recommended to back up the registry before running this tool. Go to Microsoft article How to backup and restore the Registry in Windows for backing up the registry.
Caution: Always back up the registry.
- Run the Receiver Clean-Up Utility with administrator privileges.
- Restart the machine when the utility finishes.
Note: The Receiver Clean-Up Utility can be run in unattended mode if desired using the /silent command line option.
Uninstall Citrix Receiver Manually Windows 10
C:/> ReceiverCleanupUtility.exe /silent
ReceiverLogs folder is created in the location where the utility is run and tracks all uninstall actions and results.
NOTE: In order to improve the Citrix Receiver experience, anonymous uninstall data will be sent to Citrix. To disable the collection of uninstall data, please use /disableCEIP command line parameter.
Data Modified by Receiver Clean-Up Utility
The utility terminates all Receiver processes prior to running the uninstall process. Refer to the ReadMe file included with the tool for a list of items that will be removed during the clean-up process.
How to Undo the Changes Made by Receiver Clean-Up Utility
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 and customizations in the registry.
Uninstalling Receiver Clean-Up Utility
Delete the downloaded executable and config.xml files from the current directory, and if desired delete the files in the ReceiverLogs folder.
Prerequisites
Required Security Permissions
Read, write, and modify access permissions are required for the following:
- Local machine registry (HKLM)
- Local user registry (HKCU)
- Default user profile on computer
- %programfiles%citrix on 32-bit systems or %programfiles(x86)%citrix on 64-bit systems
Known Issues
The Receiver Clean-Up Utility does not support non-Administrator users with roaming profile.
If Receiver is not installed at the default location, the Receiver Clean-Up Utility might not work properly.
Citrix Receiver Cleaner For Mac
Contact Information
Questions? Concerns? Send any feedback for this tool to supporttools@citrix.com.
Additional Information
CTX325140 - How to Remove Client Files Remaining on System after Uninstalling Receiver for Windows
CTX134237 - How to Remove Files Remaining on System after Uninstalling Receiver for Mac
Downloads - Citrix Receiver for Windows
Disclaimer
These software applications are provided to you as is with no representations, warranties or conditions of any kind. You may use and distribute it at your own risk. CITRIX DISCLAIMS ALL WARRANTIES WHATSOEVER, EXPRESS, IMPLIED, WRITTEN, ORAL OR STATUTORY, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NONINFRINGEMENT. Without limiting the generality of the foregoing, you acknowledge and agree that (a) the software application may exhibit errors, design flaws or other problems, possibly resulting in loss of data or damage to property; (b) it may not be possible to make the software application fully functional; and (c) Citrix may, without notice or liability to you, cease to make available the current version and/or any future versions of the software application. In no event should the code be used to support of ultra-hazardous activities, including but not limited to life support or blasting activities. NEITHER CITRIX NOR ITS AFFILIATES OR AGENTS WILL BE LIABLE, UNDER BREACH OF CONTRACT OR ANY OTHER THEORY OF LIABILITY, FOR ANY DAMAGES WHATSOEVER ARISING FROM USE OF THE SOFTWARE APPLICATION, INCLUDING WITHOUT LIMITATION DIRECT, SPECIAL, INCIDENTAL, PUNITIVE, CONSEQUENTIAL OR OTHER DAMAGES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. You agree to indemnify and defend Citrix against any and all claims arising from your use, modification or distribution of the code.
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
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 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
Entries in:
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
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:
- 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