Debugging remote 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.