Overview of License borrowing

Solution Number: 1016
Title: Overview of License borrowing
Platform: All Platforms
Applies to: All Products
Versions: All versions
Categories: Installation
Keywords:

Problem Description

How do I borrow license keys on a floating network license?

Solution

License borrowing means that you can use COMSOL (for a limited time) with a Floating Network License (FNL) without a network connection to the license server. This can be convenient if you want to travel with a laptop for a limited time period and still want to be able to run COMSOL, belonging to an FNL. The default maximum borrow period is one month.

From the File menu (Windows) or Options menu (Linux, Mac), select Licenses and Used Products from the main menu and click Borrow. Select the licenses you want to borrow from the list and specify the number of days you want to keep them. Click OK. Remember that other users cannot use the license keys that you have checked out. You can return the borrowed license keys early, before the borrowing period has expired, see below.

For license administrators: Control how users borrow licenses

It is possible to allow or block borrowing by certain users or certain computers. To do this, create an options file, LMCOMSOL.opt, which is saved in the same directory as the license.dat file on the license server computer. The options file allows administrators to control various usage parameters; the following instructions apply to borrowing:

  • INCLUDE_BORROW - Allow a user/group to borrow licenses. Other users/hosts are denied borrowing.
  • EXCLUDE_BORROW - Deny a user/group the ability to borrow licenses.
  • BORROW_LOWWATER - Set the number of licenses that cannot be borrowed.
  • MAX_BORROW_HOURS - Changes the maximum borrow period for the specified feature.

For examples on how to create the LMCOMSOL.opt options file, please see Knowledgebase entry 1058.
For a detailed description of the options file, please see the FlexNet Documentation: License Administration Guide which be found in the COMSOL Help Desk (choose Help->Documentation in the COMSOL Desktop).

Returning borrowed licenses manually

Using the LMTOOLS Utility

On computers running Windows, it is possible to use the LMTOOLS utility to return the borrowed licenses.

  • Start > All Programs > COMSOL Multiphysics 5.4 > License Tools > LMTOOLS
  • Choose Configuration using License File.
  • Browse to the local license file C:\Program Files\COMSOL\COMSOL54\Multiphysics\license\license.dat
  • Go to the Borrowing tab and click the List Currently Borrowed Features button to see which features that are currently borrowed.
  • On the same tab, enter the Feature name of the license Feature you wish to return in the Feature Name field and click the Return Borrowed Licenses Early button. Repeat this for all the features you wish to return.

To verify that the licenses have been returned, click the List Currently Borrowed Features button again. The output should be empty.

From the command line

If features still seem to be borrowed even if the expiration date has passed, or if you like to return the borrowed licenses early, use the lmborrow command in the license/$arch directory in the COMSOL installation folder, where $arch is either win64 (64-bit Windows), glnxa64 (64-bit Linux), or maci64 (64-bit Mac). The borrowed features can be returned by

./lmborrow -return -c ../license.dat COMSOLGUI

./lmborrow -return -c ../license.dat COMSOL

./lmborrow -return -c ../license.dat ACDC

./lmborrow -return -c ../license.dat SERIAL

on Mac and Linux. On Windows the corresponding commands would be lmutil lmborrow -return -c ../license.dat COMSOLGUI

To verify that the licenses have been returned, run ./lmborrow -status again. The output should be empty.

Troubleshooting

One reason that borrow will not work may be that the license file on the license server is not properly designed with the BORROW keyword. Please contact your system administrator if you suspect this.

Another reason may be that the license server is missing the required LSB libraries, please see Knowledgebase entry 1199 for more information.


Disclaimer

COMSOL makes every reasonable effort to verify the information you view on this page. Resources and documents are provided for your information only, and COMSOL makes no explicit or implied claims to their validity. COMSOL does not assume any legal liability for the accuracy of the data disclosed. Any trademarks referenced in this document are the property of their respective owners. Consult your product manuals for complete trademark details.