INtime SDK Help
Installation of SDK and INtime for Windows
INtime SDK v7.1 > Using INtime Software > Installation of SDK and INtime for Windows

Installation of the SDK is performed using the CD medium. The installation of the INtime Distributed RTOS component uses a USB drive.

Sources for the INtime installation package:

  1. INtime SDK CD shipped with an SDK purchase
    Use for INtime SDK installation and INtime for Windows Deployment installation.
  2. Download from TenAsys.com website
    1. INTIME SDK full_installer.exe (for INtime SDK - Development)
    2. INtime SDK ISO image (CD)
    3. INtime Runtime installer.exe (for INtime for Windows Deployment)
    4. INtime Host only installation.exe (for INtime Windows host only Deployment)
    5. INtime SDK tools_installer.exe (for INtime SDK tools only without local node)
  3. Build a USB drive for INtime Distributed RTOS Deployment installation from INtime SDK

Platform Requirements

The development kit should be installed on a Windows PC system, Windows 10 or later including 32-bit and 64-bit platforms, or Windows Server equivalents. A multi-core CPU is required to run INtime for Windows on Windows. Windows must be booted using the Windows bootloader. A dual-boot system where Windows is loaded using a third-party bootloader will not run INtime successfully.

Support for Windows 7 and 8 has been deprecated from INtime version 7 onwards.

INtime can be installed on hosts with up to 64 hardware threads. INtime can be assigned to a maximum of 32 hardware threads. Note that Hyperthreading provides 2 hardware threads for each hardware core when enabled.

Each INtime process can address a maximum of 4GB memory. Multiple processes can be loaded on each INtime instance (thread) enabling access to the entire 64-bit memory address space.

SDK Installation

The INtime SDK supports both INtime for Windows and INtime Distributed RTOS configurations.

In the INtime for Windows configuration, the INtime user’s application runs on the same platform as the development tools while with the INtime Distributed RTOS configuration, the developments tools are run on a separate platform.

The INtime for Windows configuration is designed to support an end product that has an INtime application working in conjunction with an Windows application on the same platform. For this reason installation of INtime for Windows configuration includes the installation of an INtime Node (INtime RTOS and application) on the same platform as the INtime SDK as shown in figure below. The resultant output of that environment is to have both the user’s Windows and the INtime application running on the same platform.

Partitioning of the Windows and INtime environments is described in the Configuration section.

INtime for Windows development environment configuration with the Windows and INtime components running on the same platform.

The INtime Distributed RTOS configuration is designed to support an end product that has an INtime application working on a platform by itself. For this reason the default installation of INtime Distributed RTOS configuration does not include the installation of an INtime Node (INtime RTOS and application) on the same platform as the INtime SDK. The resultant development environment looks as shown in the figure below, with the SDK running on a Windows platform and the INtime user application running on a separate platform, the target platform. The resultant output of that environment is to have an INtime application running stand-alone on a target platform that is running an INtime Node.

INtime Distributed RTOS development setup running on separate platforms connected by Ethernet.

Note that the INtime for Windows and INtime Distributed RTOS development environments are identical except for the INtime Distributed RTOS having the Windows and the INtime components running on separate platforms connected via Ethernet. Because of those similarities it is possible to develop stand-alone INtime application with an INtime for Windows configuration setup and then move the application to target platform.

SDK and INtime for Windows Installation Procedure

The procedure below describes installation of the INtime development tools and kernel on your development machine. Make sure that your development machine meets the requirements listed in the Platform Requirements section above.

Note: Install Visual Studio and run it at least once before installing INtime and insure that you are logged on with Administrator privileges. If you install Visual Studio after installing INtime, use the INtime Configuration Manager to add the INtime development tools to Visual Studio.

There are two installation sources. One is a self-extracting zip file. The other is a CD-ROM (also available as a downloaded ISO image).

For self-extracting zip file: Download and execute the zip file. The filename has the form: intimexx-yyyyy-zfull_installer.exe where xx is the major version, yyyyy is the build number, and z is the revision. For development tools only, the self-extracting zip file: intimexx-yyyyy-ztools_installer.exe. For runtime only, two other self-extracting zip files are available: runtimexx-yyyyy-z_installer.exe for INtime for Windows without the SDK, and hostxx-yyyyy-z_installer.exe for host only (Windows host utilities to use on a system with only remote INtime nodes),

For CD-ROM: Insert the INtime CD-ROM. If AutoRun is enabled a welcome dialog appears. If AutoRun has been disabled you can start the installation procedure by double-clicking the file named launch.exe in the root directory of the INtime CD-ROM. If using the ISO image, the filename has the form INtimeSDK_CDROM-yyyyy-z.iso where yyyyy is the build number and z is the revision.

The installation procedure is similar to that of most standard Windows applications. You will be asked to accept the INtime software license agreement and to supply one or more registration keys to complete the installation procedure.

A default destination folder of %PROGRAMFILES%\INtime (typically C:\Program Files\INtime) is suggested by the installation program for INtime RTOS and INtime development tools. Make note of this directory so you can locate it again if you wish to inspect header files and other INtime system files. Sample projects will be installed in the user directory of the user who installed INtime. Configuration files will be installed in the %INTIMECFG% directory.

Two basic install options for the INtime SDK are provided:

If you are installing a network licensed product you will be prompted to enter the IP address or fully-qualified domain name of the license server. Contact your company’s IT personnel for the license server information you will need to complete this licensing step.

After installation has completed you will be asked to reboot the system. If you have been provided a hardware key, insert it before rebooting. Once the system has rebooted you have the option of configuring the INtime runtime environment and services.

Licensing the SDK

Development Licenses:

INtime SDK Evaluation License
Time-limited and node-locked license for INtime SDK evaluations. Tied to a major release version.
INtime SDK USB/CID License
USB/CID (dongle) based license for INtime SDK. Tied to a major release version.
INtime SDK Network License
Network Server based license for a minimum of 6 SDK seats. The server uses a USB/CID key. Tied to a major release version.
INtime Deployment Trial License
Time-limited and node-locked self-serve licenses for either INtime for Windows and INtime Distributed RTOS for development purposes. These are Multi-core licenses that work on any version (except pre 7 INtime Distributed RTOS).

For detailed instructions for obtaining licenses for development see the procedures on our website:

https://tenasys.com/sdk-install/

Or:

https://tenasys.com/policies/

For development, SDK, development licenses:

INtime SDK Evaluation License Procedure for time-limited SDK evaluations

INtime SDK USB/CID License Procedure

INtime SDK Network License Procedure additional instructions for the network license server installation and use

For INtime Deployment Trial Licenses (for development, testing, or demonstrations):

INtime-Deployment-Trial-License-Procedure

Licensing the deployment target

A License String is required for both node-locked licenses and for USB/CID licenses. For USB/CID licenses, the License String is unique for each USB/CID key.

A License String on each SDK host is NOT used for network licenses.

The INtime SDK comes with a license to run the development tools and local INtime for Windows nodes. All customers under a support agreement have the ability to self serve a Deployment Trial License - 30-day node locked, for use with either INtime for Windows or INtime Distributed RTOS. Note that with the exception of INtime Distributed RTOS before Version 7, runtime licenses can be used for any version of that product. Only INtime SDK licenses are version dependent.

INtime Deployment Trial licenses are available self serve from the My Account page. The process includes submitting a Fingerprint (from the License Manager) and installing the resulting license.

Step by step instructions are available on the Policies page.

For detailed instructions for obtaining licenses for deployment see the procedures on our website:

https://tenasys.com/run-time-install/

Or:

https://tenasys.com/policies/

For INtime Deployment Trial Licenses (for development, testing, or demonstrations):

INtime-Deployment-Trial-License-Procedure

To help you select the most appropriate method for deployment see this guide:

Customer Operations Manager Guide

Details of the INtime installer

Overview of the INtime installer

The INtime installer provided to you has been packaged as a self-extracting zip (SFX). It has been designed to automate the installation of INtime on a Windows system. Prior to INtime’s installation, any missing pre-requisite packages will be added to the system. The installer has been designed to resume after any necessary reboot, when the user who started the installation logs back into Windows.

If the user declines a reboot request, the installation will not resume automatically at the next startup.

If INtime is already installed on the computer, it will offer to upgrade the installation to the new version.
This process is outlined in detail later in this document.

Components of the installer

The INtime installer package is provided as a single file named [type][version]_installer.exe. For example, the installer for INtime SDK version 7.0.12345.1 is named intime70-12345-1-full_installer.exe.

The installer SFX includes both 32-bit and 64-bit versions of the pre-requisite installers, as well as packages for both Windows architectures. In addition to these packages, helper applications are included to allow an older version of INtime to be upgraded to the current release in a manner that preserves the configuration of the INtime installation.

The components of the SFX will be extracted to a new subdirectory under the user’s %USERPROFILE% directory. Once INtime has been completely installed, the user may choose to remove the directory and its components, they will not be removed automatically and will be over-written by subsequent INtime installations.

The files included in the installer are:

 Using command line options with the INtime installer

The INtime installer was designed to allow the same customizations from the command line as available in past INtime releases.

The installer has two options to control its behavior. These commands are not passed onto the INtime package itself. (NOTE: These command line options are case sensitive and must be all lowercase)

Other commands specified on the command line will be passed onto the INtime package installer. These options include the standard options available to any MSI package, as well as other options provided by TenAsys to customize the INtime installation: (please note the behavior is different for an upgrade installation, detailed below)

Detailed description of the Upgrade Process

The upgrade process uses MSI (Microsoft Installer). The time estimates can be very optimistic. If the current user's Documents directory is included in OneDrive (or other backup system), this might extend the upgrade time. If possible, mark the %USERPROFILE%Documents\INtime directory as "Always keep on this device" or its equivalent. The progress of the installation can be monitored by viewing the log files: INtime_Upgrade.log and Remove_old_INtime.log in the %USERPROFILE%AppData\Local\INtime_Installer directory.

The automated upgrade process allows an older version of INtime to be replaced with the current version. The following process takes place from the SFX during this process.

When executed, the SFX extracts its contents to a new directory under the current users profile directory (for example: C:\Users\<user>\AppData\Local\INtime_installer\). Any command line options passed to the SFX will be passed to the launcher.exe program once the extraction is complete.

Once extraction is complete, the SFX launches the launcher.exe application. It chooses which architecture it is running on and calls the corresponding launch.exe program to start. It calls that launch.exe application with the same command line options it was passed.

The launch application is started and parses the command line options. If any of the options are detected that apply to the behavior of the launch process itself, it removes those options and saves the rest to a registry value named “INtimeSetup” located under the HKCU\SOFTWARE\TenAsys\INtime\ key.

It then checks the Windows installer service if the pre-requisites have been installed and if INtime is already installed. If the Windows installer service detects that INtime is already installed on the system, it will check the ProductVersion value located under the HKLM\SOFTWARE\TenAsys\ INtime\Version registry key. If the string does not match the version of the version attempting to be installed, it will offer an upgrade to the user, or proceed with an upgrade if called silently. If the strings match, the launch application will alert the user that this version is already installed and exit; it will exit silently when started in silent mode.

Once any missing pre-requisites are added to the system, it will proceed with a series of steps to backup the current configuration.

  1. Signal the INtime Status monitor to close
  2. Stop all local INtime Kernels by running the command 'nodemgr.exe “stop –all”'
  3. Export the current configuration by calling the local copy of INtiConW.exe with the following command line option where “CurrentWorkingDirectory” is the full path to the location launch.exe was executed from (this is the location the SFX was extracted to when using the SFX to perform an upgrade):
    1. INtiConW.exe /e:“[CurrentWorkingDirectory]\upgrade.icf”
  4. Export additional configuration not contained in an icf file by running “upgrade.exe /b”. The upgrade helper program will also detect if a configuration issue would cause the RTIF driver to left in the installed state by the uninstall process. In that case, it will cause the driver to be uninstalled.
  5. The existing installation is removed from the system by running
    “msiexec /x {E713FEDC-4C78-4BDE-8E91-77D9B7C23C50} /qb /l*vx Remove_old_INtime.log DONOTPASSTOWIN=1 /norestart REBOOTPROMPT=Suppress”
    1. /x {E713FEDC-4C78-4BDE-8E91-77D9B7C23C50} Tells the Windows Installer service to remove the INtime package. This package GUID is used for all versions of INtime
    2. “/l*vx Remove_old_INtime.log” will create a log of the removal under the current working directory
    3. /norestart REBOOTPROMPT=“Suppress” causes the INtime removal to not restart when
      completed.
  6. If the removal was successful, a registry value named “INtimeUpgrade” is created under the “HKCU\SOFTWARE\TenAsys\INtime” key.
  7. The upgrade helper application is called again to test for a configuration issue where an INtime device may cause a Windows device to not startup after the reboot.
  8. The user is prompted to restart the system; in silent mode, a restart is executed with no prompt.
  9. After the reboot, the launch application will check if the “INtimeUpgrade” key exists. If so, it will continue with the upgrade process
  10. The new version of INtime will be installed with the command line options originally specified, along with the following additions:
    1. INSTALLDIR=[OldVersionInstallationPath] This will install the new version under the same directory as the old version.
    2. SKIPVETHERINSTALL=1 Only if the above conditions were met
    3. INSTALLLEVEL=1000 For runtime4XX.exe installations, or intime4XX.exe installation where “Development Tools” were displayed in the INtime configuration panel (see note below for additional details).
    4. /qb show only progress bars while installing
    5. /norestart REBOOTPROMPT=“Suppress” signals the installer not to restart when installation is complete, and do not prompt the user to restart
    6. /l*vx INtime_Upgrade.log Create a log file of the new installation
  11. If the new installation was successful, the log file is copied to the root of the INtime installation directory.
  12. Import the settings saved from the upgrade backup command by running “upgrade.exe /r”
  13. Import the upgrade.icf file created before removal by running the local copy of INtiConW.exe with the command
    'INtiConW.exe /i:“[CurrentWorkingDirectory]\upgrade.icf”'
  14. Update any INtime device settings to the latest version of INtime by running the applicable devconfig.exe tools with the following command “devconfig.exe /upci”
  15. All backup information is removed from the registry and disk. The registry values used by launch are removed as well.
  16. The user is prompted to reboot the system; during a silent installation the process will exit, or a reboot will be automatically started if /forcereboots was passed to the SFX at the start of the process.

An important note about the upgrade process: When upgrading an SDK installation with the automated upgrade process, it will check if the “Development Tools” INtime configuration panel applet is configured to be shown by checking the “HKLM\SOFTWARE\TenAsys\INtime\ConfigurationPanels\” registry key for the presence of the “Development Tools” value. If this value exists, a full installation of the new version will be performed, if it is missing a Local Target Only installation will be performed. If you originally selected a “Custom” installation and chose the installed features manually, the new installation will not match your original feature set.

Detailed information regarding the INtime Installation Upgrade Helper

See Also