6.3 Workspaces

On desktop platforms, the default workspace is a JavaServer Pages (JSP) technology web application. This is called the desktop workspace. The desktop workspace can be customized, or you can develop your own using the SGD web services. See Section 6.3.1, “Setting the Language for the Desktop Workspace”.

The default workspace used for tablet devices is an HTML5 web page. This is called the tablet workspace. You can use the tablet workspace on some desktop platforms. See Section 6.3.2, “Deploying the Tablet Workspace on Desktop Platforms”.

There are some limitations when using the tablet workspace. See Section 6.3.3, “Limitations of Using the Tablet Workspace”.

6.3.1 Setting the Language for the Desktop Workspace

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/var/docroot/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 workspace 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 workspace. 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 Workspace

Individual users can override the default language for the workspace in the following ways. Note that some of these may not be available for the tablet workspace.

  • On the SGD web server Welcome page, select a preferred language from the list and then click Log in to access a workspace 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.

  • On the SGD login dialog, select a preferred language from the list before entering login credentials.

  • 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 enter 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.

6.3.2 Deploying the Tablet Workspace on Desktop Platforms

The default workspace used for tablet devices is an HTML5 web page. This workspace has been designed to work well on the supported tablet device platforms. On other client platforms, such as desktop computers, the default workspace is a JSP page.

When users connect from a desktop computer, they can display the tablet workspace by going to the following URL:

https://server.example.com/sgd/index.jsp?clienttype=h5c

where server.example.com is the name of the SGD server.

Note

See Supported Client Platforms for the supported platforms for using the tablet workspace on a desktop computer.

To display the desktop workspace, users can enter the following URL:

https://server.example.com/sgd/index.jsp?clienttype=tcc
Note

Before using the clienttype URL switch, users must be logged out of SGD.

To deploy the tablet workspace by default on non-tablet client platforms, you can configure the h5cuseragentmatch context parameter setting in the following file: /opt/tarantella/webserver/tomcat/tomcat-version/webapps/sgd/WEB-INF/web.xml.

The value of h5cuseragentmatch is a regular expression that matches the User-Agent header of the browser used on the client device.

For example, to use the tablet workspace on client devices that are running a Firefox browser:

        <context-param>
        <param-name>h5cuseragentmatch</param-name>
        <param-value>.*((ipad)|(iphone)|(android)|(cros)|(firefox)).*</param-value>
        </context-param>    

After making changes, restart the SGD web server.

# tarantella restart webserver

6.3.3 Limitations of Using the Tablet Workspace

The following limitations apply for users who connect to SGD from a tablet device, or use the tablet workspace on a desktop computer:

  • Manual installation. Manual installation of the SGD Client is not supported on a tablet device.

  • Client profiles. Client profiles are not available when using the tablet workspace.

  • Firewall forwarding. Tablet devices cannot be used with an SGD server that has been configured for firewall forwarding. Tablet devices can be used with the SGD Gateway.

  • Character applications. Running a character application, such as a VT420 terminal, is not supported.

  • Feature support. The following features are not supported when running SGD applications on the tablet workspace:

    • Printer-direct printing. Use PDF printing where possible.

    • Client drive mapping

    • Audio output and recording

    • Smart card authentication for Windows applications

    • Keyboard locales. Only en-us keyboards are supported.

    • Serial port redirection

    • Resuming of Client Window Management applications

See knowledge document ID 2221978.1 on My Oracle Support for more details of limitations when using the tablet workspace.

Supported Client Platforms in the Oracle Secure Global Desktop Platform Support and Release Notes shows the supported platforms and browsers for the tablet workspace.