FabSuite Remote Server and FabSuite Remote Monitor

Overview


FabSuite Remote Server

A Windows service that installed on the same network as FabSuite. It listens for and responds to traffic from FabSuite Remote Link.

FabSuite Remote Monitor

A graphical interface to the FabSuite Remote Server service.

Using FabSuite Remote Monitor

FabSuite Remote Monitor is accessed by double-clicking the icon on the desktop found on the FabSuite Server:

FabSuite Remote Monitor reports the following details in real-time:

FabSuite Remote Server Service Status

If the service is currently active, you will see a message that states that the service is running as well as the TCP port that the service is listening for connections. For example:

THE SERVICE IS RUNNING. 
Running - Port 9154

If the service is not active, you will see a message that states that the service is not running. For example:

THE SERVICE IS NOT RUNNING.

The status of the service is changed with the button in the upper right-hand corner of the window:

If you wish to start the service:Press the Start Service button to start it.If you wish to stop the service:Press the Stop Service button to stop it.

If you have attempted to start the service and it does not start, please contact support and send us your settings and error files.

Uptime

The time (in hours:minutes:seconds) that the service has been active.

Master Connected

Indicates fundamental program status.

Connection SSL Cipher

Indicates whether FabSuite Remote Server is connected to the MySQL database via an encrypted connection.

If FabSuite doesn't use encryption for its ODBC connection, this will be blank.

Total Remote Connections

The total count of connections that have been made during the time that the service has been active.

Current Remote Connections

The count of connections that are currently active.

Total Commands

The total count of XML/JSON commands that transacted during the time that the service has been active.

Current Sockets

The count of TCP sockets that are currently active.

Total Sockets

The total count of TCP sockets that have been created during the time that the service has been active.

FabSuite Remote Server Settings

FabSuite Remote Server is controlled by the settings seen in FabSuite Remote Monitor's Settings window. To access the settings window, click Settings.

Please Note

If you change a setting in Remote Server Monitor, you must restart the service before the new settings will be applied.

The settings window is divided into four main areas.

Database Connection Section

The Database Connection section controls how FabSuite Remote Server connects to the MySQL database.

IP Address

This is the hostname or IP address to the computer on your network where the FabSuite MySQL database resides. If the database resides on the same computer as FabSuite Remote Service (and Remote Monitor), the value should read either localhost or 127.0.0.1.

Port

This is the TCP port used for MySQL database traffic.

  • The default port is 3306.
  • The value should be the same as the port that FabSuite uses.

Username and Password

These fields should contain the credentials of a FabSuite user with administrator privileges.

Note that the password will never be shown and is stored in an encrypted fashion . Be super careful when entering these values – ThEy arE caSE-seNSitIVe.

SSL Cert & Key Paths and SSL Cipher

These fields set the path to the TLS/SSL certificates and keys that are used to encrypt the traffic between FabSuite Remote Server and the MySQL database.

If FabSuite doesn't use encryption for its ODBC connection, these fields should be blank.

Socket Section

The Socket section controls the low-level parameters used with the TCP socket that FabSuite Remote Server uses to listen and respond to requests.

Port

This is the TCP port that the service uses to communicate with the web server where FabSuite Remote Link resides.

Log Level

Traffic transacting over the TCP socket can be logged.

info level - Logs connection time, connection source, success or failure, and errors.

debug level - Logs info level plus XML or JSON of request and response. Passwords will never be logged.

SSL Cert Path

This is the path to the SSL certificates and ciphers that are used to encrypt traffic between FabSuite Remote Link (the web program) and FabSuite Remote Server over the TCP Socket.

  • All traffic between the web server and the local network must (and will always be) encrypted.
  • The value should point to the SSL subfolder in the FabSuite program folder e.g.: C:\Program Files (x86)\FabSuite LLC\FabSuite\SSL

Remote Connection Section

The Remote Connection section controls parameters specific to inbound requests and responses.

Idle Connection Timeout

This setting controls how long a user can stay logged in through Remote Link.

  • Default value: 720 minutes (12 hours).
  • If Socket Timeout errors are getting under your skin, this one of the settings that you want to adjust.
  • Should you want to change this setting, the following reference table will help you determine a value reasonable to you.


Port Forwarding (UPnP) Section

This allows Remote Server to attempt to configure your network firewall using Universal_Plug_and_Play.

We strongly suggest that you not rely upon UPnP for Remote Link, but to /wiki/spaces/HELPDOCS/pages/56754287.

 

Troubleshooting

Error 111 (Connection Refused), and Error 110 Connection Timeout Errors

This problem can occur for one of several reasons:

FabSuite Remote Server (a.k.a, "The Service") Will Not Start

This is likely a problem with the username and password used by FabSuite Remote Server (…did you recently change the admin password?).

''Session Timeout'' Errors

This is easily solved by adjusting the Command Timeout and Ping Timeout settings.

Restarting FabSuite Remote Server

To restart FabSuite Remote Server:

  1. Open FabSuite Remote Monitor.
  2. Click Stop Service (this stops the service).
  3. Click Start Service.

If you would like to adjust settings:

  1. Stop the service.
  2. Click Settings.
  3. Make adjustments in the Settings window.
  4. Click Save Settings to save your changes and close the Settings window.
  5. Click Start Service.

Requesting Help with FabSuite Remote Server

If you still need assistance with FabSuite Remote Server, please contact support. For speedier assistance, send along your log files.