Secure Global Desktop 4.40 Administration Guide > Users and Authentication > Working With Users in Different Locales

Working With Users in Different Locales

When you install SGD, the default language used for the webtop, the Sun Secure Global Desktop Client and for login scripts is English. Secure Global Desktop Administrators can configure SGD to add support for users in different locales as follows:

• Setting the language used for the webtop
• Setting the language used for application server system prompts
• Enabling an input method

The following sections describe how you do this.

Setting the Language for the Webtop

By default, the SGD Web Server Welcome page at http://server.example.com displays in English. To change the default language of the Welcome page, amend the symbolic link /opt/tarantella/webserver/apache/<version>/htdocs/index.html so that it links to another index page in this directory. For example to make the default Welcome page display in Japanese, link to the index_ja.html page.

When users log in using a web browser at the http://SGD-server/sgd URL, the default language used for messages displayed by the login dialog and the webtop is controlled by the m_defaultLang = "en"; line in the following file:
/opt/tarantella/webserver/tomcat/<version>/webapps/sgd/resources/jsp/localeutils.jsp

To change the default language, edit this line and replace "en" with the language identifier for one of the following supported languages:

The default language is also controlled by the Preferred Language in the user's client profile. Whenever the SGD Client is started from the command line (for example when the SGD Client is in integrated mode), the language specified in the profile is used for messages displayed by the SGD Client, the login dialog, and the webtop. Secure Global Desktop Administrators can set the default language by editing the profiles in their organizational hierarchy.

Note To be able to display text for a locale, users must also have appropriate fonts installed on their client device.

Overriding the Default Language

Users can override the default language as follows:

• On the SGD Web Server Welcome page (http://SGD-server), click one of the flags at the top of the page to select a preferred language and then click Log in to access a webtop in that language.
• Specify a different preferred language in the client profile.

  Note The login URL specified in the user's client profile, usually http://SGD-server/sgd, does not need to be changed.

• Log in to SGD using a URL that specifies the preferred language. The URL is http://SGD-server/sgd/index.jsp?langSelected=lang where lang is one of the language identifiers listed in the table above. Users can manually type this URL in their web browser.

  Note The login URL specified in the user's client profile, usually http://SGD-server/sgd, does not need to be changed.

• Run the SGD Client from the command line and use the -preferredlanguage lang command line argument to set the language, where lang is one of the language identifiers listed in the table above. This argument can used in shortcuts and shell scripts.

  Note The login URL specified in the user's client profile, usually http://SGD-server/sgd, does not need to be changed.

Setting the Language Used for Application Server System Prompts

By default, the login scripts supplied with SGD, support English system prompts on application servers. Administrators can add support for system prompts in other languages as follows:

• Edit the vars.exp login script and add a translation for each of the English prompts defined. You do not need to translate every prompt, only the prompts that are different to the English ones. The file contains examples to help you get started. You can also provide translations for the variables, strings and error message section to match the client or user locale.
• In the SGD Administration Console, configure the General tab » Prompt Locale attribute for your application server objects to match a locale defined in vars.exp.

Enabling an Input Method

An input method (IM) is a program or operating system component that allows users to enter characters and symbols not found on their keyboard. On Microsoft Windows Platforms, an IM is called an input method editor (IME).

When running applications, SGD enables an IM if either the TTA_PreferredLocale, TTA_HostLocale, or the LANG (from the application environment overrides) environment variables are set to a locale that requires an IM. The locales that require an IM is controlled by the IM_localeList variable which is defined in the vars.exp login script. By default, an IM is enabled for all Japanese, Korean, and Chinese locales. To enable an IM in other locales, you must edit vars.exp and add the locale to the IM_localeList variable.

Copyright © 1997-2007 Sun Microsystems, Inc. All rights reserved.