Saurabh.Tyagi 270005CY2K Visits (3764)
IBM Rational Jazz token license configuration on Jazz team server
Token based licensing is an option, along with floating and authorized user licensing, within the Rational portfolio. Technically, the basis of token licensing is on the traditional floating license mechanism and process. However, when it comes to how the license check out (consumption) works, it has a different behavior.
In a token environment, each product consumes a predefined token value, not a predefined quantity as it does in a traditional floating licensing environment. The license key has a pool of tokens from which the license server automatically calculates the tokens being checked in and out across users and products.
Lets discuss how a token based licensing model can be implemented for Jazz-based products.
Jazz-based products use IBM Rational Common Licensing (RCL) token service provider, which is an extension of the Jazz Team Server (JTS) that forwards token requests to an IBM Rational License Key Server (RLKS). Jazz-based products and non Jazz-based products can share tokens from same pool of tokens.
How to generate Jazz tokens?
Log into the Rational license key center and follow the below steps to get the required Jazz tokens
You can also refer to the technote links below which will guide you in accomplishing this task:
To configure these Jazz based licenses, from a licensing perspective pre-requisites are:
The following picture shows a high level single server topology deployment of RTC using token licensing.
Once you have successfully configured your flexlm license server with token file, you downloaded from IBM Rational license key center (license.dat), Import the Jazz Keys (Jazz.Token.zip file) on the Jazz team server.
Post successful import of Jazz keys on the Jazz team server you will find an entry very similar to the below diagram
The above screen confirms that the Jazz tokens are successfully imported on the Jazz team server and we can now proceed to configure this Jazz Team Server to communicate with the Rational License Key Server that you installed and configured earlier.
In the Floating License Server section of the License Key Management page of your Jazz team server click the radio button next to IBM Rational Common Licensing Token Service to enable the service.
Hover over the icon in the Actions column until you see the edit hover. Click the icon to view the Server Configuration dialogs shown in following picture.
Configure the following two properties in the above dialog:
If the Jazz Team Server is able to connect to the Rational License Key Server, you'll see a green checkmark on the IBM Rational Common Licensing Token Service line as shown in following picture.
NikhilBhat 270005V9K6 Visits (1556)
Of late I have come across instances, where license administrators are facing issues related to permanent and temporary licenses. I thought it will be a good idea to provide all the relevant information through this post. Let me start with a description of license key types.
License key type : These are broadly categorized into two parts
Permanent: A license issued to a customer to run products for an indefinite period of time.
To order your permanent floating, named-user floating, or authorized user license keys for most products, use the IBM Rational License Key Center.
To acquire an authorized user license key for IBM Rational products based on the Eclipse framework, purchase and download an activation kit from Passport Advantage. See Requesting license keys for information about ordering keys from the License Key Center.
Temporary (evaluation or emergency): A time-limited license issued to a customer for running IBM Rational products. You can use it on any computer until the specified expiration date.
Temporary license keys can be floating or authorized user.
Temporary keys are generated only for single or multiple license servers. They are not generated for redundant servers.
NOTE : To evaluate a product, ask your sales representative for an evaluation key.
Important : License key files file name with description:
→ rational_temp.dat: Contains all authorized user temporary license keys. Obtain a permanent license key to use your IBM Rational product past the temporary license key expiration date.
→ rational_perm.dat: Contains all authorized user permanent license keys. Go to IBM Rational License Key Center to request permanent license keys.
Now as we know and understand the basics about licenses, we can move ahead to discuss a few issues related with using the licenses in your environment. To start off, I would like to discuss about using a newly generated temp
The figure below shows the contents of a temporary license file
the Host name is “this_host”
the host id is “ANY”
the host-id is “ANY” to signify that this license can be run on any machine irrespective of the license type,
But while configuring these licenses on the license key server you need to make sure that the host name is updated to reflect the the actual Host name of the machine on which the license key server is running.
If this is not done, license checkouts will not happen.
Steps to modify the temporary license file:
1. Open the temporary license file with notepad or any other text editor.
2. Replace this_host with hostname of the machine.
3. Save the changes and exit from text editor.
If the Rational license key server is running on the host ABCD, then the above steps should be followed and the updated file should look like the one below
There may be instances where you have to use both permanent and temporary license. The following discussion focuses on this.
How to serve both permanent and temporary licenses at the same time
As pointed out earlier for temporary licenses, the following files are used
and for permanent licenses, the following files are used
So we have to configure the license server to read two license files instead of one
Steps to make the license server to read two license files
If Rational License Key Server is configured as a Service
1. Open windows registry editor (regedit.exe)
2. Navigate to the following registry key:
Note: On 64-bit Windows 7 platform, please navigate to the following key:
3. Modify the current value, and specify the complete paths to the two license files, separated with a semi-colon “;”.
4. Close the registry editor and restart your Rational License Server.
If the license server was initially started as a process from a command prompt:
1. Stop the license server by using following command
lmutil lmdown -c <pat
2).Restart the Rational License Server process using the following command:
lmgrd -c <pat
Note: The 2 paths are separated by a semi-colon ";".
I would also mention that removing the references to expired temporary licenses is also very important. If not removed, the expired licenses can cause issues while importing new licenses.
To remove expired temporary licenses:
1. Navigate to location of rati
2. Open the file in a text editor.
3. Delete the lines or INCREMENT block(s) corresponding to the expired temporary licenses.
4. Restart the license server.
→ How to serve both permanent and temporary licenses at the same time: http
→ Rational License File Management: http
→ Rational Common Licensing 8.1.4: http
IBM Rational DOORS Next Gen is supported on Jazz platform helping you to collaborate with other Jazz platform tools like Rational Team Concert and Rational Quality Manager in your environment.
IBM Rational DOORS Next Generation provides additional features like:
Rational DOORS Next Gen has assumed the place of Rational Requirements Management (RM) for the Jazz platform that adds a requirements definition and management application on top of that common platform.
Now let’s discuss the DOORS Next Gen licensing concept.
DOORS Next Gen is the name rendered to the DOORS installation based on Jazz platform where you can enrich your client from a DOORS Next Gen Analyst or a Requirements Composer Client Access license. The contemporary version of the DOORS thick client is available too; this is DOORS 9.5.
Notice the fact, as per the screenshot above, that DOORS Next Gen and Rational Requirements Composer are based on Jazz platform activated by authorized or floating CALs (Client Access Licenses).
The Jazz admin can assign the licenses to the users by logging in to the License Management page which defines the level of access for each user.
Points to remember
I hope you've got the info you are looking for, but you might still have some questions in mind. If so, I invite you to take a look at the FAQs section below and to check out the Rati
See you folks. Let’s get together with my next blog post.
@Sharma~Pankaj 270001DHR3 Visits (2662)
The IBM Rational License key server v8.1.3 (v11.10) was released on July 2nd 2012 , which means now you can migrate to license server v8.1.3 if you have deployed any older version of license server. You can refer below tech note to know the system requirements of license server v8.1.3
Scenario B: Migration of Telelogic License server 2.x to 8.1.3
Scenario C : Migration of Rational License server 8.1.x to 8.1.3
Note: If you move the license server to a new host , you may need to rehost the license file. You have to return the license file created for the old license server on Rational License Key center website and regenerate the new license file using the host details of the new server.
Authors: Pankaj Sharma & Karthik M
Saurabh.Tyagi 270005CY2K Visits (2527)
If we look around, there are couple of applications now a days which can make our lives easier and help us in our day-to-day activities, There are “n” number of applications, software, tools, utilities, and much more. Let's discuss these tools which could actually help people diagnosing issues related to licensing, We will discuss a few basic components and then dig deeper into the errors and the tips and tricks on how they can be resolved.
NOTE: On Windows Vista run lmtools utility as an administrator.
Once the paths are defined we can save the services using “save service” tab ( right top corner ).
It's always recommended to Enable 'Use Services'; 'Start Server at Power Up', In order to maximize the output.
Service which needs to be started should be selected “(Lmgrd)” in this case, If it is not the case, go to “config services” tab, select the service to be used, and then return to “Start/Stop/Re-read tab.
Functional Check if the Server is Running:
3. Shows the version of FLEXlm, and indicates the state of the license manager if started or not.
If you see the screen above (and the output) it will show the status of the license server (it started detecting lmgrd process) So the “License Server Status : 27000@CYPRES”
License file(s) on CYPRES: E:\FlexLM\License (This is the physical path of the license file),
Proceeding further we have the version of the License Server (License Server UP (MASTER) v10.1).
Then it will show that the Vendor daemon status and Feature usage information (If the licenses are issued and how many are in use), Please see the output below,
Vendor daemon status (on CYPRES):
ibmratl: UP v10.1
Feature usage info: How many licenses are served/issued from the server and how many in use,
Users of Distributor: Total of 3 licenses issued; Total of 2 licenses in use
Users of Presenter: Total of 3 licenses issued; Total of 2 licenses in use
Users of DOORS: Total of 3 licenses issued; Total of 2 licenses in use
Users of DRL: Total of 3 licenses issued; Total of 2 licenses in use
If there is an issue with the License server or with License file it will throw an error and will not have the feature usage info as license issued.
FLEXlm Error -97 rational daemon process suddenly locks up:
Error message on the LMTools Perform Status Enquiry output:
Author: Saurabh Tyagi