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...
See also Como hacer debug remoto en Tomcat desde Eclipse.
Other tools
There are some other interesting tools for debugging and profiling a Java application: