Secure Global Desktop Administration Guide > Commands > The tarantella command

The tarantella command

Syntax

tarantella 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.

OptionDescriptionCan be run by ...
archiveArchives the Secure Global Desktop server's log files.root
arrayCreates and manages arrays of Secure Global Desktop servers.Secure Global Desktop Administrators
arraymanagerStarts Array Manager.Secure Global Desktop Administrators
cacheManages the cache of LDAP data.Secure Global Desktop Administrators
configEdits array-wide and server-specific configuration.root or ttaserv group
emulatorsessionLists and controls emulator sessions.root or ttaserv group
licenseAdds, lists and removes Secure Global Desktop license keys.root or ttaserv group
objectManipulates objects in the organizational hierarchy.root or ttaserv group
objectmanagerStarts Object Manager.Secure Global Desktop Administrators
passcacheManipulates the password cache.root or ttaserv group
printControls Secure Global Desktop printing services.root or ttaserv group
queryExamines the Secure Global Desktop server's log files.root
restartRestarts Secure Global Desktop services.root
roleGive people specific roles, and gives them webtop links specific to that role.root or ttaserv group
securityControls security services, manages certificates.root
setupChanges Setup options, restores original objects.root
startStarts Secure Global Desktop services.root
start_cdmStarts client drive mapping services.root
statusShows the current status of Secure Global Desktop array members.root or ttaserv group
stopStops Secure Global Desktop services.root
stop_cdmStops client drive mapping services.root
tscalManages Microsoft Windows Terminal Services Client Access Licenses (CALs) for non-Windows clients.root or ttaserv group
uninstallUninstalls Secure Global Desktop.root
versionDisplays versions of installed Secure Global Desktop packages.root or ttaserv group
webserverControls the Secure Global Desktop Web Server.root
webtopsessionLists 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

tarantella restart --quiet

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

tarantella 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