Documentation Center

Setting up remote debugging of your JVM

To debug your JVM remotely, configure several JVM startup options either in the Windows registry or in the jvm.xml startup configuration file.

Procedure

  1. To configure remote debugging in the Windows registry, access or create the following registry key:
    HKEY_LOCAL_MACHINE\SOFTWARE\Tridion\Content Delivery\General

    This subkey may already contain one or more entries for one or more JVM arguments, called jvmarg1, jvmarg2 and so on.

  2. Create entries for two new JVM arguments. For example, if the subkey has no entries yet, add an entry called jvmarg1; if the subkey already has, for example, entries jvmarg1 through jvmarg4, add entries called jvmarg5.
  3. Set the entry you added to the value -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*.5557.
  4. Alternatively, you can configure these settings in a configuration file called jvm.xml (this does not work for the Transport Service). If you do not yet have such a file set up, first copy the file jvm_sample.xml from the Content Delivery\resources\configurations\ folder of your installation media to the configuration directory of your Server Role, and rename it to jvm.xml
  5. Open jvm.xml for editing and find the <VirtualMachines> section, which contains an <Options> section. Inside this section, add the following:
    <Option Name="-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*.5557" />
  6. Save and close jvm.xml and restart your web application or Windows service.