clearlicense

Monitors and controls the product license database

Applicability

Product	Command type
ClearCase®	command
MultiSite	command

Platform
UNIX®
Linux®
Windows®

Synopsis

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

Description

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

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 and MultiSite.
–hos/tid: Displays the machine identifier of the host on which you invoke the command.
To obtain the license server host ID for the License Registration Form (located in the IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT Installation and Upgrade 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 day.

Licensing errors

This section describes errors typically encountered in licensing.

Problems with license host file

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

mvfs: ERROR: view view-tag not licensed!
command-name: .: Input/Output error

Additional error messages may be displayed or written to /var/adm/rational/clearcase/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 or Linux platform errors may include:

Error: Unable to open file “/var/adm/rational/clearcase/config/license_host”: No such file or directory. Error: Your license server is not specified. Create “/var/adm/rational/clearcase/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 is displayed:

mvfs: ERROR: view view-tag not licensed!

command-name: .: I/O error

In addition, error messages are displayed or are logged.

On UNIX and Linux, they are logged to the file /var/adm/rational/clearcase/log/view_log:
Error: Cannot contact license server host "hostname"
defined in file /var/adm/rational/clearcase/config/license_host Error: You do not have a license to run ClearCase.
On Windows, they are logged to the Event Viewer:
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 is displayed when you try to use the product:

mvfs: ERROR: view shtest - all licenses in use!