IBM Support

How to borrow IBM Rational Rhapsody/Doors licenses from a client machine using LMTOOLS utility

Question & Answer


Question

How do you enable license borrowing from your client machine using LMTOOLS utility as an alternative to IBM Rational License Borrower Tool (borrow_tool.exe) ?

Cause

Since version 8.0.4 for Rational Rhapsody and version 9.6.1 for Rational Doors, License Borrower is no longer installed as part of product installation.

Answer

You can enable license borrowing either using LMTOOLS utility or License Borrower (now known as IBM Rational License Borrow Tool, rclborrow.exe). This technote explains steps to enable license borrowing using LMTOOLS. If you want to use License Borrower, refer to Technote 1417793 How to borrow IBM Rational Rhapsody licenses from a client machine. Note that License Borrower is no longer installed as part of product installation since version 8.0.4 for Rational Rhapsody and v9.6.1 for Rational Doors. To obtain License Borrow Tool, you will need to download and install Rational License Key Administrator (LKAD).


NOTE: Tokens do not allow borrowing capability. However, you can use disconnected functionality where applicable. For more information, refer to "Token FAQ" in Related Information section.



Borrowing Rhapsody Licenses from Client Machine

  1. Download LMTOOLS from http://www.globes.com/support/fnp_utilities_download.htm and unzip the file to your desired location. Alternatively, contact your license server administrator to obtain the copy of lmtools.exe which is stored under C:\Program Files (x86)\IBM\RationalRLKS\common by default.

    NOTE: LMTOOLS is no longer available from the link above. See Enhancement 26473 submitted from RFE Community Web site. (requires Sign-in).
  2. Start lmtools.exe on client machine.

    NOTE: You must run lmtools.exe on client machine.

  3. Navigate to Borrowing Tab.

  4. Type "telelogic" in the Vendor Name field. NOTE: Do not specify "ibmratl".

  5. Type the date that you plan to return the borrowed license in the Return Date field.

  6. (Optional) Type a time in the Return Time field. By default the return time is 12:00 midnight.



  7. Click Set Borrow Expiration.

  8. Close LMTOOLS and proceed to the completion process.

For more information on this topic, refer to Information Center for Rational Common Licensing.

Completing the borrowing process

To complete the borrowing process, you need to run Rhapsody and related features you want to borrow licenses for. Licenses checked out from the start until exiting Rhapsody will be borrowed and stored locally on your machine. Next time you run Rhapsody on this machine, the licensing information is checked out from the local borrowed license.

To complete the borrowing process:

  1. Run Rhapsody.

  2. Exercise each add-on features you want to borrow a license for.

  3. Exit Rhapsody.

For more information on this topic, refer to Information Center for Rational Common Licensing.

Returning borrowed license earlier

Early return of borrowed licenses works with Rational License Key Server V8.1.2 and later.

To return borrowing license earlier than expiry date/time:

  1. Start lmtools.exe.

  2. Click the List Currently Borrowed Features button. A window opens with information about borrowed license features, vendors, and expiration dates.

    example output:
    ========
    List All Currently Borrowed Features
    ========
    Vendor     Feature    Expiration
    ______     ________   __________
    telelogic  dev_ed     13-Mar-14 18:29

  3. Click the Return Borrowed Licenses Early button. Verify that the license was returned in the information window.



  4. Close lmtools.exe.

For more information on this topic, refer to Information Center for Rational Common Licensing.

To understand borrowing feature better, refer to the white paper titled "Understanding Rational License Borrowing", and also refer to relevant links in Related Information section below.

[{"Product":{"code":"SSB2MU","label":"IBM Engineering Systems Design Rhapsody"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Licensing","Platform":[{"code":"PF033","label":"Windows"}],"Version":"8.0.4;8.0.5;8.0.6;8.1;8.1.1;8.1.2;8.1.2.1;8.1.3","Edition":"Rational Rhapsody Architect for Software;Rational Rhapsody Architect for Systems Engineers;Rational Rhapsody Designer for Systems Engineers;Rational Rhapsody Developer","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Product Synonym

Rational Rhapsody

Document Information

Modified date:
27 May 2022

UID

swg21667200