Server Troubleshooting

System Requirements

Ensure your system meets the minimum requirements for running Elixir Repertoire Server. In particular, check the available RAM and ensure that the memory allocated to the server (defined by startServer.bat and startServer.sh) does not exceed the available RAM. The default values are 512MB, set using the option -mx512M.

Port Availability

Ensure that port 8080 is not used by other software. These values are set in the config file ERS2.xml, so you can change them in case of any conflict. Of course, if you change the values, clients must connect to the modified port numbers. By default the server will exit automatically with a message if the client connection port is not available.

Logs

The log directory contains a server.log file that will indicate any errors that occurred while the server was running. By default you will see info messages as well as warn and error messages. You can control the level of messages output by editing log-config.xml in the config directory. Look down the file for a <root> element and change the priority value "info" to "debug" for more information, or "warn" or "error" for less information. For optimization, when the server is working properly, you can set it to warn or error.

<root>
  <!-- note this value affects minimum job logging level
       error, info or debug. Increase message logged
       default should keep to info.
  -->
  <priority value="info"/>
  <appender-ref ref="Server" />
  <appender-ref ref="STDOUT_ERROR" />
</root>

Running as a Windows Service

When a program runs as a Windows service, it has no access to user environment variables. You should also avoid assuming a current directory and use absolute paths. Before attempting to run the server as a Windows Service you should ensure it runs as a standalone server. Once this has been verified, you can start as a service and review the Windows Event Viewer and the server log directory for any error messages.