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. tarantella print cancel list Lists print jobs. tarantella print list move Moves queued print jobs from one SGD server to another. tarantella print move pause Pauses printing temporarily. tarantella print pause resume Resumes printing. tarantella print resume start Starts printing services for the array. tarantella print start status Displays information about printing services. tarantella print status stop Stops printing services for the array. tarantella print stop

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.

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.

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.

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.

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:

• Whether printing services are available, not available, or paused.

• The number of print jobs spooled.

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.

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"