Citrix Workspace Cleaning Existing Workspace App



Welcome to the Citrix Discussions. Our site does not support outdated browser (or earlier) versions. To use our site, please take one of the following actions. The solution is tested and validated through the Citrix Ready HCI Workspace Appliance Program. The guide will help users deploy a turnkey, hybrid cloud, app and desktop infrastructure in a matter of hours. By enabling the HCI workspace appliance to connect to Citrix Cloud in order to automate the setup and maintenance of the Citrix Virtual Apps. Citrix Workspace App. Citrix Workspace App for Android. Citrix Workspace App for iOS. Citrix Workspace App for Windows Citrix Preview Documentation. This Preview product documentation is Citrix Confidential. You agree to hold this documentation confidential pursuant to the terms of your Citrix Beta/Tech Preview Agreement. Perform a (App Layering) Citrix Cloud Session. Click on Workspace Configuration – to check the Citrix Workspace URL. Or open the Manage welcome splash screen, you can see the link below. Open the Citrix Workspace url and logon with your credentials. The Published Apps are visible! Start – Logon to the New Citrix Cloud Desktop. There are two types of Platform Layers you can create. One for packaging layers and one for publishing layers. Since we are publishing a layer, we can select the second radio box. Specify Microsoft Hyper-V for Hypervisor, Citrix PVS for Provisioning Service and Citrix XenDesktop or XenApp for Connection Broker.

  1. Citrix Receiver Workspace
  2. Workspace App For Windows
  3. Citrix Workspace Cleaning Existing Workspace Apps
downloadReceiverCleanupUtility.zipWhy can't I download this file?This article is intended for IT administrators. If you are an end-user, please contact your support desk to run the Receiver Cleanup Utility.Receiver cleanup utility is not required while upgrading to the Receiver for Windows 4.4 or newer. Receiver for Windows 4.4 or newer can upgrade from anyolder version of Receiver without the need of using the cleanup utility.

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

DescriptionHow to Uninstall
Known Issues
How to Use
PrerequisitesContact information
How to UndoSupported Operating Systems
Additional Information

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.

How to get citrix workspace

Contact Information

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

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.

downloadRecfWin_4.4_Upgrade_Best_Practices.pdfWhy can't I download this file?Upgrade Compatibility Matrix4.4 and later 4.34.2.1004.24.1.x3.4.xReceiver 4.3.100√—————Receiver 4.2.100√√————Receiver 4.2√√√———Receiver 4.1.x√√√√——EOL versionOnline Plugin Web 12.3√—————Online Plugin 12.3√—————Consumer Version 3.4.x√√√√——Enterprise Version 3.x√MMM——

Notes:

  1. Group policy settings are retained as part of an upgrade.
  2. M = In-place upgrade is not supported.

For instructions on upgrading Citrix Receiver for Windows from 3.x to 4.x, refer to the Cookbook blog .

Upgrade from Receiver 3.x Enterprise to Receiver 4.4 or later

The Receiver Cleanup Utility is run by default as part of Graphical User Interface installation.

To run the Receiver Cleanup Utility when installing Citrix Receiver using a command line installation, run the following switch:

CitrixReceiver.exe /RCU /Silent

Note: When you upgrade Citrix Receiver for Windows from 13.x (non-Enterprise) or 4.2 to Version 4.2 or later, the /rcu switch is unnecessary and ignored.

Upgrade from Receiver 3.x Enterprise to Receiver 4.3 or earlier

Use Windows group policy to remove the older version and retain app shortcuts and other types of customization. For instruction on upgrade, refer to the Upgrade Guide.

Upgrading to the Receiver 4.x series

Upgrade from Receiver 4.1 and later to the latest Receiver 4.x and above

Note: Group policy settings are retained during this upgrade.

The following settings are retained as part of upgrade when upgrading the Citrix Receiver for Windows Version 4.x to the latest version of Citrix Receiver.

  • App shortcut management
  • Fast-connect
  • Session pre-launch
  • Device access behavior
  • Workspace control
  • File-type association
  • Security settings (https access)
  • StoreFront 3.0 theme settings
  • Auto update settings

Plug-in support

Upgrading to Citrix Receiver 4.3 or later retains supported plug-ins that are installed on the client machine.

The following plug-ins are tested for post-upgrade functionality:

  • Citrix Real Time Media Engine (RTME)
  • Microsoft VDI plug-in for Skype for Business (formerly, Lync)
  • Citrix NetScaler Gateway (AGEE)

Ntt docomo usb devices driver. The following plug-ins are not tested for post-upgrade functionality by Citrix. However, there have not been any reports of breakage:

  • VDMX
  • Tricerat
  • Thin print

Installation in user profile and upgrade

Receiver can be installed at user (each user install in their own user profile) or system level.Citrix workspace stuck on cleaning existing workspace app

Citrix Receiver Workspace


Whether Receiver was installed at user-level (installed by users in their own profiles), it is not supported to run a system-wide upgrade as administrator: every single user will have to upgrade Receiver by themselves.
If Receiver was installed system-wide, users will not be able to upgrade that installation.

Downgrading Citrix Receiver

Downgrading Citrix Receiver is not supported.

If attempted at your own risk, ensure that the existing Version of Citrix Receiver is completely uninstalled before installing the older version.

You can use the Receiver Cleanup Utility for a clean uninstall.

Unsupported upgrade to Receiver 4.x

For Citrix Receiver versions that have reached end-of-life (EOL), are SUPPORTED for in-place upgrades, or that are not shown in Table 1, the recommended upgrade procedure is as below:

Workspace App For Windows

  1. Record the existing customization to manually reconfigure it after the upgrade.

  2. Run the Receiver Cleanup Utility (see Knowledge Center article CTX137494 ) to remove the older version of Citrix Receiver completely.

  3. Install the latest Citrix Receiver for Windows available at https://www.citrix.com/downloads/citrix-receiver.html.

  4. Reconfigure the necessary customization recorded in Step 1 above.

Citrix Workspace Cleaning Existing Workspace Apps


Note: You may need to use 'Receiver Clean-Up Utility' as needed especially when problem occur during Receiver uninstall or when unexpected issues occur after install, regardless of the Receiver version you use.