clearlicense

Monitors and controls the product license database

Applicability

Product

Command type

VersionVault

command

MultiSite

command

Platform

UNIX

Linux

Windows

Synopsis

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

Description

The clearlicense command reports the status of the VersionVault user licensing facility. You can also use this command to release users' licenses, making them available to other users. As well, you can use it to specify the hostname for a license server to use for queries/operations.

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, VersionVault 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 (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.
-lic_host hostname
Specifies the hostname for a license server to use for queries/operations. Without the flag, clearlicense uses the first working server in the host's configured license server list.

Licensing errors

This section describes errors typically encountered in licensing.

Problems with license host file

If the UNIX or Linux file /var/adm/hcl/versionvault/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/hcl/versionvault/log/view_log or the the Windows Event Viewer:

Error: You do not have a license to run VersionVault.
Error: Your license server is not specified.

UNIX or Linux platform errors may include:

Error: Unable to open file
"/var/adm/hcl/versionvault/config/license_host":
              No such file or directory.
Error: Your license server is not specified.

Create "/var/adm/hcl/versionvault/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/hcl/versionvault/log/view_log:

    Error: Cannot contact license server host "hostname"
    defined in file /var/adm/hcl/versionvault/config/license_host
    Error: You do not have a license to run VersionVault.

  • On Windows, they are logged to the Event Viewer:

    Error: Cannot contact license server host "hostname"
    defined in HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Atria\ClearCase\CurrentVersion\LicenseHost.Error: You do not have a license to run VersionVault.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!