Running Oracle UCM in Debug Mode

Remote debugging is a standard Java feature that allows you to attach to a remote running Java process and start debugging it.

This is also possible with the Content Server process. Coupled with a capable IDE like Eclipse, it can help you debug custom components.

To enable the debug mode, you have to edit the file /bin/intradoc.cfg.

For Linux, you have to add the following line:

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

For Windows, it's a different approach:

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

The "address" option tells the process to accept remote debugging over the port 8000. The option "suspend=n" tells the process not to wait for the attachment of the debugging client.