Skip past navigation linksSecure Global Desktop 4.31 Administration Guide > Commands > The tarantella command

The tarantella command

Syntax

Skip past command syntax or program codetarantella option [ option-specific-arguments ]

Description

You control Secure Global Desktop from the command line using the /opt/tarantella/bin/tarantella command.

Don't try to control the Secure Global Desktop server by running binaries directly, or by using kill. Using the tarantella command is the only supported way of controlling the Secure Global Desktop server.

The options let you control the Secure Global Desktop server in different ways, or produce information about the Secure Global Desktop server. The tarantella command can be used in your own shell scripts to help automate your administration of Secure Global Desktop.

If the Secure Global Desktop server is running, most tarantella options can be run by root or any user in the ttaserv group. The ttaserv group does not have to be the user's primary or effective group. See the table below for details of which user can use the command options.

If the Secure Global Desktop server is stopped, only root can use the tarantella command.

Option Description Can be run by ...
archive Archives the Secure Global Desktop server's log files. root
array Creates and manages arrays of Secure Global Desktop servers. Secure Global Desktop Administrators
arraymanager Starts Array Manager. Secure Global Desktop Administrators
cache Manages the cache of LDAP data. Secure Global Desktop Administrators
config Edits array-wide and server-specific configuration. root or ttaserv group
emulatorsession Lists and controls emulator sessions. root or ttaserv group
license Adds, lists and removes Secure Global Desktop license keys. root or ttaserv group
object Manipulates objects in the organizational hierarchy. root or ttaserv group
objectmanager Starts Object Manager. Secure Global Desktop Administrators
passcache Manipulates the password cache. root or ttaserv group
print Controls Secure Global Desktop printing services. root or ttaserv group
query Examines the Secure Global Desktop server's log files. root
restart Restarts Secure Global Desktop services. root
role Give people specific roles, and gives them webtop links specific to that role. root or ttaserv group
security Controls security services, manages certificates. root
setup Changes Setup options, restores original objects. root
start Starts Secure Global Desktop services. root
start_cdm Starts client drive mapping services. root
status Shows the current status of Secure Global Desktop array members. root or ttaserv group
stop Stops Secure Global Desktop services. root
stop_cdm Stops client drive mapping services. root
tokencache Manipulates the token cache. root or ttaserv group
tscal Manages Microsoft Windows Terminal Services Client Access Licenses (CALs) for non-Windows clients. root or ttaserv group
uninstall Uninstalls Secure Global Desktop. root
version Displays versions of installed Secure Global Desktop packages. root or ttaserv group
webserver Controls the Secure Global Desktop Web Server. root
webtopsession Lists and controls webtop sessions. root or ttaserv group

Note All commands allow the --help option: you can use tarantella command --help to get help on a specific command.

Examples

Skip past command syntax or program codetarantella restart --quiet

Stops and then restarts the Secure Global Desktop server, without displaying any messages.

Skip past command syntax or program codetarantella role add_link --role global \
  --link ".../_ens/o=Indigo Insurance/cn=Write-o-Win"

Adds a link for the Write-o-Win application to the webtops of members of the Global Administrators role.

Related topics