ILOG JRules User Guide > Running and Debugging > Tasks > Creating a Debugger Launch Configuration > Creating a Debugger Launch Configuration for a Remote Java Application with Rules or RuleApps

The debugger launch configuration can be defined for a remote Java application with rules or RuleApps.

To define the launch configuration:

  1. Click Run > Debug. The Debug dialog box opens.
  2. In the Configurations area, select Remote Java Application with Rules and click New. A New_Configuration item appears in the Configurations area.
  3. Enter a name for the configuration in the Name field.
  4. In the Connect page, click Browse and choose a rule project from the list of available rule projects. Then click OK.
  5. You can optionally set a Java project to define a lookup path for Java and IRL source files. You will also need to specify the following information:
    1. In the Host field, enter the IP address or domain name of the host where the Java program is running. If the program is running on the same machine as the workbench, enter localhost.
    2. In the Port field, enter the port where the remote VM is accepting connections. Generally, this port is specified when the remote VM is launched. For example: 7777.
    3. Select the Allow termination of remote VM check box if you want to be able to terminate the VM to which you are connecting.
    Note
    You need to launch the remote Java VM with the appropriate JPDA flag (See http://java.sun.com/products/jpda/doc/conninv.html)

    The following JPDA flags allow you to launch the remote application so that you can later call a debugger via a socket on port 7777.

    -Xdebug -Xnoagent -Xrunjdwp:transport=dt_socket, server=y, suspend=y, address=7777

    You also need to set the following flag:

    -DIlrEclipseDebugger=true

  6. In the Source page, uncheck Use default source lookup path.
    1. Set the IRL source path if you want to be able to open IRL source files when debugging.
    2. Click Add projects to select an Execution Object Model (XOM).
  7. Click the Common tab to change the launch configuration to either local or shared.
  8. Click Apply to save your configuration.

Related Concepts

Ruleset Debugging
Rule Engine
Rule Execution Server

Related Tasks

Creating a Debugger Launch Configuration for a Rule Project
Creating a Debugger Launch Configuration for a Java Application with Rules or RuleApps

Related Samples and Tutorials

Tutorial: Debugging a Ruleset
Tutorial: Debugging a Remote Rule Execution Server Application