Intel® FLEXlm* License Borrowing Capability

Overview

This feature allows users to ‘borrow” a license seat from the license host server for a limited time, disconnect from the network and use the borrowed license even with no connection to the license server. This is very useful in case you want to use the software offline.

Required Information

To use the license borrow functionality for Intel floating product licenses, customers need to ensure they have the following items:

1) A build of the Intel® License Manager for FLEXlm* (for the desired OS) that supports the Borrow capability:

a) Users need to make sure that they are using a build of Intel FLEXlm* License Manager which supports borrowing
and early return of borrowed licenses.

b) We recommend the customer download and install one of the free license manager servers available at the
following website link:
/en-us/articles/performance-tools-for-software-developers-intel-flexlm-license-servers

2) A license file which has the keyword BORROW in it: 

a) Licenses for Intel® Software Development Products with version 2011 have the BORROW feature with a BORROW period of 7 days enabled by default.  

b) To obtain a borrow-enabled license for a multi-seat floating product license with a version older than 2011, please   submit an issue to Intel® Premier Support at https://premier.intel.com/ under product 'Download, Licensing and Registration'.

3) A single server configuration for the license server.  The redundant triad server configuration currently does not support license borrowing.

Steps for starting the FLEXlm* License Manager (Server) for using the Borrow feature

(1) Start the license server using the new borrow-enabled license file(s).

(2) Check the log for the Intel® FLEXlm* License Server and make sure that it does not complain about BORROW keyword in the license file.

• By default, the log file location on Windows* is: %ProgramFiles%\Common Files\Intel\FLEXlm
• By default, the log file location on Linux* and Mac OS* X is the same where FLEXlm server has been installed

A typical log file when FLEXlm Server has started successfully looks like the following:

14:00:31 (lmgrd) US Patents 5,390,297 and 5,671,412.
14:00:31 (lmgrd) World Wide Web: http://www.macrovision.com
14:00:31 (lmgrd) License file(s): server.lic
14:00:31 (lmgrd) lmgrd tcp-port 28518
14:00:31 (lmgrd) Starting vendor daemons ...
14:00:31 (lmgrd) Started INTEL (internet tcp_port 35860 pid 9309)
14:00:31 (INTEL) FLEXlm version 9.23
14:00:31 (INTEL) Server started on LicenseServer for:
14:00:31 (INTEL) I3F97C15E (consisting of:   ArBBL
14:00:31 (INTEL) CCompL    DbgL    FCompL
14:00:31 (INTEL) MKernL    PerfAnl    PerfPrimL
14:00:31 (INTEL) StaticAnlL    ThreadAnlGui    ThreadBB)


Client System Setup for the Borrow feature (Application Setup)

NOTE: The term “Client” refers to the application that uses Intel FLEXlm floating license seat check-out and check-in.

1) Download the lmutil for your operating system and architecture from http://www.globes.com/support/fnp_utilities_download.htm.

2) If you are not able to download the lmutil from the website above, work with your Intel Support team contact (or submit an issue to Premier Support at https://premier.intel.com/) for access to lmutil, and have the information about your Operating System, OS Version and Architecture (IA-32, Intel® 64 and/or IA-64[Intel® Itanium®]).

3) Verify that no Intel product components’ license seats (i.e., Compiler Professional Edition, Vtune, etc.) can be borrowed by running the following command. If you see any information that indicates one or more features/components were borrowed, then borrowing has already been enabled for those licensed features/components. Here is an example of output when no borrowing is enabled.

lmutil lmborrow -status

Example:
lmutil lmborrow -status
lmutil - Copyright (c) 1989-2011 by Flexera Software, Inc. All rights reserved.


4) Configure the borrow duration and FLEXlm feature to be borrowed:

lmutil lmborrow INTEL dd-mmm-yyyy:[time] <featurename>

Example:
lmutil lmborrow INTEL 06-Oct-2011 CCompL

The command above borrows a “featurename” called CCompL (Intel® C++ Compiler for Linux*) from the vendor INTEL until 6th Oct 2011 using the license file server.lic

NOTE:  The time specified on command line of lmborrow is the end date/time the user planned to borrow, which must be <= 168 hours, which is the maximum borrow period. If the user wants to borrow the license seat for only 1 or 2 days, the corresponding date/time for that period should be set.
Users cannot borrow a license seat for more than the 168 hour barrier that is set in the license file and in the license server logic. If an extended borrow time is required, please submit an issue to Intel® Premier Support at https://premier.intel.com/ under product 'Download, Licensing and Registartion' providing a jsutification of why you need to extend the borrow time beyond 7 days.

After running this command, the customer should see the following:

lmutil - Copyright (c) 1989-2011 by Flexera Software, Inc. All rights reserved.
Setting LM_BORROW=3-oct-2011:INTEL:06-oct-2011:CCompL


5) If the above steps are successful, you are now ready to borrow a seat by running the client application (e.g. – Composer XE, Vtune Amplifier XE, Inspector XE, etc). The FLEXlm feature will be borrowed when you run the client/application and a successful check-out happens. As soon as the first license is checked out, the server log file will confirm the borrowed feature with the following message in the log file:

14:35:14 (INTEL) OUT: "I3F97C15E" User1@Host1
14:35:14 (INTEL) OUT: "CCompL" User1@Host1

Note that there are no corresponding IN entries in the server log. This is different behavior than a normal check-out where corresponding to every two OUT entries in the server log file, you will also see two IN entries after the OUT entries after the application exits.


6) Verify that the FLEXlm product feature was really borrowed by running the following command on the client system:

lmutil lmborrow –status

Example for borrowing a seat for the Intel C++ Compiler for Linux*:

lmutil lmborrow –status
lmutil - Copyright (c) 1989-2011 by Flexera Software, Inc. All rights reserved.

Vendor Feature Expiration
______ ________ __________

INTEL CCompL 6-Oct-11 23:59

NOTE: Before the Borrow period expires, the product will always get the license from the local storage for the Borrowed license seat when it tries to check-out license. The Client system on which the product is used does not need to be attached to FLEXlm* license host server.


7) Disconnect the client system from the server network. Now with the borrowed license, you can use the software application with the borrowed license.

NOTE: After the Borrow period expires, the product license seat will no longer to be able to check-out the license from local storage. Instead, the client system must be “attached” to the FLEXlm* license host server to check-out a product license seat.


8) Run the following command to return a borrowed license:

lmutil lmborrow -return featurename

Example:
lmutil lmborrow -return CCompL
lmutil - Copyright (c) 1989-2011 by Flexera Software, Inc. All rights reserved.

On the FLEXlm server side, you will see the following message in the log file for the borrowed feature which was returned. This message is different compared to a normal check-in.

14:40:17 (INTEL) REMOVING User1@Host1:/dev/pts/0 from CCompL by administrator request.

14:40:17 (INTEL) IN: "CCompL" User1@Host1 (USER_REMOVED)
14:40:17 (INTEL) IN: "I3F97C15E" User1@Host1 (USER_REMOVED)


9) Run the following command to verify that the license was returned successfully back to the server:

lmutil lmborrow -status

Example:
./lmutil lmborrow -status
lmutil - Copyright (c) 1989-2011 by Flexera Software, Inc. All rights reserved.

Note: If you try to return a license which has not been borrowed, you will see a message like this:

./lmutil lmborrow -return CCompL
lmutil - Copyright (c) 1989-2011 by Flexera Software, Inc. All rights reserved.
Error: CCompL not currently borrowed.


Reportez-vous à notre Notice d'optimisation pour plus d'informations sur les choix et l'optimisation des performances dans les produits logiciels Intel.