How to Remove Client Files Remaining on System after Uninstalling Receiver for Windows

How to Remove Client Files Remaining on System after Uninstalling Receiver for Windows

book

Article ID: CTX325140

calendar_today

Updated On:

Description

This article is intended for Citrix administrators and technical teams only.

NOTE: Receiver for Windows version 4.4 or later does not require these manual steps.
Receiver for Windows 4.4 and later no longer requires separate Clean-Up Utility before installing or upgrading over a previously installed version of Receiver for Windows See CTX136410

 Citrix Workspace app is the new universal app for all workspace services, that will encompass all Citrix clients and app capabilities over time.

Uninstalling older versions (4.4 or earlier) of Receiver for Windows may leave files behind 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. 

 

 


Instructions

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:

  1. On the system in use, show all hidden system files and folders (Explorer’s Tools > Folder Options menu item).

  2. In the %userprofile%\AppData\Roaming 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:
      \Citrix\PNAgent

    • For more recent Citrix Receiver releases, remove the following folders in \AppData\Local if they exist:

      • \Citrix\Receiver
      • \Citrix\AuthManager
      • \Citrix\SelfService
  3. Repeat everything mentioned in preceding Step 2 for the C:\Users\Default folder as well (C:\Documents and Settings\Default User on Windows XP).

  4. 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%\Citrix\ICA Client
    • %programfiles%\Citrix\AuthManager
    • %programfiles%\Citrix\SelfServicePlugin

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.

  1. 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
    • Installer\UpgradeCodes\9B123F490B54521479D0EDD389BCACC1
    • Mime\Database\Content Type\application/x-ica
    • Wfica
    • WinFrameICA
    • ICA Client
  2. Navigate to HKEY_CURRENT_USER and delete the following in  \SOFTWARE\Citrix if they exist:
    • ICA Client
    • PNAgent
    • Dazzle
    • PrinterProperties
    • Receiver
    • XenDesktop\DesktopViewer
  3. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE and delete the following keys if they exist (these keys are located in HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node on 64-bit systems):

    • Citrix\AuthManager
    • Citrix\CitrixCAB
    • Citrix\Dazzle
    • Citrix\ICA Client
    • Citrix\ReceiverInside
    • Citrix\PNAgent
    • Citrix\PluginPackages\XenAppSuite
    • Citrix\XenDesktop\DesktopViewer
    • In Citrix\Install, 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 Microsoft\Windows\CurrentVersion\Uninstall if they exist:
      • CitrixOnlinePluginFull
      • CitrixOnlinePluginPackWeb
  4. 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_MACHINE\Software\Policies\Citrix\ICA Client
    • HKEY_CURRENT_USER\Software\Policies\Citrix\ICA Client
    • On 64-bit systems, ensure that the HKEY_LOCAL_MACHINE\Software\Wow6432Node\Policies\Citrix\ICA Client key does not exist either.
  5. For each user’s registry hive in HKEY_USERS, delete the following keys in \SOFTWARE\Citrix if they exist (example HKEY_USERS\S-1-5-18\Software\Citrix):

    • ICA Client
    • Dazzle
    • Receiver
    • PrinterProperties
    • PNAgent
    • Program Neighborhood Agent
  6. Repeat everything in Step 5 in the key: HKEY_USERS\.DEFAULT\Software\Citrix

Environment

Caution! Using Registry Editor incorrectly can cause serious problems that might require you to reinstall your operating system. Citrix cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Be sure to back up the registry before you edit it.

Issue/Introduction

This article explains how to remove client files remaining on system after uninstalling Receiver for Windows.

Additional Information

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.