Configure Runtime Java options

Java options are usually added to the runtime Java command with the -D<option-name>=<option-value> syntax. You can also set them in the runtime configuration file, engineParameters.xml.

Options specified in the runtime configuration are loaded after the runtime starts. Certain Java options such as memory settings need to be set at Java startup, and cannot be used with this method.

Configure Java options

To configure the runtime java options:

  1. Edit the engineParameters.xml file.

  2. Configure the Java options under the <javaConfiguration> node, as shown in the below example.

  3. Restart the runtime or reinstall the runtime service.

<parameters>
  <...>
  <javaConfiguration>
    <property name="myOption01" value="value01"/>
    <property name="myOption02" value="value02"/>
    <...>
  </javaConfiguration>
  <...>
</parameters>

System properties

The com.semarchy.xdi.graceful-shutdown-delay system property can be used to configure a graceful shutdown of the runtime.

Runtime graceful shutdown
-Dcom.semarchy.xdi.graceful-shutdown-delay=30s

Java Management Extensions (JMX) variable

Java Management Extensions (JMX) is a technology for managing and monitoring Java applications. It allows you to follow memory or class usage with utilities like jmap or external tools such as Visual VM. Java enables JMX features by default, but only on the local machine unless explicitly set otherwise. In this way, you can make use of JMX to monitor the xDI Runtime locally.

For more information about JMX, refer to the Oracle documentation.

If you want to prevent tools from monitoring the xDI Runtime, you can disable JMX in one of two ways.

Block monitoring with an environment variable (recommended)

  1. Stop the xDI Runtime.

  2. Edit or create the XDI_RUNTIME_OPTS environment variable for your machine or user session.

  3. Append the parameter -XX:+DisableAttachMechanism to this variable.

  4. Start the xDI Runtime

Block monitoring in the startup file

  1. Stop the xDI Runtime.

  2. Edit the initvariable.bat (Windows) or initvariable.sh (Linux, macOS) file.

  3. Add the parameter -XX:+DisableAttachMechanism to the XDI_RUNTIME_VM_PROPERTIES variable in the file.

  4. Start the xDI Runtime