Examples (iOS)
Examples (Android)

 

» Server Configurator module

The AdminTool's Server Configurator module give access to the global SmartFoxServer 2X instance settings. On start-up, SFS2X configures itself with these parameters.

A video tutorial showing a walkthrough of the main SmartFoxServer configuration settings is also available in our YouTube channel.

Server Configurator module

» Usage

When the module is accessed, the current configuration is automatically requested to the server. It is also possible to reload it later by pressing the Reload button located at the bottom of the module.

In order to submit your changes, press the Submit button. In case of concurrent changes made by different administrators, an alert message is displayed.

IMPORTANT
Configuration changes are not applied automatically by SmartFoxServer 2X when submitted (with the exception of the Remote Admin tab – read below). You will need to restart the server for the changes to take effect.
A little warning sign in the bottom right corner reminds that a restart is needed on configuration updates.

If enabled (green), the Make backup switch located near the Submit button allows creating a backup copy of the existing settings before saving the new ones. This is highly recommended.
The backup files are located in the [sfs2x-install-folder]/SFS2X/config/_backups folder and are named using the following convention:

In order to restore a backup, rename it to server.xml and move it to the [sfs2x-install-folder]/SFS2X/config folder, overwriting the existing file.

» Configuration settings

The SFS2X configuration settings are divided into a number of tabs. Most of the settings are self-explanatory, anyway they are all accompanied by the Help icon Help icon: keeping the mouse pointer over it for a moment shows up a tooltip with basic informations. Reading such notes is highly recommended.

The following paragraphs show the screenshots of all the module's tabs and enter into deeper details about the less straightforward settings.

» General tab

This tab contains the basic SFS2X settings.

General tab

Additional informations

» IP filter tab

This tab configures the IP addresses black-list and white-list. Please notice that these settings are not related to IP banning (see the Ban Manager module): black-listed IPs are never permitted to connect to the SFS2X instance, while white-listed IPs can still be banned.

IP filter tab

Additional informations

NEW since version 2.12.0
Starting from SFS2X 2.12.0 it is possible to use IP ranges for both white and black lists. IP ranges must be expressed using standard CIDR Notation.
For example adding the range 192.168.1.1/24 to a white list means that all addresses from 192.168.1.1 to 192.168.1.255 will be allowed to connect. If the same range is added to a blacklist, all those addresses will be rejected by the server.

» Ban manager tab

This tab collects the global banning settings. Ban rules can then be configured on a per-Zone basis by means of the Zone Configurator (Words filter and Flood filter tabs in the Zone configuration).

Ban manager tab

» HTML5 WebSockets tab

This tab allows activating the HTML5 WebSocket protocol in SmartFoxServer 2X. This is required in order to be able to connect an HTML5/JavaScript application.
Read the dedicated HTML5 and WebSockets documentation page for more informations.

Web server tab

Additional informations

» Web server tab

This tab allows to activate the Jetty web server embedded in SmartFoxServer 2X. HTTP and HTTP protocols can be enabled and configured separately.
Activating the web server is mandatory in order to run the BlueBox service, for which a few advanced settings are also available here.

Web server tab

» Adobe Flash Player tab

The settings in this tab are specifically targeted at Flash clients, which require Adobe's security restrictions to be met. Additional informations can be found in the SmartFoxServer 2X troubleshooting guide.

Adobe Flash Player tab

» Mailer tab

Providing an SMTP server address and account details in this tab enables the SFS2X's Mailer service, allowing emails to be sent from within the Extensions without the need of external software.
The Mailer is also used by SmartFoxServer 2X itself to send warning emails to the license owner in case of license issues, so configuring it in production environments is highly recommended.

Mailer tab

» Remote admin tab

This tab allows configuring the users enabled to access the server's administration through the AdminTool. For additional security, a list of allowed IP addresses and the TCP communication port must be declared.
The ability to stop/restart the server and the list of disabled AdminTool modules can be configured on a per-administrator basis.
Please note that unlike the other server settings, those grouped under this tab are applied immediately, as soon as the data is submitted (without needing a server restart).

Remote admin tab

Additional informations

» Analytics tab

In this tab it is possible to schedule the log analysis process which gathers data for the Analytics module.

Analytics tab

Read the Analytics documentation for more informations.

» Thread pools tab

This tab can be used by advanced users to fine tune the System and Extension Controllers thread pools. As these settings can affect performance under heavy load noticeably, change them only if you know what you are doing!

Thread pools tab

Additional informations

» JVM settings tab

This tabs allows advanced users and system administrators to configure additional settings to fine tune the Java Virtual Machine when the SmartFoxServer 2X process is launched. It is also possible to add classpath entries to load additional, external libraries to be used by the Extensions (even if the default entries should be enough for all purposes).

When the JVM settings are changed, the AdminTool takes care of re-generating the SFS2X startup scripts using specific templates. For this reason is not recommended to edit the startup scripts manually, or your changes could be overwritten in case you later make changes using this tab.

JVM settings tab

Additional informations

 

« back to AdminTool