Monitoring IBM Rational token based licenses – KB4001a2
Token licenses are a form of floating license, only that instead of having a pool of licenses they have a pool of tokens. When a feature is checked-out, a predefined amount of tokens is consumed. The number of consumed tokens is specific to each feature, and is apparent in the feature/Increment line in the license file. When the application is closed, the tokens are returned to the pool for other end users to use.
The IBM Rational licenses are managed by the FlexLM license manager. As such, OpenLM is capable of monitoring IBM Rational license consumption and provide usage reports on the EasyAdmin web application.
In previous versions, OpenLM would only present the IBM Rational token feature (TLSTOK), and would not elaborate on the consumption of actual features within TLSTOK. With the latest OpenLM 3.1 update, OpenLM treats the TLSTOK feature as package, and all its token based features as part of that package.
In order to obtain IBM Rational feature usage reports, the OpenLM system must be configured to
1. Monitor the IBM Rational Flexlm license manager
2. Employ an OpenLM Broker on the license server machine and
3. Read the IBM Rational license file.
Please read the following Application note for more information:
Specifically relate to the “OpenLM Broker configuration for FlexLM” and “Obtaining License file information” paragraphs.
In the example below, the OpenLM Server is configured to monitor an IBM Rational license manager (‘my_lm_host’) on port 27000.
The Broker is configured to monitor the same License server (my_lm_host) on that same port (27000). The “Watch license file” has been checked, and the IBM Rational license file’s full path has been introduced into the path text box.
The license file in this case contains a number of licensed features within the TLSTOK package, and a single licensed feature (ibmida) that is exterior to that package.
SERVER <server_name> <MAC_address> 27000 VENDOR ibmratl INCREMENT ibmida ibmratl <version> permanent <number> DUP_GROUP=UH \ vendor_info= “..."IBM InfoSphere Data Architect Floating License key…” ... INCREMENT TLSTOK ibmratl … vendor_info="... Rational Main Token Feature|0" … INCREMENT Change telelogic ... VENDOR_STRING=IBM:t,TLSTOK,1.0,Change,5 … ... INCREMENT LT_Playback_1000VU rational … VENDOR_STRING= … IBM:t,TLSTOK … LT_Playback_1000VU , 69 …
The IBM Rational license file makes use of several vendor names, e.g: ibmratl, telelogic and rational. OpenLM treats all these vendor types as one, unifying usage under a single vendor name: ibmratl.
The “Main Token feature” (TLSTOK) is displayed as a package, with a + sign on its left.
Expand the + sign to display the token based features members of TLSTOK.
The Token cost of each member feature is displayed in the ‘Cost (Tokens)’ column, which is hidden by default. make it visible by clicking the down arrow on one of the columns:
Below is an EasyAdmin ‘Licenses’ report window, concurrent with the same license file.
- The ibmida feature standing alone from the TLSTOK package
- 5 licenses allocated for ‘Change’ and 69 licenses for ‘LT_Playback_1000VU ’ within the TLSTOK package.
License Usage may be reported for both the TLSTOK ‘Main Token Feature’ as well as per member feature.
Concurrent IBM Rational license usage is presented in the “Currently Consumed Licenses” window. Note the usage of all consumed ‘ibmratl’ licenses, presented with their respective “consumed tokens”.