Skip past navigation linksSecure Global Desktop Administration Guide > Clients and webtops > Working with the Sun Secure Global Desktop Client

Working with the Sun Secure Global Desktop Client

The Sun Secure Global Desktop Client is the part of Secure Global Desktop that is installed on client devices and is required to run applications.

The Secure Global Desktop Client can operate in either of the following modes:

Note You cannot use the Secure Global Desktop Client with the classic webtop.

Depending on the client platform, users see an icon in the System tray or Workspace switcher when the Secure Global Desktop Client is running.

The Secure Global Desktop Client performs the following functions:

Installing the Secure Global Desktop Client

The Secure Global Desktop Client can be installed automatically or manually.

Automatic installation

If you have a web browser with Java™ technology enabled, the Secure Global Desktop Client is installed automatically when you visit the http://server.example.com/sgd URL.

With automatic installation, different versions of the Secure Global Desktop Client are installed in separate directories. This means:

The Secure Global Desktop Client is installed in the following directories:

If you want to use automatic installation and have more control over where the Secure Global Desktop Client is installed, you can develop your own web application for installing the Secure Global Desktop Client and use Secure Global Desktop web services to specify the installation location.

Manual installation

With manual installation, you have full control over where the Secure Global Desktop Client is installed. You download and install the Secure Global Desktop Client from the Secure Global Desktop Web Server home page, http://server.example.com. Click the Install the Sun Secure Global Desktop Client link. The Sun Secure Global Desktop Client download page has instructions for downloading and installing the Secure Global Desktop Client.

On Microsoft Windows client devices, the default installation directory is: C:\Program Files\Sun\Secure Global Desktop Client. A shortcut for the Secure Global Desktop Client is also added to the Windows Start Menu.

Note Manual installation is not available for all supported client platforms.

Configuring the Secure Global Desktop Client

The Secure Global Desktop Client needs to be configured so that it can connect to a Secure Global Desktop server. The connection settings are defined in a client profile that is stored on the client device. The profile controls:

Note The Secure Global Desktop Client can only connect to a Secure Global Desktop server if they both have the same major/patch (4.xx) version number.

There is one profile for each Secure Global Desktop server that the user connects to. The profile is downloaded when the user connects to a Secure Global Desktop server. If the Secure Global Desktop Client has been installed manually, the user is prompted for initial connection information the first time the Secure Global Desktop Client is started.

Running the Secure Global Desktop Client from the command line

Typically users log in to Secure Global Desktop by starting a web browser and visiting the http://server.example.com/sgd URL. Connecting to Secure Global Desktop in this way, automatically downloads and starts the Secure Global Desktop Client. However, you can also start the Secure Global Desktop Client from the command line and connect to a Secure Global Desktop server. You can run the Secure Global Desktop Client in either Webtop mode and Integrated mode in this way.

You start the Secure Global Desktop Client with the tcc command on Microsoft Windows client platforms or the ttatcc command on UNIX/Linux/Mac OS X client platforms, as follows:

Skip past command syntax or program codetcc
  [ -application appname ]
  [ -loginurl url ]
  [ -preferredlanguage lang ]
  [ -profile profile ]
Argument Description
-application appname The name of an application to run. This does not have to be a TFN name.

Note If the application is not on the user's webtop, they cannot launch the application.

‑preferredlanguage lang The language to use in any dialogs and messages displayed by the Secure Global Desktop Client. This overrides the language defined in the profile. The following are the supported languages:
  • en for English
  • fr for French
  • ja for Japanese
  • ko for Korean
  • zh_CN for Simplified Chinese
  • zh_TW for Traditional Chinese
-profile profile The name of the profile to use when starting the Secure Global Desktop Client.

Currently there is only one profile for each Secure Global Desktop server, called Default.

To specify the profile for a particular server, use -profile server.example.com::Default

Note Profile names are case sensitive.

-loginurl URL The login URL. This overrides the URL defined in the profile.

Note The arguments are case-sensitive.

The command line does not allow you to supply a username and password. However, the Secure Global Desktop Client can be configured to log a user in automatically.

Examples

The command line for the Secure Global Desktop Client can be used to create your own shortcuts and shell scripts. The following are some example commands:

Note If either the Connect on System Login or the Add applications to Start Menu options are enabled in a user's profile, the Secure Global Desktop Client automatically adds shortcuts for itself in the user's desktop Start Menu. The Sun Secure Global Desktop Software Release Notes has details of which desktop systems are supported.

Example 1: Starting without any arguments

Skip past command syntax or program codettatcc

Example 2: Connecting to a particular Secure Global Desktop server

Skip past command syntax or program codettatcc -profile server.example.com::Default

Example 3: Overriding the login URL

Skip past command syntax or program codetcc -loginurl URL

Example 4: Running a single application

Skip past command syntax or program codettatcc -application Write-O-Win

Compatability with previous versions

The Secure Global Desktop Client also supports the command line arguments available in versions 4.2x or earlier of Secure Global Desktop:

Skip past command syntax or program codettatcc
    -loginurl url
    -server server
    -port tcp
    -startimmediate
  [ -secure ]
  [ -baseroute ]
  [ -firewalltraversal ]
  [ -resource resource ]
  [ -connectioncookie cookie ]
  [ -ca pem_file ]
Argument Description
-loginurl URL The URL that is to be used to log in to Secure Global Desktop.
-server server The fully-qualified DNS name of the Secure Global Desktop server the Secure Global Desktop Client is to connect to.
-port tcp The port on which the Secure Global Desktop Client is to connect to the Secure Global Desktop server. Usually this is port 5307/tcp when the user has a secure connection to Secure Global Desktop, otherwise port 3144/tcp is used.
-startimmediate Starts the Secure Global Desktop Client immediately and loads the URL specified by the -loginurl option in the user's default web browser.

Note From version 4.3, the Secure Global Desktop Client always starts immediately, whether this argument is used or not.

-secure Create a secure connection to the Secure Global Desktop server.
-baseroute The base network route the Secure Global Desktop Client is to use to traverse a SOCKS proxy server.
-firewalltraversal Indicates that the Secure Global Desktop server is using firewall forwarding. Connections to the Secure Global Desktop server and the webtop both use the same port, usually port 443/tcp.
-resource resource For use by web service developers only, specifies the name of a resource file to use for the Sun Secure Global Desktop Client. The resource file is a DLL containing, for example icons and text. This can only be used on Windows client devices.
‑connectioncookie cookie For use by web service developers only, supplies the cookie used by the Secure Global Desktop server to identify the webtop session for which the Sun Secure Global Desktop Client is being used.
-ca pem_file Specifies the path to the root certificate (ca.pem file) if you are using a custom Certificate Authority.

Note Because of security changes in version 4.3, you no longer need to use this argument.

Note The arguments are case-sensitive.

The Sun Secure Global Desktop Client Helper

When using a web browser with Java technology enabled, the Secure Global Desktop Client is supported by the Sun Secure Global Desktop Client Helper, which is a Java applet.

The Sun Secure Global Desktop Client Helper performs the following functions:

The Sun Secure Global Desktop Client Helper is optional, see Can I use the browser-based webtop without Java technology? for details.

Related topics