Citrix Receiver Updates Troubleshooting Guide

Citrix Receiver Updates Troubleshooting Guide

book

Article ID: CTX226779

calendar_today

Updated On:

Description

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.

 

 


 

Where to download ?

Certain legacy Citrix tools are now available on request only. Please submit the request here - https://forms.gle/obA39PEz5qpDiSPq8

Once we verify your request, we will provide access to the download location. 

 


 

 

 

For information about configuring Receiver Updates, see Configuring Receiver Updates in Citrix product documentation.

Update: Citrix Receiver for Mac  12.9.1 contains the fix for Auto Update.

Note: Review CTX234657 to resume Auto Update and fix the "Problem Checking for updates" error displayed in Citrix Receiver Updater. 

There are three sections in this document:

Section 1: Key Citrix Receiver Updates settings for troubleshooting

Section 2: Citrix Receiver Updates Logging

Section 3: Troubleshooting Citrix Receiver Updates

Section 1: Key Citrix Receiver Updates settings for troubleshooting

You can configure Citrix Receiver Updates as follows:

  1. Right-click the Citrix Receiver for Windows icon in the notification area.
  2. Select Advanced Preferences, and click Auto Update. The Citrix Receiver Updates dialog appears.

By default, the Yes, notify me option is enabled.

User-added image

If an administrator manages the user account or if an user is under a company policy, the Receiver Updates options might be set according to the administrator-specified settings.

This is the only setting for Citrix Receiver Updates that is available for an end-user modification.

Citrix Receiver Updates rollout period:

Citrix Receiver Updates rollout do not happen to all users on same day or at the same time. It depends on the delivery period and delay groups. Ideally delivery period is 30 days. So, users will get Receiver and related plug-ins updates any day between Day-01 and Day-60.

Note: The delivery period varies depending on whether CWA is LTSR or Current Release (CR). LTSR: 60 days, CR: 14 days.

Based on the delay group settings, updates are available at the beginning, the middle, or the end of the delivery period.

The delay groups are categorized as follows:

  1. Fast – Update rollout happens at the beginning of delivery period.
  2. Medium – Update rollout happens at mid-delivery period. (When it past 40% of the defined delivery date. 24 days with LTSR, 6 days with CR)
  3. Slow – Update rollout happens at the end of delivery period. (When it past 90% of the defined delivery date. 54 days with LTSR, 13 days with CR)

Citrix Receiver Updates can be configured to deliver only updates marked for Long Term Support Releases (LTSR) or Current Releases (CR). The default is to accept CR updates.

These settings can be configured during Citrix Receiver for Windows installation, or using the Group Policy Object administrative template, or the StoreFront Account.

The registry location for each of these methods is:

  1. Install Time:  HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\ICA Client\AutoUpdate\Commandline Policy
  2. GPO:  HKEY_LOCAL_MACHINE\SOFTWARE\[WOW6432Node]\Policies\Citrix\ICA Client\AutoUpdate
  3. StoreFront: HKEY_CURRENT_USER\SOFTWARE\Citrix\Receiver\SR\Store\<some random number>\Properties

The relevant registry values to examine are:

For Install Time and GPO configured settings

Value: Auto-Update-Check

possible data:

Auto” (default) – perform auto updates,
 “Manual” – updates are only fetched when the user makes a check request from the Receiver menu,
 “Disabled” – no updates checks will be made.

Value : Auto-Update-LTSR-Only

                  possible data:

True” – the updater will ignore any updates that are not marked as being LTSR valid,     
False” (default)  - the updater will accept any updates.

Value :  Auto-Update-Rollout-Priority

          possible data:

"Fast” – updates will be accepted towards the beginning of the delivery period,
Medium” – updates will be accepted towards the middle of the delivery period,
Slow”– updates will be accepted towards the end of the delivery period.

For StoreFront Account configured settings

Value: Enable

possible data:

 ” True” (default) – perform auto updates,
 “False” – updates are only fetched when the user makes a check request from the Receiver menu

Value : LTSROnly

possible data:

True”  – the updater will ignore any updates that are not marked as being LTSR valid 
False” (default)  - the updater will accept any updates.

Value : BucketId

possible data:

"Fast” – updates will be accepted towards the beginning of the delivery period,
Medium” – updates will be accepted towards the middle of the delivery period,
Slow”  – updates will be accepted towards the end of the delivery period.

Section 2: Citrix Receiver Updates Logging

Before you troubleshoot any issues with the Citrix Receiver Updates functionality, enable logging for Citrix Receiver Updates.

In Citrix Receiver for Windows Version 4.9, Citrix Receiver Updates logging is disabled by default.
In Citrix Receiver for Windows Version 4.8, Citrix Receiver Updates logging is enabled by default.

Citrix Receiver Updates logs can be found at /%temp%/<CitrixAutoUpdate _.log>

To enable Citrix Receiver Updates logging using the registry editor:

  1. Launch the registry editor.

  2. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\CITRIX.
    Note: If you are an individual user, navigate to HKEY_CURRENT_USER\ SOFTWARE\Citrix.

  3. Add a new DWORD value.
    On 32-bit systems:
    HKEY_LOCAL_MACHINE\SOFTWARE\Citrix
    Name: AutoUpdateTracingEnabled
    Type: REG_DWORD
    Data: 1

    On 64-bit systems: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix
    Name: AutoUpdateTracingEnabled
    Type: REG_DWORD
    Data: 1

  4. Save and close the registry editor.

  5. Restart the Citrix Receiver for Windows session for the changes to take effect.

Section 3: Troubleshooting Citrix Receiver Updates

Check for the requirements below as part of troubleshooting Citrix Receiver Updates.

  1. If you have configured an SSL intercepting outbound proxy, you must add an exception to the Receiver Citrix Receiver Updates Signature service (https://citrixupdates.cloud.com) and the download location (https://downloadplugins.citrix.com).
  2. If the Receiver for Windows session is running on a VDA, Citrix Receiver Updates is disabled.
  3. If the Receiver for Windows is running on an end-point where the Desktop Lock component is enabled, Citrix Receiver Updates is disabled.
  4. In Citrix Receiver for Windows Version 4.8, Citrix Receiver Updates was not functioning in a proxy setup. This issue has been addressed in Version 4.9.
  5. The Citrix Receiver Updates functionality is not available when a user with administrator-level privileges has installed Citrix Receiver for Windows, and an individual user(non-admin) is accessing Citrix Receiver for Windows.

Common issue #1: Software is up-to-date:

To check for updates manually, select the Check for Updates option from the Citrix Receiver for Windows icon in the notification area. When you check for updates manually and do not find any update available, it is due to one of the following reasons:

  1. No updates are available.
  2. Your account is set to a medium or slow category in the delay group. This indicates that the update rollout happens at the middle or at the end of the delivery period.

The following dialog appears when you check for updates manually and when no updates are available.

User-added image

Solution:

You can check for updates at a later time or wait for the Citrix Receiver Updates notification.

Common issue #2: Issue when checking for update:

An update check can fail for various reasons. For example:

  1. No network connection during update check.
  2. Firewall settings don’t allow the connection to update server.

The following error message appears if there is an issue when checking for update.

User-added image

Solution:

Ensure that your network connection is working properly. Alternatively, also verify that the firewall settings are not blocking the connection to Citrix update server.

Common issue #3:  Issue when downloading the update

There is a network connection issue when checking for update or when you click the Download option.

The following error message appears if there is an issue when downloading the update.

User-added image

Solution:

Ensure that your network connection is working properly.

Common issue #4: Error during installation:

During update installation, the following issues might occur:

  1. Not enough disk space
  2. During installation, if the operating system starts with any other installation, Citrix Receiver installation turns unresponsive and the update installation fails.

The following error message appears if the Receiver Update install occurs at the same time as another install on the system.

User-added image
 

Additional Resources:

Resume auto-update for Citrix Receiver
Receiver for Mac Auto-Update Troubleshooting Guide
Citrix Receiver Auto-Update Frequently Asked Questions

Issue/Introduction

For information about configuring Citrix Receiver Updates, see Configure Auto-update in Citrix product documentation.

Additional Information

 


 

Where to download ?

Certain legacy Citrix tools are now available on request only. Please submit the request here - https://forms.gle/obA39PEz5qpDiSPq8

Once we verify your request, we will provide access to the download location.