Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Configure secure gateway communication services.

Reference  InstallationFolders | Licensing | Updates | SecureGateway | Web Server 


Secure communication gateways for multi-site deployments.

Parent Page: Installation & Licensing (Reference)

Table of Contents
maxLevel2
minLevel2
indent10px
excludeSteps
stylenone



TSecureGateway Executable

TSecureGateway

TSecureGateway Overview

Secure Multi-Port Gateway manages communications between multiple FrameworX projects and sites, nodes, and systemsproviding routing and security for distributed deployments.

Architecture

Benefits

Types

  • 1-to-1 Communications: Direct single site connections
  • 1-to-Many Communications: Multiple sites to master project
  • Traffic Control: Only authorized traffic between designated points
  • Site Isolation: Sites remain separate from each other
Security: All communications encrypted and authenticated

Example: Business-level project sending requests to any site in a group, with traffic handled via Secure Gateway.

Info
titleGateway Clarification

Explanation if Gateway in sense of data aquisition, and forward or make series totter others, standard feature in all product lies. see...


Installation

Basic Setup

  1. Run InstallTWebGatewayService.exe
  2. Configure TWebGatewayService.exe.config
  3. Service created in Windows Services
  4. Logs appear in Windows Event Viewer

Multi-Port Setup

When using additional ports:

  1. Stop service:

cmd

  1. InstallWebGateway
  1. /uninstall
  2. Modify
TWebGatewayService.exe.config
  1. configuration file
  2. Reinstall
with port configuration
  1. :

cmd

  1. InstallWebGateway

The installer reads config configuration and updates Windows routing table.


Configuration Parameters

Core Parameters

ParameterDescriptionDefault/Notes
LocalPortGateway listening portSet 0 for Windows Auth only
LocalPortWAWindows Auth listening portSet 0 if not using
RemoteIPTServer.exe computer IPRuntime server location
RemotePortTServer.exe portWithout Windows Auth
RemotePortWATServer.exe port with WAAlternative to RemotePort
WAAuthentication modeTrue = Windows Auth only

Optional Parameters

ParameterDescriptionUsage
RuntimeUsersProjectProject with RuntimeUsers tableValidates SmartClient/RichClient client users
CheckRunTimeUsersWAValidate with Windows AuthCannot use with RuntimeUsersProject
TargetCFCompact Framework supportFor Windows CE deployment

Multi-Port Configuration

Configure additional routing with ExtraCount:

xml

<add key="ExtraCount" value="3"/>
<add key="LocalPort2" value="3100"/>
<add key="RemoteIP2" value="192.168.1.100"/>
<add key="RemotePort2" value="3101"/>

<add key="LocalPort3" value="3200"/>
<add key="RemoteIP3" value="192.168.1.200"/>
<add key="RemotePort3" value="3201"/>

Pattern continues for LocalPort(n), RemoteIP(n), RemotePort(n).


Service Management

Starting

the

Service

Start from Windows Services or command line:

cmd

net start TWebGatewayService

Verification

Check Windows Event Viewer for startup log:

First redirect :: LocalPort: 3101, RemoteIP: localhost, RemotePort: 3101
Extra Redirection Table:
Listen on ipv4:     Connect to ipv4:
Address    Port     Address         Port
0.0.0.0    3100    192.168.80.129  3100
0.0.0.0    3102    192.168.80.129  3101

Monitoring

  • Windows Event Viewer for logs
  • Performance Monitor for traffic
  • Network traces for debugging

Configuration Examples

Single Site Gateway

Basic 1-to-1 connection:

xml

<add key="LocalPort" value="3101"/>
<add key="RemoteIP" value="192.168.1.100"/>
<add key="RemotePort" value="3101"/>

Multi-Site with Windows Auth

Master connecting to multiple sites:

xml

<add key="LocalPortWA" value="3102"/>
<add key="WA" value="true"/>
<add key="ExtraCount" value="2"/>

<add key="LocalPort2" value="3200"/>
<add key="RemoteIP2" value="site1.local"/>
<add key="RemotePort2" value="3101"/>

<add key="LocalPort3" value="3300"/>
<add key="RemoteIP3" value="site2.local"/>
<add key="RemotePort3" value="3101"/>

Limitations

and Notes

All config
  • Windows Authentication disables multi-port functionality
  • XML comments use <!-- --> syntax (remove when editing)
    • Config modifications require service restart
    Default values in TWebGatewayService.exe.config
    • Each additional port requires unique LocalPort number
    • RemotePort can be same across different RemoteIPs

    Troubleshooting

    IssueSolution
    Service won't startCheck Event Viewer for errors
    Port conflictsUse netstat to find conflicts
    Connection refusedVerify firewall rules
    Authentication failsCheck WA parameter matches client
    Routes not workingReinstall after config changes



    In this section...

    Page Tree
    root@parent