Error Messages

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.