Smarts Products: How to interpret FLEXlm error code messages used for licensing issues

Products

• VMware Smart Assurance

Environment

VMware Smart Assurance - SMARTS

Resolution

This article explains how to interpret FLEXlm error code messages used for licensing issues with Smarts products, and presents the following information:

• Smarts FLEXlm Error Message Components
• FLEXlm Error Message Formats - Short and Long
• FLEXlm Error Code Descriptions

Smarts FLEXlm Error Message Components
FLEXlm error messages presented by Smarts applications have the following components:

• FLEXlm Error Code: A negative number starting at -1. The table in the following FLEXlm Error Code Descriptions section lists the FLEXlm error codes for -1 to -128 and their meanings.
• FLEXlm Error Text: A short sentence (< 80 characters) summarizing problem.
• FLEXlm Error Explanation (optional): A short paragraph (3-5 lines) explaining problem and possible solutions or workarounds. This message component is not used in the "short" format described in the following section.
• FLEXlm Minor Error Number: A positive number starting at 1. These numbers are unique error identifiers and are used by Smarts products for more advanced support assistance. Their meaning is not documented.
• System Error Number (optional): A UNIX or Windows OS error code last set by the operating system.
• System Error Explanation (optional): A short sentence (< 80 characters) explaining the system error.
• Other supporting information (optional).

FLEXlm Error Message Formats - Short and Long
FLEXlm error messages may occur in two formats (short and long), or may appear in a format customized by the application.

• Format 1 (Short): The short format includes the FLEXlm error messag components of Error Text, Error Code, and Minor Error Number, as well as the System Error Number and possibly the System Error Explanation text (the System Error Explanation text may not be included). The syntax of the short FLEXlm error message format is as follows:

FLEXlm error text (-lm_errno, minor_num:[sys_errno]) [sys_error_text]

 

Example
The following is an example of the short format error message for FLEXlm Error Code -15:
 

Can t connect to license server (-15,12:61) Connection refused

• Format 2 (Long, FLEXlm version 6.0 and later): FLEXlm error messages were enhanced in FLEXlm v6.0 with the "long" version of the error message format. The long format includes the FLEXlm Error Explanation and supporting information. The long format is only shown/available in applications using FLEXlm v6.0 and later. The syntax of the long FLEXlm error message format is as follows:

FLEXlm error text

 FLEXlm error explanation
[Optional Supporting information]
FLEXlm error: -lm_errno, minor_num. [System Error: sys_errno] [ system_error_text ]

Example
The following is an example of the long format error message, also for FLEXlm Error Code -15:

Cannot connect to license server
 The server (lmgrd) has not been started yet, or
 the wrong port@host or license file is being used, or the
 port or hostname in the license file has been changed.
Feature: f1
Server name: localhost
License path: @localhost:license.dat:./*.lic
FLEXlm error: -15,12. System Error: 61  Connection refused 

FLEXlm Error Code Descriptions
The following table presents the descriptions for the most common error codes produced by FLEXlm-licensed products such as Smarts applications.

FLEXlm Error Codes and Descriptions

Error Code	Description
-1	Cannot find license file.
-2	Invalid license file syntax.
-3	No server for this feature.
-4	Licensed number of users already reached.
-5	No such feature exists.
-6	No TCP/IP port number in license file and FLEXlm service does not exist. (pre-v6 only)
-7	No socket connection to license manager service.
-8	Invalid (inconsistent) license key or signature. The license key/signature and data for the feature do not match. This usually happens when a license file has been altered.
-9	Invalid host. The hostid of this system does not match the hostid specified in the license file.
-10	Feature has expired.
-11	Invalid date format in license file.
-12	Invalid returned data from license server.
-13	No SERVER lines in license file.
-14	Cannot find SERVER host name in network database. The lookup for the host name on the SERVER line in the license file failed. This often happens when NIS or DNS or the hosts file is incorrect. Workaround: Use IP address (e.g., 123.456.789.123) instead of host name.
-15	Cannot connect to license server. The server (lmgrd) has not been started yet, or the wrong port@host or license file is being used, or the TCP/IP port or host name in the license file has been changed.
-16	Cannot read data from license server.
-17	Cannot write data to license server.
-18	License server does not support this feature.
-19	Error in select system call.
-21	License file does not support this version.
-22	Feature checkin failure detected at license server.
-23	License server temporarily busy (new server connecting).
-24	Users are queued for this feature.
-25	License server does not support this version of this feature.
-26	Request for more licenses than this feature supports.
-29	Cannot find ethernet device.
-30	Cannot read license file.
-31	Feature start date is in the future.
-32	No such attribute.
-33	Bad encryption handshake with daemon.
-34	Clock difference too large between client and server.
-35	In the queue for this feature.
-36	Feature database corrupted in daemon.
-37	Duplicate selection mismatch for this feature. Obsolete with v8.0+ vendor daemon.
-38	User/host on EXCLUDE list for feature.
-39	User/host not on INCLUDE list for feature.
-40	Cannot locate dynamic memory.
-41	Feature was never checked out.
-42	Invalid parameter.
-47	Clock setting check not available in daemon.
-52	FLEXlm vendor daemon did not respond within timeout interval.
-53	Checkout request rejected by vendor-defined checkout filter.
-54	No FEATURESET line in license file.
-55	Incorrect FEATURESET line in license file.
-56	Cannot compute FEATURESET data from license file.
-571	socket() call failed.
-59	Message checksum failure.
-60	Server message checksum failure.
-61	Cannot read license file data from server.
-62	Network software (TCP/IP) not available.
-63	You are not a license administrator.
-64	lmremove request before the minimum lmremove interval.
-67	No licenses to borrow.
-68	License BORROW support not enabled.
-69	FLOAT_OK can t run standalone on SERVER.
-71	Invalid TZ environment variable.
-73	Local checkout filter rejected request.
-74	Attempt to read beyond end of license file path.
-75	SYS$SETIMR call failed (VMS).
-76	Internal FLEXlm error please report to Macrovision.
-77	Bad version number must be floating-point number with no letters.
-82	Invalid PACKAGE line in license file.
-83	FLEXlm version of client newer than server.
-84	USER_BASED license has no specified users - see server log.
-85	License server doesn t support this request.
-87	Checkout exceeds MAX specified in options file.
-88	System clock has been set back.
-89	This platform not authorized by license.
-90	Future license file format or misspelling in license file. The file was issued for a later version of FLEXlm than this program understands.
-91	ENCRYPTION_SEEDS are non-unique.
-92	Feature removed during lmreread, or wrong SERVER line hostid.
-93	This feature is available in a different license pool. This is a warning condition. The server has pooled one or more INCREMENT lines into a single pool, and the request was made on an INCREMENT line that has been pooled.
-94	Attempt to generate license with incompatible attributes.
-95	Network connect to this_host failed. Change this_host on the SERVER line in the license file to the actual host name.
-96	Server machine is down or not responding. See the system administrator about starting the server, or make sure that you re referring to the right host (see LM_LICENSE_FILE environment variable).
-97	The desired vendor daemon is down. 1) Check the lmgrd log file, or 2) Try lmreread.
-98	This FEATURE line can t be converted to decimal format.
-99	The decimal format license is typed incorrectly.
-100	Cannot remove a linger license.
-101	All licenses are reserved for others. The system administrator has reserved all the licenses for others. Reservations are made in the options file. The server must be restarted for options file changes to take effect.
-102	A FLEXid borrow error occurred.
-103	Terminal Server remote client not allowed.
-104	Cannot borrow that long.
-106	License server out of network connections. The vendor daemon can't handle any more users. See the debug log for further information.
-110	Dongle not attached, or can t read dongle. Either the hardware dongle is unattached, or the necessary software driver for this dongle type is not installed.
-112	Missing dongle driver. In order to read the dongle hostid, the correct driver must be installed. These drivers are available at www.macrovision.com or from your software vendor.
-113	Two FLEXlock checkouts attempted. Only one checkout is allowed with FLEXlock-enabled applications.
-114	SIGN= keyword required, but missing from license. This is probably because the license is older than the application. You need to obtain a SIGN= version of this license from your vendor.
-115	Error in Public Key package.
-116	CRO not supported for this platform.
-117	BORROW failed.
-118	BORROW period has expired.
-119	lmdown and lmreread must be run on license server machine.
-120	Cannot lmdown the server when licenses are borrowed.
-121	FLOAT_OK license must have exactly one dongle hostid.
-122	Unable to delete local borrow info.
-123	Support for returning a borrowed license early is not enabled. The vendor must have enabled support for this feature in the vendor daemon. Contact the vendor for further details.
-124	An error occurred while returning a borrowed license to the server.
-125	Attempt to checkout just a PACKAGE. Need to also checkout a feature.
-126	Error initializing a composite hostid.
-127	A hostid needed for the composite hostid is missing or invalid.
-128	Error, borrowed license doesn't match any known server license.