FlexNet Server Returns Error - Number of INCLUDE Names Exceeds Limit

Updated Nov 2, 2026

Reported In

Software

  • Volume License Manager

Other

  • FlexNet Publisher (formerly known as FLEXlm)

Issue Details

After updating the license file on my FlexNet Server, none of the users assigned in the options file (.opt) can check out licenses for a specific user-based licensed package.
 
When launching the client software, all assigned users receive errors such as:
Your volume license server wasn't found
or messages indicating that the license has expired.
 
The license server is online, reachable from the network, and the license service is running. However, license checkout fails for every user included in the affected package. The license server debug log contains the following error:
USER_BASED license error ... Number of INCLUDE names exceeds limit of ...

Solution

This issue can occur in FlexNet Publisher user-based licensing environments when the number of users assigned to a package exceeds the licensed seat count.
 
The vendor daemon (nilm) enforces license seat allocations based on the user assignments defined in the options file (.opt). Be aware that duplicate INCLUDE entries for a single user count toward the total allocation. If a user has duplicated INCLUDE entries in the options file, a single user listed multiple times can consume multiple seat assignments.
 
For example, if a user is listed twice in separate INCLUDE statements for the same package, FlexNet counts each INCLUDE entry independently. In observed cases, each INCLUDE entry may consume two seat allocations for the package. As a result, a single user with two duplicate INCLUDE entries can consume four seats in total.
 
When the total number of INCLUDE entries exceeds the licensed limit defined in the license file (.lic), FlexNet generates the following error:
USER_BASED license error ... Number of INCLUDE names exceeds limit of ...
 
In this condition, the FlexNet server blocks license checkouts for all users assigned to the affected package. No user assigned to that package can successfully check out a license until the assignment count is reduced to within the licensed limit.
 
To resolve the issue:
  1. Open the active .opt file on the license server using a text editor.
  2. Locate the INCLUDE statements and any associated group definitions for the affected package.
  3. Review all assigned users.
  4. Remove duplicate INCLUDE statements or repeated user assignments so that each user is assigned only once.
  5. Verify that the total number of unique assigned users does not exceed the license entitlement defined in the .lic file.
  6. Save the updated .opt file.
  7. Reread the updated .opt file in LMTOOLS.
  8. Alternatively, stop and restart the NI Volume License Server service.
  9. Launch the client software and verify that license checkout completes successfully.

Additional Information

In FlexNet user-based licensing, the vendor daemon validates user assignments against the licensed seat count during license processing. Duplicate user assignments may unintentionally consume additional allocations and cause the total number of assigned users to exceed the licensed limit. When this occurs, license checkouts for the affected package are denied until the user assignments are corrected and the license server rereads the updated configuration.