Setting the RTSS Boot Configuration

When the RTX64 Runtime is installed, you can assign available processors to Windows or RTX64 through the RTX64 Activation and Configuration utility. The RTX64 Activation utility automatically detects the total number of processors on your system.

The default configuration is the maximum number of licensed RTSS processors, based on the ideal license, with at least one processor assigned to Windows.

NOTE: This warning icon indicates that the RTSS boot configuration needs to be reconfigured.

To set the RTSS boot configuration through the Activation and Configuration dialog:

  1. Launch the RTX64 Activation and Configuration utility from Start > All Programs > IntervalZero RTX64 3.7 > RTX64 Activation and Configuration.
  2. In the Activation and Configuration dialog, click Set the RTSS boot configuration.

NOTE: This option is grayed-out when the RTX64 Runtime is not installed.

  1. Assign processors between Windows and RTX64. For example, on a machine with 8 processors, and a Professional Runtime license at minimum, you can assign up to 7 processors for RTX64 .

NOTE: We recommend you do not split Hyper-threaded cores between Windows and RTX64, as it can cause loss of determinism.

  1. Click Apply to complete configuration.

NOTE: The Apply button remains grayed-out until a valid configuration is provided.

  1. When you are prompted, click Yes to reboot your computer.
  2. Restart the system. Choose the RTX64 boot configuration at system startup.

NOTE: You must reboot the machine if you change the number of Windows processors. If you change the number of RTSS processors, you must restart the RTX64 Subsystem.

NOTE: Even if you don't reboot immediately, all changes will be saved and will take affect after the next reboot. The RTX64 Subsystem will not work correctly until after the next reboot.

To set the RTSS boot configuration from the command line:

  1. Navigate to %rtx64common%\bin
  2. Open a Windows command prompt with Administrator permissions.
  3. Provide the number of Windows -w and RTSS -r processors. For example, to assign 3 processors to Windows and 5 processors to RTX64, you would type:

Rtx64ActivationUtil.exe -w 3 -r 5

  1. Restart the system.

NOTE: See RTX64 Activation Usage for a full list of supported command line parameters.

RTSS Processor Validation

RTX64 validates changes to the RTSS boot configuration and warns when pending changes will cause conflicts with existing ideal processor and affinity mask assignments.

Boot Configuration Validation

The validation performs these system checks:

Validation checks whether... If validation fails... To resolve the issue...

The Subsystem is fully functional.

A warning appears from the RTX64 System Tray.

Reinstall RTX64.

An RTSS boot entry exists.

A warning appears from the RTX64 System Tray.

Use the Activation and Configuration utility to create an RTSS boot configuration.

The system is booted into the RTSS boot entry.

A warning appears from the RTX64 System Tray.

Boot into the RTSS boot entry.

Processor Assignment Validation

The validation process checks for conflicts with the RTX64 boot configuration and the Subsystem settings for customer-provided processor assignments. These Subsystem settings are validated:

Ideal processor assignments
  • Network ideal processor
  • Network timer ideal processor
  • Network interface interrupt ideal processor
  • Network interface link status ideal processor
  • Network interface receive ideal processor
  • Scheduled task ideal processor
Affinity mask assignment
  • Scheduled task affinity mask

When a proposed boot change will result in assignment incompatibilities, RTX64 displays a warning with a link to the RTX64 tool through which the issue can be resolved.

Example:

The validation process writes these communications to the RTX64 event log:

You can access RTX64 event log entries from the Windows Event Viewer under Event Viewer > Windows Logs > Application.

 

Related topics: