Checklist for Installation of the Intel® Software License Manager (FLEXlm*)

ID 747184
Updated 7/26/2019
Version Latest
Public

author-image

By

Before you get started

Make sure you have a floating license. This is the only license type that requires the use of the Intel® Software License Manager. If you do not have a floating license, you will not be able to download the license manager package from the Intel® Registration Center.

For more detailed instructions on using the Intel® Software License Manager, please review the User's Guide.

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.

Steps to complete for the license host server system(s)

  1. Download the Intel® Software License Manager package that best matches your license host server OS. Click here for the latest version. If you already have a license server manager installed, compare the version with the current download to ensure compatibility with the latest products.
  2. If your license server is not connected to the internet:
    1. Log into the Intel® Registration Center to activate your floating license with the host name and host ID of your server.  Instructions here.
    2. Download the license file to the server.  The license manager automatically looks in /opt/intel/serverlicenses for license files, but you can choose another location.
  3. If your floating license is already activated but you are installing on a new server:
    1. Log into the Intel® Registration Center to update the host name and host ID.  If your server is connected to the internet, you can clear your host information and the installer will update it automatically.  More instructions here.
  4. Extract the license manager package and run the installer according to the user guide.
  5. When the installer prompts for a license, you have the following options (see below for redundant server set-up):
    1. If you are connected to the internet:
      1. Provide the serial number for your floating license.  For non-activated serial numbers, this will automatically activate the serial number with the host name and host ID for your server.
      2. If the license is already activated, the host name and host ID for the server must match the values used for activation.
      3. By default, the license will be placed in:
        1. Windows*: C:\Program Files (x86)\Common Files\Intel\ServerLicenses 
        2. Linux*: /opt/intel/serverlicenses
    2. If you are not connected:
      1. Provide the path to the license file or folder from step 2.2 above.
  6. The license manager should start automatically, as long as it does not detect another license manager process (lmgrd) already running. You can verify this by going to the license server directory (<install>/licenseserver is the default) and run:
    1. Windows*: Lmtools.exe
    2. Linux*: lmstat -a -c <path to license file>
    3. If the license manager did not start, you can start it manually by running:
      1. Windows*: C:\Program Files\Intel\licenseserver\LMTools.exe
      2. Linux*: lmgrd -c <path to license file or folder> -l /opt/intel/licenseserver/lmgrd.log
  7. Verify that the two ports used by the license manager are not blocked by a firewall
    1. The main process, lmgrd, will default to port 27009. This port can be changed in the registration center or in the license file.
    2. The vendor daemon, INTEL, will default to port 28519. This port can be changed in the license file on the second line, for example:
      1. VENDOR INTEL port=28519
    3. The recommended way to ensure the ports are not blocked is to telnet to each port from a remote system. If telnet is unable to connect, the license check will fail.

Steps to complete on the client systems

  1. Prepare the client system with the license. The product checks the following for existing licenses:
    1. Default Intel® license file directory:
      1. Windows*:   C:\Program Files\Common Files\Intel\Licenses
      2. Linux*:   /opt/intel/licenses/
      3. Mac OS* X:  /Users/Shared/Library/Application Support/Intel/Licenses/
    2. The INTEL_LICENSE_FILE environment variable.  This can contain:
      1. Path(s) to non-default license folders
      2. port@host for the server(s)
  2. You have the following options for license set-up:
    1. Use a license file
      1. If the system is connected to the internet, you don't need to do anything before installation. You can simply provide the serial number during installation for the activated floating license. This will automatically download the client license file to the default license folder.
      2. Download the client license file to the system. You can get this from the Intel® Registration Center. The client version of the license file only contains the first line of the server version, followed by USE_SERVER. If this file is not in the default license directory, you can provide the path to the installer or set it in the INTEL_LICENSE_FILE environment variable.
    2. Use port@host
      1. You can provide this information during installation, or
      2. Set the INTEL_LICENSE_FILE environment variable to the port@hostname for the floating license server.  The port is the one specified in the top line of the license file and runs the lmgrd process (default 27009).
  3. Install the Intel® software product(s) your users will be running from that client system. This is optional if you already have the product installed.
  4. Try launching the Intel product, such as the Intel® C++ Compiler product.

Redundant server (triad) set-up

The steps are mostly the same when using the redundant server set-up, with some changes:

  • The host information for all three license servers must be entered in the Intel® Registration Center.
  • The license file for all three servers must be the same and contain all three servers in the license file.
  • If using the client license file it must have all three servers listed.
  • If using port@host in INTEL_LICENSE_FILE, all three servers must be specified.

See this article for more details on setting up redundant servers.

Troubleshooting

Check the troubleshooting guide here to see if it includes your problem.

Or you can visit our Get Help page for support options. If you submit a ticket please follow the steps in the Troubleshooting section of the user guide to capture a debug log for your license host server and attach it to the ticket. 

The following information is also helpful for the Support team to assist you efficiently with your problem:

NOTE: DO NOT ATTACH FILES OR POST SERIAL NUMBERS IN USER FORUM COMMUNICATIONS

  • OS and architecture for your license host server system(s)
  • The name of the specific Intel® Software License Manager file you downloaded and installed (including version)
  • The serial number for the floating license you are using
  • The environment variable setting for INTEL_LICENSE_FILE
  • A copy of each floating license file you are using (including combined license files)
  • Host server name and host server ID for the license host server(s)
  • Verification that Intel License manager is running (capture of the results of running the appropriate lmstat command)
  • The version of lmgrd and the INTEL vendor daemon (running lmstat)
  • License server debug log and client-side debug log