• Receiver for Windows

Important Notes

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.

Table of Contents

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.

1. Run the Receiver Clean-Up Utility with administrator privileges.
2. 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.

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:

1. Reinstall Receiver for Windows
2. 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.

Contact Information

Questions? Concerns? Send any feedback for this tool to supporttools@citrix.com.

How To Run Citrix Receiver Cleanup Utility

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.

Issue(s)

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.

Citrix Workspace App Uninstall Utility

Was this article helpful?

Citrix Cleanup Utility Windows 10