AggreGate Server Startup Problems

AggreGate Server may show an error message on startup or appear to start successfully but not accept incoming connections from Device Servers or clients. This probably means there were some serious or critical errors during server startup. Check AggreGate Server log file to find out the actual reason of error. By default, this file is called server.log and it is located in AggreGate Server installation directory. See Configuring Logging section for more information about logging.

Sometimes critical errors displayed in the error dialog are caused by some smaller problem that can be traced back using the log file.

License is Corrupted

This error message pops up when AggreGate Server is started under Linux without root permissions. To fix the issue, restart the server with root permissions.

For Linux:

su
service %LS_BINARY%_service restart

"The JVM could not be started. The main method could have thrown an exception." message pops up

This message means a critical error occurred during JVM startup. To see the exact error message that should give troubleshooting hints use %LS_BINARY%_console server launcher to start AggreGate Server.

Under Windows, the console window may disappear before you read the message. In this case, use command line interpreter to start %LS_BINARY%_console.

For that, go to Start Menu > Run, type cmd and click OK. The command line interpreter window will open. Now type AggreGate/%LS_BINARY%_console to start the launcher.

"Could not reserve enough space for object heap" message pops up

You may see the following message when trying to start AggreGate Server:

Error occurred during initialization of VM

Could not reserve enough space for object heap

The JVM could not be started. The main method may have thrown an exception.

It means that the Java Virtual Machine cannot allocate the amount of memory specified by -Xmx (maximum memory) launcher file parameter in a single contiguous block. There are several possible solutions:

  • Decrease the value of -Xmx parameter if your AggreGate Server is not under a hard load

  • Try to free up some memory by unloading the applications of rebooting the machine

  • Add more RAM to the machine AggreGate Server is running on

  • Under Windows, some applications may register their dynamic libraries (DLLs) to be located in memory at a certain absolute address. This separates the memory into several blocks and does not allow the AggreGate Server JVM to allocate a large single block of memory. To fix that, use a registry editor to remove all entries from HKEY_LOCAL_MACHINESoftwareMicrosoftWindowsNTCurrentVersionWindowsAppInit_DLLs. Be sure to make a backup first!

"Error starting database service" message pops up

This error means that server was not able to establish connection with the database. Normally the root cause of the error is appended to the error message. If the root cause cannot be identified by reading server startup error message, try the following:

  • Disable database connection pooling

  • Try starting the server and wait until error message pops up

  • Browse the end of server log file (logs/server.log by default) to find out the root cause of database problems

  • If you're using the bundled MySQL database, it is likely that MySQL service failed to start. Check AggreGatemysqldata*.err files for errors. Since bundled MySQL server is configured for high performance, it may not be able to allocate enough buffer memory on some PCs. In this case, decrease values of innodb_buffer_pool_size and innodb_buffer_pool_size parameters in MySQL configuration file (AggreGatemysqlmy.ini).

Server was started but clients cannot connect

If AggreGate Server was launched but it's not possible to connect to it using AggreGate Client and Web UI, it may happen that server startup is still in progress. Check server log file (server.log) to see whether the server is executing a long operation, such as database maintenance. Please contact Tibbo technical support if server startup is regularly taking longer than 3-5 minutes.

Incorrect version of Java (JRE/JDK) is used by AggreGate Server for Linux

Open AggreGate Server launcher file (that is indeed a shell script) for editing and uncomment INSTALL4J_JAVA_HOME_OVERRIDE line. Specify correct JRE/JDK path in this line:

#!/bin/sh
# Uncomment the following line to override the JVM search sequence
INSTALL4J_JAVA_HOME_OVERRIDE=/usr/java/path
# Uncomment the following line to add additional VM parameters

"java.lang.OutOfMemoryError: Metaspace" Error is Logged

In the case that the host machine has sufficient available resources to run AggreGate but registers the error java.lang.OutOfMemoryError: Metaspace, the minimum value of Max Metaspace may not be enough for the particular server configuration. To solve this issue, set the property -XX:MaxMetaspaceSize in the server.vmoptions file to 512m or higher.

“java.lang.UnsatisfiedLinkError: libXtst.so.6” on Server Start

This error can occur in cases where AggreGate is installed on a 64-bit OS with a 32-bit Java Runtime Environment. In most cases it can be resolved by installing the missing libraries. On a Debian-like operating system, this can be done with the following command:

sudo apt-get install libc6-i386 libstdc++6:i386 libxrender1:i386 libxtst6:i386 libxi6:i386

Was this page helpful?