Citrix Workspace Cleanup Utility



Issue(s)

The Citrix Workspace app desktop clean-up tool allows you to delete the desktop shortcuts that remain after you uninstall Citrix Workspace app for Windows (Store). The Citrix Workspace app desktop clean-up tool is available for download from here.You can run this tool using the command line interface. Apr 15, 2020 Try the following to resolve local client issues with Citrix Workspace App (former Citrix Receiver client): Run the Citrix Receiver Cleanup utility to fully uninstall the existing Citrix Receiver installation. If you are running a Citrix Receiver or Workspace App later than 4.4 version, the Citrix Cleanup Utility is not required.

You cannot launch apps or desktops via the Citrix Workspace App. After investigation with the hosted operations team of the Citrix deployment, all logs and error codes point to the local Citrix Workspace app installation.

Resolution

Try the following to resolve local client issues with Citrix Workspace App (former Citrix Receiver client):

  1. Run the Citrix Receiver Cleanup utility to fully uninstall the existing Citrix Receiver installation. If you are running a Citrix Receiver or Workspace App later than 4.4 version, the Citrix Cleanup Utility is not required.
  2. Afterwards deploy to the latest Citrix Workspace App client version (either CR or LTSR version). Consult the following Citrix Tech Zone page for detailed instructions on Citrix Workspace App deployment.
  3. Update all web browsers to the latest version
  4. Check any browser add-ons which may be interfering and disable them temporarily
  5. Check your local network connectivity to the Internet via ISP. Check network latency and bandwidth.
  6. Uninstall any interfering software (antivirus, antispyware, antimalware)
  7. Add Citrix Workspace app processes and executables to the exclusions list of the local software firewalls
  8. Create a new windows local profile and try again from that profile.
  9. Check event logs and make use of the Citrix Receiver diagnostics tool.

You can find more detailed guidance and step-by-step procedures for analyzing and troubleshooting Citrix Virtual Apps and Desktops organized by category in my Citrix Virtual Apps and Desktops Troubleshooting e-book.

Was this article helpful?

YesNo
downloadWhy can't I download this file?

Applicable Products

  • Citrix Workspace App
  • Receiver for Windows

Objective

This article is intended for Citrix administrators and technical teams only.
Non-admin users must contact their company’s Help Desk/IT support team and can refer to CTX297149 for more information.
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

Run the following tool: CTX137494 - Receiver Clean-Up Utility

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 Cleanup Utility

Citrix Workspace Cleanup Utility Windows 10

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

    • For 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
  3. Repeat everything mentioned in preceding Step 2 for the C:UsersDefault folder as well (C:Documents and SettingsDefault 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%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.

  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
    • InstallerUpgradeCodes9B123F490B54521479D0EDD389BCACC1
    • MimeDatabaseContent Typeapplication/x-ica
    • Wfica
    • WinFrameICA
    • ICA Client
  2. Navigate to HKEY_CURRENT_USER and delete the following in SOFTWARECitrix if they exist:
    • ICA Client
    • PNAgent
    • Dazzle
    • PrinterProperties
    • Receiver
    • XenDesktopDesktopViewer
  3. 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
  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_MACHINESoftwarePoliciesCitrixICA Client
    • HKEY_CURRENT_USERSoftwarePoliciesCitrixICA Client
    • On 64-bit systems, ensure that the HKEY_LOCAL_MACHINESoftwareWow6432NodePoliciesCitrixICA Client key does not exist either.
  5. 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
  6. Repeat everything in Step 5 in the key: HKEY_USERS.DEFAULTSoftwareCitrix

Additional Resources

Citrix Cleanup Utility Windows 10

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.

Windows Cleanup Utility

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.

Disclaimer

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.