Product Documentation

Configuring Citrix Receiver Updates

Nov 27, 2017

When you configure Citrix Receiver Updates from Citrix Receiver for Windows, follow the methods below in the order of priority:

  1. Group Policy Object administrative template
  2. Command line interface
  3. Advanced Preferences (per-user)

Note

You can hide all or part of the Advanced Preferences sheet available from the Citrix Receiver icon in the notification area. For more information, see Hiding the Advanced Preferences sheet.

Note

When you upgrade Citrix Receiver for Windows using Citrix Receiver Updates, the log in window does not appear.

Limitations:

  1. If you have configured an SSL intercepting outbound proxy, you must add an exception to the Receiver auto-update Signature service (https://citrixupdates.cloud.com) and the download location (https://downloadplugins.citrix.com).
  2. Your system must have access to the internet.
  3. Receiver for Web users cannot download the StoreFront policy automatically.
  4. By default, Citrix Receiver Updates is disabled on the VDA. This includes RDS multi-user server machines, VDI and RemotePC machines.
  5. Citrix Receiver Updates is disabled on machines where Desktop Lock is installed.

Configuring using the Group Policy Object administrative template

Open the Citrix Receiver Group Policy Object administrative template by running gpedit.msc.

Under the Computer Configuration node, go to Administrative Templates > Citrix Components > Citrix Receiver > AutoUpdate.

Select the Set the Delay in Checking for Update policy. This policy allows you to stage the rollout for a period.

localized image

Select Enabled, and from the Delay Group drop-down, select one of the following options:

  • Fast – Update rollout happens at the beginning of the delivery period.
  • Medium – Update rollout happens at the mid-delivery period.
  • Slow – Update rollout happens at the end of the delivery period.

Click Apply and OK to save the Policy.

In the AutoUpdate Templates section, select the Enable or Disable AutoUpdate policy.

localized image

Note

When you select Disabled, you are not notified of the available updates. This also hides the Auto Update option from the Advanced Preferences sheet.

Select Enabled and set the values as required:

  • From the Enable AutoUpdate Policy drop-down, select one of the following options:
    • Auto – You are notified when an update is available (default).
    • Manual – You are not notified when updates are available. Check for updates manually.
  • Select LTSR ONLY to get updates for LTSR only.
  • From the auto-update-DeferUpdate-Count drop-down, select a value between -1 and 30, where
    • -1  indicates that you can defer the notifications any number of times (default value=-1).
    • 0 – indicates that the Remind me later option is not displayed.
    • Any other number – indicates that the Remind me later option is displayed in that count. For example, if you set the value to 10, the Remind me later option is displayed 10 times.

Click Apply and OK to save the policy.

Configuring using the command line interface

While installing Citrix Receiver for Windows:

To configure Citrix Receiver Updates settings as an administrator using command-line settings during Citrix Receiver installation:

  • /AutoUpdateCheck = auto/manual/disabled
  • /AutoUpdateStream= LTSR/Current. Where, LTSR refers to Long Term Service Release and Current refers to the current release.
  • /DeferUpdateCount= any value between -1 and 30
  • /AURolloutPriority= auto/fast/medium/slow

For exampleCitrixReceiver.exe / AutoUpdateCheck=auto /AutoUpdateStream= Current /DeferUpdateCount=-1 / AURolloutPriority= fast

  • To configure Citrix Receiver Updates settings as a user using command-line settings during Citrix Receiver installation
    • /AutoUpdateCheck=auto/manual

For example: CitrixReceiver.exe / AutoUpdateCheck=auto

Editing Citrix Receiver Updates settings using the Group Policy Object administrative template overrides the settings applied during Citrix Receiver for Windows installation for all users.

After Citrix Receiver for Windows installation:

Citrix Receiver Updates can be configured after installing Citrix Receiver for Windows.

To use the command line:

Open Windows Command Prompt and change the directory to where CitrixReceiverUpdater.exe is located. Typically, CitrixReceiverUpdater.exe is located at CitrixReceiverInstallLocation\Citrix\Ica Client\Receiver.

You can also set the Citrix Receiver Updates command-line policy using this binary.

For example: Administrators can use all the four options:

  • CitrixReceiverUpdater.exe / AutoUpdateCheck=auto /AutoUpdateStream= Current/DeferUpdateCount=-1 / AURolloutPriority= fast

Configuring using the graphical user interface

Note

You can hide all or part of the Advanced Preferences sheet available from the Citrix Receiver icon in the notification area. For more information, see Hiding the Advanced Preferences sheet.

An individual user can override the Citrix Receiver Updates setting using the Advanced Preferences dialog. This is a per-user configuration and the settings apply only to the current user.

Right-click Citrix Receiver for Windows from the notification area.

Select Advanced Preferences and click Auto Update.

The Citrix Receiver Updates dialog appears.

localized image

Select one of the following options:

  • Yes, notify me
  • No, don’t notify me
  • Use administrator specified settings

Click Save.

Configuring Citrix Receiver Updates using StoreFront

Use a text editor to open the web.config file, which is typically located in the C:\inetpub\wwwroot\Citrix\Roaming directory.

Locate the user account element in the file (Store is the account name of your deployment)

For example: <account id=... name="Store">

Before the </account> tag, navigate to the properties of that user account:

   <properties>

       <clear />
    </properties>

Add the auto-update tag after <clear /> tag. 

A sample web.config file looks as follows: Copy

<accounts>

        <clear />

        <account id="d1197d2c-ac82-4f13-9346-2ee14d4b0202" name="F84Store"

          description="" published="true" updaterType="Citrix" remoteAccessType="None">

          <annotatedServices>

            <clear />

            <annotatedServiceRecord serviceRef="1__Citrix_F84Store">

              <metadata>

                <plugins>

                  <clear />

                </plugins>

                <trustSettings>

                  <clear />

                </trustSettings>

                <properties>

                  <property name="Auto-Update-Check" value="auto" />

                  <property name="Auto-Update-DeferUpdate-Count" value="1" />

                          <property name="Auto-Update-LTSR-Only" value="FALSE" />

                  <property name="Auto-Update-Rollout-Priority" value="fast" />

                        </properties>

              </metadata>

            </annotatedServiceRecord>

          </annotatedServices>

          <metadata>

            <plugins>

              <clear />

            </plugins>

            <trustSettings>

              <clear />

            </trustSettings>

            <properties>

              <clear />

            </properties>

          </metadata>

        </account>

auto-update-Check

This indicates that Citrix Receiver for Windows detects when an update is available.

Valid values:

  • Auto – You are notified when an update is available (default).
  • Manual –You are not notified when updates are available. Check for updates manually.
  • Disabled – The Citrix Receiver Updates is hidden and  you will not be notified when an update is available.

auto-update-LTSR-Only

This indicates that Citrix Receiver for Windows must accept updates only for LTSR.

Valid values:

  • True – Citrix Receiver Updates checks only for LTSR updates of Citrix Receiver for Windows
  • False – Citrix Receiver Updates checks for non-LTSR updates of Citrix Receiver for Windows as well.

auto-update-DeferUpdate-Count

This indicates the number of counts you can defer the notifications. The Remind me later option is displayed in the count of the set value.

Valid values:

  • -1 – indicates that you can defer the notifications any number of times (default value=-1).
  • 0 – indicates that the Remind me later option is not displayed.
  • Any other number – indicates that the Remind me later option is displayed in that count. For example, if you set the value to 10, the Remind me later option is displayed 10 times.

auto-update-Rollout-Priority

This indicates the period that you can set for the rollout.

Valid values:

  • Fast – Update rollout happens at the beginning of the delivery period.
  • Medium – Update rollout happens at the mid-delivery period.
  • Slow – Update rollout happens at the end of the delivery period.