Exit Print View

Oracle Secure Global Desktop Administration Guide for Version 4.6

Previous Next

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 tscal Command

Use the tarantella tscal command to manage Microsoft Windows Terminal Services CALs for non-Windows clients.

Syntax

tarantella tscal free | list | return

Description

The following table shows the available subcommands for this command.

Subcommand
Description
More Information
free
Frees a Terminal Services CAL for use by another non-Windows client.
tarantella tscal free
list
Lists the Terminal Services CALs currently reserved for non-Windows clients.
tarantella tscal list
return
Returns Terminal Services CALs to the Windows license server.
tarantella tscal return

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

Examples

The following example lists the Terminal Services CALs currently reserved for non-Windows clients.

$ tarantella tscal list

tarantella tscal free

Use the tarantella tscal free command to free a Microsoft Windows Terminal Services CAL so that it can be used by another non-Windows client.

Syntax
tarantella tscal free [ --inuseby user | --calid id ]
Description

You can only free a CAL if the user has no application sessions that use Windows Terminal Services.

Note - Freed CALs are not returned to the Windows license server.

Normally, you do not need to run this command, as SGD automatically frees a CAL as soon as a user exits their last Windows application. However, if an SGD server is removed from an array or it loses contact with the array, it might still be listed as using CALs. In this situation, you can run this command to free a CAL.

If you do not use any arguments, the command frees all CALs that have no application sessions that use Windows Terminal Services.

If you run this command on a secondary server in a SGD array and the primary server is unavailable, the CAL information might not be completely accurate. This is because the primary server is responsible for updating all SGD servers in the array with changes to CAL information. The command warns you if the primary is unavailable.

The following table shows the available options for this command.

Option
Description
--inuseby
Free only the CALs for a particular user where the user is either of the following:

  • The name of a user.

  • A wild card filter.

The * character is the only character you can use in a wild card filter. It represents a string of any length containing any characters. So, an --inuseby "*green*" argument frees only the unused CALs for users whose name contains the string “green”.
--calid
The ID of the CAL you want to free. Use the tarantella tscal list command to obtain the ID of the CAL you wish to free.
Examples

The following example frees the CALs for Elizabeth Blue.

$ tarantella tscal free \
--inuseby "o=Indigo Insurance/ou=Sales/cn=Elizabeth Blue"

tarantella tscal list

Use the tarantella tscal list command to list the Microsoft Windows Terminal Services CALs currently reserved for use by non-Windows clients.

Syntax
tarantella tscal list [ --inuseby user | --inuse | --free ] 
                      [ --type name ]
                      [ --format text|xml ]
Description

If you do not use any arguments, the command lists all CALs and shows whether or not they are in use.

If you run this command on a secondary server in an SGD array and the primary server is unavailable, the list might not be completely accurate. This is because the primary server is responsible for updating all SGD servers in the array with changes to CAL information. The command warns you if the primary is unavailable.

The following table shows the available options for this command.

Option
Description
--inuseby
List only the CALs being used by a particular user where the user is either of the following:

  • The name of a user.

  • A wild card filter.

You can use the tarantella emulatorsession list command to determine the name of a user.

The * character is the only character you can use in a wild card filter. It represents a string of any length containing any characters. So, an --inuseby "*green*" argument lists only the CALs for users whose name contains the string “green”.
--inuse
List only the CALs that are currently in use.
--free
List only the CALs that are currently not in use.
--type
List only the CALs that can connect to a particular type of Terminal Services server. This is either WinNT4-TS-CAL or Win200x-TS-CAL.

Note - The name is not case sensitive.
--format
Specifies the output format. The default setting is text.
Examples

The following example lists the CALs for non-Windows clients that are currently not in use.

$ tarantella tscal list --free

tarantella tscal return

Use the tarantella tscal return command to return all free Microsoft Windows Terminal Services CALs to the Windows license server.

Syntax
tarantella tscal return --free
Description

Note - The Windows license server might not reissue the returned CALs until approximately 90 days have elapsed since they were last in use.

Use the tarantella tscal free command to free a CAL so that it can be returned.

Normally, you do not need to run this command, as SGD automatically returns a CAL if it has not been used for 90 days. However, if an SGD server is removed from an array, you can use this command to manually return the CALs.

The following table shows the available options for this command.

Option
Description
--free
Returns all free CALs to the Windows license server.
Examples

The following example returns all free CALs to the Windows license server.

$ tarantella tscal return --free
Copyright © 2010, Oracle and/or its affiliates. All rights reserved. Legal Notices
Previous Next