Intel Software License Manager Getting Started Tutorial

This tutorial will help to setup your floating license environment very quickly.
Follow these steps and choose the setup scenario that matches best:

• Obtain your license file
• Set up the license manager
• Set up clients

Obtain your License File

Please refer to the note 'Who is eligible to obtain a license file?' below.
You need a MAC address of the license server (optional the license server name) to register and create your license file.

1. Obtain a MAC address of the license server.
   If you have the license manager tools already installed you can run:
       lmutil lmhostid
   and take any of the addresses issued. 
   Otherwise run:
   OS X*, Linux*:
       ifconfig
       and take any of the 'HWaddr' values displayed
   Windows*:
       ipconfig /all
   and take any of the 'Physical Address' values displayed
   Note:
   Remove all special characters from the string and - if required - fill up with leading zeros to get your 12-digits alphanumeric string which is your Host ID.

2. Obtain the license server name (optional)
   Specifying the real server name is optional at the registration step. You can enter a placeholder during registration and modify the server name in the license file later with a plain text editor.
   Linux / OS X:
        hostname
   Windows:
        echo %COMPUTERNAME%
    
3. Register your Serial Number
   Login to the Intel® Registration Center and enter your SN and email, or if you are already logged in, your SN at the bottom of the "My Products" page.
   Enter your Host ID and server name you obtained in Step 1.
   The license file will be emailed to the email address associated with your license registration.
   
   Note:
   Registration of the Intel® Cluster Studio XE for Linux* is a two-steps process. During registration you need to accept the product EULA. If you missed to accept the EULA you will not get a license file attached to the registration notification email from Intel. In that case visit IRC and register this serial number again where you will have the chance to accept the EULA.

Who is eligible to obtain a license file?

Only the license owner or license administrator can perform a license registration and obtain a license file. Registered users have the right to download products and have read-access to the license history only.

    How can I identify which role I have?

1. Login to the Intel Registration Center
2. Click on the related product on the left hand column "Product Subscription Information", for example:     
3. On the 'Subscription History' page click on 'Manage', for example:
       
4. If you have access to the 'Manage' too you are either the owner or license administrator. Registered users don't have access to the 'Manage' tool.
5. If you have access you will see the Manage Page where you can see who the license owner and the license administrator are, for example:
       
    

Set up the License Manager

You can use an existing FlexNet or FlexNet Publisher license manager (lmgrd) if its version is the same or higher as the version of the Intel vendor daemon (INTEL). The description in this section applies also to a redundant servers installation where all steps need to be done on all 3 license servers.
A single license server or a redundant license server configuration can manage licenses from clients running on different operating systems.
Please refer also to the Floating Licenses and Software License Manager Compatibility section.
Please set up your license manager according to one of the following scenarios that match best:

I have to install a new license manager on a license server

1. Download
   Go to the License Manager Download Page (if you are logged out from IRC, the login prompt appears first)
   Select the right platform from the drop-down menu and download the right version:
   _ia32: is for 32-bit operating systems
   _intel64 is for Intel® 64 operating systems
   The Intel® Software License Manager User's Guide is also available from this download page.
   Notes:
   - On the license manager download page there is the most current version available only.
   - Access problems to this site indicate that you don't have a valid floating license registration associated to your email.
   - Only license owners and license administrators have access to that site

2. Installation
   Linux* / OS X*:
   - Copy the downloaded file into the directory you want to install the license server.
   - Extract the downloaded file, for example:
          tar xzvf l_isl_server_p_2.2.005_intel64.tar.gz  (Linux)
          tar xzvf m_isl_server_p_2.2.005.tar.gz  (OS X)
   - Change to directory flexlm and run the installer, for example:
         cd flexlm 
         Install_INTEL
   Windows:
   - Run the self-extracting w_isl_server_p_2.xxx.exe file and follow the instructions provided with the graphical installation wizard.
    
3. Start the license manager
   Linux* / OS X*:
   From the license manager directory /flexlm start the license manager lmgrd. You can specify a single license file or a license directory (if you more license files). By default, the license file name is server.lic which was created by the license manager installation. However you can move any valid floating license into the /flexlm directory and start it with the license manager. Creating a log file with option -l is optional.
        lmgrd -c server.lic -l flexnet_logfile.txt (reads server.lic license file and creates logfile)
        lmgrd -c . -l flexnet_logfile.txt               (reads al .lic files from the flexlm directory and creates logfile)
   Windows:
   You can run the license manager under Windows as system service (recommended) or as user application in a command shell (sometimes required for some Windows OS versions).
   System service:
   - Start > Intel(R) Software Development Products > Intel(R) Software License Manager and browse to the license file.
   User application:
   - Open a command shell
   - Navigate to c:\Program Files (x86)\Common Files\Intel\LicenseServer\
   - lmgrd -c server.lic -l flexnet_logfile.txt      (reads server.lic license file and creates logfile)

I need to add another Intel software license to an existing installation.
You can combine licenses into one single license file (.lic) or copy all license files into a license directory
   
     Combine licenses

1. Make sure that the SERVER and VENDOR lines are identical
2. Remove the SERVER and VENDOR lines of your new license file
3. Copy rest of contents of new license into the existing license file
4. Have the license manager re-read the combined license file, for example
        lmgrd lmreread –c <combined_license_file>
   On Windows you can re-read the new license also via the license manager GUI (Start > Intel(R) Software Development Products)

     Create license directory

1. Create a new license directory (recommended: Use the flexlm installation directory)
2. Copy all existing and new license files there (no need to edit and combine license files)
3. Have the license manager re-read the combined license file
        lmgrd lmreread –c <license_dir>
   On Windows you can re-read the new license also via the license manager GUI (Start > Intel(R) Software Development Products)

I need to add an Intel software license to an existing FlexNet/FlexNet Publisher license manager (lmgrd) already running for 3^rd party SW.
Same as above, but you need to make sure that the license manager lmgrd is of same or higher version as the Intel Vendor Daemon INTEL/INTEL.exe.

     Check for compatibility

1. Download and install the Intel license manager as described above
2. Run the Intel Vendor Daemon as follows:
        INTEL -v
3. Run the license manager as follows:
        lmgrd -v
   If the major and minor versions of lmgrd is the are the same or higher than the INTEL vendor daemon's versions you can use the existing license manager with the Intel Vendor Daemon. Otherwise you need to install an Intel License Manager in parallel to the existing license manager and run it on a different port.

     Add Intel Vendor Daemon to an existing license manager

1. Download the Intel license manager package as described above.
2. Extract downloaded package on a temp dir:
   Note: Under Windows you cannot change the installation directory. So in order to not overwrite an existing license manager installation, install it on another PC!
3. Take the Intel Vendor Daemon file INTEL / INTEL.exe and copy it to a directory on the license server (recommended: Use existing directory where the license manager lmgrd / lmgrd.exe) is running.
4. If required (i.e. if you copy the Intel vendor daemon not into the default directory) edit the license file and specify a path where the vendor daemon is located, for example
        VENDOR /flexlm/INTEL
   or
        VENDOR c:\Program Files (x86)\Common Files\Intel\LicenseServer\INTEL.exe
5. Combine licenses or create a new license directory as described above.
6. Restart the license manager as described above.

Setup Clients

There are several ways to setup a floating licensed product on client machine, but the most appropriate ones for an existing product installation or new / update installation on clients are the following.
Please note that this chapter applies to a single-license-server configuration only. Please refer to the Tips & Tricks section to use this method also for a redundant server configuration.

Product already exists on client
In this case you only need to create a new license file:

1. Use an editor and create a file with extension .lic with the following contents:
   SERVER <server_name|IP-address> <ANY|<server_MAC_address> <port>
   USE_SERVER
2. Copy the file to the default license directory:
   Linux:
   /opt/intel/licenses (for a (sudo)root installation)
   $HOME/intel/licenses (for a user installation)
   OS X:
   /Users/Shared/Library/Application Support/Intel/Licenses
   Windows:
   c:\Program Files (x86)\Common Files\Intel\Licenses\ (on 64-bit Windows systems)
   c:\Program Files\Common Files\Intel\Licenses\ (on 32-bit Windows systems)
3. Remove (or rename) all old or unused .lic files in the license directory

Update installation on client

1. Start the product installer

2. When it comes to product activation, the default activation option will be "Use Existing Activation"
   Select that option only if you are sure that the right server license was already set up with a previous installation. Otherwise select the following:
   Use "Alternative Activation > Use License Server" and specify the server name and port of the license server.

New product installation on client
 

1. Start the product installer
2. When it comes to product activation, the default activation option will be "Use Serial Number"
3. Do not use this option, but select "Alternative Activation > Use License Server" instead and specify the server name and port of the license server.
   CAVEAT! In complex environments this step may take long time (several minutes) until client-server connection and license verification/installation is finished.

Troubleshooting, Tips & Tricks
 

How to best setup a redundant server configuration

Setup of a redundant license server configuration remotely as described above is not supported by default, but you can perform the same steps as described above by referencing one of the servers only. After installation and server set up you can "expand" your client license by adding the other 2 servers in the client license, such as:

     SERVER <servername1> ANY <port>
     SERVER <servername2> ANY <port>
     SERVER <servername3> ANY <port>
     USE_SERVER

How to check license configuration from client

You can use the lmutil tool also on the client to perform the same license server checks as on the server.
Copy over the lmutil tool from the license server to the client or obtain it from FLEXERA's webpage (http://www.globes.com/support/fnp_utilities_download.htm).
Instead of using the license file or license directory use port@server as license parameter to invoke lmutil on the client, for example:
     lmutil lmstat -a -c <port>@<servername>
     lmutil lmdiag -c <port>@<servername>

How to check which license is being used

Linux only:
On Linux a very comfortable method is available to check which license and license server are being used. Create the enviornment variable FLEXLM_DIAGNOSTICS, assign it value 3 and invoke any of the tools icc, ifort, amplxe-cl, inpxe-cl or idbc, for example:

Linux/OS X:
Create the INTEL_LM_DEBUG enviornment variable, assing it a log file name and  invoke any of the tools icc, ifort, amplxe-cl, inpxe-cl or idbc. Search the logfile for any occurrence of the string SMSAxxxxxxxx. This 8-characters suffix is the serial number of the product that was used by invoking the product.For example:

Windows:
Open an Intel Software Development Product command prompt from the Start menu, create the INTEL_LM_DEBUG enviornment variable, assing it a log file name and  invoke any of the tools icl, ifort, amplxe-cl or inpxe-cl. Search the logfile for any occurrence of the string SMSAxxxxxxxx. This 8-characters suffix is the serial number of the product that was used by invoking the product.For example: 
      
       

Mixed Windows/Linux/OS X license server/client environment

You can run a single license server to manage a combined license for different client operating systems. The license server can run on Windows, Linux or OS X. In a heterogeneous environment it may be required to specify the full license server name including the full primary DNS suffix or the IP address in the license files of the clients.

Floating Licenses and Software License Manager Compatibility

In order to have full functionality of floating licensing service it is strongly recommended to use a license manager version that is specified for use with your product (please refer to the 'System Requirements' in the product release notes). Incompatible Intel license manager versions may result in reduced functionality when updating products on your client machines; for example they may not detect existing product activations or allow product activation via license server.

If you encounter problems updating products try one of the following workarounds:

• Upgrade Intel® Software License Manager to the newest version available on the Intel® Registration Center (choose the right OS and platform; only users with floating license registrations have access to this link).
• Use serial number (alphanumeric code of format xxxx-xxxxxxxx)
• Use license file (file extension .lic).

Note: Remote activation is not supported for floating licenses.

Disclaimer and Legal Information

INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH INTEL PRODUCTS. NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. EXCEPT AS PROVIDED IN INTEL'S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS, INTEL ASSUMES NO LIABILITY WHATSOEVER, AND INTEL DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF INTEL PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT.
A "Mission Critical Application" is any application in which failure of the Intel Product could result, directly or indirectly, in personal injury or death. SHOULD YOU PURCHASE OR USE INTEL'S PRODUCTS FOR ANY SUCH MISSION CRITICAL APPLICATION, YOU SHALL INDEMNIFY AND HOLD INTEL AND ITS SUBSIDIARIES, SUBCONTRACTORS AND AFFILIATES, AND THE DIRECTORS, OFFICERS, AND EMPLOYEES OF EACH, HARMLESS AGAINST ALL CLAIMS COSTS, DAMAGES, AND EXPENSES AND REASONABLE ATTORNEYS' FEES ARISING OUT OF, DIRECTLY OR INDIRECTLY, ANY CLAIM OF PRODUCT LIABILITY, PERSONAL INJURY, OR DEATH ARISING IN ANY WAY OUT OF SUCH MISSION CRITICAL APPLICATION, WHETHER OR NOT INTEL OR ITS SUBCONTRACTOR WAS NEGLIGENT IN THE DESIGN, MANUFACTURE, OR WARNING OF THE INTEL PRODUCT OR ANY OF ITS PARTS.
Intel may make changes to specifications and product descriptions at any time, without notice. Designers must not rely on the absence or characteristics of any features or instructions marked "reserved" or "undefined." Intel reserves these for future definition and shall have no responsibility whatsoever for conflicts or incompatibilities arising from future changes to them. The information here is subject to change without notice. Do not finalize a design with this information.
The products described in this document may contain design defects or errors known as errata which may cause the product to deviate from published specifications. Current characterized errata are available on request. Contact your local Intel sales office or your distributor to obtain the latest specifications and before placing your product order. Copies of documents which have an order number and are referenced in this document, or other Intel literature, may be obtained by calling 1-800-548-4725, or by visiting Intel's Web Site.
Intel processor numbers are not a measure of performance. Processor numbers differentiate features within each processor family, not across different processor families. See http://www.intel.com/products/processor_number for details.
Intel, Intel Atom, and Intel Core are trademarks of Intel Corporation in the U.S. and/or other countries.

* Other names and brands may be claimed as the property of others.
Java is a registered trademark of Oracle and/or its affiliates.
Copyright © 2013, Intel Corporation. All rights reserved.