clearlicense

Monitors and controls the product license database

APPLICABILITY

SYNOPSIS

clearlicense [ -pro·duct product-name ] [ -hos·tid | -rel·ease [ username | user-ID ] ... ]

DESCRIPTION

The clearlicense command reports the status of the ClearCase and Attache user licensing facility. You can also use this command to release users' licenses, making them available to other users.

RESTRICTIONS

None.

OPTIONS AND ARGUMENTS

Default: A report on licenses and user activity for all products with valid licenses is displayed, in the format described above.

-pro·duct product-name

Specifies the product whose licensing information is to be displayed or changed. product-name must match (including capitalization) the word that follows -license in the product's license entry-for example: ClearCase, Attache, MultiSite, and Attache-MultiSite.

-hos·tid

Displays the machine identifier of the host on which you invoke the command (for ClearCase) or the helper host's machine identifier (for Attache).

To obtain the license-server-host-ID for the License Registration Form (located in the Installation Guide; to be used when you want to add licenses to an existing license database or add a license server host), log on to the current or future license server host and run clearlicense -hostid.

-rel·ease [ username | user-ID ] ...

Specifies users (by user name or by numeric user-ID) whose licenses are to be revoked. Using -release without an argument causes your own license to be revoked. To discourage license battles among users, albd_server prevents this option from being used an excessive number of times during any single period (for Attache) or day (for all other products).

LICENSING ERRORS

This section describes errors typically encountered in licensing.

Problems with License Host File

If the UNIX file /var/adm/atria/config/license_host or the Windows registry key value LicenseHost does not exist or is empty, this message appears:

Additional error messages may be displayed or written to /var/adm/atria/log/view_log or the the Windows Event Viewer:

Error: You do not have a license to run ClearCase.

Error: Your license server is not specified.

UNIX platform errors may include:

Error: Unable to open file "/var/adm/atria/config/license_host": No such file or directory.

Error: Your license server is not specified.
Create "/var/adm/atria/config/license_host" and put the license server hostname in it.

Windows platform errors may include:

Error: Unable to query value of LicenseKeys in the NT Registry; NT error Windows-NT-status-code.

Error: Unable to read LicenseKeys from the NT Registry; NT error Windows-NT-status-code.

Problems with License Server Host

If the license server host cannot be contacted, this message appears:

In addition, error messages are displayed or are logged to

• the file /var/adm/atria/log/view_log (UNIX):

Error: Cannot contact license server host "hostname"
defined in file /var/adm/atria/config/license_host

Error: You do not have a license to run ClearCase.

• or to the Event Viewer (Windows):

Error: Cannot contact license server host "hostname"
defined in HKEY_LOCAL_MACHINE\SOFTWARE\Atria\ClearCase\CurrentVersion\LicenseHost.

Error: You do not have a license to run ClearCase.

Error: Error Windows-NT-status-code reading license server hostname from the NT Registry.

Losing a License

If you lose your license while a view is active, this message appears when you try to use the product:

SEE ALSO

Administrator's Guide