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)

On this page:

Table of Contents
maxLevel2
minLevel2
indent10px
excludeSteps
stylenone



TSecureGateway

Overview

Executable

TSecureGateway 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