SFS2X Docs / GettingStarted / admintool-ServerConfigurator
» 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.
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.
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:
YYYY = year | MM = month | DD = day
HH = hour (0-23) | mm = minutes | SS = seconds
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: 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.
This tab contains the basic SFS2X settings.
- Stats extra logging makes SFS2X log additional informations which are used to provide more metrics in the Analytics module, in particular averageand peack CCU and Room joins.
- User-friendly logging and User debug-mode switches are not yet implemented.
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.
- The IP addresses white-list parameter overrides the Maximum connections per IP address setting, allowing unlimited incoming connections from the listed IPs.
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.
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).
Read the dedicated HTML5 and WebSockets documentation page for more informations.
- Make sure the WebSocket listener port and WebSocket Secure listener port do not conflict with the general TCP port (default: 9933) and the internal web server ports (HTTP default: 8080; HTTPS default: 8443).
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.
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.
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.
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).
- Removing all the entries in the Administrators table will make the server's administration inaccessible.
- At least one administrator should have full permissions, otherwise some features could become inaccessible, requiring a manual intervention on the configuration files on the server.
- If the Allowed client IP addresses list is left empty, no restrictions on client IP addresses is applied (administrators can connect from any IP).
- If the Administration TCP port is set to -1, no restrictions on connection ports is applied (administrators can connect to any port bound by SmartFoxServer).
- The Use encryption switch enables protocol encryption for the AdminTool client; check this page for more information.
In this tab it is possible to schedule the log analysis process which gathers data for the Analytics module.
Read the Analytics documentation for more informations.
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!
- Core thread is the default number of thread used to process incoming System and Extension requests.
- Backup threads is the number of additional threads added when the core ones can't keep up with the traffic and the queues start filling up; the other settings control how backup threads are called by the system.
- The last parameter of each section sets the size of each queue.
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.
- Common examples of parameters which can be added to the JVM options list are:
- -Xms and -Xmx to configure the heap memory size (for example -Xms512M and -Xmx2048M to start with 512MB of heap memory, up to 2048MB);
- -XX:+CMSClassUnloadingEnabled and -XX:+CMSPermGenSweepingEnabled to make the Garbage Collector (GC) sweep the PermGen too.
- For more informations on the JVM options, check this link on the Oracle website.
- Important: do not to remove the -Dfile.encoding=UTF-8 option from the JVM options list and the ./, lib/*, lib/Jetty/* and extensions/__lib__/* entries from the JVM classpath list; doing this could break the SFS2X functioning.