Web Server Configuration (Reference)

TWebServices (Built-in)

The default web service that enables remote access to solutions and web clients.

When Required

TWebServices enables:

• Remote access to solution configurations
• Solutions Manager WebUI access
• Web client connections
• iPad and mobile clients
• Remote engineering

Default port: 10108

Access via: http://<ServerIP>:10108/solutions

Setup Process

1. Open FrameworX → Server Information
2. Click "Add Services" → WebServices → OK
3. Accept Windows security elevation if prompted
4. Service runs as Windows Service

Port Configuration

If port 10108 is in use:

1. Check port usage:

   cmd

   netstat -aon
   tasklist

2. Configure custom port:
   • Navigate to C:\Users\Public\Documents\FrameworX\MachineSettings\
   • Edit TWebServices.json
   • Change "portnumber" parameter
   • Save and restart service

Auto-Start Solutions

Configure TWebServicesRunPrograms.json in MachineSettings:

json

{
  "appSettings": {
    "RunPrograms": {
      "Solution1": "path/to/solution.tproj",
      "Program2": "path/to/program.exe"
    }
  }
}

Used primarily for Linux/Docker deployments where Windows Services aren't available.

Linux Deployment

1. Copy from Windows: FrameworX/net8.0/
2. To Linux: /home/FrameworX/
3. Run TWebServices executable
4. Configure auto-start in systemd or Docker

Microsoft IIS Configuration

For enterprise deployments using IIS instead of TWebServices.

When to Use IIS

• Running Runtime as Windows Service with web access
• Enterprise security requirements
• Integration with existing IIS infrastructure
• Advanced authentication scenarios

Prerequisites

IIS 7.x

Run as Administrator from C:\Windows\Microsoft.NET\Framework64\v4.0.30319:

cmd

aspnet_regiis -i -enable
ServiceModelReg.exe -r

IIS 8.0+

Enable in Windows Features:

• ASP.NET 4.5+: IIS → World Wide Web Services → Application Development
• HTTP Activation: .NET Framework Advanced Services → WCF Activation
• Dynamic Compression: Web Server → Performance Features

Service Installation

TProjectServer (Remote Configuration)

Add Application in IIS:

• Alias: TProjectServer
• Physical Path: C:\Program Files\Tatsoft\FrameworX
• Application Pool: ASP.NET v4.0
• Permissions: Everyone (Read), IIS_IUSRS (Read/Write)

Test: http://localhost/tprojectserver/service.svc

TWebClient/TSmartClient (Web Clients)

Add Application:

• Alias: fx10
• Physical Path: Installation folder
• Application Pool: ASP.NET v4.0
• Anonymous Authentication: Enabled

Add MIME Type:

• Extension: .xbap
• Type: application/x-ms-xbap

Test: http://localhost/fx10/service.svc

Dynamic Compression

1. Go to Server (not site) → Configuration Editor
2. Select system.webServer/httpCompression
3. Add to Dynamic Types: application/json
4. Restart IIS

SSL/HTTPS Configuration

Generate Certificate

1. Server Certificates → Create Self-Signed Certificate
2. Enter friendly name
3. Certificate marked for Server Authentication

Create HTTPS Binding

1. Site → Bindings → Add
2. Type: https
3. Port: 443
4. Select certificate

Update Web.config

Comment HTTP, uncomment HTTPS:

xml

<!-- HTTP
<security mode="None" />
-->
<!-- HTTPS -->
<security mode="Transport">
  <transport clientCredentialType="None"/>
</security>

HTML5 Clients with HTTPS

Launch with port parameter:

cmd

TStartup.exe /project:MyProject /html5port:443

Troubleshooting IIS