Debugging remote JBoss server

If you got problems on production environment this configuration is specially useful.

OpenKM 6.x - Tomcat

Add the following options when the JVM is started:

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

If you are using shell scripts to start Tomcat, start it with the following command:

$ $TOMCAT_HOME/bin/catalina.sh jpda start

It will start Tomcat so that a remote debugger can be connected to port 8000.

For more info read Tomcat developing: How do I configure Tomcat to support remote debugging?.

OpenKM 5.1 - JBoss

Add this line at the top of $JBOSS_HOME/bin/run.sh script:

JAVA_OPTS="-Xmx2000m -Djava.awt.headless=true -Xdebug -Xnoagent -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=8000"

Configure Eclipse

Select the project and the host. Include in source your OpenKM java project. You can debug normally, setting breakpoints etc...

Other tools

There are some other interesting tools for debugging and profiling a Java application:

• Java VisualVM
  • Profiling With VisualVM, Part 1
  • Profiling With VisualVM, Part 2
  • Remote Profiling of JBoss using VisualVM
• HPROF: A Heap/CPU Profiling Tool in J2SE 5.0
• HPjmeter