mquimby 060001FAVB Visits (2346)
Check out these recently published white papers for Rational License Server and the Rational Logiscope Eclipse integration!
Author: Indraneel Paul
Abstract: This white paper provides recommendations for maintaining a stable and efficient license service. The white paper also provides tips for enhancing the performance. Included is a case study on the performance benchmarks of Rational License Key Server 8.1.1. This white paper covers the different aspects essential for a successful deployment, such as system requirements, system resources, and network and security considerations.
Released: September 29, 2011
Author: Sandhya Boray
Abstract: The integration between Rational Logiscope and Eclipse enables you to be more efficient in the handling of code and modeling. This document describes the procedure to setup the integration between the two tools and optimize their strengths.
Released: October 28, 2011
mquimby 060001FAVB Visits (2508)
We have new tutorials on the IBM Education Assistant website for Rational. Rational Directory Server makes its debut on the site with an installation demonstration. There is also a new demonstration of installing ClearCase Remote Client (CCRC) for Eclipse.
Here are links to the demonstrations and to forms you can use to leave feedback. Your feedback helps us improve. The feedback form is quick and easy. Leave comments and let us know if these demonstrations help you achieve your goals!
What is IBM Education Assistant? IBM Education Assistant is a collection of multimedia educational modules designed to help you gain a better understanding of IBM software products and use them more effectively to meet your business requirements.
Take a tour of IBM Education Assistant
Find more great education modules here.
KushagraSharma(Kush) 270002FD5Y Visits (2819)
Rational Common licensing (RCL) v 8.1.3 has been released on July the 2nd 2012 The highlights of this release are
The advantages of moving to Rational License Key Server (RLKS 8.1.3) (11.10) server is Security and Performance; these are the two most important aspects that has been emphasized on this release. Users will benefit with a more detailed logging mechanism which will cater to the aspects of understanding any warning(s) or errors on the server side also help them keep a check on the performance of the license server.
Support for Early Return of Borrowed licenses
RCL 8.1.3 Borrow Tool has the “Return Product” button enabled and available on selecting one borrowed product from Borrowed Products table. On Clicking on “Return Products” button by selecting one or more borrowed products, It will go ahead with the Return Early operation.
Installation Manager based installation of RLKS 8.1.3 on UNIX
In order to upgrade to RLKS 8.1.3, you need to backup the license file used by older version of RLKS installation. Uninstall/remove the older version of RLKS installation and start the installation of RLKS 8.1.3. Configure the backed up license file in the configuration page of RLKS 8.1.3 installation.
@Sharma~Pankaj 270001DHR3 Visits (2315)
For a Rational License server ( version v 8.1.2 or above ) to work properly using IPv6 addresses, all systems in an enterprise (including the network hardware and software) must be configured properly to support communication using IPv6 addresses.
Before testing or deploying a Rational Common Licensing-supported or -based application that supports IPv6 or IPv4/IPv6 dual communication, make sure that all systems on the network can communicate successfully. If the license server will run under any of the following operating systems, it can communicate with clients using either IPv4 or IPv6 (as long as the network is configured properly).
Because these operating systems support dual-layer communication, both IPv4 and IPv6 enabled clients can communicate with an IPv6 license server. Moreover, IPv6 clients can communicate with an IPv4 license server using the IPv4 address, as seen below:
In the case of a license server hosted on Windows XP or Windows Server 2003 operating systems, there are certain drawbacks because of limited dual-layer support on these operating systems.
Author: Pankaj Sharma
Saurabh.Tyagi 270005CY2K Visits (2373)
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
@Sharma~Pankaj 270001DHR3 Visits (2491)
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
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.
NikhilBhat 270005V9K6 Visits (1356)
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
Saurabh.Tyagi 270005CY2K Visits (3385)
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.
RohitBalduwa 2700066W8H Visits (2756)
While using IBM WAS as an application server, there might be a need to understand certain artifacts here.
This helps in understanding the internal behavior and identifying the components in IBM WAS.
When you use the Administrative console to configure IBM WebSphere, certain XML files are updated internally. Here are the details:
Kartik_Chandrasekhar 2700060SE1 Visits (3219)
Sometimes in our days as technical support we find the need to validate what type of OS install is on a machine as a way to identify the environment in which a product may be encountering difficulties.
To help with that discovery, here are two commands we have found to check if an Ubuntu OS install is a server version or desktop setup:
Saurabh.Tyagi 270005CY2K Visits (1062)
"Software update" redirects here...
Keep calm and install a fix pack. It includes fixing security vulnerabilities and other bugs, and improving the usability or performance.
Fix list for Rational Common Licensing: http
Fix Central allows you to search, select, order, and download fixes to your system with a choice of delivery options. Fixes provide changes to your software, Licensed Internal Code, or machine code that fix known problems, add new function, and keep your system, software, or Hardware Management Console operating efficiently.
Fix Central has been designed to make it easy to find and obtain fixes by providing multiple search and ordering options.
These include the following:
The following are common fix related terms used in Fix Central:
NOTE: Fix Central may require you to log in using your IBM Registration user ID. IBM Registration is a central location for user information used throughout IBM web sites. If you have a sign-on to IBM web sites like Alphaworks or Passport Advantage, this signon is a valid IBM Web ID and can be used to log in to Fix Central. If you are prompted to sign in with an IBM ID and you do not have one, follow the register link provided on the Fix Central Sign On page. Creating an IBM Web ID is a one time, free process.
See My IBM profile summary to learn more about IBM Registration.
Fix Central provides fixes and updates for your system's software, hardware, and operating system : http
Author: Saurabh Tyagi, co-author Kiran Byrappa
Insight on log mechanism implemented in Rational License key server Administration and Reporting tool(ART) 8.1.4.x
@Sharma~Pankaj 270001DHR3 Visits (749)
In order to generate real time reports in ART tool, you need consistent and accurate data of License server logs. It is the log file that record license chec
Seeing loss of critical log data, a new log mechanism was developed and implemented in RLKS ART 22.214.171.124. Let me give you a brief high level overview of ART tool before we dive deep into the new log mechanism implemented in 126.96.36.199.
RLKS ART server
Maeve OReilly 270001WE6Q Visits (564)
I most commonly see DOORS Web Access (DWA) installed on its own server and I prefer this for two reasons:
An important related note is that DWA should be close to the DOORS database server. A ping should be less than 50ms between where the database server is running and where DWA is running. I have twice seen DWA put in a remote location (a different city), with ping times significantly in excess of 50ms. The performance was unacceptable with operations such as login and opening modules timing out.