Citrix Workspace App Cleanup Utility Download

by



I was tasked with getting our Citrix server Xenapp6.0 upgraded to a newer supported version but no one seems to be able to help, I requested from our supplier to see if they could help, They said to create a citrix account and log a ticket, I did that and sent them the file from 'My Files' folder, They came back and said please contact your local citrix agent. About Citrix Workspace app for Windows. Add accounts or switch servers. Customer Experience Improvement Program (CEIP) Change how desktops look and work.

  1. Download Citrix Cleanup Tool
  2. Citrix Workspace App Cleanup Utility Download
  3. Citrix Workspace Removal Utility
  4. Citrix Workspace Removal Tool

The new Citrix Workspace app (formerly known as Citrix Receiver) provides a great user experience — a secure, contextual, and unified workspace — on any device. It gives you instant access to all your SaaS and web apps, your virtual apps, files, and desktops from an easy-to-use, all-in-one interface powered by Citrix Workspace services. Detailed release notes for the Workspace App 1912 Version of the Citrix Receiver are available. Click Here to Get the Citrix Cleanup Utility. Updated June 25, 2019.

Citrix does not recommend extracting the Receiver (Enterprise) .msi files instead of running the installer packages. However, there might be times when you have to extract the .msi files from CitrixReceiver.exe or CitrixReceiverEnterprise.exe manually, rather than running the installer package (for example, company policy prohibits the usage of .exe files). If you use the extracted .msi files for your installation, using the .exe installer package to upgrade or uninstall and reinstall might not work properly.

For Citrix-recommended Receiver (Enterprise) installation methods, refer to Citrix eDocs - Configure and install Receiver for Windows using command-line parameters.

Extract the .msi files

Utility

Run the following at command prompt:

For 4.x use: CitrixReceiver.exe /extract [Destination_name, e.g. C:test ]

For 3.x use: CitrixReceiverEnterprise.exe /extract [Destination_name, e.g. C:test]
where Destination _name is a complete pathname to the directory into which the .msi files are extracted. The directory must exist already and /extract adds a subfolder called extract to that directory.

App

For example, if you create a C:test directory and run /extract, the extracted .msi files are put in C:testextract.

Note: If User Access Control (UAC) is enabled, Citrix advises that you install the .msi files in elevated mode. The .msi files are supported per-machine and require administrator privileges to deploy them.

Install the .msi files for Receiver

Use the following command line parameter:

Note: Double click installation for Receiver using individual .msi is not recommended for 4.4.x and 4.5

Install the Components:

When installing the Receiver.exe components, run the .msi files in the following order:

Download Citrix Cleanup Tool

  1. RIInstaller.msi
  2. ICAWebWrapper.msi
  3. GenericUSB.msi
  4. DesktopViewer.msi
  5. CitrixHDXMediaStreamForFlash-ClientInstall.msi
  6. Vd3dClient.msi
  7. AuthManager.msi
  8. SSONWrapper.msi
  9. SelfServicePlugin.msi
  10. WebHelper.msi

During the execution of each of these msi packages, the following command line parameters need to specified:
REBOOT=ReallySuppress MSIDISABLERMRESTART=0 MSIRESTARTMANAGERCONTROL=0 NEED_RECEIVER=n TROLLEYINSTALL=1 ALLUSERS=1

The command to execute a msi package is as follows:

msiexec /i <path to the .msi package> REBOOT=ReallySuppress MSIDISABLERMRESTART=0 MSIRESTARTMANAGERCONTROL=0 NEED_RECEIVER=n TROLLEYINSTALL=1 ALLUSERS=1

For a non-admin user installation, the parameters are as follows:

REBOOT=ReallySuppress MSIDISABLERMRESTART=0 MSIRESTARTMANAGERCONTROL=0 NEED_RECEIVER=n TROLLEYINSTALL=1 ALLUSERS='

Note: GenericUSB and SSON are not supported for non-admin users, so no need to install GenericUSB.msi and SSONWrapper.msi for non-admin user installation.

Remove the Components:

When removing the components, remove them in the following order:

  1. SelfServicePlugin.msi
  2. SSONWrapper.msi
  3. AuthManager.msi
  4. Vd3dClient.msi
  5. CitrixHDXMediaStreamForFlash-ClientInstall.msi
  6. DesktopViewer.msi
  7. GenericUSB.msi
  8. ICAWebWrapper.msi
  9. RIInstaller.msi
  10. WebHelper.msi

Each .msi file has an Add/Remove (Control Panel on Windows XP or Windows Server 2003) or Programs and Features (Control Panel on Windows Vista, Windows 7, and Windows Server 2008) entry in the following format:

Name of packageName displayed in Add/Remove or Programs and Features
RIInstaller.msiCitrix Receiver Inside
ICAWebWrapper.msiOnline Plug-in
PNAWrapper.msiCitrix Receiver (PNA)
SSONWrapper.msiCitrix Receiver (SSON)
CitrixHDXMediaStreamForFlash-ClientInstall.msiCitrix Receiver (HDX Flash Redirection)
DesktopViewer.msiCitrix Receiver (DV)
GenericUSB.msiCitrix Receiver (USB)
Vd3d.msiCitrix Receiver (Aero)
AuthManager.msiCitrix Authentication Manager
CitrixReceiverUpdater-User.msiCitrix Receiver Updater
SelfServicePlugin.msiCitrix Single Sign-On Plug-in

Note: CitrixReceiverUpdater-user.msi is not included in Citrix Receiver from version 4.3 onwards

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

Citrix Workspace App Cleanup Utility Download

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

Citrix Workspace Removal Utility

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:

Citrix Workspace App Cleanup Utility Download

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

Citrix Workspace Removal Tool

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