ARM Technical Support Knowledge Articles

How do I install my floating license?

Applies to: ARM Developer Suite (ADS), DS-5, RealView Development Suite (RVDS), Tool Licensing (License Management)

Answer

This FAQ is intended for customers who have already created and downloaded a FLEXlm floating license file from the ARM License Management Website.

Installing and configuring a floating license involves four steps:

  1. Install the license server utilities on the server(s).
  2. Install the license file on the server(s).
  3. Start/restart the license server(s).
  4. Configure the client machine(s) to obtain licenses from the server(s).

If you just want to replace the license file on an existing ARM license server, you must stop and restart the license server(s) before you can use a new license (see step 3 below), and step 4 above can be skipped. Step 1 can also be skipped provided that you are using the same version of the server utilities provided with the latest ARM development tools. 

Below is a brief summary of how to install an ARM development tool license. Detailed information on how to install the license server utilities and set up the client machine(s) is described in your ARM development tool's documentation (see "References" at the end of this article).

  1. Installing the server software

    For Development Studio 5 (DS-5) the correct version of the FLEXlm license server utilties are provided as part of an installation, for example, in DS-5 for Windows, the server utilities are located at: 

    C:\Program Files\DS-5\sw\FLEXnet_<version_number>

    For other ARM development tools, the FLEXlm license server utilities for supported server platforms can be downloaded from:

    https://silver.arm.com/browse/bx002 (login/registration required)

    Copy the appropriate set of files into a destination directory (for example, C:\FLEXlm) on your license server. This directory should be on your PATH

    On Linux license servers run the makelinks.sh script in the license utilities directory on the server:

    sh ./makelinks.sh

    You should use the license server utilities provided with the latest ARM development tools that you have, as changes to license file formats may mean that an older license server will not support a new tools license. For more information, see the FAQ: Which version of the license server daemons should I run?

  2. Installing the license

    Copy the license you have obtained from the web licensing system to each of the servers you are using. We recommend that you put the license file in the same directory as your license utilities. You may need to make some changes to the license file's SERVER line(s):

    1. Replace this_host with the corresponding server name.
    2. Add in the server port number after the host ID number. Typically this will be 8224 for ARM licenses.

    Your modified server line should then be of the following format:

    SERVER <servername> <host ID> <port>

  3. Starting/restarting the license server(s)

    To stop and start the license server on Windows, run the lmtools.exe program in your license utilities directory. Stop any existing service by navigating to the Start/Stop/Reread dialog and clicking the Stop Server button. On the Configure Services dialog, add paths for the lmgrd daemon, license file, and log file. Click on the Save Service button. Then go to the Start/Stop/Reread dialog, and click on the Start Server button.

    You can also start the license server from the command line on all platforms. Navigate to your license utilities directory. To stop a license service enter the following command and when prompted enter "y" to confirm:

    lmutil lmdown -c <license_file>

    To start a license service enter the following:

    lmgrd -c <license_file> -l <logfile_name>

  4. Configuring the client

    The final step is to see if the client computers can obtain their license from the license server(s).  One way to do this is to create an environment variable called ARMLMD_LICENSE_FILE on the client. The value of this environment variable should be of the form port@host, where port is the port number of the license server, and host is the hostname of the server. If you have a three server license you must include three port@host values. All three servers must have been configured and started before you can use the license.

    Here is one method of setting the ARM licensing environment variable for a three server system for a Windows 7 client. Navigate to: Control Panel → System and Security → System → Advanced system settings Environment Variables. Add a (System or User) variable named ARMLMD_LICENSE_FILE and set it to a value of the form:

    8224@my_serverA;8224@my_serverB;@my_serverC

    You would of course use the real port and server names for your own license servers. Note that the third server in this example has no port number defined as this server is using a default port in the range between 27000 and 27009

    If you are using a Unix client machine, you should set the environment variable using the relevant command for your shell (for instance, setenv if using csh or tcsh), and separate the servers with : (colon) rather than ; (semicolon).

    If you are using Windows and the latest ARM development tools, you could instead use the ARM License Manager to configure your license environment on the client. This is discussed in the documentation links above.

Note: It is strictly forbidden to attempt to install seats which have since been replaced by upgrade/update seats.
For more details, please see the FAQ: Do upgrade/update seats replace existing seats?

References:

Development Studio 5 (DS-5)

Keil Microcontroller Development Kit (MDK-ARM)

RealView Development Suite (RVDS)

ARM Developer Suite (ADS)

Downloads:

Article last edited on: 2014-06-30 10:42:08

Rate this article

[Bad]
|
|
[Good]
Disagree? Move your mouse over the bar and click

Did you find this article helpful? Yes No

How can we improve this article?

Link to this article
Copyright © 2011 ARM Limited. All rights reserved. External (Open), Non-Confidential