Configuring application delivery

When delivering applications with Citrix Virtual Apps and Desktops, consider the following options to enhance the user experience:

  • Web Access Mode - Without any configuration, Citrix Workspace app provides browser-based access to applications and desktops. You can open a browser to a Workspace for Web or Web Interface site to select and use the applications you want. In this mode, no shortcuts are placed on the user’s desktop.
  • Self Service Mode - By adding a StoreFront account to Citrix Workspace app or configuring Citrix Workspace app to point to a StoreFront website, you can configure self-service mode, which allows you to subscribe to applications from the Citrix Workspace app user interface. This enhanced user experience is similar to that of a mobile app store. In a self-service mode, you can configure mandatory, auto-provisioned and featured app keyword settings as required.

Note

By default, Citrix Workspaces app allows you to select the applications to display in the Start menu.

  • App shortcut-only mode - As a Citrix Workspace app for Windows administrator, you can configure Citrix Workspace app to automatically place application and desktop shortcuts directly in the Start menu or on the desktop in a similar way that Citrix Workspace app Enterprise places them. The new shortcut only mode allows you to find all the published apps within the familiar Windows navigation schema where you would expect to find them.

For information on delivering applications using Citrix Virtual Apps and Desktops 7, see Create a Delivery Group application.

Note

When you upgrade or install Citrix Workspace app for Windows for the first time, add the latest template files to the local GPO.

Configuring Single Sign-on with Citrix Gateway

You enable Single Sign-On with Citrix Gateway through Group Policy Object administrative template.

  1. Open the Citrix Workspace app GPO administrative template by running gpedit.msc.
  2. Under the Computer Configuration node, go to Administrative Template > Citrix Components > Citrix Workspace > User Authentication.
  3. Select Single Sign-on for Citrix Gateway policy.
  4. Select Enabled.
  5. Click Apply and OK.
  6. Restart Citrix Workspace app for the changes to take effect.

Configuring Citrix Gateway Store

Citrix recommends using the Group Policy Object administrative template to configure rules for network routing, proxy servers, trusted server configuration, user routing, remote user devices, and user experience. You can use the receiver.admx / receiver.adml template files with domain policies and local computer policies. For domain policies, import the template file using the Group Policy Management console. This is especially useful for applying Citrix Workspace app settings to a number of different user devices throughout the enterprise. To affect a single user device, import the template file using the local Group Policy Editor on the device.

To add or specify a Citrix Gateway using 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 > Classic Administrative Templates (ADM) > Citrix Components > Citrix Workspace > StoreFront.
  3. Select Citrix Gateway URL/StoreFront Accounts List.
  4. Edit the settings.

    • Store name – Indicates the displayed store name
    • Store URL – Indicates the URL of the store
    • #Store name – Indicates the name of the store behind Citrix Gateway
    • Store enabled state –Indicates the state of the store, On/Off
    • Store Description – Provides description of the store
  5. Add or specify the Citrix Gateway URL. Enter the name of the URL, delimited by a semi-colon:

Example: HRStore #Store name;On; Store for HR staff Where #Store name is the name of store behind Citrix Gateway; dtls.blrwinrx.com is the Citrix Gateway URL

In earlier releases, when you add or remove an account using the Citrix Gateway URL/StoreFront Account List policy in the GPO, you must reset the Citrix Receiver for the changes to take effect.

Starting with Version 1808, any changes made to the Citrix Gateway URL/StoreFront Account List policy is applied in a session when you restart the Citrix Workspace app. A reset is not required.

Note

Resetting Citrix Workspace app is not required only on a fresh installation of Citrix Workspace app Version 1808 and later. In case of an upgrade to Version 1808 and later, reset the Citrix Workspace app for the changes to take effect.

Limitations

  • Citrix Gateway URL should be listed as first followed by StoreFront URL(s).
  • Multiple Citrix Gateway URLs are not supported.
  • Any change in Citrix Gateway URL requires the Citrix Workspace app to be reset for the changes to take effect.
  • Citrix Gateway URL configured using this method does not support PNA Services site behind Citrix Gateway.

Configure self-service mode

By simply adding a StoreFront account to Citrix Workspace app or configuring Citrix Workspace app to point to a StoreFront site, you can configure self-service mode, which allows users to subscribe to applications from the Citrix Workspace user interface. This enhanced user experience is similar to that of a mobile app store.

Note

By default, Citrix Workspace app allows users to select the applications they want to display in their Start menu.

In self-service mode, you can configure mandatory, auto-provisioned and featured app keyword settings as needed.

Append keywords to the descriptions you provide for delivery group applications:

  • To make an individual app mandatory, so that it cannot be removed from Citrix Workspace app , append the string KEYWORDS:Mandatory to the application description. There is no Remove option for users to unsubscribe to mandatory apps.
  • To automatically subscribe all users of a store to an application, append the string KEYWORDS:Auto to the description. When users log on to the store, the application is automatically provisioned without users needing to manually subscribe to the application.
  • To advertise applications to users or to make commonly used applications easier to find by listing them in the Citrix Workspace Featured list, append the string KEYWORDS:Featured to the application description.

Customize the app shortcut location using the Group Policy Object template

Note

You should make changes to group policy before configuring a store. If at any time you want to customize the group policies, reset Citrix Workspace app for Windows, configure the group policy, and reconfigure the store.

  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 > Self Service.
  3. Select Manage SelfServiceMode policy.
    1. Select Enabled to view the Self-service user interface.
    2. Select Disabled to subscribe to the apps manually. This option hides the Self-service user interface.
  4. Click Apply and OK.
  5. Under the Computer Configuration node, go to Administrative Templates > Citrix Components > Citrix Workspace > Self Service.
  6. Select Manage App Shortcut policy.
  7. Select the options as required.
  8. Click Apply and OK.
  9. Restart Citrix Workspace app for the changes to take effect.

Using StoreFront account settings to customize app shortcut locations

You can set up shortcuts in the Start menu and on the desktop from the StoreFront site. The following settings can be added in the web.config file in C:\inetpub\wwwroot\Citrix\Roaming in the <annotatedServices> section:

  • To put shortcuts on the desktop, use PutShortcutsOnDesktop. Settings: “true” or “false” (default is false).
  • To put shortcuts in the Start menu, use PutShortcutsInStartMenu. Settings: “true” or “false” (default is true).
  • To use the category path in the Start menu, use UseCategoryAsStartMenuPath. Settings: “true” or “false” (default is true).

Note

Windows 8/8.1 and Windows 10 do not allow the creation of nested folders within the Start Menu. Applications will be displayed individually or under the root folder but not within Category sub folders defined with Citrix Virtual Apps .

  • To set a single directory for all shortcuts in the Start menu, use StartMenuDir. Setting: String value, being the name of the folder into which shortcuts are written.
  • To reinstall modified apps, use AutoReinstallModifiedApps. Settings: “true” or “false” (default is true).
  • To show a single directory for all shortcuts on the desktop, use DesktopDir. Setting: String value, being the name of the folder into which shortcuts are written.
  • To not create an entry on the clients ‘add/remove programs’, useDontCreateAddRemoveEntry. Settings: “true” or “false” (default is false).
  • To remove shortcuts and Citrix Workspace icon for an application that was previously available from the Store but now is not available, use SilentlyUninstallRemovedResources. Settings: “true” or “false” (default is false).

In the web.config file, the changes should be added in the XML section for the account. Find this section by locating the opening tab:

\<account id=... name="Store"

The section ends with the </account> tag.

Before the end of the account section, in the first properties section:

\<properties\> \<clear /\> \</properties\>

Properties can be added into this section after the <clear /> tag, one per line, giving the name and value. For example:

\<property name="PutShortcutsOnDesktop" value="True" /\>

Note

Property elements added before the <clear /> tag may invalidate them. Removing the <clear /> tag when adding a property name and value is optional.

An extended example for this section is:

\<properties\ <property name="PutShortcutsOnDesktop" value="True" \ <property name="DesktopDir" value="Citrix Applications" \>

Important

In multiple server deployments, use only one server at a time to make changes to the configuration of the server group. Ensure that the Citrix StoreFront management console is not running on any of the other servers in the deployment. Once complete, propagate your configuration changes to the server group, so that the other servers in the deployment are updated. For more information, see StoreFront documentation.

Using per app settings in Citrix Virtual Apps and Desktops 7.x to customize app shortcut locations

Citrix Workspace app can be configured to automatically place application and desktop shortcuts directly in the Start Menu or on the desktop. This functionality was similar to previously released versions of Workspace for Windows, however, release 4.2.100 introduced the ability to control app shortcut placement using Citrix Virtual Apps per app settings. This functionality is useful in environments with a handful of applications that need to be displayed in consistent locations.

If you want to set the location of shortcuts so every user finds them in the same place use Citrix Virtual Apps per App Settings:

   
If you want per-app settings to determine where applications are placed independently of whether in self-service mode or Start Menu mode. Configure Workspace app for Windows with PutShortcutsInStartMenu=false and enable per app settings. Note: This setting applies to the Web interface site only.

Note

The PutShortcutsInStartMenu=false setting applies to both XenApp 6.5 and XenDesktop 7.x.

Configure per app settings in XenApp 6.5

To configure a per app publishing shortcut in XenApp 6.5:

  1. In the XenApp Application Properties screen, expand Basic properties.
  2. Select the Shortcut presentation option.
  3. In the Application shortcut placement portion of the Shortcut presentation screen, select the Add to the client’s Start menu check box. After selecting the check box, enter the name of the folder where you want to place the shortcut. If you do not specify a folder name, XenApp places the shortcut in the Start Menu without placing it in a folder.
  4. Select the Add shortcut to the client’s desktop to include the shortcut on a client machine’s desktop.
  5. Click Apply.
  6. Click OK.

    alt_text

Using per app settings in XenApp 7.6 to customize app shortcut locations

To configure a per app publishing shortcut in XenApp 7.6:

  1. In Citrix Studio, locate the Application Settings screen.
  2. In the Application Settings screen, select Delivery. Using this screen, you can specify how applications are delivered to users.
  3. Select the appropriate icon for the application. Click Change to browse to the location of the desired icon.
  4. In the Application category field, optionally specify the category in Citrix Workspace app where the application appears. For example, if you are adding shortcuts to Microsoft Office applications, enter Microsoft Office.
  5. Select the Add shortcut to user’s desktop checkbox.
  6. Click OK.

    alt_text

Reducing enumeration delays or digitally signing application stubs

If users experience delays in app enumeration at each logon, or if there is a need to digitally sign application stubs, Citrix Workspace app provides functionality to copy the .EXE stubs from a network share.

This functionality involves a number of steps:

  1. Create the application stubs on the client machine.
  2. Copy the application stubs to a common location accessible from a network share.
  3. If necessary, prepare a white list (or, sign the stubs with an Enterprise certificate.
  4. Add a registry key to enable Workspace for Windows to create the stubs by copying them from the network share.

If RemoveappsOnLogoff and RemoveAppsonExit are enabled, and users are experiencing delays in app enumeration at every logon, use the following workaround to reduce the delays:

  1. Use regedit to add HKEY_CURRENT_USER\Software\Citrix\Dazzle /v ReuseStubs /t REG_SZ /d “true”.
  2. Use regedit to add HKEY_LOCAL_MACHINE\Software\Citrix\Dazzle /v ReuseStubs /t REG_SZ /d “true”. HKEY_CURRENT_USER has preference over HKEY_LOCAL_MACHINE.

Caution

Editing the Registry incorrectly can cause serious problems that may require you to reinstall your operating system. Citrix cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Be sure to back up the registry before you edit it.

Enable a machine to use pre-created stub executables that are stored on a network share:

  1. On a client machine, create stub executables for all of the apps. To accomplish this, add all the applications to the machine using Citrix Workspace app; Citrix Workspace app generates the executables.
  2. Harvest the stub executables from %APPDATA%\Citrix\SelfService. You only need the .exe files.
  3. Copy the executables to a network share.
  4. For each client machine that will be locked down, set the following registry keys:
    1. Reg add HKEY_LOCAL_MACHINE\Software\Citrix\Dazzle /v CommonStubDirectory /t REG_SZ /d “\\ShareOne\WorkspaceStubs”
    2. Reg add HKEY_LOCAL_MACHINE\Software\Citrix\Dazzle /v
    3. CopyStubsFromCommonStubDirectory /t REG_SZ /d “true”. It’s also possible to configure these settings on HKEY_CURRENT_USER if you prefer. HKEY_CURRENT_USER has preference over HKEY_LOCAL_MACHINE.
    4. Exit and restart Citrix Workspace app to test the settings.

Example use cases

This topic provides use cases for app shortcuts.

Allowing users to choose what they want in the Start Menu (Self-Service)

If you have dozens (or even hundreds) of apps, it’s best to allow users to select which applications they want to favorite and add to the Start Menu:

   
If you want the user to choose the applications they want in their Start Menu.. configure Citrix Workspace app in self-service mode. In this mode you also configure auto-provisioned and mandatory app keyword settings as needed.
If you want the user to choose the applications they want in their Start Menu but also want specific app shortcuts on the desktop.. configure Citrix Workspace app without any options and then use per app settings for the few apps that you want on the desktop. Use auto provisioned and mandatory apps as needed.

No app shortcuts in the Start Menu

If a user has a family computer, you might not need or want app shortcuts at all. In such scenarios, the simplest approach is browser access; install Citrix Workspace app without any configuration and browse to Workspace for Web and Web interface. You can also configure Citrix Workspace app for self-service access without putting shortcuts anywhere.

   
If you want to prevent Citrix Workspace app from putting application shortcuts in the Start Menu automatically.. configure Citrix Workspace app with PutShortcutsInStartMenu=False. Citrix Workspace app will not put apps in the Start Menu even in self-service mode unless you put them there using per app settings.

All app shortcuts in the Start Menu or on the Desktop

If the user has only a few apps, you can put them all in the Start Menu or all on the desktop, or in a folder on the desktop.

   
If you want Citrix Workspace app to put all application shortcuts in the start menu automatically.. configure Citrix Workspace app with SelfServiceMode =False. All available apps will appear in the Start Menu.
If you want all application shortcuts to put on desktop.. configure Citrix Workspace app with PutShortcutsOnDesktop = true. All available apps will appear in the desktop.
If you want all shortcuts to be put on the desktop in a folder… configure Citrix Workspace app with DesktopDir=Name of the desktop folder where you want applications.

Per app settings in XenApp 6.5 or 7.x

If you want to set the location of shortcuts so every user finds them in the same place use XenApp per App Settings:

   
If you want per-app settings to determine where applications are placed independently of whether in self-service mode or Start Menu mode.. configure Citrix Workspace app with PutShortcutsInStartMenu=false and enable per app settings.

Apps in category folders or in specific folders

If you want applications displayed in specific folders use the following options:

   
If you want the application shortcuts Citrix Workspace app places in the start menu to be shown in their associated category (folder).. configure Citrix Workspace app with UseCategoryAsStartMenuPath=True.
If you want the applications that Citrix Workspace app puts in the Start menu to be in a specific folder.. configure Citrix Workspace app with StartMenuDir=the name of the Start Menu folder name.

Remove apps on logoff or exit

If you don’t want users to see apps if another user is going to share the end point, you can ensure that apps are removed when the user logs off and exits

   
If you want Citrix Workspace app to remove all apps on logoff.. configure Citrix Workspace app with RemoveAppsOnLogoff=True.
If you want Citrix Workspace app to remove apps on exit.. configure CCitrix Workspace app with RemoveAppsOnExit=True.

Configuring local app access applications

When configuring local app access applications:

  • To specify that a locally installed application must be used instead of an application available in Citrix Workspace app, append the text string KEYWORDS:prefer=”pattern.” This feature is referred to as Local App Access.

    Before installing an application on a user’s computer, Citrix Workspace app searches for the specified patterns to determine if the application is installed locally. If it is, Citrix Workspace app subscribes the application and does not create a shortcut. When the user starts the application from the Citrix Workspace app window, Citrix Workspace app starts the locally installed (preferred) application.

    If a user uninstalls a preferred application outside of Citrix Workspace app, the application is unsubscribed during the next Citri Workspace app refresh. If a user uninstalls a preferred application from the Citrix Workspace app dialog, Citrix Workspace app unsubscribes the application but does not uninstall it.

Note

The keyword prefer is applied when Citrix Workspace app subscribes an application. Adding the keyword after the application is subscribed has no effect.

You can specify the prefer keyword multiple times for an application. Only one match is needed to apply the keyword to an application. The following patterns can be used in any combination:

  • To specify that a locally installed application should be used instead of an application available in Citrix Workspace app, append the text string KEYWORDS:prefer=”pattern”. This feature is referred to as Local App Access.

    Before installing an application on a user’s computer, Citrix Workspace app searches for the specified patterns to determine if the application is installed locally. If it is, Citrix Workspace app subscribes the application and does not create a shortcut. When the user starts the application from the Citrix Workspace app dialog, Citrix Workspace app starts the locally installed (preferred) application.

    If a user uninstalls a preferred application outside of Citrix Workspace app, the application is unsubscribed during the next Citrix Workspace app refresh. If a user uninstalls a preferred application from the Citrix Workspace app, Citrix Workspace app unsubscribes the application but does not uninstall it.

Note:

The keyword prefer is applied when Citrix Workspace app subscribes an application. Adding the keyword after the application is subscribed has no effect.

You can specify the prefer keyword multiple times for an application. Only one match is needed to apply the keyword to an application. The following patterns can be used in any combination:

  • prefer=”ApplicationName”

    The application name pattern matches any application with the specified application name in the shortcut file name. The application name can be a word or a phrase. Quotation marks are required for phrases. Matching is not allowed on partial words or file paths and is case-insensitive. The application name matching pattern is useful for overrides performed manually by an administrator.

KEYWORDS:prefer= Shortcut under Programs Matches?
Word \Microsoft Office\Microsoft Word 2010 Yes
Microsoft Word \Microsoft Office\Microsoft Word 2010 Yes
Console McAfee\VirusScan Console Yes
Virus McAfee\VirusScan Console No
Console McAfee\VirusScan Console Yes
  • prefer=”\\Folder1\Folder2\…\ApplicationName”

    The absolute path pattern matches the entire shortcut file path plus the entire application name under the Start menu. The Programs folder is a sub folder of the Start menu directory, so you must include it in the absolute path to target an application in that folder. Quotation marks are required if the path contains spaces. The matching is case-sensitive. The absolute path matching pattern is useful for overrides implemented programmatically in Citrix Virtual Apps and Desktops.

KEYWORDS:prefer= Shortcut under Programs Matches?
\Programs\Microsoft Office\Microsoft Word 2010 \Programs\Microsoft Office\Microsoft Word 2010 Yes
\Microsoft Office \Programs\Microsoft Office\Microsoft Word 2010 No
\Microsoft Word 2010 \Programs\Microsoft Office\Microsoft Word 2010 No
\Programs\Microsoft Word 2010 \Programs\Microsoft Word 2010 Yes
  • prefer=”\Folder1\Folder2\…\ApplicationName”

    The relative path pattern matches the relative shortcut file path under the Start menu. The relative path provided must contain the application name and can optionally include the folders where the shortcut resides. Matching is successful if the shortcut file path ends with the relative path provided. Quotation marks are required if the path contains spaces. The matching is case-sensitive. The relative path matching pattern is useful for overrides implemented programmatically.

KEYWORDS:prefer= Shortcut under Programs Matches?
\Microsoft Office\Microsoft Word 2010 \Microsoft Office\Microsoft Word 2010 Yes
\Microsoft Office \Microsoft Office\Microsoft Word 2010 No
\Microsoft Word 2010 \Microsoft Office**\Microsoft Word 2010 Yes
\Microsoft Word \Microsoft Word 2010 No

For information about other keywords, see “Additional recommendations” in Optimize the user experience section in the StoreFront documentation.