The Server Management screen gives you access to server settings such as gateways, licenses, communication and thread settings, as well allows you to restart or shutdown the server remotely.

Gateways

 

From this view, you can change the StandAlone gateway name, the number of  connections you want to allow to the registry and also creating and editing gateway listeners.

To add a new listener, use the bottom row of textfields. Enter the IP address as the host name, the port required, and the select the protocol for this listener. Click Create. Repeat for any additional listeners needed. Finally, reboot the server, and check the server console to verify that there were no errors in opening the listeners.

If a change to a listener is required, simply change appropriate information and click Update to save the changes.

General Settings

 

This page allows you to edit general server settings and communication settings. These include things like the server name, the IP/combo that the registry uses to listen for gateway connections, and idle disconnect time among others.

To edit a setting, change the appropriate information and click Update to save the changes.

A few of the settings:

• Command line parameters: JVM options to be used when ES5 is not running in safe mode.
• Concurrent user limit: Maximum number of users allowed to be logged in at any given time.  This is separate from the limit imposed by the license.
• Maximum queued message: When a client has a poor connection, messages arrive at the server out of order.  The server queues them until the expected message ID arrives.  This parameter determines the maximum number of out of order messages at a given time before the server gives up and disconnects the client.
• Timeout: Number of milliseconds that the server will wait for a response from a client, after sending a message that requires an immediate automatic response from the client.  If the limit is exceeded, the server disconnects the client.
• Max Inbound (Outbound) Message Length: Maximum size in bytes of a message from the client to the server (from server to client). Messages larger than this amount will generate a warning in the server log but not be processed.  This protects the ES5 from a common DoS attack.
• Client Idle Disconnect Time (s): If a client does not send a message to the server on its primary connection within this number of seconds, the server will kick the client.
• Not Logged In Disconnect Time (s): If a client connects but fails to successfully log in within this number of seconds, the server will drop the connection.

 

See also: Adjusting ElectroServer's Memory.

Manage Licenses

 

By default ElectroServer has a demo license (limit of 25 users, any IP address) installed. Through this section, the properties of all installed licenses can be viewed and new licenses can be uploaded. More licenses can be installed, but only one license is active at any time.

Once you purchase a license, upload it, and then use this view to enable the new license. A server restart is required for a license to become the active license. Inactive licenses can be deleted.

To upload a new license, click Choose File and select the license from your local computer. Verify that the correct file name is displayed in the header and then click Upload. Once the license has been successfully uploaded, you can select it from the combobox next to the Activate button.

Restart & Shutdown

 

Use the Restart Server or Shutdown Server buttons in this view to restart or shutdown the server accordingly. You will be automatically logged out of your current admin session once you do.

Thread Settings

 

This page displays the current thread settings. They should be modified by advanced users only, and most applications will not need to adjust any of these settings at all.

Processor thread count is the number of threads that are given to each listener for its worker thread pool. On a typical server that is mostly using a single listener you will want this to be a multiple of the number of CPU cores in the machine.  The only real way to determine if the processor thread count needs to be increased is profiling.

The other settings available  on this screen  vary depending on the version of ES5.

To edit a setting, change the appropriate information and click Update to save the changes.

Upload Certificate

 

A production ES5 application that uses the ES Admin remotely will want to enable SSL.  After you have obtained a certificate from a trusted authority, it is added to the KeyStore using this screen.  After uploading the certificate, configure ES5 to enable SSL and then restart ES5.  You will also need to edit your ES Admin settings to connect using SSL. Note: There is no need for SSL during development and testing, or if the ES Admin connects using localhost.