Product Documentation

Install and uninstall Receiver for Windows manually

Aug 17, 2015

You can install Receiver from the installation media, a network share, Windows Explorer, or a command line by manually running the CitrixReceiver.exe installer package. For command line installation parameters and space requirements, see Configure and install Receiver for Windows using command-line parameters.

When you cancel the installation before completion, some components might be installed. In that case, remove Receiver with the Windows Programs and Features utility (Add/Remove Programs).

Important: The process for configuring pass-through authentication (single sign-on) changed for Receiver for Windows 4.x. For information, refer to the /includeSSON description in Configure and install Receiver for Windows using command-line parameters.

If company policies prohibit you from using an .exe file, refer to How to Manually Extract, Install, and Remove Individual .msi Files.

Manually installing and configuring Receiver for pass-through authentication

Receiver can be used in pass-through authentication scenarios with XenApp and XenDesktop. This section also describes how to install and configure CitrixReciver.exe to use pass-through authentication for a Web Interface or StoreFront server connection.

When successfully installed and configured, users can access their XenApp/XenDesktop resources without entering their credentials again. The credentials from the client machine are passed through automatically to the endpoint.

Consider the following requirements for pass-through authentication:

  • Citrix Receiver for Windows installation package is CitrixReceiver.exe.
  • Load group policy files accordingly:
    • receiver.adm (located in the %SystemDrive%\Program Files (x86)\Citrix\ICA Client\Configuration folder on a Windows machine where Citrix Receiver is installed); the receiver.adm file must be present in Windows XP, Windows 2003 and thin client.
    • receiver.admx, receiver.adml (located in the %SystemDrive%\Program Files (x86)\Citrix\ICA Client\Configuration folder on a Windows machine where Citrix Receiver is installed); to load the ADMX file to a GPO, refer to the "About ADMX Template" Usage section in Configure Receiver with the Group Policy Object template.
  • Local administrator privileges are required for the client device to allow software installation and configuration.
    Note: .adm files are only used if running XPe OS for thin client. 

There are two different deployment scenarios to achieve pass-through authentication for XenApp/XenDesktop when enterprise software deployment tools such as Citrix Merchandising Server or Microsoft System Center Configuration Manager are not used:

  1. Install Citrix Receiver manually and then configure using Local Group Policy (importing receiver.adm, receiver.admx, receiver.adml) on various machines individually.
    Note: This is recommended for very small environments.

  2. Install Citrix Receiver using Active Directory Group Policy (for example, usingCheckAndDeployCitrixReceiverEnterpriseStartupScript.bat, which is included with XenApp). Configuration using receiver.adm, receiver.admx, receiver.adml can then be applied using Active Directory Group Policy Management to a large number of machines and centrally managed.

This option is not covered in this article because of higher level of complexity. Refer to CTX134280 - How to Deploy Citrix Receiver Enterprise for Pass-Through Authentication Using Active Directory Group Policy for more information.

Note: Citrix strongly recommends that any steps outlined in this article are thoroughly tested and validated in non-production environments prior to use.

To manually install and configure Receiver for pass-through authentication:

  1. Run the following command using PowerShell on the Controller: Set-BrokerSite -TrustedRequestsSentToTheXmlServicePort $True
  2. Log on to the client machine as the user with administrative rights.
  3. Uninstall any existing installations of Online Plugin or Citrix Receiver for Windows from the client machine before starting the installation process
  4. Download Citrix Receiver for Windows Installation Package (CitrixReceiver.exe) from Citrix Downloads.

    Use the appropriate installation deployment, either using the command line, or using the GUI.

To use the command line:

  1. Open Windows Command Prompt and change directory where CitrixReceiver.exe is located.
  2. On the Command Prompt, run the following command to install Citrix Receiver with the SSON feature enabled: CitrixReceiver.exe /includeSSON.  Note the information contained in the article Configuring and Installing Receiver for Windows Using Command-Line Parameters; the parameter /includeSSON enables Single Sign-On for Receiver standard (CitrixReceiver.exe). This option is not supported for Receiver enterprise (CitrixReceiverEnterprise.exe), which installs Single Sign-On by default
  3. After installation is completed, a pop up message is displayed: “Installation completed successfully.”

    User-added image
 

To use the GUI:

  1. Double click CitrixReceiver.exe.
  2. In the Enable Single Sign-on installation Wizard, select the Enable single sign-on checkbox to install Citrix Receiver with the SSON feature enabled. This is equivalent to installing Receiver using the command line with the /includeSSON flag.
Note: The Enable Single Sign-on installation Wizard is only available for fresh (new) installations on a domain joined machine when installed by a local administrator.
localized image

Configuring SSON via Local Group Policy Editor (GPO)

By default, the group policy for SSON is to Enable pass-through authentication; this is sufficient for SSON to work when Desktop Viewer and Receiver for Web is not used.  When using Desktop Viewer, enable the GPO to Allow pass-through authentication for all ICA connections.

To use the ADM file to configure user authentication

  1. Open Local Group Policy Editor by running the command gpedit.msc or by searching for “Edit group policy” on Start.
  2. Add the receiver.adm template to the Local Group Policy Editor by selecting Computer Configuration; right-click Administrative Templates, and choose Add/Remove Templates > Click Add.
  3. After the receiver.adm template has been successfully added, expand Computer Configuration > Administrative Templates > Classic Administrative Templates (ADM) > Citrix Components > Citrix Receiver > User authentication.
Note: Depending on the StoreFront\Receiver for Web configuration and security settings, the Allow pass-through authentication for all ICA connections might have to be selected for pass-through authentication to work.
localized image

Using a ADMX file for pass-through authentication

  1. Add the receiver.admx and receiver.adml template to the Local Group Policy Editor. Refer to the "About ADMX Template Usage" section in Configure Receiver with the Group Policy Object template.
    .
  2. After successfully adding the eceiver.admx and receiver.adml template, expand Computer Configuration > Administrative Templates > Citrix Components > Citrix Receiver > User Authentication. 
  3. Select the Local user name password setting.
  4. Select Enable pass-through authentication and Allow pass-through authentication for all ICA connections options when enabling the preceding policy.
localized image

Add the Fully Qualified Domain Name (FQDN) to the Trusted Sites list

  1. On the client device, launch Internet Explorer.
  2. In Internet Explorer, click Tools > Internet Options > Trusted sites.
  3. Click Add to add a FQDN to the trusted site list (for example, https://sf1.blricat.com). Once added, the site appears in the Websites list:
localized image

After adding a website to trusted site list, select an appropriate user authentication method:

  1. In the Internet Options Security tab, select Trust Sites.
  2. Choose Custom level, security zone.
  3. Scroll to the bottom of the list and select Automatic logon with current user name and password.
  4. Restart the client device to apply the changes.
Note: The Automatic logon with current user name and password is a per-user setting; if these settings are not configured by the local administrator, each user must configure this option;  to apply this setting globally, configure a GPO by adding this value under the Custom level in both Internet and Trusted Sites.
localized image

Important Upgrade Considerations with using Single Sign-on (SSON)

The table below contains information about upgrading Receiver using the command line with SSON:

SSON installed prior to upgrade

SSON option during installation of new receiver

(CMD Line - /includeSSON or UI Option checked)

Behavior

Yes

Yes

SSON Components Upgraded

Registry Key created

SSON functionality works – No Action required to enable

Yes

No

SSON Components Upgraded

Registry Key created

SSON functionality works - No Action required to enable

No

Yes

SSON Components Upgraded

Registry Key created

SSON functionality disabled – User needs to uninstall receiver and install it back with SSON selected via cmdline option /includeSSON or by GUI option

No

No

SSON component not installed

Note: The Enable Single Sign-on installation Wizard is not available when upgrading an existing version of Citrix Receiver.

Remove Receiver for Windows

You can uninstall Receiver with the Windows Programs and Features utility (Add/Remove Programs).
Note: Do not use this method if Citrix Receiver Updater was used to install Receiver.

In some cases, uninstalling Receiver for Windows does not remove all component files or registry entries. If you are unable to install Receiver after uninstalling an older version, use the Receiver Clean-Up Utility to remove old files and registry entries.

If you delete Receiver-related files or registry entries just before uninstalling Receiver with Programs and Features, the uninstall might fail. The Microsoft Windows Installer (MSI) is trying to repair and uninstall at the same time. If this occurs, use Receiver to start an auto-repair. After the auto-repair completes, you can cleanly uninstall Receiver with Programs and Features.

Auto-repair occurs if there is a problem with Receiver; however, there is no Repair option in Programs and Features for Receiver. If the Receiver repair option prompts for the location of the .msi file, browse to one of these locations to find the file:

  • If installed per computer:
    • Operating system: Windows Server 2012/2008, Windows 8, Windows 7, Windows Vista

      C:\ProgramData\Citrix\Citrix Receiver\

    • Operating system: Windows 2003 and Windows XP

      C:\Documents and Settings\All Users\Application Data\Citrix\Citrix Receiver\

  • If installed per user:
    • Operating system: Windows Server 2012/2008, Windows 8, Windows 7, Windows Vista

      %USERPROFILE%\Appdata\local\Citrix\Citrix Receiver\

    • Operating system: Windows 2003 and Windows XP

      %USERPROFILE%\Local Settings\Application Data\Citrix\Citrix Receiver\

To remove Receiver using the command line

You can also uninstall Receiver from a command line by typing the following command:

CitrixReceiver.exe /uninstall

After uninstalling Receiver from a user device, the custom Receiver registry keys created by icaclient.adm remain in the Software\Policies\Citrix\ICA Client directory under HKEY_LOCAL_MACHINE and HKEY_LOCAL_USER. If you reinstall Receiver, these policies might be enforced, possibly causing unexpected behavior. To remove the customizations, delete them manually.

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