Product Documentation

Improving the user experience

Jan 31, 2011

Setting preferences

You can set preferences by clicking Preferences on the Citrix Receiver menu. You can control how desktops are displayed, connect to different applications and desktops, and manage file and device access.

To manage an account

To access desktops and applications, you need an account with XenDeskop or XenApp. Your IT help desk might ask you to add a new account to Citrix Receiver for this purpose, or they might ask you to use a different NetScaler Gateway or Access Gateway server for an existing account. You can also remove accounts from Citrix Receiver.

  1. On the Accounts page of the Preferences dialog box, do one of the following:
    • To add an account, click Add. Your help desk may alternatively provide a provisioning file with account information that you can use to create a new account.
    • To change details of a store that the account uses, such as the default gateway, click Edit.
    • To remove an account, click Remove.
  2. Follow the on-screen prompts. You may be required to authenticate to the server.

To change how you see your desktops

This feature is not available with Citrix XenApp for UNIX sessions.

You can display desktops across the entire screen on your user device (full screen mode), which is the default, or in a separate window (windowed mode).

  1. On the General page of the Preferences dialog box, select a mode in Display desktop in.

To reconnect sessions automatically

Citrix Receiver can reconnect to desktops and applications that you become disconnected from (for example, if there is a network infrastructure issue).

  1. On the General page of the Preferences dialog box, select an option in Reconnect apps and desktops.

To control how local files are accessed

A virtual desktop or application may need to access files on your device. You can control the extent to which this happens.
  1. On the File Access page of the Preferences dialog box, select a mapped drive and then one of the following options:
    • Read and write - Allow the desktop or application to read and write to local files.
    • Read only - Allow the desktop or application to read but not write to local files.
    • No access - Do not allow the desktop or application to access local files.
    • Ask me each time - Display a prompt each time the desktop or application needs to access local files.
  2. If you selected one of the options that grants access to local files, you can additionally save time when browsing to locations on your user device. Click Add, specify the location, and select a drive to map to it.

To set up a microphone or webcam

You can change the way a virtual desktop or application accesses your local microphone or webcam.
  1. On the Mic & Webcam page of the Preferences dialog box, select one of the following options:
    • Use my microphone and webcam - Allow the microphone and webcam to be used by the desktop or application.
    • Don't use my microphone or webcam - Do not allow the microphone or webcam to be used by the desktop or application.

To set up Flash Player

You can choose how Flash content is displayed. This content is normally displayed in Flash Player and includes video, animation, and applications.
  1. On the Flash page of the Preferences dialog box, select one of the following options:
    • Optimize content - Improve playback quality at the risk of reducing security.
    • Don't optimize content - Provide basic playback quality without reducing security.
    • Ask me each time - Prompt me each time Flash content is displayed.

Configuring ClearType font smoothing

ClearType font smoothing (also known as Sub-pixel font rendering) improves the quality of displayed fonts beyond that available through traditional font smoothing or anti-aliasing. You can turn this feature on or off, or specify the type of smoothing by editing the following setting in [WFClient] section of the appropriate configuration file:

FontSmoothingType = number

where number can take one of the following values:
Value Behavior
0 The local preference on the device is used. This is defined by the FontSmoothingTypePref setting.
1 No smoothing
2 Standard smoothing
3 ClearType (horizontal sub-pixel) smoothing

Both standard smoothing and ClearType smoothing increase Receiver's bandwidth requirements significantly.

Important: The server can configure FontSmoothingType through the ICA file. This takes precedence over the value set in [WFClient]. If the server sets the value to 0, the local preference is determined by another setting in the [WFClient]:

FontSmoothingTypePref = number

where number can take one of the following values:
Value Behavior
0 No smoothing
1
2 Standard smoothing
3 ClearType (horizontal sub-pixel) smoothing (default)

Configuring special folder redirection

In this context, there are only two special folders for each user:

  • The user’s Desktop folder
  • The user’s Documents folder (My Documents on Windows XP)

Special folder redirection enables you to specify the locations of a user’s special folders so that these remain fixed across different server types and server farm configurations. This is particularly important if, for example, a mobile user needs to log on to servers in different server farms. For static, desk-based workstations, where the user can log on to servers that reside in a single server farm, special folder redirection is rarely necessary.

To configure special folder redirection

This is a two-part procedure. First, you enable special folder redirection by making an entry in module.ini; then you specify the folder locations in the [WFClient] section, as described here:

  1. Add the following text to module.ini (for example, $ICAROOT/config/module.ini):

    [ClientDrive]

    SFRAllowed = True

  2. Add the following text to the [WFClient] section (for example, $HOME/.ICAClient/wfclient.ini):

    DocumentsFolder = documents

    DesktopFolder = desktop

    where documents and desktop are the UNIX filenames, including the full path, of the directories to use as the users Documents and Desktop folders respectively. For example:

    DesktopFolder = $HOME/.ICAClient/desktop

    • You can specify any component in the path as an environment variable, for example, $HOME.
    • You must specify values for both parameters.
    • The directories you specify must be available through client device mapping; that is, the directory must be in the subtree of a mapped client device.
    • You must use the drive letters C or higher.

Setting up server-client content redirection

Server-client content redirection enables administrators to specify that URLs in a published application are opened using a local application. For example, opening a link to a webpage while using Microsoft Outlook in a session opens the required file using the browser on the user device. Server-client content redirection enables administrators to allocate Citrix resources more efficiently, thereby providing users with better performance.

The following types of URL can be redirected:

  • HTTP (Hypertext Transfer Protocol)
  • HTTPS (Secure Hypertext Transfer Protocol)
  • RTSP (Real Player)
  • RTSPU (Real Player)
  • PNM (Older Real Players)

If Citrix Receiver does not have an appropriate application or cannot directly access the content, the URL is opened using the server application.

Server-client content redirection is configured on the server and enabled by default in Citrix Receiver provided that the path includes RealPlayer and at least one of Firefox, Mozilla, or Netscape.

Note

RealPlayer for Linux can be obtained from http://proforma.real.com/real/player/unix/unix.html.

To enable server-client content redirection if RealPlayer and a browser are not in the path

  1. Open the configuration file wfclient.ini.
  2. In the [Browser] section, modify the following settings:

    Path=path

    Command=command

    where path is the directory where the browser executable is located and command is the name of the executable used to handle redirected browser URLs, appended with the URL sent by the server. For example:

    $ICAROOT/nslaunch netscape,firefox,mozilla

    This setting specifies the following:

    • The nslaunch utility is run to push the URL into an existing browser window
    • Each browser in the list is tried in turn until content can be displayed successfully
  3. In the [Player] section, modify the following settings:

    Path=path

    Command=command

    where path is the directory where the RealPlayer executable is located and command is the name of the executable used to handle the redirected multimedia URLs, appended with the URL sent by the server.

  4. Save and close the file.

Note

For both Path settings, you need only specify the directory where the browser and RealPlayer executables reside. You do not need to specify the full path to the executables. For example, in the [Browser] section, Path might be set to /usr/X11R6/bin rather than /usr/X11R6/bin/netscape. In addition, you can specify multiple directory names as a colon-separated list. If these settings are not specified, the user's current $PATH is used.

To turn off server-client content redirection from Receiver

  1. Open the configuration file module.ini.
  2. Change the CREnabled setting to Off.
  3. Save and close the file.

Controlling keyboard behavior

To generate a remote Ctrl+Alt+Delete key combination:

  1. Decide which key combination will create the Ctrl+Alt+Delete combination on the remote virtual desktop.
  2. In the WFClient section of the appropriate configuration file, configure UseCtrlAltEnd accordingly:
    • True means that Ctrl+Alt+End passes the Ctrl+Alt+Delete combination to the remote desktop.
    • False (default) means that Ctrl+Alt+Enter passes the Ctrl+Alt+Delete combination to the remote desktop.

Using xcapture

The Citrix Receiver package includes a helper application, xcapture, to assist with the exchange of graphical data between the server clipboard and non-ICCCM-compliant X Windows applications on the X desktop. Users can use xcapture to:

  • Capture dialog boxes or screen areas and copy them between the user device desktop (including non-ICCCM-compliant applications) and an application running in a connection window
  • Copy graphics between a connection window and X graphics manipulation utilities xmag or xv

To start xcapture from the command line

At the command prompt, type /opt/Citrix/ICAClient/util/xcapture and press ENTER (where /opt/Citrix/ICAClient is the directory in which you installed Receiver).

To copy from the user device desktop

  1. From the xcapture dialog box, click From Screen. The cursor changes to a crosshair.
  2. Choose from the following tasks:
    • Select a window. Move the cursor over the window you want to copy and click the middle mouse button.
    • Select a region. Hold down the left mouse button and drag the cursor to select the area you want to copy.
    • Cancel the selection. Click the right mouse button. While dragging, you can cancel the selection by clicking the right button before releasing the middle or left mouse button.
  3. From the xcapture dialog box, click To ICA. The xcapture button changes color to show that it is processing the information.
  4. When the transfer is complete, use the appropriate paste command in an application launched from the connection window.

To copy from xv to an application in a connection window

  1. From xv, copy the information.
  2. From the xcapture dialog box, click From XV and then click To ICA. The xcapture button changes color to show that it is processing the information
  3. When the transfer is complete, use the appropriate paste command in an application launched from the connection window.

To copy from an application in the connection window to xv

  1. From the application in a connection window, copy the information.
  2. From the xcapture dialog box, click From ICA and then click To XV. The xcapture button changes color to show that it is processing the information
  3. When the transfer is complete, paste the information into xv.

Reconnecting users automatically

This topic describes the HDX Broadcast auto-client reconnection feature. Citrix recommends you use this in conjunction with the HDX Broadcast session reliability feature.

Users can be disconnected from their sessions because of unreliable networks, highly variable network latency, or range limitations of wireless devices. With the HDX Broadcast auto-client reconnection feature, Citrix Receiver can detect unintended disconnections of sessions and reconnect users to the affected sessions automatically.

When this feature is enabled on the server, users do not have to reconnect manually to continue working. Citrix Receiver attempts to reconnect to the session a set number of times until there is a successful reconnection or the user cancels the reconnection attempts. If user authentication is required, a dialog box requesting credentials appears to a user during automatic reconnection. Automatic reconnection does not occur if users exit applications without logging off. Users can reconnect only to disconnected sessions.

By default, Citrix Receiver waits 30 seconds before attempting to reconnect to a disconnected session and attempts to reconnect to that session three times.

When connecting through an AccessGateway, ACR is not available. To protect against network dropouts, ensure that Session Reliability is enabled both on the Server and Client, as well as configured on the AccessGateway.

For instructions on configuring HDX Broadcast auto-client reconnection, see your XenApp and XenDesktop documentation.

Ensure session reliability

This topic describes the HDX Broadcast session reliability feature, which is enabled by default.

With HDX Broadcast session reliability, users continue to see a published application's window if the connection to the application experiences an interruption. For example, wireless users entering a tunnel may lose their connection when they enter the tunnel and regain it when they emerge on the other side. During the downtime, all of the user's data, key presses, and other interactions are stored, and the application appears frozen. When the connection is re-established, these interactions are replayed into the application.

When auto-client reconnection and session reliability are configured, session reliability will take precedence if there is a connection problem. Session reliability attempts to re-establish a connection to the existing session. It may take up to 25 seconds to detect a connection problem, and then takes a configurable period of time (the default is 180 seconds) to attempt the re-connection. If session reliability fails to reconnect, then auto-client reconnect attempts to reconnect.

If HDX Broadcast session reliability is enabled, the default port used for session communication switches from 1494 to 2598.

Citrix Receiver users cannot override the server settings. For more information on these, see your XenApp and XenDesktop documentation.

Important

HDX Broadcast session reliability requires that another feature, Common Gateway Protocol, is enabled (using policy settings) on the server. Disabling Common Gateway Protocol also disables HDX Broadcast session reliability.