Runtime Installation Reference

Install and configure runtime components.

Reference → Solution → Deployment → Runtime | Server | Client Types | Container | Redundancy | Security

Deployment Scenarios

Windows Runtime Deployment

For Windows-only solutions targeting .NET Framework 4.8:

• Install the complete FrameworX platform (same as Designer)
• No separate runtime-only installer exists
• Configure to use only runtime components in production
• Disable Designer access if needed for security

Multiplatform Runtime Deployment (.NET 10)

For solutions targeting Linux, Docker, or edge devices, or for web-based clients using WebAssembly:

Silent Install and Exit Codes

The Windows installer is an Inno Setup package. For unattended deployment (SCCM, Intune, Ansible, PowerShell DSC):

Start-Process -FilePath "FrameworX-10.1.5-Setup.exe" `
  -ArgumentList "/VERYSILENT", "/SUPPRESSMSGBOXES", "/NORESTART", `
                "/LOG=C:\Logs\frameworx-install.log", `
                "/DIR=C:\Program Files\Tatsoft\FrameworX" `
  -Wait -PassThru

Installer exit codes (Inno Setup standard):

For full automation patterns including SCCM/Intune packaging and rollback, see IT Deployment RunBook.

Solution Startup Configuration

TStartup.exe Overview

TStartup.exe is the executable that runs FrameworX solutions. It supports various parameters for debugging, redundancy, and advanced configuration.

Basic Startup Methods

Manual Start:

• From SolutionCenter: Select solution → Runtime Startup
• From Designer: Runtime → Startup → Run Startup
• Using Windows shortcut with parameters

Windows Service:

• Runs on computer startup
• No user login required
• Configure at Runtime → Startup

Command Line/Batch File:

cd "C:\Program Files\Tatsoft\FrameworX\10.1"
TStartup.exe /Solution:"C:\Solutions\MySolution.tproj"

Startup Shortcuts in the User Utilities Folder

StartRuntime and StartRichClient are not executables. They are .bat shortcuts created in the user Utilities folder the first time the product runs, both for an installed copy and for a copy started directly from the binaries package:

<User>\Documents\FrameworX\Utilities\StartRuntime.bat
<User>\Documents\FrameworX\Utilities\StartRichClient.bat

Each shortcut calls the real executable in the product folder, with the full installation path already written into the file, so it runs from any working directory:

The same folder holds the other shortcuts generated for the installed components, for example StartWebServices.bat, SolutionCreator.bat, TDatabaseBuilder.bat, UpgradeSolution.bat, RemoveAllServices.bat, and the AI listener shortcuts StartDesignerMCPHttp.bat, StartRuntimeMCPHttp.bat and StartConsoleMCPHttp.bat. The exact set depends on the components installed.

Required Parameters

The minimum parameter needed:

/Solution:"C:\Solutions\Solution.tproj"

Solution Merging on Startup

The platform supports modular project design by automatically merging multiple project files at runtime based on naming conventions.

How It Works:

When launching a main solution (e.g., MyProject), FrameworX automatically merges any projects with names following the pattern:

• Base name + double underscore + suffix + double underscore
• Example: MyProject__ModuleName__

Example Structure:

MyProject.tproj                    → Main solution
MyProject__DeviceConfig__.tproj    → Device configurations
MyProject__DBTest__.tproj          → Test database settings
MyProject__CustomerA__.tproj       → Customer customizations

Runtime Behavior:

• Detects all matching MyProject__*__.tproj files
• Merges contents (tags, scripts, displays, connections)
• Creates unified runtime environment
• Maintains modular development structure

Windows Service Configuration

Install the service with AutoStartup in Runtime → Startup (see Runtime Startup Reference, Enabling AutoStartup), or from a script with TManageServices CLI.

Service Security Settings

Log On Configuration:

• Default: Local System account
• Custom: Domain user for external resources
• Configure in Windows Services console

Start Type:

• Automatic (Delayed Start) is the installer default and the recommended start type. The delay gives the machine time to complete the network link, negotiation and address assignment before the runtime starts.
• Keep the Windows default delay of 120 seconds. It applies to the whole machine and is not a per-service setting.
• On a redundant node this is not optional: the node resolves its Primary or Secondary role from the local addresses of the machine at startup, so a service that starts before the network is ready starts as a standalone node. See Redundancy Reference.

Startup Parameters Reference

Main Parameters

Redundancy Parameters

Redundancy Example:

TStartup.exe /Solution:"C:\Solutions\Solution.tproj" 
  /redundancy 
  /ip1:192.168.1.1 /port1:3101 
  /ip2:192.168.1.2 /port2:3101
  /autoswitch /timeautoswitch:60

Diagnostic Parameters

Advanced Parameters

Per-Process Log File Configuration

Each runtime process (TServer, TStartup, TRunModule, TRichClient) can size-limit its active log file and control retention of daily compressed archives, directly from that process's JSON configuration file (e.g. TServer.json).

Configuration

Add a Logging section under appSettings:

{
  "appSettings": {
    "Logging": {
      "MaxFileSizeMB": 10,
      "KeepAllZips": false
    }
  }
}

Omitting the Logging section entirely preserves prior (legacy) behavior — no size cap, and the daily archive compaction described below is unaffected.

MaxFileSizeMB

Caps the size of the process's active log file, in megabytes. When the limit is reached, the process stops writing to that log file and records a notice ("Log file size limit of <N> MB exceeded; logging to this file is stopped.").

• Integer values only, minimum effective value 1. Fractional or sub-1 values (e.g. 0.5) are truncated to 0, which disables the size limit — no warning is logged when this happens. Sub-1 MB caps are not supported.
• A value of 0 or an omitted setting means no limit.

KeepAllZips — daily archive retention

On each day change, the runtime compacts the previous day's per-process log: every non-current log file for that process is compressed into a same-named .zip archive, then the original text log is deleted. This daily compaction always runs, independent of KeepAllZips. The currently-active log file is never touched.

KeepAllZips controls only how many of those daily archives are retained afterward:

Retention is evaluated independently per process log (TServer, TStartup, TRunModule, TRichClient are each pruned separately), and pruning only runs when more than one archive is present — the newest archive is never at risk. KeepAllZips is independent of MaxFileSizeMB: the size cap governs the active log within a day, while KeepAllZips governs retention of the compressed archives across days.

Linux/Docker Startup

systemd Service

Create /etc/systemd/system/frameworx.service:

[Unit]
Description=FrameworX Runtime
After=network.target

[Service]
Type=simple
ExecStart=/opt/frameworx/TStartup.exe /Solution:/opt/solutions/Solution.tproj
Restart=always
User=frameworx

[Install]
WantedBy=multi-user.target

Docker Entrypoint

ENTRYPOINT ["./TStartup.exe"]
CMD ["/Solution:/app/solutions/Solution.tproj"]

Client Display Considerations

A runtime running as a Windows Service has no user interface. To start clients at boot, see Installation Folders and Utilities Reference, AutoStartClient.exe.

Auto-Start Configuration

TWebServices Auto-Start

Configure TWebServicesRunPrograms.json:

{
  "appSettings": {
    "RunPrograms": {
      "MainSolution": "/opt/frameworx/solutions/Main.tproj",
      "BackupSolution": "/opt/frameworx/solutions/Backup.tproj"
    }
  }
}

In this section...