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.
→ rational_server_temp.dat: Contains all temporary floating license keys on a license server. Obtain a permanent license key to continue to use your Rational product.
→ rational_server_perm.dat: Contains all permanent floating license keys on a license server. Go to Rational License Key Center to request new 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 temporary/evaluation/trial license.
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:
HKEY_LOCAL_MACHINE\SOFTWARE\Flexlm License Manager\Flexlm license manager\License
Note: On 64-bit Windows 7 platform, please navigate to the following key:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Flexlm license manager\License
3. Modify the current value, and specify the complete paths to the two license files, separated with a semi-colon “;”.
C:\Program Files (x86)\IBM\RationalRLKS\common\rational_server_perm.dat;C:\Program Files (x86)\IBM\RationalRLKS\common\rational_server_temp.dat
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 <path_to_license_file>
2).Restart the Rational License Server process using the following command:
lmgrd -c <path_to_perm_file>;<path_to_temp_file>
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 rational_server_temp.dat or rational_temp.dat.
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://www.ibm.com/support/docview.wss?uid=swg21122042
→ Rational License File Management: http://www.ibm.com/support/docview.wss?uid=swg27038595
→ Rational Common Licensing 8.1.4: http://pic.dhe.ibm.com/infocenter/rational/v0r0m0/index.jsp?topic=/com.ibm.rational.license.doc/topics/t_define_lic_types.html