Intel Software Network articles Feed

Checklist for Installation and Troubleshooting Intel® FLEXlm* License Manager

Mon, 16 Aug 2010 00:00:00 -0700

NOTE: Many of the following steps should be reviewed and performed when a floating product license is renewed or added to an existing set of floating licenses, and when a combined license file is updated.

1. Download the latest Intel FLEXlm* License Manager user guide. Click here to download the user guide.

Steps to complete FOR THE LICENSE HOST SERVER SYSTEM(S)

2. Download the Intel® FLEXlm* license server that best matches your license host server OS. Click here to download license servers.

3. Verify your license host server machine’s host name and host id. If you are using three redundant license host server systems, verify the host name and host id for all three machines. Click here for more information.

4. Verify your floating licenses are registered with the correct host name and host id specified. If you are using three redundant license host server systems, verify all three host names and host ids are specified for each floating license.
You can find this information by logging  into the Intel Registration Center and checking your floating license information.

5. If any of your floating licenses have incorrect or out-of-date host name or host id information, follow the instructions in this user guide to correct the information in the floating license(s), and obtain updated license file(s). Click here for more information.

6. If you wish to combine your floating license files into one file, follow the instructions in section 4.3 of the Intel(R) FLEXlm* License Manager user guide, or follow the instructions here.

7. Verify that all the individual floating license files or the combined license file resides on your license host server system. Ensure there are no Single User, evaluation, or Beta licenses residing in the flexlm license directory on your license host server system.

On Linux*: /opt/intel/flexlm/
On Mac OS* X: /opt/intel/flexlm/
On Windows*: C:\Program Files\Common Files\Intel\FLEXlm

8. If you have specified three redundant license host server systems in your floating licenses, at least two of the three redundant license host servers must be up and running at all times. Click here for more information.

9. Install your Intel® FLEXlm* license server binary on your license host server system. If you have specified three redundant license host server systems in your floating licenses, complete all three license host server installations. Follow the instructions in Chapter 3 of the Intel FLEXlm* License Manager user guide.

10. Start your license host server process by following the instructions in Chapter 3 of the Intel FLEXlm* License Manager user guide. If you are using a Vista or Windows Server 2008 system, please see the information at this link.

11. Ensure your license server is running by following the instructions in the user guide for the << lmstat >> command. Click here for more information.

Steps to complete ON THE CLIENT SYSTEMS

12. On each client system, install the Intel software product(s) your users will be running from that client system. You will likely need a copy of the floating .lic license file on the client system for each product you will be installing; please put the copy of the Intel product floating license file(s) in the default Intel license file directory, and make sure you are using the same license file on the client system as you are using on the license host server system(s).

There is a different default Intel license file directory on Windows*, Linux* and Mac OS* X.

Windows*:   C:\Program Files\Common Files\Intel\Licenses

Linux*: /opt/intel/licenses/

Mac OS* X: /Users/Shared/Library/Application Support/Intel/Licenses/

13. Set the INTEL_LICENSE_FILE environment variable on each client system. Click here for more information.

14. Try launching the Intel product, such as the Intel® C++ Compiler product.

15. If problems occur with floating license seat check-out, or with any of these steps, please follow the steps in Chapter 5 of the user guide to capture a debug log for your license host server.

Then submit a new issue to Intel® Premier Support and attach the debug log you generated.
If you do not have access to Premier Support, please post a new question on the user forum.

15. To help the Support team assist you efficiently with your problem, please provide the following information:

     a. OS and architecture for your license host server system(s)

     b. the name of the specific Intel FLEXlm license manager server file you downloaded and installed

     c. the serial number for the floating license you are using
[NOTE: DO NOT POST SERIAL NUMBERS IN USER FORUM COMMUNICATIONS UNTIL OUR SUPPORT TEAM HAS CHANGED YOUR POSTING TO PRIVATE STATUS.]

     d. the environment variable setting for INTEL_LICENSE_FILE

     e. a copy of each floating license file you are using
[NOTE: DO NOT ATTACH FILES TO A USER FORUM POSTING UNTIL OUR SUPPORT TEAM HAS CHANGED YOUR POSTING TO PRIVATE STATUS.]

     f. the combined license file (only if customer is using a combined license file)
[NOTE: DO NOT ATTACH FILES TO A USER FORUM POSTING UNTIL OUR SUPPORT TEAM HAS CHANGED YOUR POSTING TO PRIVATE STATUS.]

     g. host server name and host server id for the license host server(s)

      h. verification that Intel License manager is running (capture of the results of running the appropriate lmstat command)
[NOTE: DO NOT ATTACH FILES TO A USER FORUM POSTING UNTIL OUR SUPPORT TEAM HAS CHANGED YOUR POSTING TO PRIVATE STATUS.]

     i. license server debug log and client-side debug log
[NOTE: DO NOT ATTACH FILES TO A USER FORUM POSTING UNTIL OUR SUPPORT TEAM HAS CHANGED YOUR POSTING TO PRIVATE STATUS.]

Intel® FLEXlm* License Borrowing Capability

Thu, 05 Aug 2010 22:00:00 -0700

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:
http://software.intel.com/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-2009 by Macrovision Corporation. All rights reserved.

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

lmutil lmborrow INTEL dd-mmm-yyyy:[time] -c

Example:
lmutil lmborrow INTEL 06-Oct-2011 CCompL -c server.lic

where,
server.lic is the license file which was used to start the server. It should be noted that license borrowing will fail if the license file on the client side is different than the one which was used to start the server.

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-2004 by Macrovision Corporation. 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-2004 by Macrovision Corporation. 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 -c server.lic featurename

Example:
lmutil lmborrow -return -c server.lic CCompL
lmutil - Copyright (c) 1989-2009 by Macrovision Corporation. 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-2009 by Macrovision Corporation. 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 -c server.lic CCompL
lmutil - Copyright (c) 1989-2009 by Macrovision Corporation. All rights reserved.
Error: CCompL not currently borrowed.

Intel® FLEXlm* License Manager FAQ

Sun, 01 Aug 2010 00:00:00 -0700

When is a floating license seat checked out and checked in?

Sun, 20 Jun 2010 00:00:00 -0700

For an Intel compiler product, the license is checked out (allocated) at the very beginning when compiler or debugger is started; and returned when the compiler or debugger work is *done*.

NOTE: For performance libraries (Intel(R) Integrated Performance Primitives, Intel(R) Threading Building Blocks, and Intel(R) Math Kernel Library), and other Intel software tools products, license check-out is only done during product installation.

All compiler floating license seats are available on a first-come first-served basis for check-out by any number of compiler products installed on client systems that have been configured to check-out floating license seats from the license host server system.

However if all license seats are allocated for the requested compiler product, additional users need to wait for one of the client systems to release a floating license seat. This is automatically done in our compiler and debugger products, and means that some users may experience some compiling delay. The wait time for a compiler license seat is "forever", until a license seat is available. The wait time is not configurable by end user.

User may configure their license server to make some features "linger" a period of time so that the license will be "reserved" during this period after the license is returned by the compiler. No linger time is setting by default, so the compiler license seat is usually eturned immediately.

To determine how many floating license seats are checked-out, use the command lmstat. This can be executed on the server using -c argument.

1. On the license host server system:

For Linux execute << lmstat -a -c >> where is the name and path to the floating license file.

For Windows execute << lmutil lmstat -a -c >> where is the name and path to the floating license file.

2. On a client system, where the appropriate INTEL_LICENSE_FILE has been correctly set to point to the license host server system:

For Linux execute << lmstat -a >>

For Windows execute << lmutil lmstat -a >>

3. The Macrovision FLEXnet (new name for FLEXlm) End User Guide provides details and examples on using the lmstat command. The guide from Macrovision can be found at (version 11.4):

http://www.minitab.com/uploadedFiles/Shared_Resources/Documents/License_Management/flexnet_licensing_end_user_guide.pdf

or at (version 10.8):
http://infocenter.arm.com/help/topic/com.arm.doc.faqs/stockdata/9/enduser.pdf

4. Here's some example output below for Linux using Intel's FLEXlm

license host manager. The output includes information about total number of licenses issued and total number in use.

$ ./lmstat -a

lmstat - Copyright (c) 1989-2003 by Macrovision Corporation. All rights reserved.
Flexible License Manager status on Wed 6/16/2010 02:11
License server status: 28518@spd16
License file(s) on spd16:

/tmp/jsmith/bin/flexlm_ia32_RH8/spd16.lic:

spd16: license server UP (MASTER) v9.2

Vendor daemon status (on spd16):

INTEL: UP v9.2

Feature usage info:

Users of I00000000000000000080000000000: (Total of 2 licenses issued;

Total of 0 licenses in use)

Users of FCompL: (Total of 2 licenses issued; Total of 0 licenses in use)

How to set INTEL_LICENSE_FILE Environment Variable

Sun, 20 Jun 2010 00:00:00 -0700

Once you have installed the Intel FLEXlm* license server on your host license server system and installed the client application, the INTEL_LICENSE_FILE environment variable must be set.

Most Intel software products have a script file, e.g. iccvars.sh for the Intel C++ compiler, that can be run to set up the environment correctly including INTEL_LICENSE_FILE environment variable. This environment variable must be set for proper authentication of the product license file.

Other ways to set up the INTEL_LICENSE_FILE environment variable:

On Windows* systems, follow these steps:

1. Click Start >> Control Panel > System > Advanced > Environment Variables

2. Under system variables click New.

3. Enter INTEL_LICENSE_FILE in the text box for Variable Name.

4. In the Variable value text box, input the full path to the folder where one or more licenses reside.

5. Click OK > OK > OK.

On Linux*, UNIX* and Mac* OS X systems, use following commands:

For C shell (csh), use the setenv command:

% setenv INTEL_LICENSE_FILE

For Bourne shell (sh), Korn shell (ksh), and bash shell (bsh), use the export and assignment commands:

$ export INTEL_LICENSE_FILE=

where, should be the folder in which one or more license files reside. You can provide multiple path values to the INTEL_LICENSE_FILE variable by using “:” as a separator. For example,

$ export INTEL_LICENSE_FILE=/opt/intel/licenses:$HOME/intel/licenses

Getting the product running with my new license

Sun, 20 Jun 2010 00:00:00 -0700

Please make sure to Register your Serial Number ; After registration, you will receive an email with a copy of your .lic license file attached.

The next steps are different based on your license type.

If you have a single user license, follow the simple steps below.

Save the license file sent to you by email to:

          • On Windows*: \Program Files\Common Files\Intel\Licenses
          • On Linux*: /opt/intel/licenses
          • On MAC OS* X: /Users/Shared/Library/Application Support/Intel/Licenses
            Note: if the INTEL_LICENSE_FILE environment variable is defined, copy the file to the directory specified by the environment variable, instead.

If you have a counted (floating) license, you must do following to install and configure your License Host Server system and your client systems:

- Set up the license host server system
- Read the Intel License Manager for FLEXlm* User's Guide
- Download the correct Intel FLEXlm server for license host server system
- Install the FLEXlm server: after installation, the license server should start running automatically
- To manually start or stop the FLEXlm license server, please refer to the FLEXlm user's guide

References and useful articles: http://software.intel.com/en-us/articles/licensing-faq/

ONLY One FLEXlm license manager can be started at one time on one server

Thu, 04 Mar 2010 00:00:00 -0800

Can I start two FLEXlm license manager s at one time on one server with two different floating license files?

No, you cannot. There is only one lmgrd process allowed at one time with the FLEXlm license manager started on one server. If you want to start the FLEXlm license manager with more than one license file, please start the FLEXlm license manager with those license files together at one time. That will work.

How to find Host ID for Floating licenses

Thu, 13 Aug 2009 00:00:00 -0700

Identifying the Host Name and Host ID
The host name and host ID are system-level identifiers on supported platforms that are used in the license file to identify the node on which you plan to install the Intel License Manager for FLEXlm* and license file. To enable you to obtain a counted license, these unique values must be available when you register your product. For node-locked licenses, you will also need the host name and host id of the node from which your applications will run, if different from the node for the Intel License Manager for FLEXlm*. Follow the directions below to obtain the host name and host id for each supported platform.

For CoFluent products: Please refer to product documentation for instructions on how to find your composite host ID for node-locked and floating licenses.

Microsoft Windows*
1. From the Start menu, click Run...
2. Type cmd in the Open: field, then click OK.
3. Type ipconfig /all at the command prompt, and press Enter.

In the resulting output, host name is the value that corresponds to Host Name, and host id is the value that corresponds to Physical Address.

For example, if the output of ipconfig /all included the following:
Host Name . . . . . . . : mycomputer
. . .
Physical Address . . . . : 00-06-29-CF-74-AA
then host name is mycomputer and the host ID is 00-06-29-CF-74-AA.

Linux*
1. Run the hostname command to display the host name.
2. Run the command /sbin/ifconfig eth0 to display the hardware address.
For example, if the /sbin/ifconfig eth0 command returns
HWaddr 00:D0:B7:A8:80:AA, then the host ID is 00:D0:B7:A8:80:AA.
It is strongly recommended that users run the lmhostid utility to obtain the hostid value required to generate the counted licenses. The lmhostid utility can be found in the install location to which Intel License Manager for FLEXlm* is installed.

Mac OS* X on Intel® Architecture
1. Run the hostname command to display the host name.
2. Run the command /sbin/ifconfig en0 ether to display the hardware address.
The following is an example of an address that could be returned by this command:
en0: flags=8863 mtu 1500
ether 00:13:20:60:23:4f
It is strongly recommended that users run the lmhostid utility to obtain the hostid value required to generate the counted licenses. The lmhostid utility is installed to the same location as the Intel License Manager for FLEXlm*.