ARM Technical Support Knowledge Articles

Why do I see "license checkout" or "not supported" errors?

Applies to: DS-5, Tool Licensing (License Management)


This article applies specifically to:

ARM tools including Development Studio 5 are managed using Flexera Software's FlexNet Publisher product. Users normally only need to carry out the following steps to enable use of the tools:

  1. Purchase and download an ARM tools (FlexNet) license.
  2. Download and install the toolchain.
  3. Install the license by following some basic instructions provided in the following FAQs:

You may, however, also need to select a tool variant.

Tool variants

ARM toolchains are available in different flavors, for example:

These are known as "tool variants". Each tool variant supports different feature sets. Despite there being different variants of a given toolchain, the installer (32-bit or 64-bit) does not support custom installations which means that all components and features are installed and your license determines which components and features may or may not be used. For example, a DS-5 Ultimate Edition license permits the use of all of the installed components whereas a DS-5 Professional Edition license, for instance, does not permit development for the ARMv8 architecture.

Depending on your license(s), you might be able to select from a number of different tool variants.

Tool variant-related error messages

In rare circumstances, an ARM Compiler configuration problem may occur if:

Typical error messages are of the form: 

For example:

Resolving tool variant-related error messages

ARM recommends using the ARM Compiler in a supported environment such as Eclipse for DS-5, the DS-5 Command Prompt, or µVision IDE for MDK-ARM.

Resolving tool variant related error messages within Eclipse IDE

The toolkits listed by the ARM License Manager are determined by the licenses that are available. For example, the ARM DS-5 Ultimate Edition option will only appear in the list if the available licenses support ARM DS-5 Ultimate Edition.

  1. Launch Eclipse for DS-5.
  2. Open the ARM License Manager window from the Help menu.
  3. Confirm that the Configuration tab contains your license, and if not use the Add License... feature.
  4. Select the toolkit from the drop down list.


Resolving tool variant related error messages µVision IDE

Check that you have installed the correct license file within the License Management window. If you are still experiencing issues using the tools contact Keil Support.

Resolving tool variant related error messages the DS-5 Command Prompt

Make sure that you use the select_toolchain or select_default_toolchain command before attempting to use the tools.

Resolving tool variant related error messages with Streamline

If you are experiencing tool variant related error messages when using the Streamline profiling tool, contact ARM Technical Support.

Resolving tool variant related error messages when using ARM tools in a non-ARM supplied environment

If you intend to use ARM Compiler in an alternative environment, for example, a standard Command Prompt in Windows, you will need to manually configure your tool variant. For the latest versions of ARM Compiler it is recommended to set the tool variant using the ARM_TOOL_VARIANT environment variable. Older versions of ARM Compiler do not use the ARM_TOOL_VARIANT environment variable and instead it is necessary to use the --tool_variant=<opt> option.

The value of ARM_TOOL_VARIANT or --tool_variant=<opt> should be set according to the table below.

License Tool variant <opt>
DS-5 Ultimate Edition ult
DS-5 Ultimate Evaluation Edition ulteval
DS-5 Professional Edition pro
DS-5 Professional Evaluation Edition ds5eval
DS-5 Altera Edition altera
DS-5 Starter Kit for Renesas RZ renrz_sk
DS-5 Renesas RZ Edition renrz_tk
DS-5 Starter Kit for Vybrid Controllers vf6xx_sk
DS-5 Vybrid Controller Edition vf6xx_tk
MDK-Professional Edition mdk_pro_flex
MDK-Standard Edition mdk_std_flex
MDK-Cortex-M Edition mdk_cm_std_flex

If DS-5 has been correctly configured, the prefix can be found in the Product Information reported in the Diagnostics tab of the ARM License Manager:


ARM Compiler 6

When using ARM Compiler 6.01 or later set the ARM_TOOL_VARIANT environment variable as follows:


When using ARM Compiler version 6.00 set environment variables as follows:


Alternatively, specify the option directly on the command-line, for example:

armclang --tool_variant=<opt> --target=aarch64-arm-none-eabi -c main.c

ARM Compiler 5

When using ARM Compiler 5.04 update 3 or later set the ARM_TOOL_VARIANT environment variable as follows:


When using ARM Compiler 5.02, ARM Compiler 5.03, and earlier releases of ARM Compiler 5.04, set environment variables as follows: 


Alternatively, specify the option directly on the command-line, for example:

armcc --tool_variant=<opt> -c main.c

Other information

On Windows, if you want to create a shortcut to Eclipse for DS-5 or add (pin) Eclipse for DS-5 to your taskbar, ensure that the Target location points to:


and not:


See also:

Attachments: DS-5_ARM_License_Manager_Configuration.jpg , DS-5_ARM_License_Manager_Diagnostics.jpg

Article last edited on: 2015-12-08 12:49:24

Rate this article

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