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.
- The default value is
9154
- The TCP port must match the port that is set in FabSuite Remote Link (the web program).
- Your network /wiki/spaces/HELPDOCS/pages/56754287.
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 is not active. (see starting the service)
- The network firewall at the fabricator is blocking connections on the /wiki/spaces/HELPDOCS/pages/56754287.
- Windows Firewall on the computer where FabSuite Remote Server is blocking connections on the TCP port used by FabSuite Remote Server and FabSuite Remote Link.
This technote from Microsoft may be of assistance
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:
- Open FabSuite Remote Monitor.
- Click
Stop Service
(this stops the service). - Click
Start Service
.
If you would like to adjust settings:
- Stop the service.
- Click
Settings
. - Make adjustments in the Settings window.
- Click Save Settings to save your changes and close the Settings window.
- 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.