Question & Answer
Question
Can User-based and Floating User licenses coexist on the same license server? When I try to mix the two, I get errors such as, License checkout failure: User/host not on INCLUDE list for feature, and FLEXlm error: -39,147
Cause
This issue is caused by the license file configuration. When multiple license keys for the same product are added in the same license file, the license server sorts those licenses in the following way (taken from the FlexNet Publisher End user guide):
Sort Rules
Feature definition lines are automatically sorted when they are read from the license file. The default sorting rules are as follows:
- License file. Automatic sorting does not occur across files in a license search path.
- Feature name.
- FEATURE before INCREMENT.
- Uncounted before counted.
- Version, later versions after earlier versions.
- Issued date, in reverse order, newest first. The date is taken from ISSUED= or START=.
- Original order is otherwise maintained.
Answer
Two changes are needed in the license file:
- Automatic ordering needs to be disabled. This is done by adding the SORT attribute on the INCREMENT line.
- The "INCLUDE" lines in the options file for the user or group-specific licenses need to be changed to specify which particular license key is referred to by the line.
For example, given the following options and license files (All host ID's and key ID's are intentionally invalid)
ibmratl.opt
-----------------------------------------------------------
GROUP PurifyPlus_000 myuser1 myuser2
INCLUDE purify GROUP PurifyPlus_000
-----------------------------------------------------------
license.dat
-----------------------------------------------------------
SERVER myserver 0012a34bc56d <lmgrd port number>
VENDOR ibmratl <port=nnnnnn> (where nnnnnn stands for the port number that you have reserved for the ibmratl vendor daemon)
INCREMENT PurifyPlusUNIX rational 5.00000 permanent 2 123456789ABC \
VENDOR_STRING="0|NamedUser| |purecov:5.0 purify:5.0 quantify:5.0" \
USER_BASED DUP_GROUP=UH vendor_info="0|IBM Rational \
PurifyPlus for Linux and UNIX Named User License Key|0" ISSUED=31-Mar-2011 \
NOTICE="Sales Order Number: 0123 for Company X" ck=121 SN=1234567
INCREMENT PurifyPlusUNIX rational 5.00000 15-Dec-2011 2 CBA987654321 \
INCREMENT PurifyPlusUNIX rational 5.00000 15-Dec-2011 2 CBA987654321 \
VENDOR_STRING="0|Floating| |purecov:5.0 purify:5.0 quantify:5.0" \
OVERDRAFT=0 DUP_GROUP=UH vendor_info="0|IBM Rational \
PurifyPlus for Linux and UNIX Floating License Key|0" ISSUED=31-Mar-2001 \
NOTICE="Sales Order Number: 3210 for Company X" ck=83 SN=7654321
-----------------------------------------------------------
The new options file would have to read:
-----------------------------------------------------------
GROUP PurifyPlus_000 myuser1
INCLUDE purify:KEY=123456789ABC GROUP PurifyPlus_000
-----------------------------------------------------------
And the new License file would have to read:
-----------------------------------------------------------
SERVER myserver 0012a34bc56d <lmgrd port number>
VENDOR ibmratl <full path to the ibmratl.opt file> <port=nnnnnn> (where nnnnnn stands for the port number that you have reserved for the ibmratl vendor daemon.)
INCREMENT PurifyPlusUNIX rational 5.00000 permanent 2 123456789ABC \
SORT=50 VENDOR_STRING="0|NamedUser| |purecov:5.0 purify:5.0 quantify:5.0" \
-----------------------------------------------------------
The new options file would have to read:
-----------------------------------------------------------
GROUP PurifyPlus_000 myuser1
INCLUDE purify:KEY=123456789ABC GROUP PurifyPlus_000
-----------------------------------------------------------
And the new License file would have to read:
-----------------------------------------------------------
SERVER myserver 0012a34bc56d <lmgrd port number>
VENDOR ibmratl <full path to the ibmratl.opt file> <port=nnnnnn> (where nnnnnn stands for the port number that you have reserved for the ibmratl vendor daemon.)
INCREMENT PurifyPlusUNIX rational 5.00000 permanent 2 123456789ABC \
SORT=50 VENDOR_STRING="0|NamedUser| |purecov:5.0 purify:5.0 quantify:5.0" \
USER_BASED DUP_GROUP=UH vendor_info="0|IBM Rational \
PurifyPlus for Linux and UNIX Named User License Key|0" ISSUED=31-Mar-2011 \
NOTICE="Sales Order Number: 0123 for Company X" ck=123 SN=1234567
INCREMENT PurifyPlusUNIX rational 5.00000 15-Dec-2011 2 CBA987654321 \
SORT=75 VENDOR_STRING="0|Floating| |purecov:5.0 purify:5.0 quantify:5.0" \
SORT=75 VENDOR_STRING="0|Floating| |purecov:5.0 purify:5.0 quantify:5.0" \
OVERDRAFT=0 DUP_GROUP=UH vendor_info="0|IBM Rational \
PurifyPlus for Linux and UNIX Floating License Key|0" ISSUED=31-Mar-2001 \
NOTICE="Sales Order Number: 3210 for Company X" ck=83 SN=7654321
-----------------------------------------------------------
These changes ensure that the user-based licenses are checked first, preventing the users on the INCLUDE lists from using the standard floating licenses. Note that the user names for IBM Common Licensing are case-sensitive, which may mean that additional user names may be needed for products running on Microsoft Windows, where OS user names are not case-sensitive.
-----------------------------------------------------------
These changes ensure that the user-based licenses are checked first, preventing the users on the INCLUDE lists from using the standard floating licenses. Note that the user names for IBM Common Licensing are case-sensitive, which may mean that additional user names may be needed for products running on Microsoft Windows, where OS user names are not case-sensitive.
For more information about IBM Common Licensing, see the IBM Knowledge Center (https://www.ibm.com/support/knowledgecenter/SSSTWP_8.1.6/com.ibm.rational.license.doc/helpindex_RCL.html).
[{"Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSTMW6","label":"Rational License Key Server"},"ARM Category":[{"code":"a8m0z0000001i5rAAA","label":"Rational licensing->License Key Server->Configuration"}],"ARM Case Number":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"}],"Version":"8.1.1;8.1.2;8.1.3;8.1.4;8.1.5;8.1.6"}]
Was this topic helpful?
Document Information
Modified date:
09 September 2020
UID
swg21472462