Troubleshooting
Problem
This technote provides an explanation of the potential causes for the FLEXlm -12 error that can occur on a IBM® Rational® 2001a.04.00 and v2002.05.xx client systems. This technote also provides a patch that may correct this error on your systems.
Symptom
Client systems might receive the following error:
FLEXlm error: -12,122 Invalid returned data from license server
Cause
Conflicting third party software is interfering with the communication between the FLEXlm License Server and client machines. Some products involve firewall, security, and/or anti-virus protection. This is reported Defect RATLC00001777 and has been resolved in v2003.06.xx of the IBM Rational products.
Resolving The Problem
A client system is attempting to obtain an IBM Rational floating license from a license server.
Verify the following:
- The client system's configuration and settings are correct.
- The license server is running and able to serve licenses.
- Network communication is available server-to-client and client-to-server, (can "ping" in both directions).
- Other client machines are able to acquire a license from the server.
There are a number of third party products that cause interference with the communication between the license server and client machines.
Methods to resolve this issue:
- Apply the Hot Fix/Patch designed to resolve this error. The related Information is located at the bottom of this technote and provides the link to download the patch.
- Uninstall the problematic software and reboot the machine.
- Upgrade the client to a newer version of the IBM Rational software, this issue was resolved in the 2003 release of IBM Rational's products.
Some non-Rational applications installed on this machine can cause this error message.
Below a list of known ones:
- Aventail® - Extranet Management and Security solution
- Aventail Technotes
- Bonzi® Buddy™ - interactive talking companion that walks, talks,searches the Internet, and manages downloads and calendars
- Gator® - automatically fills out forms and remembers login names, account numbers, and passwords.
- HotBar® - offers a dynamic toolbar and skins for IE
- IBM® Personal Communications - host communication and terminal emulation package
- that enables access to applications and data residing on midrange and host systems
- Microsoft® Internet Security and Acceleration (ISA)
- Microsoft Critical Update installation on Windows® 2000 SP3 and has Microsoft Data Access Components (MDAC) version 2.5 or less installed. The solutions to this is to update MDAC version 2.5 to MDAC version 2.6.
- SINE
- Sygate® Personal Firewall
- V-One
- Webcelerator - speeds up internet browsing
Qbik WinGate - Windows-based proxy server - Zone Labs™ ZoneAlarm® - Personal Firewall. Open ZoneAlarm from Start > Programs > ZoneAlarm, Open ZoneAlarm from Start > Programs > ZoneAlarm, click on the Programs button, make sure that the Rational License Key Administrator and the Rational applications are allowed access to the Internet.
- RSA Keon®
- Venturi Technotes
- Zer0Knowledge Network - Zer0Knowledge Network markets a line of personal firewall, security, and anti-virus products.
- VCom™ SystemSuite™
- BMC® Remedy® Technotes
Hot Fix:
The purpose of these files is to correct an IBM Rational licensing problem at the FLEXlm level. It is important to note that this problem proved to be specific to certain third party VPN or firewall products. IBM Rational successfully reproduced the issue with Qbik Wingate and Aventail products and has verified that the fix corrects the problem in a test environment. Considering the nature of the problem, IBM Rational does not guarantee the files will work in all environments. If after applying the patch you are still experiencing the issue, Please try one of the other resolutions provided above. If the problem then persists please contact IBM Rational customer support.
Note: Also note that upgrading to Aventail 5.0 also resolves the issue.
Note: Before installing these files it is important to make sure you can first reproduce the "FLEXlm -12" error.
- On a client machine, run the Rational product using a floating license key and verify that the product fails with the "FLEXlm -12" error.
- If the product runs, it may be able to run due to a local temporary license key.
- The temporary license keys are written to the following file:
<rational>\common\rational_temp.dat - Rename that file to rational_temp_orig.dat if you have temporary Nodelocked keys.
Hot Fix installation Instructions:
- Open Windows Explorer and navigate to the following directory:
<install dir>\Rational\common - In the "common" folder, locate the files below and rename them something other than their original names (example licadmin.old). The purpose of this is to allow you to change your machine back to its original state if needed.
licadmin.exe
lmgrd.exe
rational.exe
license.dll
licensing.dll
rscommonui.dll
suite objects.dll - Download the attached text file:
119315603_Rational-FLEXlm70h.zip_1-14RT7W_1-U2WN.txt
Rename the file to:
119315603_Rational-FLEXlm70h.zip - Extract the files in this zip file to the following directory:
<install dir>\Rational\common - Launch the License Key Administrator (Start > Run type licadmin.exe). You should now see the gray "served by" lines, and launch your IBM Rational products using floating licenses.
Historical Number
119315603
Was this topic helpful?
Document Information
Modified date:
16 June 2018
UID
swg21135432