Secure Global Desktop Administration Guide > Clients and webtops > User preferences files on UNIX, Linux and Mac OS X client devices

User preferences files on UNIX, Linux and Mac OS X client devices

On UNIX, Linux and Mac OS X client devices, a user preferences file is used to control how users connect to a Secure Global Desktop server and how they display web documents.

The preferences file is used by:

Note The Native Client can only be used to access the classic webtop. The Sun Secure Global Desktop Client can only be used with browser-based webtop.

The preferences are stored in the $HOME/.tarantella/native-preferences file. Each preference is specified using a line of the form:

Preference=value

The following preferences can be defined:

Preference Description
URL The URL to be used to log in to Secure Global Desktop.

For the Native Client, the URL is displayed in the login box.

Username For the Native Client only, the username displayed in the login box.
Anonymous For the Native Client only, whether to check Log In Anonymously in the login box. Use 1 for yes, 0 for no.
DocLaunch The method of viewing web documents:
  • 0 = Automatic.
  • 1 = Run the configured DocBrowser application on the host (see below).
  • 2 = Use the application object configured to display web documents.
CertsFile The full path to a root certificate file (the ca.pem file) if you are using a custom Certificate Authority. For example: 
CertsFile=/usr/local/global-certs/ca.pem
UseProxy Whether to use an HTTP proxy server when connecting to Secure Global Desktop. Use 1 for yes, 0 for no (default).
ProxyHost The Internet hostname of a host running an HTTP proxy server. This setting is not used unless UseProxy=1. 
ProxyHost=chicago.indigo-insurance.com
ProxyPort The port on ProxyHost where the HTTP proxy server listens. This setting is not used unless UseProxy=1. A ProxyHost must also be specified. The default value is 8080.
NoProxyList A semicolon-separated list of Internet hostnames for which connections are not to be proxied. This setting is not used unless either UseProxy=1 or UseSocks=1. 
NoProxyList=chicago.indigo-insurance.com;detroit.indigo-insurance.com
DocBrowser The full path of the application to use for displaying web documents, if DocLaunch=1. For example: 
DocBrowser=/usr/bin/netscape
UseSocks Whether to use a Socks proxy server when connecting to Secure Global Desktop. Use 1 for yes, 0 for no (default).
SocksHost The Internet hostname of a host running a Socks proxy server. This setting is not used unless SocksProxy=1. 
ProxyHost=chicago.indigo-insurance.com
SocksPort The port on SocksHost where the Socks proxy server listens. This setting is not used unless SocksProxy=1. A SocksHost must also be specified. The default value is 1080.

If the user changes these settings in the Native Client dialogs, the changes to all values apart from DocBrowser and CertsFile are only saved to the preferences file when the user exits the Native Client.

Related topics

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