Advanced store settings
You can configure most advanced store properties by using the Advanced Settings page in the Configure Store Settings. Some settings can only be modified using PowerShell.
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.
-
Select the Stores node in the left pane of the Citrix StoreFront management console, select a store in the center pane, and in the Action pane, select Configure Store Settings.
-
On the Configure Store Settings page, select Advanced Settings and make the required changes.
-
Click OK to save your changes.
Address resolution type
Use the Advanced Settings page to specify the type of address to request from the server. The default is DnsPort. From the Address resolution type drop-down menu on Advanced Settings, select one of the following:
- Dns
- DnsPort
- IPV4
- IPV4Port
- Dot
- DotPort
- Uri
- NoChange
Allow font smoothing
You can specify if you want font smoothing for HDX sessions. The default is On.
Use the Advanced Settings task, select the Allow font smoothing option, and click OK.
Allow session reconnect
You can specify if you want HDX sessions to be reconnected. The default is On.
Use the Advanced Settings task, select the Allow session reconnect option, and click OK to enable session reconnect.
Allow special folder redirection
Use the Advanced Settings task to enable or disable special folder redirection. With special folder redirection configured, users can map Windows special folders for the server to those on their local computers. Special folders refer to standard Windows folders, such as \Documents and \Desktop, which are always presented in the same way regardless of the operating system.
Use the Advanced Settings task, select or deselect the Allow special folder redirection option to enable or disable special folder redirection, and click OK.
Advanced health check
Note:
This feature is valid in StoreFront 1912 LTSR CU1 and later versions only. It’s used only for the Local Host Cache feature in a Citrix Virtual Apps and Desktops service deployment.
Local Host Cache requires a customer-deployed on-premises StoreFront as part of the deployment. We recommend that you add all Cloud Connectors that have (or can have) VDAs registered with them to the StoreFront as Delivery Controllers. Cloud Connectors that are not added to the StoreFront cannot be used to launch resources. In this case, from StoreFront 1912 LTSR CU4 onwards, StoreFront attempts to launch resources of those connectors using the best online connectors of other resource locations which are configured in the StoreFront controller list. Launches fail if the connectors are in outage mode.
To ensure resource availability during an outage, without having to publish resources in every zone (resource location), enable the advanced health check feature in each StoreFront store in each zone.
To enable advanced health check you must use the PowerShell command Set-STFStoreFarmConfiguration. For example:
$storeService = Get-STFStoreService –VirtualPath '/Citrix/Store'
Set-STFStoreFarmConfiguration $storeService -AdvancedHealthCheck $true
<!--NeedCopy-->
Background health check polling period
StoreFront runs periodic health checks on each Citrix Virtual Desktops broker and Citrix Virtual Apps server to reduce the impact of intermittent server availability. The default is every minute (00:01:00). Use the Advanced Settings task, specify a time for the Background health-check Polling period, and click OK to control the frequency of the health check.
Communication time-out duration
By default, requests from StoreFront to a server providing resources for a store time out after 30 seconds. The server is considered unavailable after 1 unsuccessful communication attempt. Use the Advanced Settings task, make your changes to the default time, and click OK to change these settings.
Connection timeout
You can specify the number of seconds to wait when establishing an initial connection with a Delivery Controller. The default is 6.
Use the Advanced Settings task, specify the seconds to wait when establishing the initial connection, and click OK
Enable enhanced enumeration
This option controls whether StoreFront queries Delivery Controllers concurrently or sequentially when enumerating apps and desktops across multiple Citrix Virtual Apps and Desktops Sites. Concurrent enumeration provides faster responses to user queries when aggregating resources across multiple Sites. When this option is selected (the default), StoreFront sends out enumeration requests to all Delivery Controllers at the same time and aggregates responses when they have all responded. You can use the options Maximum concurrent enumerations and Minimum farms for concurrent enumeration to tune this behavior.
Use the Advanced Settings task, select (or deselect) the Enable enhanced enumeration option, and click OK.
Enable socket pooling
Socket pooling is disabled by default in stores. When socket pooling is enabled, StoreFront maintains a pool of sockets, rather than creating a socket each time one is needed and returning it to the operating system when the connection is closed. Enabling socket pooling enhances performance, particularly for Secure Sockets Layer (SSL) connections. To enable socket pooling, you edit the store configuration file. Use the Advanced Settings task, select the Enable socket pooling option, and click OK to enable socket pooling.
File type association
By default, file type association is enabled in stores so that content is seamlessly redirected to users’ subscribed applications when they open local files of the appropriate types. To enable disable file type association, use the PowerShell command Set-STFStoreFarmConfiguration. For example:
$storeService = Get-STFStoreService –VirtualPath '/Citrix/Store'
Set-STFStoreFarmConfiguration $storeService -EnableFileTypeAssociation $false
<!--NeedCopy-->
Filter resources by excluded keywords
You can filter matching resources by excluded keywords. Specifying exclusion keywords removes any previously configured inclusion keywords. The default is No filtering (no resource types excluded).
Use the Advanced Settings task, select Filter resources by excluded keywords, click to the right of it, enter a semicolon-separated list of keywords in the enter keywords box, and click OK.
Alternatively you can use PowerShell. This command sets filtering to exclude workflow resources from enumeration:
Set-DSResourceFilterKeyword -SiteId 1 -VirtualPath "/Citrix/Store" -ExcludeKeywords @("WFS")
<!--NeedCopy-->
The following keywords are reserved and must not be used for filtering:
- Auto
- Mandatory
Filter resources by included keywords
You can filter matching resources by inclusion keywords. Specifying inclusion keywords removes any previously configured exclusion keywords. The default is No filtering (no resource types excluded).
Use the Advanced Settings task, select Filter resources by included keywords, click to the right of it, enter a semicolon-separated list of keywords in the enter keywords box, and click OK.
The following keywords are reserved and must not be used for filtering:
- Auto
- Mandatory
Filter resources by type
Choose the resource types to be included in resource enumeration. The default is No filtering (all resource types included).
Use the Advanced Settings task, select Filter resources by type, click to the right of it, choose the resource types to include in the enumeration, and click OK.
Alternatively you can use PowerShell. This example sets allowed resource types to applications only:
Set-DSResourceFilterType -SiteId 1 -VirtualPath "/Citrix/Store" -IncludeTypes @("Applications")
<!--NeedCopy-->
Maximum concurrent enumerations
Specify the maximum number of concurrent requests to send to all Delivery Controllers. This option takes effect when the option Enable enhanced enumeration is enabled. The default is 0 (No Limit).
Use the Advanced Settings task, select Maximum concurrent enumerations, enter a number, and click OK.
Minimum farms for concurrent enumeration
Specify the minimum number of Delivery Controllers required to trigger concurrent enumeration. This option takes effect when the option Enable enhanced enumeration is enabled. The default is 3.
Use the Advanced Settings task, select Minimum farms for concurrent enumerations, enter a number, and click OK.
Override ICA client name
Overrides the client name setting in the .ica launch file with a unique ID generated by the web browser. When disabled, Citrix Workspace app specifies the client name. The default is Off.
Use the Advanced Settings task, select the Override the ICA client name option, and click OK.
Require token consistency
When enabled, StoreFront enforces consistency between the gateway used to authenticate and the gateway used to access the store. When the values are inconsistent, users must reauthenticate. You must enable this for Smart Access. You must disable this if users access the store through a gateway with authentication disabled. The default is On.
Use the Advanced Settings task, select the Require token consistency option, and click OK.
Server communication attempts
Specify the number of attempts to communicate with Delivery Controllers before marking them unavailable. The default is 1.
Use the Advanced Settings task, select Server communication attempts, enter a number, and click OK.
Show Desktop Viewer for legacy clients
Specify whether to show the Citrix Desktop Viewer window and toolbar when users access their desktop from legacy clients. The default is Off.
Use the Advanced Settings task, select the Show Desktop Viewer for legacy clients option, and click OK.
Treat desktops as apps
Specify whether, when the store is accessed, Desktops are displayed in the Apps view rather than in the Desktops view. The default is Off.
Use the Advanced Settings task, select the Treat desktops as apps option, and click OK.
In this article
- Address resolution type
- Allow font smoothing
- Allow session reconnect
- Allow special folder redirection
- Advanced health check
- Background health check polling period
- Communication time-out duration
- Connection timeout
- Enable enhanced enumeration
- Enable socket pooling
- File type association
- Filter resources by excluded keywords
- Filter resources by included keywords
- Filter resources by type
- Maximum concurrent enumerations
- Minimum farms for concurrent enumeration
- Override ICA client name
- Require token consistency
- Server communication attempts
- Show Desktop Viewer for legacy clients
- Treat desktops as apps