Enabling OLT and the IBM Distributed Debugger for WebSphere Advanced Single Server Edition

Once you have completed the following steps for enabling OLT and the IBM Distributed Debugger for the application server, you can start OLT on the workstation where you want to trace and debug your application. Refer to Tracing a distributed application and Starting the OLT server and viewer on separate workstations for instructions on how to do this.

WebSphere Advanced Single Server Edition Version 4.0
You can start WebSphere Advanced Single Server Edition Version 4.0 with OLT and the Distributed Debugger enabled via command prompt or via the WebSphere Application Server browser-based user interface.

To start by command prompt, issue the following:

startServer -oltenabled -debug

To start by the WebSphere Application Server user interface, do the following:

  1. Start the Administrative Console:
  2. Select IBM Debug and OLT in the topology view on the left side of the console for the default server on your node.
  3. This will cause the IBM Distributed Debugger and Object Level Trace Settings page to display in the right-hand frame of the browser. In this page, select the Enable Object Level Trace and Enable IBM Distributed Debugger checkboxes. In the Host Name field, specify the OLT Host Name by entering the name of the machine where you will be running the OLT tool. The OLT Port should not be changed from its default of 2102, unless there is a port conflict.

    Note: If you modify the Port in the IBM Distributed Debugger and Object Level Trace settings frame to a port other than 2102, you must start OLT and modify the OLT Server TCP/IP port accordingly. The OLT Server TCP/IP port is set in the Browser Preferences dialog box (accessed by selecting File > Preferences from the OLT menu bar and then selecting the OLT node). If there is a port conflict and you are unable to start OLT, go to the %userprofile%\DbgProf directory and modify the OLT_TRC_SRVAPP_PORT in the dertrenv.dat file accordingly.

    The entry in the Source Path field indicates to the Debugger where servlet source files, EJB source files, and JSP files can be found. Use semicolons to separate all entries on the Source Path. For example, add the following to the source path:

    <WAS_ROOT>\installedApps\sampleApp.ear\examples.war;<WAS_ROOT>\installedApps\sampleApp.ear\examples.war\WEB-INF\classes

    where WAS_ROOT is where WebSphere Application Server is installed (eg. c:\WebSphere\AppServer). Click OK when you are finished.

  4. To save your configuration, click Save and then click OK in the Save Configuration frame.
  5. Restart the application server in order to pick up your changes.

WebSphere Application Server Version 3.5.x
Enter the following command to start WebSphere Application Server Version 3.5.x with OLT and the Distributed Debugger enabled:

startstd -oltenabled -debug

ngrelt.gif (466 bytes)
Tracing a distributed application
Enabling OLT for Component Broker
Enabling OLT for WebSphere Advanced Edition and Enterprise Extensions
Preparing for an OLTand IBM Distributed Debugger session on workstations
Compiling application code for OLT and the IBM Distributed Debugger

ngrelr.gif (548 bytes)
WebSphere Advanced Single Server Edition: tracing and debugging a servlet