ILNumerics - Technical Computing Tools

High Performance Framework for Visualization

and Computing in Industry and Science

 

tgt

ILNumerics® License Activation

This page shows how to manage your ILNumerics licenses and how to activate your seat for ILNumerics development.

Licensing Overview

In order to develop code with ILNumerics you will require a valid license for each ILNumerics module used. This allows one to use all functionality of the module within your custom applications. ILNumerics comes with an installer and must be installed on every single development machine. The installation will be available for all users to that machine, administrative rights are required. Afterwards, any number of users (Developer Seats) are allowed for that machine as long as each user utilizes her own account on the operating system. However, each developer seat (again: 'windows user') will require her own set of licenses. ILNumerics allows multiple seats to live next to each other on the same machine.

License Activation in Visual Studio

Regardless if you started by downloading a trial or if you got passed a license key from your manager - you will start by installing the ILNumerics installation package. This will install the library and all related products for all users of the machine. The second step is to activate your individual seat in order to start working with ILNumerics. Activation is only needed once for each development seat and after a new license has been purchased. The activation step is fully integrated into Visual Studio and actually really simple:

Having installed ILNumerics open Visual Studio. If you installed ILNumerics for the first time, Visual Studio will recognize that there are no licenses assigned to your seat and lead you right to the Options dialog for ILNumerics. In case the dialog is not opened automatically it can be found here:

      Visual Studio -> Tools -> Options -> ILNumerics -> Licenses

 

Provide your email address and the license key in the text boxes and click on 'Activate'. If you downloaded a trial of ILNumerics, use the same email address as for the download. The license key was sent to you within the email received from us after registering for the trial. Or you may find the license key in the invoice after your purchase. (In case that for some reasons you find an existing license key there and need to replace it you can find details below: 'Changing Licensing Information'.)

Note that for each activation all licenses currently existing on your seat are replaced with a fresh new set of licenses according to all modules currently licensed to you. You can repeat the activation on the same seat as often as necessary. If you purchased a new module - just come back here and press Activate again. Your email and license key will be there already.

After successfull activation the valid time spans are displayed for each licensed module:

 

The new licenses are valid immediately. No restart required.

Offline License Activation

The automatic activation process requires a working internet connection on the development machine where Visual Studio runs on. If for some reasons no internet connection is available you can activate the seat in a manual process.

  1. Open Visual Studio -> Tools -> Options -> ILNumerics -> Licenses.
  2. Copy / note the 'Machine Key' displayed in the lower part of the options page.
  3. Find a computer with a working internet connection. Open a browser and log into your account (see below) using your license key and your email address.
  4. Use the machine key (see step 2) in order to activate your seat and download your licenses as a file. Store the file on an USB stick or similar and bring it back to the developer machine.
  5. Back in Visual Studio on the development machine click on 'Import' and point to the stored licenses file.

This will install the licenses on the development machine and activate the seat. Once you expect new licenses to be available after a purchase/ renewal simply repeat this process or use the License Activation via Visual Studio directly.

Online License Management

The online license management allows one to manage a developer seat online. It lists all modules licensed for the seat, provides access to both, updates and archived versions of ILNumerics for download and allows for manual activation of such seats not directly connected to the internet.

In order to log into the online license management go to http://ilnumerics.net/mylicenses.php

Use your license key and your email address for logging into the management site. Follow the instructions on-site in order to take the required actions.

The 'Licensed Items' table lists all modules currently enabled for your seat. Individual time spans and version spans as well as the number of activations is displayed for each module. If some range happens to be undefined, the corresponding limit is left open.

The 'Manual Activation' section allows you to paste in the machine key acquired from your development machine (see above). Click on 'Activate' and download the resulting file. It contains all licenses for the seat identified by the machine key and can be imported to

the development machine using the Visual Studio IDE.

On the bottom of the Online License Management page a list with all existing ILNumerics releases is displayed. Note that currently, the list contains all releases up from version 4.8 - regardless if any release matches with your set of valid licenses. Make sure to have proper licenses with a version range including the release before downloading. Otherwise it will not work on your machine. Also, as with version 4.8 there is only one download and install package for all modules / toolboxes.

If you encounter any issues, get in touch with sales!

Changing Licensing Information

The following information is valid for ILNumerics Ultimate VS version 4.8 only. Later versions allow for the direct modification of existing license keys in the Visual Studio Options dialog.

Version 4.8: After activation you will notice that Visual Studio will not allow you to change the licensing information. Commonly, modifications are rarely needed, since the license key assigned to your seat will stick to you, no matter what. The same is true for your email address: commonly email addresses do rarely change. However, there are situations when modifications could be necessary. Some examples:
  • Your license has been transfered to you from another seat / collegue.
  • Your email address has been changed.
  • Your license key has been changed for some other reasons.

In such situations, the activation procedure for your seat must be repeated. In order to clean existing licensing information (license key, email address) delete the following key from your local user registry:

HKEY_CURRENT_USER\Software\ILNumerics

You may use regedit.exe which is available on every Windows installation. Afterwards, you can re-enter another email / license key in the Visual Studio options dialog and proceed normally with the activation.

Licensing for Your Projects

Once you have activated your seat you can start developing your projects. The ILNumerics Visual Studio extension will automatically track which projects need a license for deployment to non-licensed machines and automatically add the required deployment items to your projects. In most situations you will not have to deal with licensing explicitly. For more demanding situations read about the various uses and licensing scenarios and how to apply them to your setup on 'licensing scenarios'.

 

Further readings:

Licensing Scenarios

Login: my licenses

Getting Started: Your first Computing Module