6.3. Webtops

The webtop is a JavaServer Pages (JSP) technology web application. The standard webtop can be customized, or you can develop your own using the SGD web services.

6.3.1. Setting the Language for the Webtop

By default, the SGD web server Welcome Page at https://server.example.com, where server.example.com is the name of an SGD server, is displayed in English.

To change the default language of the SGD web server Welcome Page, amend the symbolic link /opt/tarantella/webserver/apache/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 browser at the https://server.example.com/sgd URL, where server.example.com is the name of an SGD server, the default language used for messages displayed by the login dialog and the webtop is controlled by the defaultlanguage parameter setting in the following file: /opt/tarantella/webserver/tomcat/tomcat-version/webapps/sgd/WEB-INF/web.xml

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

Language

Identifier

English

en

French

fr

German

de

Italian

it

Japanese

ja

Korean

ko

Portuguese (Brazilian)

pt_BR

Simplified Chinese

zh_CN

Spanish

es

Traditional Chinese

zh_TW

Save changes to the web.xml file and restart the SGD web server.

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, the language specified in the profile is used for messages displayed by the SGD Client, the login dialog, and the webtop. SGD Administrators can set the default language by editing the profiles in their organizational hierarchy. See also Section 6.2.4, “Client Profile Settings”.

Note

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

6.3.1.1. Overriding the Default Language for the Webtop

Individual users can override the default language for the webtop in the following ways:

  • On the SGD web server Welcome Page, select a preferred language from the list and then click Log in to access a webtop in that language.

    The SGD web server Welcome Page is at https://server.example.com, where server.example.com is the name of an SGD server.

  • Specify a different preferred language in the client profile.

  • Log in to SGD using a URL that specifies the preferred language. The URL is https://server.example.com/sgd/index.jsp?langSelected=lang, where lang is a supported language identifier for SGD and server.example.com is the name of an SGD server. Users can manually type this URL in their browser.

  • Run the SGD Client from the command line and use the -preferredlanguage lang command line argument to set the language, where lang is a supported language identifier for SGD. This argument can used in shortcuts and shell scripts.

Note

When you override the default language, the login URL specified in the user's client profile does not need to be changed. This is usually https://server.example.com/sgd, where server.example.com is the name of an SGD server.