Configuring Receiver for Web Using the Configuration Files

Updated: 2012-08-20

This topic describes additional configuration tasks for Receiver for Web sites that involve editing the configuration files.

Important: In multiple server deployments, ensure that any configuration changes you make on the primary server are propagated to the server group so that the configurations of the secondary servers are also updated.

To configure how resources are displayed for users

When both desktops and applications are available from a site, Receiver for Web displays separate desktop and application views by default. Users see the desktop view first when they log on to the site. Regardless of whether applications are also available from a site, if only a single desktop is available for a user, Receiver for Web attempts to automatically start that desktop when the user logs on.

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

To change these default settings, edit the site configuration file.

  1. On the StoreFront server, use a text editor to open the web.config file for the 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 Receiver for Web from automatically starting and accessing a desktop when a user logs on to the site and only a single desktop is available for that user.

To configure detection and deployment of Citrix Receiver

By default, when a user accesses a 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 or if a more recent version is available, the user is prompted to download and install the appropriate Citrix Receiver for their platform, installation files for which are automatically stored on the server when you install StoreFront. To disable detection and deployment of Citrix Receiver, edit the site configuration file.

  1. On the StoreFront server, use a text editor to open the web.config file for the 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" upgradeAtLogin="true">
    
  3. Change the value of the enabled attribute to false to disable detection and deployment of Citrix Receiver for the site. Set the value of the upgradeAtLogin attribute to false to stop offering users with older clients the option to upgrade.
  4. To update the versions of Citrix Receiver for Windows and Citrix Receiver for Mac stored on the StoreFront server and offered to users, replace the Citrix Receiver installation files in the \Receiver Clients\Windows\ and \Receiver Clients\Mac\ directories of the StoreFront installation, typically located at C:\Program Files\Citrix\Receiver StoreFront\.
  5. Using an account with local administrator permissions, start Windows PowerShell and, at a command prompt, type the following commands to update StoreFront with the new versions of Citrix Receiver.
    > C:\Program Files\Citrix\Receiver StoreFront\Scripts\
      UpdateWindowsReceiverLocation.ps1 -ClientLocation "Windows\filename"
    > C:\Program Files\Citrix\Receiver StoreFront\Scripts\
      UpdateMacOSReceiverLocation.ps1 -ClientLocation "Mac\filename"

    Where filename is the name of the updated Citrix Receiver installation file.

To 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 Receiver for Web sites. To disable or configure workspace control, edit the site configuration file.

  1. On the StoreFront server, use a text editor to open the web.config file for the 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 logging on to the site 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 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 automatically disconnected when the user logs off from that site, provided that the same browser is used to log on, start the resources, and log off.

    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.

To stop offering provisioning files to users

By default, users can obtain from Receiver for Web sites provisioning files that enable them to configure Citrix Receiver automatically with connection details, including any Access Gateway deployments and beacons, for the store providing the desktops and applications for the site. To stop offering Citrix Receiver provisioning files to users, edit the site configuration file.

  1. On the StoreFront server, use a text editor to open the web.config file for the 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 the Citrix Receiver provisioning file button from the site.

To configure store time-out duration and retry attempts

By default, contact between the Receiver for Web site and the associated store times out after one minute and the store is considered unavailable after two unsuccessful communication attempts. To change these settings, edit the site configuration file.

  1. On the StoreFront server, use a text editor to open the web.config file for the 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.

To configure session durations

Once authenticated to XenDesktop, XenApp, or AppController, users can, by default, access resources provided by the site, farm, or virtual appliance for up to eight hours without needing to log on again. By default, user sessions on 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 Receiver for Web site functions such as subscribing to applications. To change these settings, edit the site configuration file.

  1. On the StoreFront server, use a text editor to open the web.config file for the 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 AppController, can continue to use resources provided by the site, farm, or virtual appliance.
  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 Receiver for Web site session can remain idle before the user is required to log on again to access the site.

Contact Careers Terms of Use Privacy Governance Follow Us
© Citrix Systems, Inc. All rights reserved.