Intel® Software License Manager User's Guide

5. Installing the Intel® Software License Manager

5.1 Windows* Installation

1. Download the latest Intel® Software License Manager for Windows* that matches your environment (w_isl_server_<ver>.exe).
2. Run the self-extracting executable downloaded in the previous step.
3. Accept the license agreement to continue with the installation.
4. To configure the license manager, you must provide a serial number or license file:  
   1. To use a serial number, you must be connected to the internet.  
      1. If you have already activated your license, select the same host ID you provided to the registration center.  This will generate the license file in a default folder used by the license manager.
      2. If you have not activated your license, select either host ID.  This will automatically activate your license with the server’s host name and host ID you selected, along with default port values for the license manager daemons.
   2. To use a license file, browse to the location of your activated license file.
   3. The license manager installer uses C:\Program Files (x86)\Common Files\Intel\ServerLicenses as the default license folder.  It will automatically detect licenses in that location.  You can also set environment variable LM_LICENSE_FILE to point to a folder or license file.
5. If there are any invalid license files in the default license folder or LM_LICENSE_FILE, be sure to remove them.
6. Finish the installation process. The license manager is installed in C:\Program Files\Intel\licenseserver and should start automatically as a service.  It will create a log file named Iflexlm.log in the install folder.
7. The Intel® Software License Manager service runs as the Local Service account.  This may have insufficient privileges to create the log file in step 6, resulting in the license manager being unable to start.  In this case, it is necessary to either change the Intel® Software License Manager service Log On account to Local System, or change the log file path to a folder writeable by the user account.  See this article for more details.
8. Ensure that the ports used by the license manager services are not blocked.  There are two:
   1. Lmgrd port – this is specified in the license file and has a default value of 27009.
   2. INTEL port – this may be specified in the license file as: VENDOR INTEL port=<port>.  As of December 2017, this is defaulted to 28519 in the Intel Registration Center.  If it is not, then the OS will assign it when the license manager is started or restarted.  Check the log file for the value.

5.2 Linux* and OS X* Installation

1. Place the downloaded package <l|m>_isl_server_<ver>_<architecture>.tar.gz in the directory to which you wish to extract its files.  This need not be the same location in which you plan to install the Intel® Software License Manager files.
2. Extract the files from the package with the following command:

   tar -zxvf <l|m>_isl_server_<ver>_<architecture>.tar.gz

3. Run one of the following scripts from the directory created to begin installation:
   1. install.sh – command line
   2. install_GUI.sh – graphical interface

5.2.1 Command Line Installation

1. Select the elevation mode for the installation.
2. Accept the license agreement to continue with the installation.
3. To configure the license manager, you must provide a serial number or license file:  
   1. To use a serial number, you must be connected to the internet.
      1. If you have already activated your license, select the same host ID that you provided to the registration center.  This will generate the license file in a default folder used by the license manager.
      2. If you have not activated your license, select a host ID.  This will automatically activate your license with the server’s host name and host ID you selected, along with default port values for the license manager daemons.
   2. To use a license file, enter the name and path of your activated license file.
   3. The license manager uses /opt/intel/serverlicenses as the default license folder.  It will automatically detect licenses in that location.  You can also set environment variable LM_LICENSE_FILE to point to a folder or license file.
4. If there are any invalid license files in the default license folder or LM_LICENSE_FILE, be sure to remove them.
5. Start the installation.  The default install location is /opt/intel/licenseserver.  To change it:
   1. Select the Customize installation option:  
   2. Select the Change installation directory option:  
6. Finish the installation process. The license manager should start automatically as a service.

5.2.2 Graphical Installation

1. Select the elevation mode for the installation.
2. Accept the license agreement to continue with the installation.
3. To configure the license manager, you must provide a serial number or license file:  
   1. To use a serial number, you must be connected to the internet.
      1. If you have already activated your license, select the same host ID that you provided to the registration center.  This will generate the license file in a default folder used by the license manager.
      2. If you have not activated your license, select a host ID.  This will automatically activate your license with the server’s host name and host ID you selected, along with default port values for the license manager daemons.
   2. To use a license file, browse to the location of your activated license file.
   3. The license manager uses /opt/intel/serverlicenses as the default license folder.  It will automatically detect licenses in that location. You can also set environment variable LM_LICENSE_FILE to point to a folder or license file.
4. If there are any invalid license files in the default license folder or LM_LICENSE_FILE, be sure to remove them.
5. Start the installation.  The default install location is /opt/intel/licenseserver.  To change it:
   1. Click the Customize button:  
   2. Change the Destination folder:  
6. Finish the installation process. The license manager should start automatically as a service.  It will create a log file in the installation folder named lmgrd.log.
7. Ensure that the ports used by the license manager services are not blocked.  There are two:
   1. Lmgrd port – this is specified in the license file and has a default value of 27009.
   2. INTEL port – this may be specified in the license file as: VENDOR INTEL port=<port>.  If it is not, then the OS will assign it when the license manager is started or restarted.  Check the log file for the value.

5.2.3 Starting the Intel® Software License Manager automatically on Linux* after reboot

5.2.3.1 Add the startup command to the system startup files

cd <server-directory>
`pwd`/lmgrd –c `pwd`/<licensefile> -l `pwd`/<log file>

$(pwd)/lmgrd –c $(pwd)/<licensefile> -l $(pwd)/<log file>  (non-csh)

5.2.3.2 Use Systemd

[Unit]
Description=Intel Licensing Manager
After=network.target network.service
[Service]
Environment=LICENSE_FILE=<licensefile>
Environment=LOG_FILE=<log file>
WorkingDirectory=/opt/intel/licenseserver/
ExecStart=lmgrd -c $LICENSE_FILE -l $LOG_FILE
Restart=always
RestartSec=30
Type=forking
[Install]
WantedBy=multi-user.target

$ systemctl start flexlm.service
$ systemctl status flexlm.service

$ systemctl enable flexlm.service 

5.3 Using Multiple Licenses

• Each license has the same server host ID and host name
• Each license uses the same lmgrd and INTEL vendor daemon ports

5.3.1 Separate License Files

• Run the command lmgrd –c <path to license folder> -l <path to log file>

• Set environment variable LM_LICENSE_FILE to the license folder path, such as /opt/intel/serverlicenses
• Run lmgrd –l <path to log file> 

5.3.2 Combining License Files

6. Managing the Intel® Software License Manager

6.1 Windows* Utilities

6.1.1 Intel® Software License Manager Configuration (ilmconfig.exe) 

The ILM configuration utility is provided by Intel to allow quick starting, stopping, and license rereading of the Intel Software License Manager.  It is accessible from the Start menu from All apps -> Intel® Software Development Products -> Configure Intel® Software License Manager Utility, or by running ilmconfig.exe in the license manager install directory.  

6.1.1.1 License file

6.1.1.2 Start

6.1.1.3 Stop

6.1.1.4 Apply

6.1.2 LMTOOLS.exe

6.1.2.1 Launch and Usage

LMTOOLS can be run by browsing to the Intel Software License Manager install folder and running lmtools.exe.  It requires administrator privileges.   

6.1.2.2 System Settings

This tab displays the host settings used to verify the server license.  The host ID on the license must match one of the Ethernet IDs.  

6.1.2.3 Start/Stop/Reread

From this tab you can start, stop, or reread the license file.  

6.1.2.4 Server Status/Server Diags

Server Status

Click the “Perform Status Enquiry” button to view the status of the license server using the license file named at the bottom of the dialog box.  It will display the number of total license seats for each component and the number currently checked out. 

Server Diags

Click the “Perform Diagnostics” button to get a list of available licenses on the system, including non-floating licenses.  Enter a code in the Feature Name field, such as Comp-CW, to see which licenses grant that feature.  

6.1.2.5 Config Services

This tab allows you to change the names and locations of the files used by the license manager, and enable/disable the automatic startup of the license manager at system power up.  After making any changes to this tab, click the “Save Service” button to save them. 

Path to lmgrd.exe file

Path to the license file

Path to the debug log file

Start Server at Power Up

Use Services

FlexNet Licensing Service Required

6.1.2.6 Borrowing

Use this tab to manage license borrowing.  The license file must contain the BORROW keyword, as configured in the Intel Registration Center.   

6.1.3 lmgrd.exe

1. Open a Command Prompt as administrator
2. Move to the license manager install directory
3. Run lmgrd with options –c <license file> and –l <log file>

cd <install-directory>
lmgrd –c <path to license file> -l <path to log file>

6.1.4 Lmutil.exe

6.2 Linux* and OS X* Utilities 

6.2.1 Start the license manager (lmgrd)

• The port used by lmgrd is defined in the top line, defaulted to 27009.
• The daemon to serve licenses for a particular vendor (INTEL) is defined in the second line.  The port for the INTEL daemon may also be defined in this line, otherwise it will be assigned by the OS when lmgrd starts.
• Both ports used by lmgrd and the INTEL daemon must be open.

 lmgrd –c <license file> -l <log file> 

6.2.2 Check the license manager status (lmstat)

• lmgrd version, port number, and license file used
• INTEL daemon version
• Total number of license seats available for individual components listed in the license(s)
• Number of license seats currently in use for each component

 lmstat –a 

6.2.3 Check the host ID used by the license manager (lmhostid)

 lmhostid

6.2.4 Reread the license file (lmreread)

 lmreread –c <license file>

6.2.5 Release a license seat (lmremove)

Users of PerfAnl:  (Total of 7 licenses issued;  Total of 1 license in use)"PerfAnl" v2018.0914, vendor: INTEL, expiry: 1-jan-0
  platforms: i86_n  i86_r  i86_re  ia64_n  amd64_re  i86_mac  x64_n  x64_mac  , vendor_string: SUPPORT=COM https://registrationcenter.intel.com
  nodelocked license locked to NOTHING (hostid=ANY)
    user1 hostname1 /dev/pts/0 (v2007.0901) (serverhost/27009 203), start Mon 11/13 12:26

• Feature = PerfAnl
• User name = user1
• Host = hostname1

 lmremove –c <license file> <feature> <user name> <host>

6.2.6 Shut down the license manager (lmdown) 

 lmdown –c <license file>

6.2.7 Remove the license manager (uninstall.sh)

1. Run the uninstall.sh script to remove the installed files from the system.
2. To permanently remove the Intel® Software License Manager, delete the lines that were added to the system startup files as described in section 4.2.3 of this guide.

7. Using the Client Application for the First Time

7.1 Installing the Client Application

7.1.1 Use the client license file

SERVER <server name> <hostid> <port>
USE_SERVER

7.1.2 Use the INTEL_LICENSE_FILE environment variable

27009@host1:27009@host2:27009@host3

7.1.3 Use the server license file

7.2 License Check-out 

7.2.1 License Seat Allocation Overview

7.2.2 Check License Allocation Status

Linux*

lmstat -a -c <license file>

Windows*

lmutil lmstat –a –c <license file>

Linux*

lmstat -a

Windows*

lmutil lmstat –a

7.2.3 License Borrowing

7.2.3.1 Borrow

1. Copy the lmutil component to the client machine.  
2. Run lmutil lmborrow INTEL dd-mmm-yyyy [hh:mm]
   1. INTEL is the vendor daemon to borrow from
   2. The date is when the license will be returned, and must be less than the maximum borrow time specified in the license file.
3. Run the application to check out and borrow the license.
4. Verify that the license seat has been borrowed by running lmutil lmborrow –status
5. Disconnect from the network to use the license without connecting to the license server.

7.2.3.2 Return

8. Troubleshooting

8.1 Getting Online Support

8.2 Creating Debug Logs for License Checkout Issues

8.2.1 License Server Log

• For Windows* this is typically located at C:\Program Files\Intel\licenseserver\Iflexlm.log
• For Linux* and Mac OS*, this is typically located at /opt/intel/licenseserver/lmgrd.log

8.2.2 Client Log

1. Set INTEL_LMD_DEBUG.  If it is already set, please clear the log file it points to.
2. Run the application with the license failure.
3. Send the log file to support.

8.2.3 lmstat Output

8.3 Server Issues

8.3.1 License manager is not running

8.3.2 License manager is not serving licenses

8.3.2.1 Port Issues

8.3.2.2 License File Issues

1. The license file is outdated.  If the license has been renewed but the license file has not been updated on the server, then it may fail to serve seats for newer product versions, while able to serve older product checkouts.
2. The license version is outdated.  Licenses are upgraded as newer products change the feature codes they use.  Even though a license for the 2015 product version is valid and current, it may not contain the right codes for newer product checkouts.  Upgraded licenses will always be backward compatible for older products.
3. Multiple license files are used inefficiently.  The Intel® Software License Manager can serve licenses from a variety of license files and versions.  However, it may not serve those licenses in the most efficient order.  An example is if you have a license for two Composer Edition 2015 seats and one for two Composer Edition 2017 seats, for a total of four.  If requests for the 2015 version consume the 2017 seats, then requests for the 2017 version will have to wait.  That means two seats are being consumed out of a total of four.  To enforce the order of licenses used, combine the license files.

8.3.3 Verify Compatible Versions

8.4 Client Issues

8.4.1 Slow Checkouts

• Old license server information or license files.  Check the following places for invalid licenses and delete any found:
  • INTEL_LICENSE_FILE environment variable - make sure port@host is correct and any folders specified do not contain invalid license files.
  • For Linux: /opt/intel/licenses
  • For Windows: [Program Files]\Common Files\Intel\Licenses
• Slow DNS lookups.  Newer versions of the product always do DNS resolution before connecting to the license server, even with IP addresses.  Make sure that the fastest nameserver is called first, by checking nsswitch.conf and resolv.conf, for example.
• INTEL_LMD_DEBUG is set.  If you are not actively debugging license checkouts, make sure this environment variable is not set.

8.4.2 No Checkouts

8.5 Information Needed for Support Requests

• Client Information
• Intel Software License Manager Information

8.5.1 Client Information

• Package ID of the product. This is the name of the file you downloaded and installed.
• Name of client application with all parameters.
• Operating system, architecture, kernel, glibc, and any service packs installed on the client system.
• Values to which the LM_LICENSE_FILE and INTEL_LICENSE_FILE environment variables are set.
• A copy of all license files used on the client system. It is important to copy the license files themselves rather than copy/pasting the contents as this can mask other potential problems with the files.
• On Linux* or OS X*, set INTEL_LMD_DEBUG to /tmp/licensecheckout.log and on Windows*, set INTEL_LMD_DEBUG to C:\temp\licensecheckout.log and run the client. Once the client finishes execution, attach the licensecheckout.log to the support issue.
• If you are opening a support request about a segmentation fault issue, attach the stack dump.

8.5.2 Intel Software License Manager Information 

• The output of lmstat –a (Linux*) or lmutil lmstat –a (Windows*)
• Operating system, architecture, kernel, glibc, and any service packs installed on the system on which the Intel® Software License Manager server is installed. 
• The Intel® Software License Manager server file name that you downloaded and installed 
• A copy of the server log file at one of the following locations, depending on your operating system: 
  • Windows*: <install drive>:\program files\common files\intel\flexlm\iflexlm.log
  • Linux * or OS X*: <install location of servers>/lmgrd.log
• A copy of the license file you used to start the server. It is important to copy the license files themselves rather than copy/pasting the contents as this can mask other potential problems with the files.
• Values to which the LM_LICENSE_FILE and INTEL_LICENSE_FILE environment variables are set.