MaxRT Activation Utility

You can use the MaxRTActivationUtil.exe command line utility to silently activate wRTOS components and configure system processors.

Usage

MaxRTActivationUtil.exe [-a Key] [-if File] [-ef Key File] [-lf File] [-aa Key] [-af Key File] 
[-w Proc] [-r Proc] [-v] [-dongle] [-nodongle] [-detectdongle] [-listdongles] [-h]

Parameters

-a

Create and activate the wRTOS license. Requires an activation key.

Example:

MaxRTActivationUtil.exe -a <activation key>

-if

Import an activation file.
-af Auto export a fingerprint file on the next reboot.
-ef Export a fingerprint file.
-listdongles Provides a list of the dongles connected to the machine.
-lf Import the license file.
-aa Automatically activate the key on the next reboot of the system.
-dongle Force activation to the dongle.
-nodongle Force activation to the machine.
-detectdongle Detects the ID of the dongle connected to the machine.
-w

Set the number of Windows cores. Requires -r. A restart of Windows is required.

Example:

MaxRTActivationUtil.exe -w 3 -r 5

-r

Set the number of RTSS cores. Requires -w

Note: This requires a restart of the wRTOS Subsystem.

Example:

MaxRTActivationUtil.exe -w 3 -r 5

-h Displays help.
-v Validates the license. This parameter will also display the current license(s).

Error Returns

MaxRTActivationUtil.exe returns 0 when it succeeds. When it fails, it returns an error code. The table below lists the possible error codes returned by MaxRTActivationUtil.exe.

Error value

Error code

Meaning
0 ERROR_SUCCESS Success
1 ERROR_INVALID_FUNCTION Returns for all error cases that are not translated to Windows errors
5 ERROR_ACCESS_DENIED Windows Administrator permissions are required
6 ERROR_INVALID_HANDLE Could not retrieve the process handle
13 ERROR_INVALID_DATA Failed to find server location or license file
87 ERROR_INVALID_PARAMETER There could be several reasons, such as invalid values for RTSS or Windows processors, conflicting flags, or arguments that failed to process
126 ERROR_MOD_NOT_FOUND Could not retrieve the process

648

 ERROR_DEVICE_ENUMERATION_ERROR Two or more dongles are connected to the machine

Remarks

You must run MaxRTActivationUtil.exe as Administrator to successfully activate wRTOS components.

Related topics: