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
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!