IBM Support

License Usage Mapper does not retain settings

Troubleshooting


Problem

Attempts to update the IBM Rational License Usage Mapper in the License Key Administrator result in the changes not being retained after closing.

Symptom

An example error message is as follows:

Unable to obtain a Rational ClearQuest license; you may need to launch the Rational License Administrator to establish one.
The error reported by the license manager is :
Failed to check out a key for ClearQuest:
FLEXlm Error -18, License server does not support this feature.

Cause

This problem is caused by the String Value HKEY_CURRENT_USER\Software\Rational Software\Licensing\1.0\SuiteMap2\Product Name\Choices not being created at install.

Resolving The Problem

To correct the issue you must create a String Value in the Microsoft Windows registry.

Disclaimer

This solution contains information about modifying the system registry. Before making any modifications to the Microsoft Registry Editor, it is strongly recommended that you make a backup of the existing registry. For more information describing how to back up the registry, refer to Microsoft Knowledge Base article 256986


  1. Select Start > Run..., type regedit and click OK

  2. In the Microsoft Windows Registry navigate to the following folder:

    HKEY_CURRENT_USER\Software\Rational Software \Licensing\1.0\SuiteMap2\


  3. Right click on the Product folder and select New > String Value

  4. Type the name Choices

  5. Double click on Choices a String Value and enter the appropriate Value data you obtain from the license key INCREMENT line in the license file.

    For example:

    INCREMENT UnifyingPlatform rational 1.0 22-JUL-2005 9999 \
    1612907B7D0D \
    VENDOR_STRING="3121-09813|Floating|0|ClearQuest:1.1, RequisitePro:4.0, soda_word:3.5, TestManager:7.1, UnifiedProcess:5.1" \
    HOSTID=ANY \
    DUP_GROUP=UH \
    OVERDRAFT=0 \
    vendor_info="|Rational Suite Team Unifying Platform|<B.0.V.>" \
    NOTICE="Rational Startup License" \
    ck=0


    If you had a RequisitePro:4.0 folder in the HKEY_CURRENT_USER\Software\Rational Software \Licensing\1.0\SuiteMap2\ directory and you wanted to indicate that IBM Rational RequisitePro can use an IBM Rational Suite Team Unifying Platform license key you would enter UnifyingPlatform:1.0; in the Value data of the Choices String Value.

    Note: The semi-colon needs to end of the Value data.

    Alternatively you can export a HKEY_CURRENT_USER\Software\Rational Software \Licensing\1.0\SuiteMap2\ registry key from a working installation to the machine having the problem and import it on the problem system.

    Update: Rational Common Licensing v8.1.

    The String Value for v8.1 is
    HKEY_LOCAL_MACHINE\SOFTWARE\Rational Software\Licensing\8.0\SuiteMap2

[{"Product":{"code":"SSTMW6","label":"Rational License Key Server"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"License Key Administrator","Platform":[{"code":"PF033","label":"Windows"}],"Version":"2003.06.13;2003.06.14;2003.06.15;2003.06.16;7.0;7.0.0.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018

UID

swg21263952