Skip past navigation linksSecure Global Desktop 4.31 Administration Guide > Commands > The tarantella license query command

The tarantella license query command

Syntax

Skip past command syntax or program codetarantella license query [ --now
                         | --history [--format text|csv|xml] 
                         | --maxusers [--format text|xml] ]

Description

Displays information on license usage across the array, including license infringements.

To avoid inconsistencies arising from the replication of data across the array, you must run this command on the primary server in the array.

Note This command only shows the license usage for the software components that are licensed on a per-user basis.

Secure Global Desktop maintains a history of license usage for 30 samples. A sample is created every day, whenever the server is restarted (warm or cold), and whenever your license keys change (licenses added or removed).

Argument Description
--now Displays information on the current license usage across the array. This is the default if no arguments are specified.
--history [--format text | csv | xml] Displays recent historical information on license usage across the array.

The license usage information is broken down by sample and software component. For each component, the command displays:

  • the number of licenses used;
  • the number of licenses available; and
  • the maximum number of users using a component during the sample period (the peak).

Use --format to specify the output format (by default, "text").
--maxusers [--format text | xml] Use this option to display the number and the full TFN names of users who were consuming a license when license usage peaked in the history (30 samples) kept by Secure Global Desktop.

A user consumes licenses if:

  • they are logged in to Secure Global Desktop; or
  • they have a suspended emulator session; or
  • they are within the lease period for a named-user license.

Note Anonymous or guest users will only be listed once.

The output distinguishes between standard and secure connections.

Use --format to specify the output format (by default, "text").

Information on recent license infringements is also shown whenever a Secure Global Desktop Administrator logs in to Secure Global Desktop.

Examples

Skip past command syntax or program code$ tarantella license query --now
License usage at: Tue Feb 20 12:42:21 GMT 2007
Type                In use / Total
Base                9      / 100
UNIX                9      / 100
Mainframe           0      / 100
Windows             5      / 100
AS/400              0      / 100

Displays information on the current license usage across the array.

Skip past command syntax or program code$ tarantella license query --history
2007/02/14 15:45:07:
 - Base       in use:     5 / 100         peak: 15
 - UNIX       in use:     5 / 100         peak: 15
 - Mainframe  in use:     0 / 100         peak: 0
 - Windows    in use:     3 / 100         peak: 12
 - AS/400     in use:     0 / 100         peak: 0
 - TASP       in use:     0 / 100         peak: 0
2007/02/15 13:25:53:
 - Base       in use:     9 / 100         peak: 16
 - UNIX       in use:     9 / 100         peak: 16
 - Mainframe  in use:     0 / 100         peak: 0
 - Windows    in use:     5 / 100         peak: 13
 - AS/400     in use:     0 / 100         peak: 0

Displays recent historical information on license usage across the array.

Skip past command syntax or program code$ tarantella license query --maxusers
Maximum number of users logged in: 3
  .../_ens/o=Indigo Insurance/ou=IT/cn=Bill Orange
  .../_ens/o=Indigo Insurance/ou=IT/cn=Ginger Butcher
  .../_ens/o=Indigo Insurance/ou=IT/cn=Rusty Spanner
Number of TSP users: 0

Displays the numbers and names of users who were logged in when license usage last peaked.

Related topics

Copyright © 1997-2007 Sun Microsystems, Inc. All rights reserved.