User host not on INCLUDE list for feature

Technote (troubleshooting)


Problem(Abstract)

Attempts to check out a license result in the error "User host not on INCLUDE list for feature" when using IBM Rational products.

Symptom

Attempts to check out a license result in error message similar to this example attempt to obtain a license for IBM Rational PurifyPlus:

Error: License checkout failure: User/host not on INCLUDE list for feature.

Feature: PurifyPlusUNIX
License path: 27000@hostname
FLEXnet Licensing error:-39,147

For further information, refer to the FLEXnet Licensing End User Guide, available at "www.macrovision.com".

In 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.


Cross reference information
Segment Product Component Platform Version Edition
Software Development Rational Purify Licensing AIX, HP-UX, Linux, Solaris, Windows 7.0, 7.0.1
Software Development Rational Quantify Licensing AIX, HP-UX, Linux, Solaris, Windows 3.0.1, 3.0.1.1, 3.0.1.2, 3.0.1.3
Software Development Rational PureCoverage Licensing AIX, HP-UX, Linux, Solaris, Windows 3.0.1, 3.0.1.1, 3.0.1.2, 3.0.1.3
Software Development Rational Team Concert Licensing Linux, Windows 3.0.1, 3.0.1.1, 3.0.1.2, 3.0.1.3

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Rational License Key Server
Option Files

Software version:

7.0, 8.1.1, 8.1.2

Operating system(s):

AIX, HP-UX, Linux, Solaris, Windows

Reference #:

1579675

Modified date:

2012-05-08

Translate my page

Machine Translation

Content navigation