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

Syntax

Description

Examples

tarantella array clean

Syntax

Description

Examples

tarantella array detach

Syntax

Description

Examples

tarantella array edit_backup_primary

Syntax

Description

Examples

tarantella array join

Syntax

Description

Examples

tarantella array list

Syntax

Examples

tarantella array list_backup_primaries

Syntax

Description

Examples

tarantella array make_primary

Syntax

Description

Examples

tarantella array remove_backup_primary

Syntax

Description

Examples

The tarantella cache Command

Syntax

Description

Examples

The tarantella config Command

Syntax

Description

Examples

tarantella config edit

Syntax

Description

Examples

tarantella config list

Syntax

Description

Examples

The tarantella emulatorsession Command

Syntax

Description

Examples

tarantella emulatorsession list

Syntax

Description

Examples

tarantella emulatorsession info

Syntax

Description

Examples

tarantella emulatorsession shadow

Syntax

Description

Examples

tarantella emulatorsession suspend

Syntax

Description

Examples

tarantella emulatorsession end

Syntax

Description

Examples

The tarantella help Command

Syntax

Description

Examples

The tarantella object Command

Syntax

Description

Examples

tarantella object add_host

Syntax

Description

Examples

tarantella object add_link

Syntax

Description

Examples

tarantella object add_mapping

Syntax

Description

Examples

tarantella object add_member

Syntax

Description

Examples

tarantella object delete

Syntax

Description

Examples

tarantella object edit

Syntax

Description

Examples

tarantella object list_attributes

Syntax

Description

Examples

tarantella object list_contents

Syntax

Description

Examples

tarantella object new_3270app

Syntax

Description

Examples

tarantella object new_5250app

Syntax

Description

Examples

tarantella object new_charapp

Syntax

Description

Examples

tarantella object new_container

Syntax

Description

Examples

tarantella object new_dc

Syntax

Description

Examples

tarantella object new_doc

Syntax

Description

Examples

tarantella object new_dynamicapp

Syntax

Description

Examples

tarantella object new_group

Syntax

Description

Examples

tarantella object new_host

Syntax

Description

Examples

tarantella object new_org

Syntax

Description

Examples

tarantella object new_orgunit

Syntax

Description

Examples

tarantella object new_person

Syntax

Description

Examples

tarantella object new_windowsapp

Syntax

Description

Examples

tarantella object new_xapp

Syntax

Description

Examples

tarantella object remove_host

Syntax

Description

Examples

tarantella object remove_link

Syntax

Description

Examples

tarantella object remove_mapping

Syntax

Description

Examples

tarantella object remove_member

Syntax

Description

Examples

tarantella object rename

Syntax

Description

Examples

tarantella object script

Syntax

Description

Examples

The tarantella passcache Command

Syntax

Description

Examples

tarantella passcache delete

Syntax

Description

Examples

tarantella passcache edit

Syntax

Description

Examples

tarantella passcache list

Syntax

Description

Examples

tarantella passcache new

Syntax

Description

Examples

The tarantella print Command

Syntax

Description

Examples

tarantella print cancel

Syntax

Description

Examples

tarantella print list

Syntax

Description

Examples

tarantella print move

Syntax

Description

Examples

tarantella print pause

Syntax

Description

Examples

tarantella print resume

Syntax

Description

Examples

tarantella print start

Syntax

Description

Examples

tarantella print status

Syntax

Description

Examples

tarantella print stop

Syntax

Description

Examples

The tarantella query Command

Syntax

Description

Examples

tarantella query audit

Syntax

Description

Using a Filter

Examples

tarantella query billing

Syntax

Description

Examples

tarantella query errlog

Syntax

Description

Examples

tarantella query uptime

Syntax

Description

Examples

The tarantella restart Command

Syntax

Description

Examples

tarantella restart sgd

Syntax

Description

Examples

tarantella restart webserver

Syntax

Description

Examples

The tarantella role Command

Syntax

Description

Examples

tarantella role add_link

Syntax

Description

Examples

tarantella role add_member

Syntax

Description

Examples

tarantella role list

Syntax

Description

Examples

tarantella role list_links

Syntax

Description

Examples

tarantella role list_members

Syntax

Description

Examples

tarantella role remove_link

Syntax

Description

Examples

tarantella role remove_member

Syntax

Description

Examples

The tarantella security Command

Syntax

Description

Examples

tarantella security certinfo

Syntax

Description

Examples

tarantella security certrequest

Syntax

Description

Examples

tarantella security certuse

Syntax

Description

Examples

tarantella security customca

Syntax

Description

Examples

tarantella security decryptkey

Syntax

Description

Examples

tarantella security disable

Syntax

Description

Examples

tarantella security enable

Syntax

Description

Examples

tarantella security fingerprint

Syntax

Description

Examples

tarantella security peerca

Syntax

Description

Examples

tarantella security selfsign

Syntax

Description

Examples

tarantella security start

Syntax

Description

Examples

tarantella security stop

Syntax

Description

Examples

The tarantella service Command

Syntax

Description

Examples

tarantella service delete

Syntax

Description

Examples

tarantella service edit

Syntax

Description

Examples

tarantella service list

Syntax

Description

Examples

tarantella service new

Syntax

Description

Examples

The tarantella setup Command

Syntax

Description

Examples

The tarantella start Command

Syntax

Description

Examples

tarantella start cdm

Syntax

Description

Examples

tarantella start sgd

Syntax

Description

Examples

tarantella start webserver

Syntax

Description

Examples

The tarantella status Command

Syntax

Description

Examples

The tarantella stop Command

Syntax

Description

Examples

tarantella stop cdm

Syntax

Description

Examples

tarantella stop sgd

Syntax

Description

Examples

tarantella stop webserver

Syntax

Description

Examples

The tarantella tokencache Command

Syntax

Description

Examples

tarantella tokencache delete

Syntax

Description

Examples

tarantella tokencache list

Syntax

Description

Examples

The tarantella tscal Command

Syntax

Description

Examples

tarantella tscal free

Syntax

Description

Examples

tarantella tscal list

Syntax

Description

Examples

tarantella tscal return

Syntax

Description

Examples

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

Syntax

Description

Examples

tarantella webserver delete_trusted_user

Syntax

Description

Examples

tarantella webserver list_trusted_users

Syntax

Description

Examples

The tarantella webtopsession Command

Syntax

Description

Examples

tarantella webtopsession list

Syntax

Description

Examples

tarantella webtopsession logout

Syntax

Description

Examples

E.  Login Scripts

F.  Third-Party Legal Notices

Glossary

Index

The tarantella print Command

This command enables you to administer SGD printing services across the array.

Syntax

tarantella print start | stop | status | pause | resume | list | cancel | move

Description

The following table shows the available subcommands for this command.

Subcommand
Description
More Information
cancel
Cancels print jobs.
list
Lists print jobs.
move
Moves queued print jobs from one SGD server to another.
pause
Pauses printing temporarily.
resume
Resumes printing.
start
Starts printing services for the array.
status
Displays information about printing services.
stop
Stops printing services for the array.

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


Examples

The following example starts SGD printing services for the array.

$ tarantella print start

The following example lists all print jobs for Bill Orange.

$ tarantella print list \
--person "o=Indigo Insurance/ou=IT/cn=Bill Orange"

tarantella print cancel

Cancels SGD print jobs that are currently spooled.

You can run this command on any SGD server in the array.

Syntax
tarantella print cancel { 
                          --all | --person pobj... [--server serv]
                        | --server serv }
Description

The following table shows the available options for this command.

Option
Description
--all
Cancels all print jobs spooled across the array.
--jobid
Cancels jobs with the specified job IDs.
--person
Cancels jobs belonging to each specified user profile, which must be the name.

If this is used without --server, SGD cancels all print jobs for each specified user profile.

--server
Cancels jobs on each SGD server listed. Use the peer DNS name for each server.

If this is used with --person, SGD only cancels the print jobs for each specified user profile on each specified server.

Examples

The following example cancels print jobs for Bill Orange.

$ tarantella print cancel \
--person "o=Indigo Insurance/ou=IT/cn=Bill Orange"

The following example cancels all print jobs on the SGD server detroit.

$ tarantella print cancel --server "detroit.indigo-insurance.com"

tarantella print list

Lists print jobs currently spooled.

You can run this command on any SGD server in the array.

Syntax
tarantella print list 
         { --jobid id... | [ --person pobj... ] [ --server serv... ] }
         [ --format text|brief ]
Description

The following table shows the available options for this command.

Option
Description
--jobid
Lists jobs with the specified job IDs.
--person
Lists jobs belonging to each specified person, which must be the name.
--server
Lists jobs for each specified SGD server. Use the peer DNS name for each server.

If this is used with the --person option, SGD only lists the spooled print jobs for the specified user profile on that server.

--format
Specifies the output format.

The “text” format displays a block of text for each print job, showing each print job attribute, for example the job ID and job owner, on a new line. A blank line separates each job. This is the default.

The “brief” format shows print job attributes on one line.

If you omit --jobid, and --person or --server are used, all print jobs across the array are listed.

Examples

The following example lists print jobs for Bill Orange, in “text” format.

$ tarantella print list \
--person "o=Indigo Insurance/ou=IT/cn=Bill Orange"

The following example lists print jobs in “text” format for Bill Orange and Rusty Spanner on the SGD servers detroit and chicago.

$ tarantella print list \
--person "o=Indigo Insurance/ou=IT/cn=Bill Orange" \
"o=Indigo Insurance/ou=IT/cn=Rusty Spanner" \
--server "detroit.indigo-insurance.com" \
"chicago.indigo-insurance.com"

tarantella print move

Moves queued print jobs from one SGD server to another.

If an SGD server is temporarily unavailable, you can use this command to move the print jobs that are “stranded” on that server.


Note - This command only moves the print jobs that are currently in the SGD print queue. The SGD print queue is located at /opt/tarantella/var/print/queue.


Syntax
tarantella print move --server serv [ --printer printer_name ]
                    [ --cups { y | n |auto } ]
                    [ --preserve ]
Description

The following table shows the available options for this command.

Option
Description
--cups
Indicates that the SGD server you are moving print jobs from uses the Common UNIX Printing System (CUPS).

If you do not use this option, a default of auto is assumed and this means SGD tries to detect whether CUPS is being used. If CUPS is incorrectly detected, use this option to tell SGD whether CUPS is being used (y) or not (n).

--preserve
Forces SGD to copy rather than move the print jobs to the target SGD server. The original print jobs are kept in the SGD print queue.

Note - If SGD printing services are restarted on the original SGD server and the print jobs have not been deleted, they are printed.


--printer
The name of the printer on the SGD server where you are moving the print jobs. If you leave out this argument, a default of tta_printer is used.
--server
The fully qualified peer DNS name of the SGD server where you are moving the print jobs.
Examples

The following example moves print jobs from the SGD server where the command is run to the printer called tta_boston on the SGD server boston.indigo-insurance.com.

$ tarantella print move \
--server boston.indigo-insurance.com --printer tta_boston

tarantella print pause

You can run this command on any SGD server in the array.

Pauses SGD printing services. New print jobs continue to spool, but do not print until printing is resumed using tarantella print resume.

If --server is not used, this command pauses printing services across the array.


Note - Pausing printing services on individual SGD servers in the array can cause problems for users. Whenever you pause printing services, do so for the whole array.


Syntax
tarantella print pause [ --server serv... ]
Description

The following table shows the available options for this command.

Option
Description
--server
Pauses printing services on each SGD server listed. Use the peer DNS name for each server.
Examples

The following example pauses printing services across the array.

$ tarantella print pause

The following example pauses printing services on the SGD servers detroit and chicago.

$ tarantella print pause \
--server "detroit.indigo-insurance.com" \
"chicago.indigo-insurance.com"

tarantella print resume

Resumes SGD printing services, previously suspended with tarantella print pause. Any spooled jobs begin to print.

If --server is not used, this command resumes printing services across the array.

You can run this command on any SGD server in the array.


Note - Resuming printing services on individual SGD servers in the array can cause problems for users. Whenever you resume printing services, do so for the whole array.


Syntax
tarantella print resume [ --server serv... ]
Description

The following table shows the available options for this command.

Option
Description
--server
Resumes printing services on each SGD server listed. Use the peer DNS name for each server.
Examples

The following example resumes printing services across the array.

$ tarantella print resume

The following example resumes printing services on the SGD servers detroit and chicago.

$ tarantella print resume \
--server "detroit.indigo-insurance.com" \
"chicago.indigo-insurance.com"

tarantella print start

Starts SGD printing services. If --server is not used, this command starts printing services across the array.

You can run this command on any SGD server in the array.


Note - Starting printing services on individual SGD servers in the array can cause problems for users. Whenever you start printing services, do so for the whole array.


Syntax
tarantella print start [ --server serv... ]
Description

The following table shows the available options for this command.

Option
Description
--server
Starts printing services on each SGD server listed. Use the peer DNS name for each server.
Examples

The following example starts printing services across the array.

$ tarantella print start

The following example starts printing services on the SGD server detroit.

$ tarantella print start --server "detroit.indigo-insurance.com"

tarantella print status

Displays information about SGD printing services, including the following:

You can run this command on any SGD server in the array.

Syntax
tarantella print status [ --summary |
                          --server serv | 
                          --namemapping ]
Description

The following table shows the available options for this command.

Option
Description
--summary
Shows information for the array.
--server
Shows information for the SGD server listed. Use the peer DNS name for the server.
--namemapping
Lists all the current name mappings used for printing. The print name mapping table ensures that users can print from an application and then exit the application, without losing the print job.

These name mappings expire in time. You can set the expiry timeout on the Global Settings -> Security tab in the Administration Console.

Examples

The following example displays information about SGD printing services for the array.

$ tarantella print status --summary

tarantella print stop

Stops SGD printing services. Print jobs are not accepted and do not spool.

If --server is not used, this command stops printing services across the array.

You can run this command on any SGD server in the array.


Note - Stopping printing services on individual SGD servers in the array can cause problems for users. Whenever you stop printing services, do so for the whole array.


Syntax
tarantella print stop  [ --server serv... ][ --purge ]
Description

The following table shows the available options for this command.

Option
Description
--purge
Removes all pending print jobs. If you omit this, print jobs that are currently spooled are printed.
--server
Stops printing services on each SGD server listed. Use the peer DNS name for each server.
Examples

The following example stops printing services across the array, removing all pending print jobs.

$ tarantella print stop --purge

The following example stops printing services on the SGD server detroit.

$ tarantella print stop --server "detroit.indigo-insurance.com"