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 8)

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"

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

Automated Setup

Configure in Runtime → Startup:

1. Select "Run as Windows Service"
2. Set service name and startup type
3. Configure user credentials
4. Apply settings

Manual Service Installation

The automated setup executes these steps:

1. Create command line:

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

1. Install service:

C:\Windows\Microsoft.NET\Framework64\v4.0.30319\installutil 
  "C:\Program Files\Tatsoft\FrameworX\10.1\TStartupAsService.exe"

1. Registry entry added:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\TStartup\ImagePath

1. Service set to automatic start

Service Security Settings

Log On Configuration:

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

Delayed Start:

• For dependencies on other services
• Configure delay in service properties

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

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

When running as Windows Service:

• Server components run without user interface
• Client displays must be started separately
• Use AutoStartClient.exe for automatic client startup
• Configure remote access via TWebServices

See Client Deployment (Reference) for detailed client auto-start configuration.

Auto-Start Configuration

Windows Startup Folder

Create shortcut in:

C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUp\

TWebServices Auto-Start

Configure TWebServicesRunPrograms.json:

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

In this section...