Debugging JSystem
Debugging can help you understand the behavior of your test automation project when executed from the runner or even to understand the internal mechanism of the framework and reports.
To understand how to debug JSystem you first need to identify the JVM you want to debug. In JSystem there are two JVM processes. The first one is responsible for the GUI and for the creating the different reports; The second one is responsible for managing the system objects and running the tests.
In the more common use case, you would like to debug your tests while they are executed from the runner. The simplest way is to tap on the Debug checkbox in the runner.
In this mode, when you will click on the Play button, the runner will halt until you connect to the JVM remote debugging port. By default, the port is 8787
Advanced users would sometimes like to debug the actual framework or the reports. To enable remote debugging, open the runBase.bat file on Windows or runBase file on Mac and Linux and un-comment the line
DEBUG="-Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,address=8787,server=y,suspend=n
If you leave the switch suspend=n, the runner will not wait for you to connect to the remote debugging port.