Troubleshooting
Problem
Attempts to check out a license result in the error "User host not on INCLUDE list for feature" when using IBM Rational products.
Symptom
fpuriIn IBM Rational Team Concert, the following error will be seen in the IBM Rational Jazz Team Server (JTS) log file:
ERROR com.ibm.rational.common.token.licensing - com.telelogic.licensing.LicenseUnknownException
User/host not on INCLUDE list for feature.
Feature: JazzToken
License path: 19353@rtc.lic.tuc.us.ray.com:FLEXnet Licensing error:-39,147
Cause
FLEXnet licensing software allows you to reserve licenses for certain users, or groups of users, using an options file. This message usually means you are trying to check out a license reserved for another user or group.
Diagnosing The Problem
Check whether your license server was started with an options file.
- The path to the options file may appear in your license file as the fourth field on the VENDOR line (or DAEMON line), for example:
VENDOR ibmratl /path_to_ibmratl_daemon /any_path/any_name.opt
- If the path is omitted from the VENDOR line, the vendor daemon automatically looks for a file named vendor.opt (where vendor is the vendor daemon name, for example, ibmratl.opt) in the same directory as the license file.
The following option keywords restrict who may use licenses or where licenses may be used:
EXCLUDE, EXCLUDEALL, EXCLUDE_BORROW, INCLUDE, INCLUDEALL,
INCLUDE_BORROW, MAX, and RESERVE. These options take a type argument, which
specifies whether the restriction is based on USER, HOST, DISPLAY, INTERNET, or
PROJECT.
Resolving The Problem
Update your option file as desired, then stop and restart the license server lmgrd, or run the lmreread utility to force the VENDOR daemon to reread the options file.
Note: If LDAP is used for login in a mixed environment, the username from the Unix or Linux client might be different from the one on Microsoft Windows. For example, the username might be "domain/userid" on Linux and "userid" on Windows. Incorporated both names in the option file.
For details of option file usage and syntax, see the FLEXnet Licensing End User Guide from Flexera Software.
Product Synonym
Rational Team Concert
Was this topic helpful?
Document Information
Modified date:
16 June 2018
UID
swg21579675