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:
- Right-click the Citrix Receiver for Windows icon in the notification area.
- Select Advanced Preferences, and click Auto Update. The Citrix Receiver Updates dialog appears.
By default, the Yes, notify me option is enabled.
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-30.
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:
- Fast – Update rollout happens at the beginning of delivery period.
- Medium – Update rollout happens at mid-delivery period.
- Slow – Update rollout happens at the end of delivery period.
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:
- Install Time: HKEY_LOCAL_MACHINESOFTWAREWOW6432NodeCitrixICA ClientAutoUpdateCommandline Policy
- GPO: HKEY_LOCAL_MACHINESOFTWARE[WOW6432Node]PoliciesCitrixICA ClientAutoUpdate
- StoreFront: HKEY_CURRENT_USERSOFTWARECitrixReceiverSRStore<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:
Launch the registry editor.
Navigate to HKEY_LOCAL_MACHINESOFTWARECITRIX.
Note: If you are an individual user, navigate to HKEY_CURRENT_USER SOFTWARECitrix.Add a new DWORD value.
On 32-bit systems:
HKEY_LOCAL_MACHINESOFTWARECitrix
Name: AutoUpdateTracingEnabled
Type: REG_DWORD
Data: 1
On 64-bit systems: HKEY_LOCAL_MACHINESOFTWAREWow6432NodeCitrix
Name: AutoUpdateTracingEnabled
Type: REG_DWORD
Data: 1Save and close the registry editor.
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.
- 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).
- If the Receiver for Windows session is running on a VDA, Citrix Receiver Updates is disabled.
- If the Receiver for Windows is running on an end-point where the Desktop Lock component is enabled, Citrix Receiver Updates is disabled.
- 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.
- 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:
- No updates are available.
- 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.
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:
- No network connection during update check.
- Firewall settings don’t allow the connection to update server.
The following error message appears if there is an issue when checking for update.
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.
Solution:
Ensure that your network connection is working properly.
Common issue #4: Error during installation:
During update installation, the following issues might occur:
- Not enough disk space
- 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.
Additional Resources:
Resume auto-update for Citrix Receiver
Receiver for Mac Auto-Update Troubleshooting Guide
Citrix Receiver Auto-Update Frequently Asked Questions
andServiceRecord.log
(along with CitrixServerCommunication.log)
(Citrix Receiver Launcher/NPAPI plugin component)
~/Library/Logs/Citrix Receiver/Citrix Receiver Launcher_<time_stamp>.txt
(*) The log files for Always-on logging (for Citrix Viewer) and Session logging are the same. Viewer log files generated by Always-on logging contains only the most important logs. However, if Session logging is enabled, other logging along with the Always-on logswill be written to the log file.
You can click “Email Log Files” available in the Logging screen to zip Session/Store/Always-on/Citrix Receiver Updater log files, and send it as an attached file via email using your default email client.