Skip past navigation linksSecure Global Desktop Administration Guide > Commands > The tarantella tscal free command

The tarantella tscal free command

Syntax

Skip past command syntax or program codetarantella tscal free [ --inuseby user | --calid id ]

Description

Use the tarantella tscal free command to free a Microsoft Windows Terminal Services Client Access License (CAL) so that it may be used by another non-Windows client.

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

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

You should not need to run this command as Secure Global Desktop automatically frees a CAL as soon as a user exits their last Windows application. However, if a Secure Global Desktop server is removed from an array or it loses contact with the array, it may 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 emulator sessions which use Windows Terminal Services.

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

Argument Description
--inuseby user Free only the CALs for a particular user where user is either:
  • the TFN name of a user; or
  • 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 TFN name contains the string 'green'.

--calid id 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

Skip past command syntax or program codetarantella tscal free --inuseby ".../_ens/o=Indigo Insurance/ou=Sales/cn=Elizabeth Blue"

Frees the CALs for Elizabeth Blue.

Related topics