Upgrade

Manual upgrade

If you have installed Citrix Workspace app for Windows, you can upgrade it by:

  • Downloading the Citrix Workspace app from the Citrix download page.
  • Upgrading your Citrix Workspace app using your app store.
  • Auto update to Citrix Workspace app from Citrix Receiver using Citrix Workspace Updates.

Automatic upgrade

When a new version of the Citrix Workspace app is released, Citrix pushes an update to the system that has Citrix Workspace app installed.

Note:

  • If you have configured an SSL intercepting outbound proxy, add an exception to the Workspace auto-update signature service https://citrixupdates.cloud.com/ and the download location https://downloadplugins.citrix.com/ to receive updates from Citrix.
  • Your system must have access to the internet to receive updates from Citrix.
  • By default, Citrix Workspace Updates is disabled on the VDA. This includes RDS multi-user server machines, VDI and RemotePC machines.
  • Citrix Workspace Updates are disabled on machines where Desktop Lock is installed.
  • Workspace for Web users cannot download the StoreFront policy automatically.
  • Citrix Workspace updates can be limited to LTSR updates only.
  • Citrifx 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 of the Citrix Workspace app.

Citrix Workspace Updates configuration

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 during Citrix Workspace app installation.
  3. Command line interface when Citrix Workspace app is installed on the system.
  4. Advanced Preferences (per-user)
  5. StoreFront

Configure Citrix Workspace Updates using the Group Policy Object administrative template

Open the Citrix Workspace app Group Policy Object administrative template by running gpedit.msc and navigate to the Computer Configuration node, go to Administrative Templates > Citrix Components > Citrix Workspace > Workspace Updates.

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

    localized image

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

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

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

Configure Citrix Workspace Updates 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 app 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

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

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

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