JMap Server

Preparing the Environment

Remote debugging environment

It may be useful to have remote debugging for the JMap Server extensions. Once deployed, these extensions are executed directly in the JMap Server process. It is therefore only possible to debug such extensions remotely. The Java Runtime Environment allows for remote debugging by adding a special parameter in the JMap Server environment. You will then be able to perform a server connection from Eclipse and monitor the execution of your JMap extensions step by step.

To activate remote debugging in JMap Server, you must modify the file startjmapserver.vmoptions located in the JMap_HOME/bin directory. The line starting with -Xdebug should be added.

-Xmx768m

-XX:MaxPermSize=256m

-Djava.awt.headless=true

-Dfile.encoding=ISO-8859-1

-Xdebug

-Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=8000

Next, you must restart JMap Server. JMap Server will then be in debug mode and it will be awaiting commands from Eclipse. It is not recommended to activate the debug mode in a production environment, as it significantly decreases system performance.

In Eclipse, you must create a remote debugging configuration using the same parameters given in the configuration file shown above (these are the default parameters).