Deployment Scenario 3: Deploying in an Image for Auto Activation

In this scenario, wRTOS is installed and configured for auto activation before an image is created for deployment.

Deployment Steps

Deployment of wRTOS in this scenario requires the following steps:

  1. Installing
  2. Activating and Configuring
  3. Creating an Image
  4. wRTOS Activation on the Target System

Installation

Before beginning the installation, do the following:

Important Considerations

Installing

To install wRTOS:

  1. Download the zip file from the IntervalZero Customer Center.
  2. Extract the contents of the zip file.
  3. Double-click the self-extracting executable.
  4. The MaxRT wRTOS Runtime Installer Wizard appears. Click Next on the Welcome screen.
  5. Read the End User License Agreement, select I accept the terms of the license agreement, and then click Next.
  6. On the Destination Folder screen, optionally browse for a different destination location or accept the default location: C:\Program Files\IntervalZero\MaxRT\wRTOS\. Click Next to continue.
  7. On the Custom Setup screen, select the features and components you want to install. Clear selection of the features and components you don't want to install. Click Next to continue.

Note: TCP/IP requires the wRTOS Basic Networking package license. GigE Vision requires the wRTOS GigE Vision license and a wRTOS Basic Networking package license. E-CAT requires the wRTOS Fieldbus package license. Contact IntervalZero Sales to purchase product licenses.

  1. On the Virtual Machine Support screen, leave the Enable virtual machine support check box cleared. Click Next to continue.
  2. On the Ready to Install the Program screen, click Install.
  3. Once wRTOS Runtime has been successfully installed, click Finish to exit the Installer Wizard. If wRTOS is not licensed, or the RTSS Configuration is not set, wRTOS Settings opens, where you can activate components and configure the RTSS core configuration. See Activating and Configuring wRTOS Runtime.
  4. Reboot the system, and then choose the wRTOS boot configuration at system startup: [Operating System] - wRTOS

IMPORTANT: If you boot into a non-wRTOS configuration during startup, a warning message will appear, and wRTOS may not behave as expected.

Activating and Configuring

You can set up your system to auto-activate your product and configure the wRTOS boot configuration using a Command Line utility.

Recommended License Type:

Node Locked – Pool Activation. A single activation key licenses multiple systems.

Auto-Activating wRTOS

To activate your product (Internet connection):

  1. Navigate to the wRTOS\bin directory and run MaxRTActivationUtil.exe as Administrator.
  2. Type the -aa flag and then provide your activation key. For example:

MaxRTActivationUtil.exe -aa WRTOS64-111-2222-3333-4444-5555-WNET64-111-2222-3333-4444-5555

Note: You can find your activation key in the email you received from IntervalZero Sales.

This will set up the system to activate upon the next reboot.

  1. If you want to force activation to an IntervalZero-provided dongle, you can use the -dongle flag. For example:

MaxRTActivationUtil.exe -aa WRTOS64-111-2222-3333-4444-5555-WNET64-111-2222-3333-4444-5555 -dongle (forces activation to dongle)

To activate your product (no Internet connection):

  1. Navigate to the wRTOS\bin directory and run MaxRTActivationUtil.exe as Administrator.
  2. Type the -af flag and then provide your activation key. For example:

MaxRTActivationUtil.exe -af WRTOS64-111-2222-3333-4444-5555-WNET64-111-2222-3333-4444-5555 fingerprint.rfp

Note: You can find your activation key in the email you received from IntervalZero Sales.

This will set up the system to generate a fingerprint file on the desktop. The fingerprint can then be used to generate a license file.

  1. If you want to force activation to an IntervalZero-provided dongle, you can use the -dongle flag. For example:

MaxRTActivationUtil.exe -af -dongle WRTOS64-111-2222-3333-4444-5555-WNET64-111-2222-3333-4444-5555 (forces activation to dongle)

Configuring your System

You can use the MaxRTActivationUtil.exe command line utility to configure system processors.

Note: If your system is hyper-threaded, it is recommended that you assign an even number of processors to Windows so that the Windows logical processor and RTSS logical processor do not share the same physical processor.

Setting the RTSS configuration:

  1. Navigate to the C:\Program Files\IntervalZero\MaxRT\Common\bin directory.
  2. Run MaxRTActivationUtil.exe as Administrator. You must license the product before you configure the system.
  3. Specify the number of Windows -w and RTSS -r processors. For example, to assign 3 processors to Windows and 5 processors to wRTOS on a dedicated system, you would type:

MaxRTActivationUtil.exe -w 3 -r 5

  1. Restart the system.

Creating an Image

Once wRTOS has been installed and successfully activated and configured, create an image for deployment on the target system.

You can use the wRTOS Configuration and Control (RTFW) library to configure the wRTOS Subsystem prior to image creation. For instance, you can set the HAL Timer Period and Local Memory allocation behavior - two options you will not likely change on the target system(s).

wRTOS Activation on the Target System

Once the image is deployed on the target system, reboot the machine. wRTOS will be automatically activated if one of the following scenarios is true:

Related topics: