Skip past navigation linksSecure Global Desktop Administration Guide > Clients and webtops > Native Client preferences files on UNIX, Linux and Mac OS X client devices

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

The Native Client on UNIX, Linux and Mac OS X client devices uses a preferences file to control how users connect to a Secure Global Desktop server and how they display web documents.

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

Skip past command syntax or program codePreference=value

The following preferences can be defined:

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

The URL is displayed in the login dialog.

Username The username to be used to log in to Secure Global Desktop.

The username is displayed in the Native Client login dialog.

Anonymous Whether to check Log In Anonymously in the login dialog. 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:
Skip past command syntax or program codeCertsFile=/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.
Skip past command syntax or program codeProxyHost=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.
Skip past command syntax or program codeNoProxyList=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:
Skip past command syntax or program codeDocBrowser=/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 UseSocks=1.
Skip past command syntax or program codeProxyHost=chicago.indigo-insurance.com
SocksPort The port on SocksHost where the Socks proxy server listens. This setting is not used unless UseSocks=1. A SocksHost must also be specified. The default value is 1080.
SerialPorts A list of serial ports to be mapped in a Windows application emulator session.

Each serial port in the list is separated with a semi-colon and has the format serial device=com_port_name.

Skip past command syntax or program code/dev/ttyS0=COM1;/dev/ttyS4=COM8

The =com_port_name is optional, but if it is omitted the serial port will be mapped to COMx in the Windows application session where x is the position of the serial port in the list.

If the user changes these settings in the Native Client dialogs, for example by entering a different login URL, the changes to all values apart from DocBrowser and CertsFile are saved to the preferences file when the user exits the Native Client.

Related topics