6.2 Client Profiles

This section includes details on how to manage and configure client profiles for the SGD Client.


Client profiles are not available when using the tablet workspace.

This section includes the following topics:

6.2.1 Client Profiles and the SGD Client

A client profile is a group of configuration settings that control the SGD Client. The settings in a client profile include the following:

  • The URL the SGD Client connects to when it starts. Usually, this is the URL used to log in to SGD.

  • Proxy server configuration. Whether the proxy settings are manually configured in the profile or determined from the browser.


The SGD Client can only connect to an SGD server if they both have the same major and patch version number. For example, version 5.20.903.

There is one client profile, a single group of settings, for each SGD server that the user connects to. The profile is downloaded when the user connects to an SGD server. If the SGD Client has been installed manually, the user is prompted for initial connection information the first time the SGD Client is started.


Client profiles are not the same as user profiles. User profiles control workspace content and other SGD-specific settings, such as printing.

This section includes the following topics:

6.2.2 Managing Client Profiles

SGD Administrators manage client profiles with the SGD administration tool, Profile Editor. The Profile Editor tool is only available to SGD Administrators.

SGD Administrators can create, edit, and delete client profiles for the following objects:

  • Organization objects

  • Organizational unit (OU) objects

  • Profile objects in the System Objects organization. For example, System Objects/LDAP Profile

Each of these objects can only have one client profile. The client profile is stored on the SGD server.

The default system client profile is the profile for the System Objects organization. This client profile can be edited, but it cannot be deleted.

Users can edit their own client profiles from the workspace. They click the Edit button in the Applications area of the workspace and then go to the Client Settings tab.

Users can only edit the client profile for the SGD server they are currently connected to. The client profile for a user is stored on the client device, not the SGD server.


Anonymous users cannot edit client profiles. This is because these users are temporary. See Section 2.3, “Anonymous User Authentication” for more details.

6.2.3 How to Configure Client Profile Editing for Users

  1. Enable profile editing for SGD.

    Profile editing for SGD is enabled by default.

    1. In the Administration Console, go to the Global Settings, Client Device tab.

    2. In the Profile Editing section, ensure the Editing check box is selected.

      The check box is selected by default.


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

  2. Configure profile editing in the organizational hierarchy.

    Profile editing can be configured for organizations, organizational units, or user profiles.

    Profile editing can be inherited from a parent object in the organizational hierarchy, so that SGD Administrators can enable or disable profile editing for many users without having to edit each user profile. By default, profile editing is enabled for all users.

    1. In the Administration Console, go to the User Profiles tab and select an object in the organizational hierarchy.

    2. Go to the Client Device tab.

    3. Enable Client Profile Editing as follows:

      • Select the Override Parent's Setting, or the Override Global Setting check box.

        Selecting this check box enables you to override the profile editing setting from any parent object. For example, profile editing can be disabled for an OU, but enabled for a user profile in that OU.

      • Select the Enabled check box.

        Selecting the check box enables profile editing for the user profile, or for all users in the organization unit or organization.

        The initial state of this check box is the setting of the parent object.

    4. Click Save.

6.2.4 Client Profile Settings

The following table lists the settings available in a client profile, with a description of what the setting does.



Login URL

The SGD URL to use for the profile. This is usually https://server.example.com/sgd, where server.example.com is the name of an SGD server.

If the user runs SGD by displaying the workspace in a browser, the URL is loaded automatically in the user's default browser, so that they can log in and access their workspace.

Always use a fully qualified domain name.

The URL in a client profile can be overridden by a command-line argument. See Section 6.1.6, “Running the SGD Client From the Command Line”.

The default Login URL is https://server.example.com:80/sgd/index.jsp.

Alternative PDF Viewer

The application command for an alternative PDF viewer to use with PDF printing.

If the application is not on the user's PATH, enter the full path to the application.

This setting only applies to UNIX, Linux, and Mac OS X platform client devices.


Controls the amount of information that is output to the SGD Client log file.

On Windows platforms, output is logged to the user's application data folder. On UNIX, Linux, and Mac OS X platforms, output is logged to the system log location.

See Section 7.4.7, “SGD Client Logging” for the default log file locations.

The default is Errors only.

Preferred Language

The default language to use when the SGD Client is started from the command line.

The language selected is used for messages displayed by the SGD Client, the login dialog, and the workspace.

See Section 6.3.1, “Setting the Language for the Desktop Workspace” for details.

The default is en.

Span Multiple Monitors

(Kiosk Mode)

Enables X applications to be displayed in kiosk mode on a multihead or dual head monitor.

This is a legacy setting, for applications that do not use the RANDR X extension.

When enabled, the kiosk mode display is spanned across all monitors.

When disabled, the kiosk mode display uses the primary monitor only. This is the default setting.

Allow Applications to Warp the Client Pointer

Enables applications to take control of the mouse pointer.

Try to Match the Client Keyboard Layout

When enabled, SGD attempts to detect the locale and keyboard layout for the client keyboard automatically.

For some client keyboards, users may still need to configure these settings manually. Users can disable the Try to Match the Client Keyboard Layout setting and configure the layout and locale appropriate for their keyboard.

By default, this setting is enabled and should work well with most keyboards. Contact Oracle Support if you encounter issues when using the default setting.

Proxy Settings

Settings that control how the SGD Client determines what proxy servers to use.

Use Default Web Browser Settings means use the proxy server settings configured in the user's default browser.

Manual Proxy Settings enable you to define the proxy server settings in the profile. You can specify an HTTP proxy server.

If the proxy settings are determined from a browser, the settings are stored and used the next time the SGD Client starts.

If Establish Proxy Settings on Session Start is enabled, the SGD Client obtains the proxy settings from the browser every time it starts. The stored proxy settings are not used.

By default, the Use Default Web Browser Settings check box is selected and the Establish Proxy Settings on Session Start check box is not selected.

Connection Failure

Settings that control what the SGD Client does if the connection to an SGD server is lost, whether to always reconnect, to never reconnect, or to ask the user.

If the SGD Client reconnects, these settings control how many attempts are made to reconnect and the time in seconds between each attempt.

If the SGD Client is unable to reconnect, the user session ends and any running applications are ended or suspended, depending on the resumability setting of the application.

The default settings are to Always Attempt to Reconnect, and make 6 attempts at 10 second intervals.

Clipboard Synchronisation

Settings that control how data on the SGD clipboard is synchronized with the clipboard on the client device.

For some client platforms, users might need to change these settings to configure copy and paste to and from SGD applications.

CLIPBOARD selection refers to data that is copied and pasted using menu options. PRIMARY selection refers to data that is copied and pasted by highlighting and using the middle mouse button.

These settings only apply to UNIX and Linux platform computers.

Keyboard Shortcuts

Enables users to configure the following keyboard shortcuts for use with SGD applications:

  • Current Desktop Snapshot: Places a snapshot of the entire desktop area on to the client clipboard.

  • Active Window Snapshot: Places a snapshot of the active window area on to the client clipboard.

  • Full Screen Toggle: Toggles between a full screen (kiosk mode) display and an independent window display.

  • Scale to Fit Toggle: Only for applications where the Window Size: Scale to Fit Window attribute is enabled. Toggles between a scaled display and an unscaled display.

  • Iconify Kiosk Window: Minimizes the active window. Only applies for kiosk mode applications.

These settings only apply to UNIX, Linux, and Mac OS X platform computers.

6.2.5 About the Profile Cache

Client profiles created by SGD Administrators are stored on the SGD server where they are created. The profiles are then copied to all the SGD servers in the array, so that they are available for editing on any SGD server.

When a user first logs in to SGD, the SGD Client downloads the client profile to a profile cache on the client device. The client profile that is downloaded is the first match of the following:

  • The client profile defined for a user profile object in the System Objects organization that is assigned to the user. For example, if the user is authenticated using LDAP authentication and a client profile exists for the System Objects/LDAP Profile object, this is the profile that is downloaded.

  • The client profile defined by an SGD Administrator for the organizational unit or organization to which the user belongs. If there is no client profile for the user's organizational unit, SGD checks any parent object further up the organizational hierarchy to see whether they have a client profile.

  • The system default client profile defined for the System Objects object.

When a user edits and saves a client profile, they override the client profile defined by an SGD Administrator, or the system default client profile, and create a user-specific client profile that is only saved in the profile cache on the client device.


Users must log out of SGD and log in again for changes to their client profile to take effect.

The profile cache is specific to each user who logs in to SGD from the client device and is stored in the following locations:

  • UNIX, Linux, and Mac OS X platform client devices$HOME/.tarantella/tcc/profile.xml

  • Microsoft Windows client devicesC:\Users\username\AppData\Local\Sun\SSGD\profile.xml


If a Windows user has a roaming user profile, see Section 6.1.4, “How to Enable Automatic Installation for Roaming User Profiles”.

The same profile cache is used by the SGD Client, whether it has been installed manually or automatically.

The profile cache is updated each time the user edits a client profile, or each time the user logs in, if they are using the client profile defined by an Administrator.


If a user has not edited their client profile, any manual changes made to the profile.xml file are lost when the user next logs in.

The profile cache contains one client profile for each SGD server the user connects to.

Users can restore a client profile to the default settings by editing the client profile and clicking the Reset button. This resets the client profile to the settings defined for the system default client profile on the System Objects object.

6.2.6 Microsoft Windows Users With Roaming User Profiles

Users with Microsoft Windows client devices can have roaming user profiles. Roaming user profiles provide the user with the same working environment, no matter which Microsoft Windows computer they use. If Microsoft Windows users have roaming user profiles, the SGD client profile is automatically adjusted to allow for this, as follows:

  • Settings specific to the user's client device, for example the proxy server configuration, are stored on the client device in the following default location:


  • Settings specific to the user, for example the preferred language, are stored in the location of the roaming user profile:



    This location also contains the user's hostsvisited and certstore.pem files.

The following settings from the SGD client profile are stored in the location of the user's roaming profile.


Profile Entry

Login URL


Connection Failure




The settings that are stored with the user's roaming profile are controlled by the properties file /opt/tarantella/var/serverconfig/local/roamingattributes.properties.

Automatic installation of the SGD Client for roaming users is not enabled by default. See Section 6.1.4, “How to Enable Automatic Installation for Roaming User Profiles” for details of how to enable this feature.