ILNumerics® License Activation
This page shows how to manage your ILNumerics licenses and how to activate your seat for ILNumerics development.
Licensing OverviewIn 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, whether 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 / a new module has been added to your seat. 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 leads you directly 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 here but want 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.
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. This options is available for corporate subscription users.
- Open Visual Studio -> Tools -> Options -> ILNumerics -> Licenses.
- Copy / note the 'Machine Key' displayed in the lower part of the options page. Consider using notepad.exe or similar to store the key in a text file on an USB removable drive or similar. (Using a pen with a paper is rather error prone, given that the characters in the key must not be confused and are case sensitive!) Also, note the version of ILNumerics currently installed. The version is displayed in Visual Studio -> Extensions -> Manage -> Installed and is required in the format: ?.?.0.0., i.e.: only the first two components (major, minor version) are provided. Other components are 0 (zero).
- 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. (On new seats this will also associate your email with the seat.)
- Use the machine key and te version (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.
- Back in Visual Studio on the development machine click on 'Import' and point to the stored license file.
This will install the licenses on the development machine and your seat should be ready for development now. Once you expect new licenses to be available after a purchase/ renewal or update 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 https://ilnumerics.net/account.html
Use your license key and your email address to log-in to your account. Follow the instructions on-site in order to take the required actions.
Select your seat from the 'Seats' list and review the enabled modules for the seat.
The 'Modules' table lists all modules currently enabled for your seat. Individual time spans and version spans are displayed for each module. If some range happens to be undefined, the corresponding limit is left open, which means 'unlimited'.
At the bottom of the [SEATS] page you find the section dealing with activations of the seat.
The 'Activation' section allows you to list existing activations for the selected seat. Here you can perform offline activation by clicking on 'New Activation'. Follow the instructions to provide the machine key acquired from your development machine (see above). Click on 'Activate' and download the resulting file. It contains al licenses for the seat identified by the machine key and can be imported to the development machine using the Visual Studio IDE.
The 'Downloads' section of your account lists all existing ILNumerics releases. 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. Note, that since 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.
- 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:
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'.
Getting Started: Your first Computing Module