The StarLicense Manager displays an error when a requested operation cannot be performed or a problem occurs. Some of the errors are passed to the application using the service, which may handle or display the error to the user differently from those shown below. Following are the errors and suggestions on how to resolve them.
Error |
Description |
API version mismatch |
An application using the Windows management interface has a later version of the interface than is available on the computer on which the application is running. Search the computer for versions of the Dynamic Link Library, starlicense_mgmt.dll, and remove or rename the older version to prevent it from loading. |
access denied |
If you are trying to modify a configuration, be sure that you are logged in with Administrator privileges. If a license server cannot read or write the configuration, verify that the license service is running with authority that allows access to and can update the Windows registry. |
error reading configuration |
|
error writing configuration |
|
invalid address |
The TCP/IP address specified for the listener is not valid. Execute the ipconfig command from a command prompt on the server to display the IP addresses assigned to it. |
invalid checksum |
The license key that you entered cannot be validated. Verify that you are entering the key exactly as it was provided to you by StarQuest, and that it was intended for use on this computer (license keys are based on the HostID or TCP/IP address of a particular computer). |
invalid license |
|
invalid mask |
The specified trace mask is not valid. Enter the series of hexidecimal digits as they were provided to you by StarQuest support. Tracing should be enabled only if StarQuest support needs a trace for diagnostic purposes.. |
invalid node lock |
The license key does not match the unique identifier for this computer. License keys are based on the HostID or TCP/IP address of a particular computer. If you change the IP address of a computer, you must obtain a new license key from StarQuest. |
invalid port |
The port number on which you want the server to listen for license requests is not valid on the license server. The port may be in use by another application, or outside the range of valid port numbers. Execute the netstat -a command from a command prompt to see which ports are in use, and try a different port number. |
invalid product ID |
There are no licenses installed for the specified product ID. Contact the product vendor to obtain a license key for using the product. |
invalid value |
A value specified for configuring the license server or listener is not valid. Verify the correct TCP/IP address and port and re-enter the configuration information. |
license has expired |
A checkout cannot complete because the license has expired. Contact StarQuest to renew the license. |
license was revoked |
An administrator has revoked use of the license that was checked out. Try to check out another connection, or contact your administrator. |
memory allocation failure |
There is not enough memory available to complete the operation. Try the operation again. If the problem persists, review the event log on the server or client that is generating the error. |
no license(s) defined |
No licenses are configured in the license client. Obtain a license key from StarQuest to configure the license. |
platform specific error |
A platform-specific error occurred that could not be converted to a StarLicense error code. Check the Windows event log or the UNIX syslog for the local error code. |
protocol error |
The client license request or the license server response was incomplete. This may be due to network problems that are not related to the license client or server. Retry the operation. |
RPC error |
The Windows RPC management connection could not be established or was interrrupted. This may be due to network problems that are not related to the license client or server. Retry the operation. |
server is unavailable |
No license servers could be found to respond to the checkout request. Make sure the client is configured to use valid license servers, and that license servers are properly configured to listen to license requests. |