Using MaxRTActivationUtil.exe

You can use the eRTOS Activation command line utility, MaxRTActivationUtil.exe, to activate eRTOS SDK. This utility requires a valid activation key, which you can find in the email you received from IntervalZero Sales when you purchased eRTOS or by viewing your orders in the IntervalZero Customer Center. You can activate eRTOS SDK to a machine or IntervalZero-provided dongle.

Note: You must run MaxRTActivationUtil.exe as Administrator to successfully activate eRTOS components.

Usage

MaxRTActivationUtil.exe [-a Key] [-af Key File] [-ef Key File] [-listdongles] [-lf File] [-aa Key] [-ps Proxy Server Address and Port] [-pc Proxy Server Credentials][-dongle] [-nodongle] [-detectdongle]

Parameters

-a

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

Example:

MaxRTActivationUtil.exe -a <activation key>

-af

Auto export a fingerprint file on 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.

-ps

Connect to the proxy server at the given address and port number.

Example:

MaxRTActivationUtil.exe -ps <proxy server address>:<port number>

-pc

The user name and password to use when connecting to the proxy server specified by -ps.

Example:

MaxRTActivationUtil.exe -pc <user name> <password>

-dongle

Force activation to the dongle.

-nodongle

Force activation to the machine.

-detectdongle

Detects the ID of the dongle connected to the machine.

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

Could be several reasons, such as: invalid values for RTSS or Windows processers; conflicting flags. 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

See also: