A.6. Client Device Tab

Attributes on the Client Device tab are settings for the user's client device. This tab controls the use of client device features for applications displayed through SGD.

From the command line, use the Section D.16, “tarantella config list” command to list these settings, and the Section D.15, “tarantella config edit” command to edit these settings.

This tab contains the following sections:

A.6.1. Windows Client Drive Mapping

Usage: Select or deselect the check box.

Description

Whether to enable client drive mapping (CDM) for applications running on Windows application servers.

Changes to this attribute only take effect for new user sessions.

Command Line

Command option: --array-windowscdm 1 | 0

Usage: Specify 1 (true) or 0 (false).

The following example enables Windows CDM for the array.

--array-windowscdm 1

A.6.2. Unix Client Drive Mapping

Usage: Select or deselect the check box.

Description

Whether to enable CDM for applications running on UNIX or Linux platform application servers.

To use UNIX platform CDM, the Oracle Secure Global Desktop Enhancement Module (SGD Enhancement Module) must be installed and running on the application server.

If you enable UNIX platform CDM, CDM services only become available when you restart all SGD servers in the array. To manually start CDM services without restarting the array, run the tarantella start cdm command on all SGD servers in the array.

If you disable UNIX platform CDM, the CDM processes only stop when you restart all SGD servers in the array. To manually stop CDM services without restarting the array, run the tarantella stop cdm command on all SGD servers in the array.

Changes to this attribute only take effect for new user sessions.

Command Line

Command option: --array-unixcdm 1 | 0

Usage: Specify 1 (true) or 0 (false).

The following example enables UNIX platform CDM for the array.

--array-unixcdm 1

A.6.3. Dynamic Drive Mapping

Usage: Select or deselect the check box.

Description

Whether to enable dynamic drive mapping for the array. This feature enables “hot plugging” of removable storage devices, such as Universal Serial Bus (USB) drives.

By default, dynamic drive mapping is enabled for an SGD array.

To use dynamic drive mapping, CDM must be enabled for the array. This means that the Section A.6.1, “Windows Client Drive Mapping” or Section A.6.2, “Unix Client Drive Mapping” attribute must be enabled.

To use dynamic drive mapping for UNIX and Linux platform application servers, the Oracle Secure Global Desktop Enhancement Module (SGD Enhancement Module) must be installed and running on the application server.

Changes to this attribute only take effect when you restart all the SGD servers in the array.

Command Line

Command option: --array-dyndevice 1 | 0

Usage: Specify 1 (true) or 0 (false).

The following example disables dynamic drive mapping for the array.

--array-dyndevice 0

A.6.4. Windows Audio

Usage: Select or deselect the check box.

Description

Whether to enable Windows audio services for the array.

To play audio for Windows applications, audio redirection must be enabled on the Windows Remote Desktop Session Host.

Changes to this attribute only take effect for new user sessions.

Command Line

Command option: --array-audio 1 | 0

Usage: Specify 1 (true) or 0 (false).

The following example disables Windows audio services for the array.

--array-audio 0

A.6.5. Windows Audio Sound Quality

Usage: Select an option.

Description

The sample rate of the audio data.

Adjusting the audio quality increases or decreases the amount of audio data sent.

By default, SGD uses Medium Quality Audio.

The sample rates are as follows:

  • Low Quality Audio – 8 kHz

  • Medium Quality Audio – 22.05 kHz

  • High Quality Audio – 44.1 kHz

If the application server hosting the Windows application does not support the High Quality Audio setting, the audio rate is downgraded automatically.

Command Line

Command option: --array-audio-quality low | medium | high

Usage: Specify an audio quality setting.

The following example specifies medium quality audio for Windows audio services.

--array-audio-quality medium

A.6.6. Unix Audio

Usage: Select or deselect the check box.

Description

Whether to enable UNIX platform audio services for the array.

UNIX platform audio is only available for X applications. The audio module of the SGD Enhancement Module must be installed and running on the application server.

Changes to this attribute only take effect for new user sessions.

Command Line

Command option: --array-unixaudio 1 | 0

Usage: Specify 1 (true) or 0 (false).

The following example disables UNIX platform audio services for the array.

--array-unixaudio 0

A.6.7. Unix Audio Sound Quality

Usage: Select an option.

Description

The sample rate of the audio data.

Adjusting the audio quality increases or decreases the amount of audio data sent.

By default, SGD uses Medium Quality Audio.

The sample rates are as follows:

  • Low Quality Audio – 8 kHz

  • Medium Quality Audio – 22.05 kHz

  • High Quality Audio – 44.1 kHz

Command Line

Command option: --array-unixaudio-quality low | medium | high

Usage: Specify an audio quality setting.

The following example specifies medium quality audio for UNIX platform audio services.

--array-unixaudio-quality medium

A.6.8. Audio Input

Usage: Select or deselect the check box.

Description

Whether to enable users to record audio in Windows application sessions.

To record audio in Windows applications, audio recording redirection must be enabled on the Windows Remote Desktop Session Host.

Changes to this attribute only take effect for new user sessions.

Command Line

Command option: --array-audioin 1 | 0

Usage: Specify 1 (true) or 0 (false).

The following example disables audio recording in Windows application sessions for the array.

--array-audioin 0

A.6.9. Smart Card

Usage: Select or deselect the check box.

Description

Whether to enable smart card services for the array.

To use smart cards, smart card device redirection must be enabled on the Windows Remote Desktop Session Host.

Changes to this attribute only take effect for new user sessions.

Command Line

Command option: --array-scard 1 | 0

Usage: Specify 1 (true) or 0 (false).

The following example enables smart card services for the array.

--array-scard 1

A.6.10. Serial Port Mapping

Usage: Select or deselect the check box.

Description

Whether to enable access to serial ports for the array.

By default, access to serial ports is enabled.

Access to serial ports for individual users can be enabled and disabled using the Section C.2.95, “Serial Port Mapping” attribute for organization, organizational unit or user profile objects.

Changes to this attribute only take effect for new user sessions.

Command Line

Command option: --array-serialport 1 | 0

Usage: Specify 1 (true) or 0 (false).

The following example enables access to serial ports for the array.

--array-serialport 1

A.6.11. Copy and Paste

Usage: Select or deselect the check box.

Description

Whether to allow copy and paste operations for Windows and X application sessions for the array.

By default, copy and paste is allowed.

Copy and paste operations for individual users can be enabled and disabled using the Section C.2.35, “Copy and Paste” attribute for organization, organizational unit, or user profile objects.

Changes to this attribute only take effect for new application sessions.

Command Line

Command option: --array-clipboard-enabled 1 | 0

Usage: Specify 1 (true) or 0 (false).

The following example enables copy and paste for Windows and X application sessions.

--array-clipboard-enabled 1

A.6.12. Client's Clipboard Security Level

Usage: Type a number in the field.

Description

The security level for the SGD Client.

Used to control copy and paste operations between Windows or X application sessions and applications running on the client device.

The security level can be any positive integer. The higher the number, the higher the security level. The default security level is 3.

Changes to this attribute only take effect for new application sessions.

Command Line

Command option: --array-clipboard-clientlevel num

Usage: Replace num with a positive integer that specifies the security level.

The following example specifies a client clipboard security level of 3.

--array-clipboard-clientlevel 3

A.6.13. Time Zone Map File

Usage: Type the file name in the field.

Description

A file that contains mappings between UNIX platform client device and Windows application server time zone names.

Command Line

Command option: --xpe-tzmapfile filename

Usage: Replace filename with the path to the time zone map file.

In the following example, a time zone map file is specified.

--xpe-tzmapfile "%%INSTALLDIR%%/etc/data/timezonemap.txt"

A.6.14. RandR Extension

Usage: Select or deselect the check box.

Description

Whether to enable the RANDR X extension for application sessions in the array.

By default, the RANDR X extension is disabled.

RANDR can be enabled or disabled for individual users with the Section C.2.92, “RandR Extension” attribute for organization, organizational unit, or user profile objects.

Changes to this attribute only take effect for new application sessions.

Command Line

Command option: --array-xrandr-enabled 1 | 0

Usage: Specify 1 (true) or 0 (false).

The following example enables the RANDR X extension for application sessions.

--array-xrandr-enabled 1

A.6.15. Editing

Usage: Select or deselect the check box.

Description

Whether to allow users to edit their own profiles for use with the SGD Client.

By default, profile editing is enabled.

If profile editing is disabled, it is disabled for all users, including SGD Administrators. However, SGD Administrators can still create and edit profiles using the Profile Editor application.

Profile editing for individual users can be enabled and disabled using the Section C.2.22, “Client Profile Editing” attribute for organization, organizational unit, or user profile objects.

Changes to this attribute only take effect for new user sessions.

Command Line

Command option: --array-editprofile 1 | 0

Usage: Specify 1 (true) or 0 (false).

The following example enables user profile editing for the array.

--array-editprofile 1