Install License Key
3 minute read
This page is applicable for the latest image version mcx-rtos-v.2025.03
. For other mcx-rtos-images checkout: Older versions.
Motorcortex Libraries require a license.lic
([hardwarekey].lic
) file to run in a production environment. This section will explain how to acquire and install license.lic
file. You can always run your Motorcortex application without a license key, but the program will exit after 30 minutes.
Prerequisites
- Laptop
- Motorcortex.io account
- Motorcortex Controller with running a application connected to laptop
Acquire The License File.
For generating a license file the controller Hardware key is needed.
-
E-mail this hardware key and list of components to
license@vectioneer.com
-
You wil receive a
123456789.lic
file trough E-mail, where the filename corresponds to the Hardware Key.
Installing the license file on the controller.
The license file can be stored in any location on the controller and can have any filename, as long as the “license” tag in the config.json file points to this file.
You can therefore add the license file into the configuration package so you can deploy it through the portal. The drawback is that for every controller hardware, you need to have a separate configuration package. The solution is to install the license in a differnt location than the configuration folder, so it does not get overwritten if you deploy the configuration and the license file stays with the machine.
Preferred method: install the license file in /etc/motorcortex via Cockpit
The license file can be stored in a location that is not affected by deploying a configuration. The license now stays with the controller regardless of the configuration that is deployed. A convenient location for the license is /etc/motorcortex/
, this file directory is not overwritten when deploying a new configuration.
Note
Every time installing a new mcx-rtos, installation of a license file is required.
-
Inside config.json change license path to:
"License": "/etc/motorcortex/license.lic"
. -
Browse to Navigator Tab, navigate to
/etc/motorcortex/
folder andUpload
the123456789.lic
. -
Inside the
/etc/motorcortex/
folder, createNew Symbolic Link
. Target:123456789.lic
Name:license.lic
. -
Restart your Motorcortex Application.
Check If The License File Is Valid
A license file is valid
if it matches the controllers Hardware Key
and application: List of Components
. The status of the license can be seen in the log of the motorcortex application:
Browse to Cockpit terminal and execute the following command:
mcx-lastlog | grep License
If your license check turns out invalid
: check if your Hardware Key
, List Of Components
match your hardware device and application.
Note
Features
that are enabled in the license,
will only be added to your application.