WebSphere Portlet Factory designer - how to setup the debugging mode

Configuring a server for debugging a model

An example procedure based on the IBM WebSphere Application Server can show you how to debug a model.

1. To configure the WebSphere Application Server for debugging, use the IBM WebSphere Portal server or WebSphere Application Server Admin tool.
   • For portlets

     Access WebSphere Portal server Configuration page. Click Servers > Application Servers > WebSphere Portal.

   • For standalone applications and widgets

     Access the application server Configuration page. Click Servers > Application Servers > server1.

2. On the Configuration page, under Additional Properties, select Debugging Service.

   This link provides access to the application server Debug General Properties page.

3. On the Debug General Properties page, make server debugging possible by enabling the Startup check box.
4. On the Debug General Properties page, make a note of the port number to be used for debug output.
5. Optional: For a portlet, you can also set various debug parameters for WebSphere Portal server, including the JVM Debug Port. IBM WebSphere Portlet Factory Designer can connect to the JVM Debug port to receive debug information.

Running a model in debug mode

After you configure the server for debugging, follow these steps to initiate debugging of Java code:

1. Add a breakpoint to the code.
   1. Open the Java source file for an LJO or the generated Java source file for the model.

      For example, for a model named "Test" in the WEB-INF/models directory, you would find its generated Java source file in: WEB-INF/factory/generated/genjava/_Test.java

   2. Set a breakpoint at the desired spot in the code.
2. Run the Model to Initiate Debugging.
   1. In IBM WebSphere Portlet Factory Designer, choose Run > Debug Configurations > Remote Java Application > the name of your model
   2. Click the debug button
   3. Wait until the debugger is finished loading.
   4. Debug the code for your model as you would any other Java application.