Product Documentation

Configure Citrix Receiver for Web sites using the configuration files

Sep 16, 2015

Configure how resources are displayed for users

When both desktops and applications are available from a Citrix Receiver for Web site, separate desktop and application views are displayed by default. Users see the desktop view first when they log on to the site. If only a single desktop is available for a user, regardless of whether applications are also available from a site, that desktop starts automatically when the user logs on. To change these settings, you edit the site configuration file.

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.
  1. Use a text editor to open the web.config file for the Citrix Receiver for Web site, which is typically located in the C:\inetpub\wwwroot\Citrix\storenameWeb\ directory, where storename is the name specified for the store when it was created.
  2. Locate the following element in the file.
    <uiViews showDesktopsView="true" showAppsView="true" defaultView="desktops" /> 
    
  3. Change the value of the showDesktopsView and showAppsView attributes to false to prevent desktops and applications, respectively, being displayed to users, even if they are available from the site. When both the desktop and application views are enabled, set the value of the defaultView attribute to apps to display the application view first when users log on to the site.
  4. Locate the following element in the file.
    <userInterface ... autoLaunchDesktop="true"> 
    
  5. Change the value of the autoLaunchDesktop attribute to false to prevent Citrix Receiver for Web sites from automatically starting a desktop when a user logs on to the site and only a single desktop is available for that user.

    When the autoLaunchDesktop attribute is set to true and a user for whom only one desktop is available logs on, that user's applications are not reconnected, regardless of the workspace control configuration.

Note: To enable Citrix Receiver for Web sites to start their desktops automatically, users accessing the site through Internet Explorer must add the site to the Local intranet or Trusted sites zones.

Disable the My Apps Folder View

By default, Citrix Receiver for Web displays the My Apps Folder View for unauthenticated (access for unauthenticated users) and mandatory (all published applications are available in the Home screen without users subscribing to them) stores. This view displays applications in a folder hierarchy and includes a breadcrumb path.

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.
  1. Use a text editor to open the web.config file for the Citrix Receiver for Web site, which is typically located in the C:\inetpub\wwwroot\Citrix\storenameWeb\ directory, where storename is the name specified for the store when it was created.
  2. Locate the following element in the file.
    <userInterface enableAppsFolderView="true">  
    
  3. Change the value of the enableAppsFolderView attribute to false to disable Citrix Receiver for Web My Apps Folder View.

Make Citrix Receiver installation files available on the server

By default, when a user accesses a Citrix Receiver for Web site from a computer running Windows or Mac OS X, the site attempts to determine whether Citrix Receiver is installed on the user's device. If Citrix Receiver cannot be detected, the user is prompted to download and install the appropriate Citrix Receiver for their platform from the Citrix website.

If you copy Citrix Receiver for Windows and Citrix Receiver for Mac installation files to the StoreFront server, you can configure the site to provide users with these local files rather than redirecting them to the Citrix website. When Citrix Receiver installation files are available on the StoreFront server, you can also configure the site to offer users with older clients the option to upgrade to the version on the server. To configure deployment of Citrix Receiver for Windows and Citrix Receiver for Mac, you run Windows PowerShell scripts and edit the site configuration file.
Note: These changes cannot be reverted. If you are not changing other configuration settings, you may revert with the following workaround: Back up the web.config file under C:\inetpub\wwwroot\citrix\<storename> before you change the download link and restore the web.config file when you want to revert it back.  Make a copy of the default setting to refer to. The StoreFront and PowerShell consoles cannot be open at the same time. Always close the StoreFront admin console before using the PowerShell console to administer your StoreFront configuration. Likewise, close all instances of PowerShell before opening the StoreFront console.
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.
  1. Copy the Citrix Receiver for Windows and Citrix Receiver for Mac installation files to \Receiver Clients\Windows\ and \Receiver Clients\Mac\ directories, respectively, in the StoreFront installation, which is typically located at C:\Program Files\Citrix\Receiver StoreFront\.

    You also have the option to copy Citrix Receiver installation files to the server when installing StoreFront at a command prompt. For more information, see To install StoreFront at a command prompt.

  2. Using an account with local administrator permissions, start Windows PowerShell and, at a command prompt, type the following commands to update StoreFront with the Citrix Receiver installation file names.
    & "installationlocation\Scripts\UpdateWindowsReceiverLocation.ps1" 
      -ClientLocation "Windows\filename.exe" 
     
    & "installationlocation\Scripts\UpdateMacOSReceiverLocation.ps1" 
      -ClientLocation "Mac\filename.dmg"
    

    Where installationlocation is the directory in which StoreFront is installed, typically C:\Program Files\Citrix\Receiver StoreFront\, and filename is the name of the Citrix Receiver installation file.

  3. On the StoreFront server, use a text editor to open the web.config file for the Citrix Receiver for Web site, which is typically located in the C:\inetpub\wwwroot\Citrix\storenameWeb\ directory, where storename is the name specified for the store when it was created.
  4. Locate the following element in the file.
    <pluginAssistant ... upgradeAtLogin="false"> 
    
  5. Set the value of the upgradeAtLogin attribute to true to offer users with older clients the option to upgrade to the versions available on the server.

Disable detection and deployment of Citrix Receiver

By default, when a user accesses a Citrix Receiver for Web site from a computer running Citrix Windows or Mac OS X, the site attempts to determine whether Citrix Receiver is installed on the user's device. If Citrix Receiver cannot be detected, the user is prompted to download and install the appropriate Citrix Receiver for their platform from the Citrix website. To disable detection and deployment of Citrix Receiver for Windows and Citrix Receiver for Mac for theCitrix  Receiver for Web site, you edit the site configuration file.

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.
  1. Use a text editor to open the web.config file for the Citrix Receiver for Web site, which is typically located in the C:\inetpub\wwwroot\Citrix\storenameWeb\ directory, where storename is the name specified for the store when it was created.
  2. Locate the following element in the file.
    <pluginAssistant enabled="true" ... > 
    
  3. Change the value of the enabled attribute to false to disable detection and deployment of Citrix Receiver for the site.

Configure workspace control

Workspace control lets applications follow users as they move between devices. This enables, for example, clinicians in hospitals to move from workstation to workstation without having to restart their applications on each device. Workspace control is enabled by default for Citrix Receiver for Web sites. To disable or configure workspace control, you edit the site configuration file.

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.
  1. Use a text editor to open the web.config file for the Citrix Receiver for Web site, which is typically located in the C:\inetpub\wwwroot\Citrix\storenameWeb\ directory, where storename is the name specified for the store when it was created.
  2. Locate the following element in the file.
    <workspaceControl enabled="true" autoReconnectAtLogon="true" 
      logoffAction="disconnect" showReconnectButton="false" 
      showDisconnectButton="false" /> 
    
  3. Change the value of the enabled attribute to false to disable workspace control for the site. Set the value of the autoReconnectAtLogon attribute to false to prevent automatic reconnection of users to any applications that they left running. To automatically shut down users' applications when they log off from the site, set the value of the logoffAction attribute to terminate. Set logoffAction to none to leave users' applications running and active when they log off from the site.

    By default, autoReconnectAtLogon is set to true and logoffAction is set to disconnect. This configuration enables a user to log on to a site, start their applications, then log on to the same site using a different device and have those resources automatically transferred to the new device. All the applications that the user starts from a particular site are left running but are automatically disconnected when the user logs off from that site, provided that the same browser instance is used to log on, start the resources, and log off. If there is only one desktop available for a user on a Citrix Receiver for Web site that is configured to start single desktops automatically when the user logs on, that user's applications are not reconnected, even if the autoReconnectAtLogon attribute is set to true.

    Disable automatic reconnection of applications at logon to enable users to choose whether they want their applications to follow them from device to device. If you disable automatic reconnection of applications at logon, ensure that the Connect link is enabled so that users can manually reconnect to applications that they left running.

  4. Change the value of the showReconnectButton attribute to true to display on the site the Connect link, which enables users to manually reconnect to applications that they left running. Set the value of the showDisconnectButton attribute to true to display the Disconnect link, which enables users to manually disconnect from applications without shutting them down.

    By default, the Connect and Disconnect links do not appear on sites. Enable the links and disable automatic reconnection of applications at logon to enable users to choose whether they want their applications to follow them from device to device.

Stop offering provisioning files to users

By default, Citrix Receiver for Web sites offer provisioning files that enable users to configure Citrix Receiver automatically for the associated store. The provisioning files contain connection details for the store that provides the resources on the site, including details of any NetScaler Gateway deployments and beacons configured for the store. To stop offering Citrix Receiver provisioning files to users, you edit the site configuration file.

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.
  1. Use a text editor to open the web.config file for the Citrix Receiver for Web site, which is typically located in the C:\inetpub\wwwroot\Citrix\storenameWeb\ directory, where storename is the name specified for the store when it was created.
  2. Locate the following element in the file.
    <receiverConfiguration enabled="true" ... />
    
  3. Change the value of the enabled attribute to false to remove from the site the option for users to download a provisioning file.

Configure Citrix Receiver for HTML5 use of browser tabs

By default, Citrix Receiver for HTML5 starts desktops and applications in a new browser tab. However, when users start resources from shortcuts using Citrix Receiver for HTML5, the desktop or application replaces the Citrix Receiver for Web site in the existing browser tab rather than appearing in a new tab. To configure Citrix Receiver for HTML5 so that resources are always started in the same tab as the Citrix Receiver for Web site, you edit the site configuration file.

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.
  1. Use a text editor to open the web.config file for the Citrix Receiver for Web site, which is typically located in the C:\inetpub\wwwroot\Citrix\storenameWeb\ directory, where storename is the name specified for the store when it was created.
  2. Locate the following element in the file.
    <html5 ... singleTabLaunch="false" />
    
  3. Change the value of the singleTabLaunch attribute to true to start desktops and applications with Citrix Receiver for HTML5 in the same browser tab as the Citrix Receiver for Web site instead of opening a new tab.

Configure store time-out duration and retry attempts

By default, requests from a Citrix Receiver for Web site to the associated store time out after one minute. The store is considered unavailable after two unsuccessful communication attempts. To change these settings, you edit the site configuration file.

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.
  1. Use a text editor to open the web.config file for the Citrix Receiver for Web site, which is typically located in the C:\inetpub\wwwroot\Citrix\storenameWeb\ directory, where storename is the name specified for the store when it was created.
  2. Locate the following element in the file.
    <communication attempts="2" timeout="00:01:00" ...>
    
  3. Change the value of the attempts attribute to the set the number of unsuccessful communication attempts before the store is considered to be unavailable. Use the timeout attribute to set the time limit in hours, minutes, and seconds for a response from the store.  If users' requests are timing out, it might help to reduce the attempts to 1 and increase the timeout to 2 minutes (“00:02:00”) or longer.

Configure session duration

Once authenticated, users can, by default, access XenDesktop, XenApp, and App Controller resources for up to eight hours without needing to log on again. By default, user sessions on Citrix Receiver for Web sites time out after 20 minutes of inactivity. When a session times out, users can continue to use any desktops or applications that are already running, but must log on again to access Citrix Receiver for Web site functions such as subscribing to applications. To change these settings, you edit the site configuration file.

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.
  1. Use a text editor to open the web.config file for the Citrix Receiver for Web site, which is typically located in the C:\inetpub\wwwroot\Citrix\storenameWeb\ directory, where storename is the name specified for the store when it was created.
  2. Locate the following element in the file.
    <authentication tokenLifeTime="08:00:00" ... />
    
  3. Change the value of the tokenLifeTime attribute to set the time in hours, minutes, and seconds for which users, once authenticated to XenDesktop, XenApp, or App Controller can continue to use resources provided by that deployment.
  4. Locate the following element in the file.
    <sessionState timeout="20" />
    
  5. Use the timeout attribute to set the time in minutes for which a Citrix Receiver for Web site session can remain idle before the user is required to log on again to access the site.