Product Documentation

Configuring Citrix Workspace Updates

When you configure Citrix Workspace Updates from Citrix Workspace app, follow the methods below in the order of priority:

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

Note

  • When you upgrade Citrix Workspace app using Citrix Workspace Updates, the log in window does not appear.
  • With this release, HDX RTME for Windows is included in Citrix Workspace updates. You are notified of the available HDX RTME update on both the LTSR and the current release versions of Citrix Workspace app.

Limitations:

  1. If you have configured an SSL intercepting outbound proxy, you must add an exception to the Workspace 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. Workspace for Web users cannot download the StoreFront policy automatically.
  4. By default, Citrix Workspace Updates is disabled on the VDA. This includes RDS multi-user server machines, VDI and RemotePC machines.
  5. Citrix Workspace Updates is disabled on machines where Desktop Lock is installed.

Configuring using the Group Policy Object administrative template

  1. Open the Citrix Workspace app Group Policy Object administrative template by running gpedit.msc.

  2. Under the Computer Configuration node, go to Administrative Templates > Citrix Components > Citrix Workspace > Workspace Updates.

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

    localized image

  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 Workspace Updates Templates section, select the Citrix Workspace Updates policy.

    localized image

    Note

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

  7. Select Enabled and set the values as required:

    • From the Enable Citrix Workspace Update 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 on 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 Workspace app for Windows

To configure Citrix Workspace Updates settings as an administrator using command-line settings during Citrix Workspace app for Windows 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 - CitrixWorkspaceApp.exe /AutoUpdateCheck=auto /AutoUpdateStream=Current /DeferUpdateCount=-1 /AURolloutPriority=fast*

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

For example: CitrixWorkspaceApp.exe/AutoUpdateCheck=auto*

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

After Citrix Workspace for Windows installation

Citrix Workspace Updates can be configured after installing Citrix Workspace app for Windows.

To use the command line:

Open Windows Command Prompt and change the directory to where CitrixWorkspaceUpdater.exe is located. Typically, CitrixWorkspaceUpdater.exe is located at CitrixWorkspaceInstallLocation\Citrix\Ica Client\Workspace.

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

For example, Administrators can use all the four options:

  • CitrixWorkspaceUpdater.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 Workspace app icon in the notification area. For more information, see Hiding the Advanced Preferences sheet.

An individual user can override the Citrix Workspace Updates 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 Workspace app icon from the notification area.

  2. Select Advanced Preferences and click Workspace Updates.

    localized image

  3. Select one of the following options:

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

Configuring Citrix Workspace Updates 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.

    <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 attribute indicates that Citrix Workspace app 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 Workspace Updates is hidden and you will not be notified when an update is available.

auto-update-LTSR-Only

This attribute indicates that Citrix Workspace app must accept updates only for LTSR.

Valid values:

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

auto-update-DeferUpdate-Count

This attribute 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 attribute 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.