Citrix Workspace app is the new universal app for all workspace services, that will encompass all Citrix clients and app capabilities over time.
Under certain circumstances, uninstalling older versions of Receiver for Windows may leave some files behind on the computer and in the registry.This article can also be used as reference to completely clean a system after uninstalling a legacy ICA Client or Citrix Online Plug-in version.
Note: If you plan to install a currently supported version of Receiver for Windows on the system (version 4.4 or later) then there is no need to perform these manual steps or run the clean-up utility. As per article CTX136410, Receiver for Windows 4.4 and later no longer require the separate Clean-Up Utility before installing or upgrading over a previously installed version of Receiver for Windows.
Instructions
After uninstalling Receiver and restarting the system, the following steps guide to remove any unnecessary files manually that might have been left on the client system.
Citrix Workspace Replace Receiver Lock
It is important to remember that certain items mentioned in the following section might not exist on your system depending on the Receiver package used for the installation and how the package was deployed, for example per-machine against per-user installation.
More information on this is available in the Receiver and Plug-ins section of the Citrix eDocs for your version.
Following are the steps for cleaning up the file system:
On the system in use, show all hidden system files and folders (Explorer's Tools > Folder Options menu item).
In the %userprofile%AppData folder
Delete the ICAClient folder if it exists.
If the Program Neighborhood Agent was present on the system, the following folder might also exist and should be deleted:
CitrixPNAgentFor more recent Citrix Receiver releases, remove the following folders in AppData if they exist:
- CitrixReceiver
- CitrixAuthManager
- CitrixSelfService
On Windows 7, the files and folders mentioned in the preceding must be deleted in both of the following locations:
- AppDataLocal
- AppDataRoaming
Repeat everything mentioned in preceding Step 2 for the C:UsersDefault folder as well (C:Documents and SettingsDefault User on Windows XP).
If they exist, ensure the following folders are removed from the directory in which the Receiver was installed. For example, the default install directory is %programfiles%Citrix (%programfiles(x86)%Citrix on 64-bit systems).
- %programfiles%CitrixICA Client
- %programfiles%CitrixAuthManager
- %programfiles%CitrixSelfServicePlugin
Complete the following steps to clean up the system registry:
Caution! Refer to the Disclaimer at the end of this article before using Registry Editor.
After uninstalling Receiver and restarting the system, the following steps guide to remove any unnecessary files manually that might have been left on the client system.
Citrix Workspace Replace Receiver Lock
It is important to remember that certain items mentioned in the following section might not exist on your system depending on the Receiver package used for the installation and how the package was deployed, for example per-machine against per-user installation.
More information on this is available in the Receiver and Plug-ins section of the Citrix eDocs for your version.
Following are the steps for cleaning up the file system:
On the system in use, show all hidden system files and folders (Explorer's Tools > Folder Options menu item).
In the %userprofile%AppData folder
Delete the ICAClient folder if it exists.
If the Program Neighborhood Agent was present on the system, the following folder might also exist and should be deleted:
CitrixPNAgentFor more recent Citrix Receiver releases, remove the following folders in AppData if they exist:
- CitrixReceiver
- CitrixAuthManager
- CitrixSelfService
On Windows 7, the files and folders mentioned in the preceding must be deleted in both of the following locations:
- AppDataLocal
- AppDataRoaming
Repeat everything mentioned in preceding Step 2 for the C:UsersDefault folder as well (C:Documents and SettingsDefault User on Windows XP).
If they exist, ensure the following folders are removed from the directory in which the Receiver was installed. For example, the default install directory is %programfiles%Citrix (%programfiles(x86)%Citrix on 64-bit systems).
- %programfiles%CitrixICA Client
- %programfiles%CitrixAuthManager
- %programfiles%CitrixSelfServicePlugin
Complete the following steps to clean up the system registry:
Caution! Refer to the Disclaimer at the end of this article before using Registry Editor.
Using Registry Editor, navigate to the HKEY_CLASSES_ROOT key and delete the following keys if they exist:
- Citrix.ICAClient* (delete all instances that exist – such as Citrix.ICAClient.2 or Citrix.ICAClient.2.1)
- Citrix.ICAClientProp* (delete all instances – such as Citrix.ICAClientProp.2 or Citrix.ICAClientProp.2.1 might exist)
- ica
- In the CLSID key, delete any keys whose names begin with 238F
- InstallerUpgradeCodes9B123F490B54521479D0EDD389BCACC1
- MimeDatabaseContent Typeapplication/x-ica
- Wfica
- WinFrameICA
- ICA Client
- Navigate to HKEY_CURRENT_USER and delete the following in SOFTWARECitrix if they exist:
- ICA Client
- PNAgent
- Dazzle
- PrinterProperties
- Receiver
- XenDesktopDesktopViewer
Navigate to HKEY_LOCAL_MACHINESOFTWARE and delete the following keys if they exist (these keys are located in HKEY_LOCAL_MACHINESOFTWAREWow6432Node on 64-bit systems):
- CitrixAuthManager
- CitrixCitrixCAB
- CitrixDazzle
- CitrixICA Client
- CitrixReceiverInside
- CitrixPNAgent
- CitrixPluginPackagesXenAppSuite
- CitrixXenDesktopDesktopViewer
- In CitrixInstall, delete the following keys if they exist:
- {94F321B9-45B0-4125-970D-DE3D98CBCA1C}
- ICA Client
- PNAgent
- DesktopViewer
- ReceiverInsideForOnline
- MUI
- Depending on the Receiver package installed, delete one of the following keys in MicrosoftWindowsCurrentVersionUninstall if they exist:
- CitrixOnlinePluginFull
- CitrixOnlinePluginPackWeb
After uninstalling the Receiver software, any custom Receiver-side registry keys that icaclient.adm created remain in the registry as well. If you reinstall Receiver, these policies might be enforced possibly causing unexpected behavior. If you want to remove these customizations as well, delete the following ICA Client keys:
- HKEY_LOCAL_MACHINESoftwarePoliciesCitrixICA Client
- HKEY_CURRENT_USERSoftwarePoliciesCitrixICA Client
- On 64-bit systems, ensure that the HKEY_LOCAL_MACHINESoftwareWow6432NodePoliciesCitrixICA Client key does not exist either.
For each user's registry hive in HKEY_USERS, delete the following keys in SOFTWARECitrix if they exist (example HKEY_USERSS-1-5-18SoftwareCitrix):
- ICA Client
- Dazzle
- Receiver
- PrinterProperties
- PNAgent
- Program Neighborhood Agent
Repeat everything in Step 5 in the key: HKEY_USERS.DEFAULTSoftwareCitrix
Additional Resources
Citrix recommends you to restart the system after editing the registry.The number of items, their locations and names mentioned in this article might change in subsequent releases of the Receiver for Windows.
CTX121917 - How to Remove Legacy ICA Clients for Windows Using MSI or EXE Command-line Parameters
Refer Receiver and Plug-ins section of the Citrix eDocs.