Page History

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:

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 Solution Manager: 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:

cmd

cd "C:\Program Files (x86)\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:

cmd

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

1. Install service:

cmd

C:\Windows\Microsoft.NET\Framework64\v4.0.30319\installutil 
  "C:\Program Files (x86)\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:

cmd

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/frameworkx.service:

ini

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

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

[Install]
WantedBy=multi-user.target

Docker Entrypoint

dockerfile

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

Auto-Start Configuration

Windows Startup Folder

Create shortcut in:

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

TWebServices Auto-Start

Configure TWebServicesRunPrograms.json:

json

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

Client Display Considerations

When running as Windows Service, client displays must be started separately. See Client Deployment (Reference) for auto-start configuration and deployment options.

This consolidated page now includes all the startup configuration details, parameters, and the solution merging feature in the appropriate context.