Exit Print View

Oracle Secure Global Desktop Administration Guide for Version 4.6

Document Information

Preface

1.  Networking and Security

2.  User Authentication

3.  Publishing Applications to Users

4.  Configuring Applications

5.  Client Device Support

6.  SGD Client and Webtop

7.  SGD Servers, Arrays, and Load Balancing

A.  Global Settings and Caches

B.  Secure Global Desktop Server Settings

C.  User Profiles, Applications, and Application Servers

D.  Commands

The tarantella Command

Syntax

Description

Examples

The tarantella archive Command

Syntax

Description

Examples

The tarantella array Command

Syntax

Description

Examples

tarantella array add_backup_primary

tarantella array clean

tarantella array detach

tarantella array edit_backup_primary

tarantella array join

tarantella array list

tarantella array list_backup_primaries

tarantella array make_primary

tarantella array remove_backup_primary

The tarantella cache Command

Syntax

Description

Examples

The tarantella config Command

Syntax

Description

Examples

tarantella config edit

tarantella config list

The tarantella emulatorsession Command

Syntax

Description

Examples

tarantella emulatorsession list

tarantella emulatorsession info

tarantella emulatorsession shadow

tarantella emulatorsession suspend

tarantella emulatorsession end

The tarantella help Command

Syntax

Description

Examples

The tarantella object Command

Syntax

Description

Examples

tarantella object add_host

tarantella object add_link

tarantella object add_mapping

tarantella object add_member

tarantella object delete

tarantella object edit

tarantella object list_attributes

tarantella object list_contents

tarantella object new_3270app

tarantella object new_5250app

tarantella object new_charapp

tarantella object new_container

tarantella object new_dc

tarantella object new_doc

tarantella object new_dynamicapp

tarantella object new_group

tarantella object new_host

tarantella object new_org

tarantella object new_orgunit

tarantella object new_person

tarantella object new_windowsapp

tarantella object new_xapp

tarantella object remove_host

tarantella object remove_link

tarantella object remove_mapping

tarantella object remove_member

tarantella object rename

tarantella object script

The tarantella passcache Command

Syntax

Description

Examples

tarantella passcache delete

tarantella passcache edit

tarantella passcache list

tarantella passcache new

The tarantella print Command

Syntax

Description

Examples

tarantella print cancel

tarantella print list

tarantella print move

tarantella print pause

tarantella print resume

tarantella print start

tarantella print status

tarantella print stop

The tarantella query Command

Syntax

Description

Examples

tarantella query audit

tarantella query billing

tarantella query errlog

tarantella query uptime

The tarantella restart Command

Syntax

Description

Examples

tarantella restart sgd

tarantella restart webserver

The tarantella role Command

Syntax

Description

Examples

tarantella role add_link

tarantella role add_member

tarantella role list

tarantella role list_links

tarantella role list_members

tarantella role remove_link

tarantella role remove_member

The tarantella security Command

Syntax

Description

Examples

tarantella security certinfo

tarantella security certrequest

tarantella security certuse

tarantella security customca

tarantella security decryptkey

tarantella security disable

tarantella security enable

tarantella security fingerprint

tarantella security peerca

tarantella security selfsign

tarantella security start

tarantella security stop

The tarantella service Command

Syntax

Description

Examples

tarantella service delete

tarantella service edit

tarantella service list

tarantella service new

The tarantella setup Command

Syntax

Description

Examples

The tarantella start Command

Syntax

Description

Examples

tarantella start cdm

tarantella start sgd

tarantella start webserver

The tarantella status Command

Syntax

Description

Examples

The tarantella stop Command

Syntax

Description

Examples

tarantella stop cdm

tarantella stop sgd

tarantella stop webserver

The tarantella tokencache Command

Syntax

Description

Examples

tarantella tokencache delete

tarantella tokencache list

The tarantella tscal Command

Syntax

Description

Examples

tarantella tscal free

tarantella tscal list

tarantella tscal return

The tarantella uninstall Command

Syntax

Description

Examples

The tarantella version Command

Syntax

Description

Examples

The tarantella webserver Command

Syntax

Description

Examples

tarantella webserver add_trusted_user

tarantella webserver delete_trusted_user

tarantella webserver list_trusted_users

The tarantella webtopsession Command

Syntax

Description

Examples

tarantella webtopsession list

tarantella webtopsession logout

E.  Login Scripts

F.  Third-Party Legal Notices

Glossary

Index

The tarantella config Command

The tarantella config command lists and configures global settings, and also server-specific settings for any SGD server in the array.

Syntax

tarantella config list | edit

Description

The following table shows the available subcommands for this command.

Subcommand
Description
More Information
list
Lists global and server-specific attributes and their current values.
edit
Edits global and server-specific attributes.

Note - All commands include a --help option. You can use tarantella config subcommand --help to get help on a specific command.


Examples

The following example lists server-specific attributes from the server newyork.indigo-insurance.com.

$ tarantella config list --server newyork.indigo-insurance.com

The following example sets the cpe-maxsessions attribute to 10 for the server where the command is run.

$ tarantella config edit --cpe-maxsessions 10

tarantella config edit

Edits global and server-specific attributes.

Syntax
tarantella config edit { { --setting value... }...
                         [ --array | --server serv... ]
                       } | --file file
Description

The following table shows the available options for this command.

Option
Description
--setting value...
Names an attribute you want to edit, and its new value or values.
--array
When configuring a server-specific attribute, applies the change to all SGD servers in the array.
--server
When configuring a server-specific attribute, applies the change to each named serv in the array. Use a peer DNS name or IP address for each server.
--file
Specifies a file containing a batch of commands to edit attributes.

If neither --array nor --server is specified, the command sets server-specific attributes for the SGD server where the command is run.

Use tarantella config list to see a list of settings you can change.

For detailed information on global attributes, see Appendix A, Global Settings and Caches.

For detailed information on server-specific attributes, see Appendix B, Secure Global Desktop Server Settings.

Some attribute settings are lists. When editing a list on the command line, it is best to enclose each item in the list in quotes, and separate each item with a space. For example:

$ tarantella config edit --tarantella-config-tpeconfig-logfilter \
"tpe/*/*" "pem/*/*"

Alternatively, you can put each item in the list on a separate line. For example:

$ tarantella config edit --tarantella-config-tpeconfig-logfilter \
"tpe/*/*" \
"tpe/*/*"

If you omit the quotes, you must use a backslash (\) to escape any characters, such as asterisks (*), to prevent your shell from expanding them.

On the command line, when you display attribute settings that are lists, the setting is shown as a comma-separated list. For example:

$ tarantella config list --tarantella-config-tpeconfig-logfilter
tarantella-config-tpeconfig-logfilter: tpe/*/*,pem/*/*
Examples

The following example sets the cpe-exitafter attribute to 50 on SGD servers newyork.indigo-insurance.com and boston.indigo-insurance.com.

$ tarantella config edit --cpe-exitafter 50 \
--server newyork.indigo-insurance.com boston.indigo-insurance.com

The following example sets the cpe-maxsessions attribute to 10 for the server where the command is run.

$ tarantella config edit --cpe-maxsessions 10

tarantella config list

Lists global and server-specific attributes and their current values.

Syntax
tarantella config list { [ --setting... ]
                         [ --server serv ]
                       } | --file file
Description

The following table shows the available options for this command.

Option
Description
--setting
Names an attribute you want to list the value of. If no --setting is specified, all global and server-specific attributes are listed.
--server
Lists server-specific attributes for the specified SGD server in the array. Use a peer DNS name or IP address. If omitted, lists server-specific attributes for the SGD server where the command is run.
--file
Specifies a file containing a batch of commands to list attributes.

For detailed information on global attributes, see Appendix A, Global Settings and Caches.

For detailed information on server-specific attributes, see Appendix B, Secure Global Desktop Server Settings.

Examples

The following example lists global attributes, and server-specific attributes for the server newyork.indigo-insurance.com.

$ tarantella config list --server newyork.indigo-insurance.com

The following example lists the value of the array-port-unencrypted attribute.

$ tarantella config list --array-port-unencrypted