Product Support > SERT

Troubleshooting UI "Unable to establish listener connection on port 8897"


A confusing error message that is sometimes seen in the SERT GUI after attempting to launch a test is:

"Unable to establish listener connection on port 8897
Q: Is UiListener enabled in listeners.xml on local director?"

The most common cause of this message is insufficient heap memory to run the director on the controller system.   The director run script (director.bat on Windows, on Linux) requests as much as 2 gigabytes of heap space.  On 32-bit operating systems or with 32-bit JVMs, the maximum heap memory that can be allocated is roughly 1.5GB.  Even on 64-bit operating systems with 64-bit JVMs, the system may not be able to allocate 2GB.

To verify that heap memory is the issue, look at the file director.log in the SERT installation directory.  The final lines should show error messages similar to the following:

Error occurred during initialization of VM
Could not reserve enough space for 2097152KB object heap

To resolve this issue, edit the director run script (director.bat/  Edit the following line:

set JAVAOPTIONS_DIRECTOR=-Xms64m -Xmx2048m

change the maximum heap value (-Xmx) to a smaller value, such as 1024m:

set JAVAOPTIONS_DIRECTOR=-Xms64m -Xmx1024m

That amount of heap space should be sufficient for most systems being tested, although it may not be enough for a multi-node or blade system.

Note: starting with SERT 1.1.1, a 64-bit operating system and JVM are required for the controller system.


[0] Message Index

Go to full version