Configuring auto-update

When you configure auto-update 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)

Configuring using the Group Policy Object administrative template

  1. As an administrator, open the Citrix Receiver Group Policy Object administrative template by running gpedit.msc.

    • If you are applying the policy on a single computer, launch the Citrix Receiver Group Policy Object administrative template from the Start menu.
    • If you are applying the policy on a domain, launch the Citrix Receiver Group Policy Object administrative template by using the Group Policy Management console.
  2. Under the Computer Configuration node, go to Administrative Templates > Citrix Components > Citrix Receiver > AutoUpdate.

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

    Delay in checking for update

  4. 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.
  5. Click Apply and OK to save the Policy.

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

    Enable or disable AutoUpdate policy

  7. 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.
  8. Click Apply and OK to save the policy.

Configuring using the command line interface

While installing Citrix Receiver for Windows

To configure auto-update 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 example: CitrixReceiver.exe / AutoUpdateCheck=auto /AutoUpdateStream= Current /DeferUpdateCount=-1 / AURolloutPriority= fast

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

For example: CitrixReceiver.exe / AutoUpdateCheck=auto

Editing auto-update 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

Auto-update 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 auto-update command-line policy using this binary.

For example: ** Administrators can use all the four options:

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

Configuring using the graphical user interface

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

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

  2. Select Advanced Preferences and click Auto Update.

    The auto-update dialog appears.

    auto-update dialog

  3. Select one of the following options:

    • Yes, notify me
    • No, don’t notify me
    • Use administrator specified settings
  4. Click Save.

Configuring Auto-update using StoreFront

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

  2. 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>

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

    <account>

            <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 – Disable auto-update.

auto-update-LTSR-Only

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

Valid values:

  • True – auto-updates checks only for LTSR updates of Citrix Receiver for Windows
  • False – auto-update 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.

Limitations:

  1. Your system must have access to the internet.
  2. Receiver for Web users cannot download the StoreFront policy automatically.
  3. 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).
  4. By default, auto-update is disabled on the VDA. This includes RDS multi-user server machines, VDI and RemotePC machines.
  5. auto-update is disabled on machines where Desktop Lock is installed.