2.6. Starting OpenIDM in Debug Mode

To debug custom libraries, you can start OpenIDM with the option to use the Java Platform Debugger Architecture (JPDA).

  • Start OpenIDM with the jpda option: 

    $ cd /path/to/openidm
$ ./startup.sh jpda
./startup.sh
Using OPENIDM_HOME:   /Users/lana/openidm
Using OPENIDM_OPTS:   -Xmx1024m -Djava.compiler=NONE -Xnoagent -Xdebug -Xrunjdwp:transport=dt_socket,address=5005,server=y,suspend=n
Using LOGGING_CONFIG: -Djava.util.logging.config.file=/Users/lana/openidm/conf/logging.properties
Listening for transport dt_socket at address: 5005
Using boot properties at /Users/lana/openidm/conf/boot/boot.properties
OpenIDM version "2.1.0-SNAPSHOT" (revision: 2144)
-> OpenIDM ready

    The relevant JPDA options are outlined in the startup script (startup.sh).

  • In your IDE, attach a Java debugger to the JVM via socket, on port 5005.

[Caution] Caution

This interface is internal and subject to change. If you depend on this interface, contact ForgeRock support.